DeepSeek Harness (dsh) 对比 HagiCode:功能与差异

DeepSeek Harness (dsh) 是 DeepSeek AI 的开源 Agent harness,目前仍处于开发者预览阶段;HagiCode 是把 dsh 当作执行器之一来运行的工作台。想体验它的插件化架构或写脚本,单用 dsh 即可;需要并行会话、提案和托管提交时,再加上 HagiCode。

更新于: 2026年10月16日

简短结论

DeepSeek Harness,命令是 dsh,是 DeepSeek AI 开源的 Agent harness。它可以作为本地 Web UI、无界面的一次性命令、SDK 服务或 ACP 服务运行,几乎每个部分都是插件。HagiCode 是桌面与网页端的 AI 编程工作台,把包括 dsh 在内的 Agent CLI 当作执行器来驱动。它不取代 dsh;HagiCode 以 ACP 模式启动 dsh,并在外层提供会话、提案和提交处理。

dsh 目前是开发者预览版,它自己的安全声明写明这是实验性、未经审计、可能有不兼容变更的软件。如果你想研究 harness 本身、写插件或做脚本,单用 dsh 就好。如果想让它和其他 Agent 并排运行,并配上提案和并行会话,HagiCode 就是这一层。

DeepSeek Harness 与 HagiCode 对比一览

对比项	DeepSeek Harness	HagiCode
类别	DeepSeek AI 开源的 Agent harness,基于 Cordis 框架用插件搭成;开发者预览	工作台,把包括 dsh 在内的 Agent CLI 当执行器运行
界面与平台	本地 Web UI(dsh web)、headless、基于 stdio JSON-RPC 的 SDK、ACP;需要 Node.js 22.19+ 或 24+	桌面端(Windows、macOS、Linux)、Docker Compose 容器版、Microsoft Store 版
价格与许可	MIT 许可,免费运行;模型费用付给模型提供商	桌面版和容器版免费;Store 版基础免费,可选一次性购买 TurboEngine
模型与提供商	DeepSeek API key、目录内提供商(Anthropic、OpenAI、Moonshot、Z.ai 等)、自定义 OpenAI 或 Anthropic 兼容端点	不托管模型,把提供商和模型传给 dsh;可选 OmniRoute 路由
并行工作	Web UI 中可开多个会话;Agent 可在会话内委派工作	同时运行多个会话,每个是带状态的命名 Agent
规范与规划流程	Agent 在会话内维护计划;没有提案生命周期	OpenSpec 提案:提出、校验、实施、归档(免费版同时 3 个,TurboEngine 为 32 个)
Git 与提交	在工作区里执行 shell 命令;文档中有 GitHub 评审指南	AI 生成提交信息,提交期间锁定仓库;内置 Git 与 GitHub 集成
上手成本	npx @deepseek-ai/dsh web,然后在设置的模型页添加密钥	安装桌面端,另需 dsh 在 PATH 中并配置好模型
最适合	想要开放、可改造 harness、能接受预览版软件的开发者	让 dsh 与其他 Agent 并排使用、并要求规范可追溯的人

DeepSeek Harness 的长处

一切皆插件

dsh 把模型适配器、Agent 循环和界面都做成通过 Cordis 组合的插件。每个 profile 有自己的插件集和用于覆盖配置的 cordis.patch.yml,dsh plugin --profile <name> add <package> 可以向 profile 安装插件。想改变一个 Agent harness 的行为,这正是这个项目的重点。

一个程序,四种运行方式

dsh web 提供浏览器界面。dsh headless "run the tests" 回答一个任务后退出,可以从 stdin 读取任务、输出按行分隔的 JSON 事件,也能按 id 恢复会话。sdk profile 通过 stdio 提供 JSON-RPC,并有 Python SDK 指南;acp profile 为编辑器和自动化客户端服务。

不必重启就能换模型

