5.2 KiB
DeepSeek Harness
English | 中文
DeepSeek Harness（dsh）是一款基于 DeepSeek Harness SDK 构建的开源 coding agent（编程智能体）。
它采用了一切皆插件的架构。
内测声明
感谢您愿意拨冗试用 DeepSeek Harness。当前版本仍处于内部测试阶段，功能仍待完善，体验难免有些粗糙。
“如切如磋，如琢如磨。” 产品的成长，离不开一次次真实的碰撞与坦诚的反馈。您在真实使用中发现的问题，也可能促使我们重新审视，甚至推翻已有的设计。
为了帮助我们更准确地还原您真实使用中的问题，内测版本默认会上传所有 Session Log；如需关闭，可以设置环境变量 DSH_TELEMETRY_DISABLED=1。另外，如果您有任何反馈与建议，请在企业微信群中留言告诉我们。每一条反馈，都会帮助我们把它打磨得更好。
安装
克隆仓库，然后运行安装器：
git clone <repo-url>
cd deepseek-harness
scripts/install.sh
安装器要求系统已安装 git 和 Node ^22.19 || >=24，缺少 pnpm 时可代为安装，并会提示输入 DeepSeek API 密钥，然后构建所需的仓库产物并启动 Web UI。
安装器会把所有检出都放在 ~/.dsh/source 下：master 克隆位于 ~/.dsh/source/master，每次安装的 staging 检出是一个 git worktree ~/.dsh/source/staging-<时间戳>。稳定符号链接 ~/.dsh/source/current 指向当前生效的 staging worktree，~/.local/bin 中的 dsh 链接到 current/bin/dsh，因此升级只需重指一个符号链接，PATH 上的 dsh 从不移动。再次运行该命令会基于更新后的 master 新增一个 staging worktree，并把 current 重指到它。其他安装位置和选项见 scripts/install.sh。
使用 DeepSeek Harness
Web UI
推荐在本地使用 Web UI；安装结束时，选择 Web UI 即可。以后需要启动时，或更新当前生效的检出后，请构建仓库并运行：
(cd ~/.dsh/source/current && pnpm run build)
dsh web
上述路径是安装器的默认位置。如果你设置过 DSH_SOURCE 或 DSH_CURRENT，或者复用了已有检出，请把 ~/.dsh/source/current 换成该检出路径；详情见 scripts/install.sh。Web UI 默认通过 http://127.0.0.1:3080 提供服务。
自定义运行时
原始 dsh 要求传入一份 patch 列表配置，并将其叠加在随附 base 之上：
dsh --config ./app.cordis.yml
base、overlay 语义与配置输出命令详见 CLI（命令行界面）契约。
Headless
运行一项任务，打印最终答案后退出：
dsh -p "summarize this workspace"
自动化与 SDK
在源码检出中通过环境变量或根目录 .env 设置 DEEPSEEK_API_KEY，然后启动 ACP（Agent Client Protocol）自动化服务器：
pnpm run demo:acp
Python SDK 驱动随附的 JSON-RPC 运行时。示例涵盖可运行的 headless、ACP、JSON-RPC、Code Mode 和自指组合。
为什么选择 DeepSeek Harness
内置功能涵盖文件读取、编辑与搜索、shell 和持久 PTY 执行、可复用 skill（技能）、任务跟踪、目标、计划、待办事项与后台任务、subagent 与工作流、沙箱与审批、设置与凭据、可持久化、恢复、fork 与查询的会话、LSP 与 Web 访问、上下文压缩（context compaction），以及遥测。每个组合只选用适合其使用方式的能力子集。Web UI 包含 Plan Mode。
- 一切皆插件。 模型、工具、策略、存储、上下文管理和界面均可组合为 Cordis 插件，部署方无需 fork agent loop（智能体循环）即可扩展或替换行为。底层设计见架构文档。
- 运行可重建。 凡是模型可见的内容，都会记录在权威会话流中；持久化、恢复／fork／查询、回放、遥测和 UI 均从同一组事件派生。参见会话日志架构。
- Code Mode（需显式启用）。 它会提供
run_code工具和生成的 TypeScript SDK，只有程序输出会重新进入模型上下文。参见 Code Mode。 - 自指 Cordis 工具需显式启用。 这些工具可让 agent 检查自身的实时运行时，并在运行中挂载或卸载插件。参见 Cordis 工具。
社区
扫描二维码，或打开 DeepSeek Harness 微信社区申请页面 申请加入。
开发
pnpm install
pnpm run test:coverage
面向 agent：遵循 AGENTS.md。
DeepSeek Harness 目前处于内测阶段。
许可证
第三方依赖及其许可证在 THIRD_PARTY_NOTICES.md 中披露。