Metadata-Version: 2.5
Name: ikc-core-sdk
Version: 0.2.0
Summary: IKC 实例核心服务（ikc-core-service）客户端 SDK：typed 资源方法 + 统一壳解包 + 身份信任头/traceId/幂等重试装配
Author: SITECH-iKM
Requires-Python: >=3.12
Requires-Dist: httpx<1.0,>=0.27
Requires-Dist: ikc-sdk-lib==0.7.0
Requires-Dist: pydantic<3.0,>=2.7
Description-Content-Type: text/markdown

# 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`。

## 安装

```bash
pip install "ikc-core-sdk==0.2.0"      # PyPI 独立分发
```

## 版本与兼容性

| ikc-core-sdk | 依赖 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）升级前请核对上表。
