本文适用于deepseek-harness-sdk==0.1.0rc6与deepseek-harness-runtime-bin==0.1.0rc6。升级客户端后,请重新完成下方的只读文件测试。
支持范围
模型目录会变化。运行前先用 Coding Plan 专属密钥查询实时目录:
deepseek-v4-pro。不要把 deepseek-v4-flash 当作本文工具模式的等价替代;本次固定版本验证中,它的多轮推理历史与工具回放未通过。
1. 准备专属密钥
打开 Coding Plan 应用,进入已购买的 Coding Application,创建或复制该应用的专属 API Key。Coding Plan 不使用通用余额,其他应用的密钥不能代表套餐权限。 只把密钥放进当前 shell:2. 创建隔离工作区
Harness 的 bundled runtime 包含本地 Bash 工具。第一次验证不要指向真实项目或主目录;创建一个没有秘密的一次性目录:deepseek-harness-runtime-bin。不要使用 danger-full-access 扩大文件访问范围;本文示例只把一次性目录传给 cwd。
3. 运行官方 Python SDK
把下面内容保存为/tmp/deepseek-harness-demo/run.py:
/v1/chat/completions、SSE、推理内容、工具调用与工具结果回传。完成后可删除 /tmp/deepseek-harness-demo;若 Session 目录包含项目上下文,也应按代码仓库同等敏感级别保管。
常见问题
- 401:检查
ACEDATACLOUD_API_KEY是否导出到运行 Python 的同一个 shell。 - 403 或额度提示:确认密钥属于当前 Coding Application,套餐仍在有效期且有剩余额度。
- 模型不可用:重新查询
/v1/models,不要根据旧截图猜模型名。 reasoning_content/ 工具回放错误:确认 SDK/runtime 都是本文固定版本,并使用deepseek-v4-pro。- 工具执行次数异常:停止运行可能产生副作用的任务,先用本文只读 fixture 验证当前服务版本。
- 安装失败:确认 Python 3.10+、操作系统架构受当前 wheel 支持,并检查 SDK/runtime 版本一致。
能力边界
本文只验证本地 Python SDK 到 Chat Completions 的文本与工具循环。图片、Files API、/v1/responses、/v1/messages、远程工作区和托管 sandbox 不在本教程承诺范围内;工作区权限与本地命令风险由运行 Harness 的机器和配置负责。

