Skip to main content
DeepSeek Harness 是在本地运行的编程 Agent。它会读取工作区、调用工具并执行命令,再通过 OpenAI-compatible Chat Completions 接口调用模型。
本文适用于 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:
不要把真实密钥写入脚本、配置仓库、终端截图或 Session 记录。

2. 创建隔离工作区

Harness 的 bundled runtime 包含本地 Bash 工具。第一次验证不要指向真实项目或主目录;创建一个没有秘密的一次性目录:
如果公司网络使用私有 PyPI 镜像,请先确认镜像中同时存在相同版本的 deepseek-harness-runtime-bin。不要使用 danger-full-access 扩大文件访问范围;本文示例只把一次性目录传给 cwd。

3. 运行官方 Python SDK

把下面内容保存为 /tmp/deepseek-harness-demo/run.py:
运行:
预期结果:
这一步同时验证 Bearer 鉴权、/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 的机器和配置负责。

官方参考

返回 Coding Plan 配置中心。