用 Python SDK 驱动 Harness

官方 Python SDK 通过 JSON-RPC 启动并驱动同版本 Harness Runtime。它适合把 Agent 纳入 Python 服务、测试或自动化，而不是替代 Web UI。

安装

pip install deepseek-harness-sdk

SDK 要求 Python 3.10+。官方文档当前列出的 Runtime 平台是 Linux x64/arm64 与 macOS 14+ arm64。安装会带上相同发布版本的 Runtime wheel，因此系统不需要另装 Node.js。

版本必须对齐

Python SDK 与 Runtime wheel 应使用同一个版本。DSH 仍处于预发布期，不要让 SDK 自动漂移到与教程或服务端不同的版本。

Session 与进程

SDK 客户端通过 stdio JSON-RPC 与 Runtime 进程通信。调用方应显式管理工作区、Agent ID、Session ID、权限回调和进程生命周期。

重要安全提示

官方 minimal composition 使用 danger-full-access。其中的持久 Bash 和绝对文件编辑路径可能修改 Runtime 可见的任意位置。

第一次实验应在可丢弃 checkout、容器或 VM 中进行。不要直接把 minimal composition 指向包含私人文件、生产凭据或未提交改动的目录。

什么时候选它

• 需要 Python 控制流程、接收事件或处理权限回调；
• 需要把 Agent 嵌入既有 Python 系统；
• 需要比 Headless 单次文本输出更精细的生命周期管理。

如果只是从 Shell 提交一个任务，Headless 更短；如果目标客户端原生支持 ACP，则官方 ACP 示例更贴近协议集成。