DeepSeek Harness 是什么
本教程共 32 篇 · 第 1 篇 · 更新于 2026-08-15 · 约 7 分钟阅读
本节目标：搞懂 DeepSeek Harness 是什么、解决什么问题，弄清它和 Claude Code 的关系，学完你能说清楚它「能做什么、不能做什么」。
先看一个公式：Agent = Model + Harness
Harness 的英文原意是「马具、挽具」。把 AI 模型比作一匹马，Harness 就是驾驭这匹马的全部工程：缰绳、鞍具、方向控制。
用这个思路看 AI Agent，就得到社区广泛流传的公式：
Agent = Model + Harness
模型负责「想」——理解、推理、生成。Harness 负责「做」——把模型接进文件系统、终端、网页和工具链，让它在真实环境里干活。
之前 DeepSeek 只开源了模型这一半。2026 年 8 月 13 日，另一半补齐了：DeepSeek Harness 正式开源，发布两天内（截至 2026-08-15 实测快照）GitHub 星标约 10.8 万（数据来自 GitHub API）。发布当天的媒体报道口径是：VentureBeat 报道约 2.75 万星标，The New Stack 报道数小时内突破 3.3 万。
官方名片
先看项目的基本身份信息，后面所有章节都用这套叫法：
| 项目 | 值 |
|---|---|
| 项目名称 | DeepSeek Harness |
| 命令名 | dsh |
| npm 包 | @deepseek-ai/dsh |
| 官方仓库 | github.com/deepseek-ai/deepseek-harness |
| 标语 | Everything is a Plugin（一切皆插件） |
| 许可证 | MIT |
| 开发状态 | Developer Preview（开发者预览），会有破坏性兼容变更 |
| 底层框架 | Cordis（元框架） |
| 默认 Web 端口 | http://127.0.0.1:3080 |
它由 DeepSeek AI 开发，用 TypeScript 编写，跑在 Node.js 上。发布形态很轻：装好 Node.js，一行 npx @deepseek-ai/dsh web 就能启动。
标语：Everything is a Plugin
「一切皆插件」不是营销口号，是这个项目最核心的设计。
模型适配器是插件，工具注册表是插件，会话日志是插件，沙箱是插件，Web 界面是插件，连 Agent 的主循环本身都是插件。官方文档的原话是：没有需要打补丁的「特权核心」（no privileged core to patch）。
Note换模型、换界面、加能力，都只是换一个插件的事。全程不用改框架源码——因为根本没有「源码里的固定部分」可改。
用乐高类比最好理解：传统工具是一块整板，想加功能得敲掉重铸；dsh 是一箱积木，缺哪块就插哪块，不想要的拔掉即可。任何一次插件卸载，它注册的能力都会自动撤销，不会留下残留。
底层是 Cordis
dsh 不是从零写的框架，它站在 Cordis 之上。Cordis 是一个插件元框架，设计思想来自论文《A Programming Paradigm for Spatiotemporal Composability》。
对新手来说，现阶段只需记住三点：运行中的 dsh 是一棵插件树；插件之间通过服务（Service）和事件（Event）协作；扩展方式就是「把新插件挂载到其它插件旁边」。具体机制在第 6 章展开。
和 Claude Code 是什么关系
发布当天，多家英文科技媒体把它称作 Claude Code 的「开源对手」（open source rival，来源：VentureBeat，2026-08-13）。这个说法没错，但要加两个限定。
第一，它是对标对象，不是替代品。 VentureBeat 原文写得很克制：它是 Claude Code、Codex 底层 Agent 基础设施的开源替代，但还不是两者完整开发者体验的替代品（not yet a full replacement）。Claude Code 是闭源商业产品，dsh 是 MIT 开源、可自托管。
第二，它刻意不绑定 DeepSeek 模型。 官方 provider 目录覆盖 DeepSeek、Anthropic、OpenAI、AWS Bedrock、Azure、Google Gemini 等，也支持自定义 OpenAI 兼容端点（来源：官方文档 + The New Stack 报道）。更有意思的是，它还内置了两个子 Agent 提供方，可以把任务直接委派给本机的 Claude Code 和 Codex 执行——默认关闭，需要你自己安装并登录对应产品（来源：官方仓库 packages/subagent/）。
一句话总结关系：Claude Code 是「一个产品」，dsh 是「一套可自由组装的底座」。两者定位不同，本教程不评价谁好谁坏，你按场景选。
能做什么
官方文档列出的核心能力，对应一个编码 Agent 的完整工作流：
- 检查代码仓库、读取与编辑文件
- 执行 Shell 命令
- 搜索文件与网页
- 维护任务计划、调用 Skills 技能
- 委派子 Agent
- 执行权限审批策略，敏感操作先征求你的同意
使用形态有三种：Web 界面（默认 http://127.0.0.1:3080）、无头命令行（headless，一次性任务）、官方 Python SDK。模型看到的一切都会写入只追加（append-only）的会话日志，支持回放、分叉、检索——每一步都有迹可循。
安全层面，官方用系统级沙箱隔离 Agent 的子进程：Linux 用 Landlock、macOS 用 Seatbelt、Windows 用 ACL 受限令牌（来源：The New Stack 报道，2026-08-13）。
它还支持 MCP 客户端、Agent Client Protocol（ACP），能读取项目里的 AGENTS.md 和 CLAUDE.md 指令文件。
不能做什么
边界同样重要，免得期望错位：
- 不是托管云服务。没有 DeepSeek 官方托管的后台 Agent，全部跑在你自己的电脑上。
- 不是成品聊天产品。没有内置多模态看图能力（官方 DeepSeek 路由是纯文本的，无法配置图片模态，看图能力靠社区视觉插件补齐）；没有官方桌面客户端和内置 TUI。
- 没有现成的 GitHub PR 工作流集成。官方文档没有把它列为已完成功能。
- 不能离线推理。模型调用走云端 API，需要联网和 API Key。
- 不是稳定版。Developer Preview 阶段接口随时可能变，官方明说会有破坏性变更。
Warning这些「不能」都是 2026-08-15 的状态。预览版迭代很快，后续以官方文档和
dsh --version实测为准。
版本与模型背景
本教程的版本基线是 @deepseek-ai/dsh 0.1.0-rc.6（npm latest，2026-08-13 发布），底层 Cordis 4.0.0-rc.8，要求 Node.js ^22.19.0 || >=24.0.0。所有命令和配置都按这个版本校正。
同期 DeepSeek 还发布了 V4 Pro 正式版与 V4 Flash 等模型，媒体对 API 定价调整讨论很多。定价与模型能力属于媒体口径，本教程不展开；配置模型的方法见第 13 章。
社区与生态
官方交流渠道是 GitHub Discussions 和 Discord。插件发现靠 GitHub 的 dsh-plugin topic——给仓库打上这个标签，就能被检索到。
发布初期官方表示暂不接受外部 Pull Request（来源：The New Stack 报道），建议通过 Discussions 反馈、用插件扩展能力。仓库的 CONTRIBUTING.md 是最新依据。
小结
DeepSeek Harness 是 DeepSeek 开源的 Agent 运行框架：模型负责想，它负责做；一切皆插件，没有特权内核；MIT 协议，免费可自托管；对标 Claude Code，但模型无关、形态更开放。
它是给开发者用的底座，不是给普通用户的聊天工具。如果你是开发者，想搭一套自己说了算的 Agent 环境，它值得上手。下一章，我们把环境装好。