ikc-core-sdk

IKC 实例核心服务（ikc-core-service）的独立客户端 SDK 分发（导入包 ikc_core_sdk）。

与 ikc-core 服务端 wheel 中的 ikc_core_sdk 同源（force-include 自 src/ikc_core_sdk），版本号保持一致；
供下游（如 ikc-open-platform）以正常依赖模式引用，无需安装服务端重型依赖（celery/psycopg 等）；
能力面：typed 资源方法（知识库 A-01~A-04、文档 ingest/upload/get、Wiki/Graph 只读、系统路由）+ 泛化 client.request；统一响应壳解包与类型化异常；身份信任头 / Bearer / 23 位 traceId / 幂等重试装配。

用法与资源清单见 ikc-core-service 仓库 docs/客户端SDK设计与使用.md。

安装

pip install "ikc-core-sdk==0.4.2"      # PyPI 独立分发

版本与兼容性

ikc-core-sdk	依赖 ikc-sdk-lib	说明
`0.4.2`	`==0.9.2`	仅依赖 pin 变更（方法签名与返回形状不变）+ 修正 `__version__` 漂移：0.4.0/0.4.1 只递增了 `pyproject.toml`，`src/ikc_core_sdk/_version.py` 仍是 `0.3.0`（0.4.1 已带该缺陷发布，建议使用 0.4.2）
`0.4.0`	`==0.8.3`	`wiki.build`/`graph.build` 增 `async=True`（返回作业视图）+ `build_async()` 别名，新增 `wiki.job`/`graph.job`（W-07/G-07）；`AsyncWiki`/`AsyncGraph` 同步补齐；同步方法签名与返回形状不变
`0.3.0`	`==0.8.2`	新增 `wiki.build`（W-06）/ `graph.build`（G-06）：请求/响应模型取自 ikc-sdk-lib，返回写后结果视图；只读方法签名与返回形状不变
`0.2.0`	`==0.7.0`	对齐图谱资产对象（G8）/ traceId 纯函数（G2）/ 引擎作业视图与状态映射（G3）；方法签名与返回形状不变（资源方法仍返回响应壳 `data` dict）
`0.1.0`	`==0.6.1`	首个独立分发版本

SDK 版本与 ikc-core 服务端版本解耦（SDK 可先于服务端发版）；升级 ikc-sdk-lib pin 属兼容性变更，下游（如 ikc-open-platform）升级前请核对上表。

分发形态：本包只发布 wheel（sdk/dist/ikc_core_sdk-<version>-py3-none-any.whl）。 sdist 在“由 sdist 重建 wheel”时会因 force-include 的相对路径（../src/ikc_core_sdk）失效而构建失败，故不上传 sdist；本地历史 sdist 仅作构建留档。

Metadata

Release files for ikc-core-sdk 0.4.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for ikc-core-sdk 0.4.2
File	Interpreter	ABI	Platform	Reset
ikc_core_sdk-0.4.2-py3-none-any.whl 26.7 kB Sep 19, 2026	Python 3	none	any	Details

Release files / ikc_core_sdk-0.4.2-py3-none-any.whl

Download URL	ikc_core_sdk-0.4.2-py3-none-any.whl
Size	26.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2a3306918f72c143f119fc4a340fda83feb2b73ba93bdcf23e5383109eecbebc`
BLAKE2b-256 checksum How to use checksums	`11a0a2bc701e1ae0be18d463340f9e71558c94700492782cf88714ba17f723c0`
Upload date	Sep 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.3`