AIREITER8 月 13 日，DeepSeek V4-Pro 正式 GA，同日上线的还有 DeepSeek Harness（DSH）。这是面向 V4-Pro 和 V4-Flash 的编程 Agent 运行框架，npm 包名为 @deepseek-ai/dsh。它可通过常规 DeepSeek API key 使用，安装只需四步，并带有插件系统。安装前有一点必须分清：PyPI 上从 5 月起就存在一个完全无关的 Python 包 deepseek-harness，同样提供 dsh 命令；两者并不是同一个工具。
DeepSeek Harness（DSH）到底是什么
编程 Agent 的 harness（运行框架）负责模型外围的一系列工作：挑选上下文、处理工具调用报错、重新规划任务，以及判断任务何时完成。即使底层模型不变，只要 harness 配置不同，基准分数也可能发生变化。因此 DeepSeek 在公布 Agent 评测时，同时披露了 harness 设置，而不是只给出孤立的模型成绩。
一些熟悉的例子是：Claude Code 为 Anthropic Claude 模型提供运行框架；Cursor 在 IDE 中整合多个模型提供商；GitHub Copilot 则让 OpenAI 模型在 VS Code 内运行。模型配上 harness，才构成真正的 Agent：它不只是回答单轮提示词，还能改文件、执行命令和调用 API。DSH 为 V4-Pro 和 V4-Flash 承担的正是这一层职责。
DSH 是 DeepSeek 的第一方 harness，定位上类似于 Claude Code 之于 Sonnet 和 Opus，专为 V4-Pro、V4-Flash 构建。7 月 31 日的 V4-Flash beta 更新日志首次公开提到它：其中说明 Agent 基准采用“DeepSeek Harness minimal mode（即将发布）”，并设置 effort=max、top_p=0.95、temperature=1.0。
所谓“minimal mode”，是一套精简配置：推理强度拉满，采样参数固定。它的目的不是针对每项基准单独调优，而是让 Agent 评测能够复现。beta 相关信息中还提到插件系统，说明完整产品的范围比用于产出公开分数的基准运行器更广。
V4-Pro 和 V4-Flash 都支持 100 万 token 上下文窗口，并提供三档推理强度：简单任务使用 low，常规 Agent 工作使用 high，复杂任务使用 max（官方更新日志，8 月 13 日条目）。
安装 @deepseek-ai/dsh：四步完成
需要 Node.js 18 或更高版本，这与 DeepSeek 官方 Claude Code 集成指南要求的基础环境一致。
- 确认 Node 版本：
node --version，需为 18+；若 macOS 未安装，可运行brew install node。 - 全局安装：
npm install -g @deepseek-ai/dsh。 - 设置密钥：从 DeepSeek 平台获取 key 后，运行
export DEEPSEEK_API_KEY=<your key>。 - 启动：
cd /path/to/my-project && dsh。
macOS 上全局安装 npm 包时，权限报错很常见。npm 推荐的解决方式是设置一个当前用户可写的全局前缀：npm config set prefix ~/.npm-global。使用 sudo 也能安装，但可能导致后续更新包时出现文件所有权冲突。
目前没有公布 harness 软件本身的单独定价。其背后的模型 API 将在 8 月 16 日 16:00 UTC 调整为峰谷定价，低谷价格为峰时的一半（官方更新日志）。
V4-Pro GA 基准成绩：Harness 体现在哪里
以下是 DeepSeek 在其 8 月 13 日更新日志中公布的官方成绩，均使用前文所述的 harness 配置得出：
| 基准测试 | V4-Pro GA | V4-Flash beta |
|---|---|---|
| Terminal Bench 2.1 | 87.9 | 82.7 |
| Cybergym | 83.3 | 76.7 |
| Toolathlon-Verified | 74.1 | 70.3 |
| DSBench-FullStack | 71.1 | 68.7 |
| DSBench-Hard | 67.2 | 59.6 |
| DeepSWE | 62.7 | 54.4 |
| NL2Repo | 61.5 | 54.2 |
| Agents' Last Exam | 25.7 | 25.2 |
| HLE（使用工具） | 60.0 | — |
在这些基准中，V4-Pro 比 Flash 高出 0.5 至 8.3 分，差距最大的是 DeepSWE（+8.3）和 NL2Repo（+7.3）。其中最醒目的数字是 Terminal Bench 2.1 的 87.9。r/LocalLLaMA 上有一项独立公开 harness 复现，在 445 次试验中测得 Flash 0731 得分为 82.7，在配置差异允许的范围内印证了 DeepSeek 的说法。DSBench-FullStack 与 DSBench-Hard 属于内部评测集，因此这两行是 DeepSeek 自己的测量结果。
所有公开基准均在 max 推理强度下运行。用于生产时，DeepSeek 的建议是：简单任务选 low，常规 Agent 工作选 high，复杂任务选 max。
@deepseek-ai/dsh 与 pip install deepseek-harness 不是一回事
两个名称几乎相同的包，相隔数月发布，但彼此没有关联。
@deepseek-ai/dsh（npm） | deepseek-harness（PyPI） | |
|---|---|---|
| 维护者 | DeepSeek（官方 scope） | Henry Zhang，非官方关联 |
| 首次发布 | 2026 年 8 月 13 日 | 2026 年 5 月 9 日 |
| 语言 | Node.js | Python |
| 产品性质 | 编程 Agent harness | 协议适配库 |
| 安装方式 | npm install -g @deepseek-ai/dsh | pip install deepseek-harness |
| 许可证 | 尚未核实 | MIT |
PyPI 项目是协议适配库，并非编程 Agent。作者围绕 270+ 次试验记录了 16 项 V4 API 行为，并将其整理为一份 10 条规则的契约，提供四种交付形式：Python 库、dsh CLI、MCP server 和 Anthropic Skill。对于基于 V4 开发的人来说，最容易踩到的三项问题是：
- 多轮工具调用循环中，如果 assistant 消息未保留
reasoning_content，就会返回 HTTP 400；两个模型上均以 3/3 次复现。 /beta端点会静默将v4-pro重映射为deepseek-reasoner。- 在 1,024 token 前缀之后，缓存命中会按 256 token 的块出现；某个五轮循环达到 95% 的平衡命中率，实际输入成本约降低 50 倍。
混淆的核心在于两个包都提供 dsh 命令。通过 pip 安装的是适配库；通过 npm 在 @deepseek-ai scope 下安装的，才是 harness。
不等 DSH，也能把 DeepSeek V4 用作编程 Agent
如果 DSH 文档尚未稳定，而你已经想使用 DeepSeek 驱动的编程 Agent，DeepSeek 的官方集成指南提供了三条支持路径：
| 工具 | 配置方式 | DeepSeek 模型 | 适用场景 | |
|---|---|---|---|---|
| Claude Code | 环境变量、Anthropic 兼容端点 | V4-Pro（主模型）、V4-Flash（子 Agent） | 以 max 强度进行终端编程 | |
| OpenCode | /connect 流程，选择 DeepSeek 提供商 | V4-Pro | 开源方案，可交互选择提供商（需要 v1.14.24+） | |
| OpenClaw | `curl -fsSL https://openclaw.ai/install.sh \ | bash` | V4-Pro 或 V4-Flash | 支持 Skills 与聊天集成的个人助手 |
Claude Code 的配置会把 DeepSeek 模型映射到 Claude Code 的各个模型槽位：
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<your DeepSeek API key>
export ANTHROPIC_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max有一个映射细节需要注意：请求 claude-sonnet 时，实际解析到的是 Flash，而不是 Pro。DeepSeek 文档将 Pro 放入 Opus 槽位，将 Flash 放入 Haiku 槽位。这三种工具都被列为第三方集成，DeepSeek 不保证其效果或安全性。若想横向比较更多方案，可参阅我们的编程 Agent LLM 对比及V4-Pro GA API 指南。
常见问题
@deepseek-ai/dsh 是官方 DeepSeek Harness 吗？
@deepseek-ai 这一 npm scope 与 DeepSeek 的 GitHub 组织一致，发布时间也符合 7 月 31 日更新日志中承诺的时间窗口。社区帖子确认该包可以安装。DeepSeek 的 8 月 13 日更新日志记录了 V4-Pro GA，但没有点名 harness；同时 npm 阻止自动化验证包页面，因此无法通过注册表确认其信息。
DSH 与 PyPI 上的 deepseek-harness 有什么区别？
这是来自不同维护者的不同产品。@deepseek-ai/dsh 是 8 月 13 日发布在 npm 上的编程 Agent harness；pip install deepseek-harness 安装的是 Henry Zhang 独立开发的 Python 协议适配库，采用 MIT 许可证，于 5 月 9 日发布，主要处理 V4 API 的特殊行为。两者都带有 dsh 命令。
使用 DSH 需要 DeepSeek API key 吗？
需要。Harness 通过 DeepSeek API 调用 V4-Pro 和 V4-Flash，因此用量会按 token 计费。npm 包本身可免费安装，费用来自 API 消耗。V4 系列将在 8 月 16 日 16:00 UTC 切换至峰谷定价，低谷价格是峰时的一半。
DSH 和 Claude Code 相比怎么样？
Claude Code 是成熟且文档完善的终端编程 Agent，已可通过 Anthropic 兼容端点运行 DeepSeek。DSH 的卖点则是模型专属优化：它围绕 V4 的协议行为构建，而不是后期去适配 V4。结合基准配置的披露，这种优势有其合理性；但在 DSH 官方文档完善、社区测试积累之前，独立使用中的优势尚未得到验证。
AI harness 和 AI agent 有什么区别？
Harness 是基础设施层，负责上下文管理、工具路由和任务编排。Agent 则是完整组合：模型在 harness 中运行，从而具备多步骤执行能力。每个 Agent 都需要 harness，但同一个 harness 可以服务不同模型。Claude Code、Cursor、Copilot 和 DSH 都是 harness；让它们成为“Agent”的，是其中运行的模型。
发布信息：哪些已官方确认，哪些来自社区
本文信息分为两个证据等级。
官方已确认（DeepSeek API 更新日志，含日期条目）：
deepseek-v4-pro于 8 月 13 日 GA，原生支持 OpenAI Responses API，并提供三档推理强度（更新日志）。- V4-Flash 于 7 月 31 日进入公开 beta，基准测试使用“DeepSeek Harness minimal mode（即将发布）”。
- 所有 V4-Pro GA 和 V4-Flash beta 的公开基准数字均来自这些更新日志条目。
- V4 系列定价将在 8 月 16 日 16:00 UTC 切换为峰谷价格。
- Claude Code、OpenCode 和 OpenClaw 集成指南属于官方文档。
社区报告（Reddit 帖子、复现截图）：
@deepseek-ai/dsh可以安装并正常运行。u/Testx01 于 8 月 13 日 12:56 UTC 发布了包链接，u/Available_Yam_6267 在数分钟后跟帖。@deepseek-ainpm scope 与 DeepSeek 的GitHub 组织一致。- npm 的包页面阻止自动化抓取，因此无法通过注册表确认版本、许可证和维护者元数据。
“Deepseek harness is out on npm :)”——u/Testx01，r/DeepSeek，8 月 13 日
- 一则复现的内部 beta 消息称，一个由 369 名成员组成的 beta 小组于 8 月 11 日推送了最终内部构建，并要求插件开发者在 8 月 13 日公开 beta 前给仓库加上
#dsh标签；上线后，插件将可转移至个人账户。 - 社区报道援引中国科技媒体 5 月的说法称，DeepSeek 当时正组建专门的 harness 团队，并招聘 Agent Harness 产品岗位。
在 DeepSeek 自己的网站发布正式文档前，DSH 的功能、CLI 和插件相关说法均应视为社区确认的信息。