在设置的模型页,你可以填入 DeepSeek API key、选择目录内的提供商,或定义使用 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages 协议的自定义端点。模型改动在下一次请求生效,密钥保存后只写不读,存放在 $DSH_HOME/.credentials.yaml。

对成熟度很坦率

README 提醒会有不兼容变更,SAFETY.md 称其为实验性、不可用于生产,发布版本都是 alpha 标签。仓库创建于 2026 年 8 月,变化会很快;这种坦率有助于你决定在哪里运行它。

什么时候选 DeepSeek Harness,什么时候选 HagiCode

这些情况选 DeepSeek Harness

• 你想试用 DeepSeek 自己的 harness,或开发、测试 dsh 插件;
• 你想要一个本地 Web UI 来操作 Agent,而不想再装别的应用;
• 你用 dsh headless 跑一次性脚本,或基于 SDK、ACP profile 开发;
• 你能接受预览版软件和版本间的不兼容变更;
• 你只使用 DeepSeek 模型或某一个网关。

这些情况选 HagiCode

• 你想在同一个工作区里让 dsh 与 Claude Code、Codex 等其他 Agent CLI 并排使用;
• 你想同时运行多个 dsh 会话,并把每个作为命名 Agent 跟踪;
• 你希望每次改动都从 OpenSpec 提案开始,有校验和归档;
• 你想要 AI 生成提交信息和内嵌 Code Server 编辑器;
• 你想把 dsh 学到的内容存入 Vault，并在 Monospecs 里一次描述多仓库改动。

HagiCode 不适合 dsh 用户的场景

脚本或 CI 运行:请直接用 dsh headless 或 SDK;HagiCode 是桌面与网页应用。

dsh 自带 Web UI,如果你只是想要一个浏览器前端,HagiCode 的功能超出所需。

需要先装好 dsh 并配置模型;HagiCode 会检查 dsh --help 是否表明是 DeepSeek Harness,名字相同的其他程序会被拒绝。

dsh 是预览版:一次不兼容的更新可能让 ACP 集成暂时失效,直到两边都跟上。

免费版同时最多 3 个提案,不想要规范流程的团队会觉得提案是额外负担。

HagiCode 并不是深度手工编辑的 IDE 替代品,编辑能力止于内嵌的 Code Server。

把 DeepSeek Harness 和 HagiCode 一起用

HagiCode 在你打开的仓库里,以 ACP profile 子进程的方式运行 dsh,并传入你选的提供商和模型。HagiCode 不提供 dsh 的凭据字段,登录和模型密钥仍留在 dsh 里。

不存在锁定:dsh 仍是一个普通安装,随时可以用 dsh web 或 dsh headless 直接运行。

1. 安装 Node.js 22.19+ 或 24+,然后运行 npm install -g @deepseek-ai/dsh,让 dsh 命令出现在 PATH 中。
2. 在 dsh 中至少配置一个模型提供商,例如在它的 Web UI 的设置、模型页填入 DeepSeek API key。
3. 安装 HagiCode Desktop(Windows、macOS 或 Linux,免费),把 Agent CLI 选为 DeepSeek Harness。
4. 同时设置提供商和模型,模型 id 要与 dsh 列出的完全一致,HagiCode 原样转发、不做拆分。
5. 打开仓库,开始会话或提案。HagiCode 始终启动 dsh --profile acp,额外参数里不允许出现 --profile;启动超时默认 45 秒。
6. 想回到纯 dsh,在同一目录直接运行它即可。

dsh 在 HagiCode 里能用什么

并行会话、Agents 管理、OpenSpec 提案、AI 提交、Code Server、Monospecs、Vault 和统一工具调用视图都适用于 dsh 会话。dsh 接受 omniroute 这样的提供商 id,所以把 OmniRoute 配成 dsh 的提供商后,它可以放在下层。

交互式提问只支持 Claude、Pi、OMP 和 Reasonix,Agent 工作面板只支持 Claude,所以这两项在 dsh 下不可用。

HagiCode 在 Agent 之上增加了什么

并行会话与 Agents 管理

同时运行多个 dsh 会话,各有独立上下文,并能看到哪个在运行、等待或已完成。dsh 自己的子 Agent 委派仍在单个会话内部,HagiCode 提供的是上面一层。

OpenSpec 提案

每个任务从提案开始,在提案里与 dsh 讨论方案,再让 dsh 在该范围内实施。因为 dsh 是预览版,当后续版本行为变化时,书面提案也记录了你当时改了什么。

AI 提交与 Code Server

HagiCode 根据 diff 写提交信息,并在提交期间锁定仓库,让 dsh 的产出落成干净的历史。Code Server 可以在浏览器里打开 dsh 改过的文件。

Monospecs 与 Vault

Monospecs 在 .hagicode/monospecs.yaml 里列出子仓库,让跨仓库改动以一个提案的形式交给 dsh。Vault 存放你一次登记、反复复用的参考项目和笔记。

OmniRoute、工具调用视图与用量

OmniRoute 集中管理各 Agent 的模型路由。dsh 的工具调用与其他 Agent 一样显示在同一种类型化视图里,可选的 TokenMonitor 会在状态栏显示今日 token 和费用。

结论

• dsh 是 DeepSeek AI 的开源、插件化 harness,目前仍是开发者预览版。
• HagiCode 与它并不竞争:它运行 dsh,并增加并行 Agent、提案、提交和知识库,代价是多装一个软件。
• 探索、写脚本或开发插件时单用 dsh;当 dsh 只是真实项目里的多个 Agent 之一时,用 HagiCode 加 dsh。

常见问题

DeepSeek Harness (dsh) 免费吗?

dsh 采用 MIT 许可,免费运行。你向模型提供商付费,例如通过 DeepSeek API key;具体费率请看提供商的价格页。

dsh 怎么安装?

官方 README 用 npx @deepseek-ai/dsh web 运行,它会在 http://127.0.0.1:3080 启动 Web UI,需要 Node.js 22.19+ 或 24+。配合 HagiCode 使用时,请运行 npm install -g @deepseek-ai/dsh 全局安装,让 dsh 出现在 PATH 中。

dsh 可以用于生产吗?

按它自己的说法不可以。README 称 dsh 是有不兼容变更的开发者预览版,SAFETY.md 写明它是实验性、未经审计、不可用于生产。

dsh 能和 HagiCode 一起用吗?

可以。HagiCode 以 ACP profile 启动 dsh,传入你选的提供商和模型,并检查 dsh --help 是否表明是 DeepSeek Harness。请先安装 dsh 并配置模型。

HagiCode 会取代 dsh 吗?

不会。dsh 是执行器,HagiCode 是它外层的工作台,你仍可直接运行 dsh。

dsh 和 HagiCode 该选哪个?

想探索 harness、写插件或跑一次性脚本,单用 dsh。当 dsh 只是多个 Agent 之一,并需要并行会话、提案和托管提交时,再加 HagiCode。

在你已有的 Agent 之上试试 HagiCode

安装 HagiCode 桌面版,接入你现有的 CLI,保持原来的工作方式。

安装 HagiCode 桌面版

更多对比

• Claude Code 对比 HagiCode
• CodeBuddy CLI 对比 HagiCode
• Codex CLI 对比 HagiCode
• GitHub Copilot 对比 HagiCode
• DeepAgents 对比 HagiCode
• Gemini CLI 对比 HagiCode
• Hermes Agent 对比 HagiCode
• Junie CLI 对比 HagiCode
• Kimi CLI 对比 HagiCode
• Kiro CLI 对比 HagiCode
• OMP CLI 对比 HagiCode
• OpenCode 对比 HagiCode
• Pi CLI 对比 HagiCode
• QoderCLI 对比 HagiCode
• Reasonix CLI 对比 HagiCode