DeepSeek 把 agent 运行时开源了
DeepSeek Harness(命令行名 dsh)不是新模型,也不是 chat.deepseek.com。它是套在模型外面的那一层:工具、文件、会话、循环、界面。官方一句话:一切皆插件。
本页更新于 2026-08-13。数字来自官方仓库当日快照,不编评测分数。
一句话分清三件事
对话产品
chat.deepseek.com 是网页对话。问问题、写文案走那里。
模型 API
deepseek-v4-pro / flash 是接口里的模型。你的后端直接调它。
Harness / dsh
让模型读仓库、跑命令、换插件的那套运行时。本页讲的是这个。
创始人
只挂已核实的人物页、官方 X,以及本站已收录的访谈。个人账号核实不了就不写。
实验室官方 X:@deepseek_ai(梁文锋个人账号尚未核实,不挂在他名下)
先跑起来
官方最短路径是一行命令。启动后还要做两件事:填 API Key,选工作区。没选工作区,输入框不会开。
npx @deepseek-ai/dsh web # Web UI → http://127.0.0.1:3080 # Settings → Models → DeepSeek API key # Choose workspace → send: Summarize this repository
命令与默认端口摘自官方 README / Web UI 指南。兼容性会变,以仓库当前文档为准。
四层叠起来才是一次启动
不要把 Harness 想成一个锁死的 App。启动时从空列表往上叠:底座 bundle → 界面或 headless → 你的 patch。任何一层都能换。
- 01
cordis.patch.yml
你自己的覆盖层:换模型、加插件、改权限。
- 02
profile · web / headless
启动时选哪套组合:带界面,或一次性无服务端。
- 03
bundle · dsh-web-app
浏览器应用。headless 配置里不会叠这一层。
- 04
bundle · dsh-base
每一套 profile 的第一层:模型适配、工具、持久化、沙箱、凭证。
教程
全部教程入门 · 2026-08-13
DeepSeek Harness 入门:一行起 Web UI,再跑通第一个仓库任务
别一上来写插件。先按官方 README 把 dsh Web UI 跑起来,填 API Key、选工作区,再让 agent 总结当前仓库。
进阶 · 2026-08-13
DeepSeek Harness 架构:为什么「一切皆插件」不是海报
用官方 architecture.md 把 profile、bundle、session log 和 turn/step 讲清。不复制包表,只讲你改行为时该挂哪里。
进阶 · 2026-08-13
DeepSeek Harness 第一个插件:先挂上去,再谈产品化
按官方「第一个插件」教程走通 apply(ctx) 和 cordis overlay。不复制步骤全文,只补上边界和下一步该做什么。
和 Claude Code、Cursor 怎么放在一张桌上
这张表只作选型定向,不是评测排名。Harness 的许可与架构来自官方 README / architecture.md;Claude Code 与 Cursor 的形态来自各自产品页。我们没有在同一任务集上跑过对照评测,所以不写谁更快、更准、更便宜。
| 产品 | 开源许可 | 产品形态 | 默认可替换性 | 成熟度(官方口径) |
|---|---|---|---|---|
| DeepSeek Harness | MIT | 开源 agent 运行时 + Web UI / headless | 模型、工具、会话、循环、UI 都是插件 | 开发者预览,会破坏兼容 |
| Claude Code | 专有产品 | 终端编程 Agent | Skills / hooks / MCP,核心循环不开放 | 已面向开发者正式提供 |
| Cursor | 专有产品 | AI 原生 IDE | 规则、Skills、扩展,编辑器本身封闭 | 已面向开发者正式提供 |
网址导航
文档与教程
社区
- GitHub Discussions
官方反馈与 bug 报告入口。
- Discord 社区
官方 README 给出的英文社区。
- dsh-plugin 话题
给插件仓库打上这个 topic,方便被发现。
相关工具
- Cordis 框架
Harness 的插件运行时:服务、类型化事件、可逆副作用。
- DeepSeek API 文档
V4 Pro / Flash、计费与 Codex / Claude Code 接入说明。
- DeepSeek 对话
官方对话产品,和 Harness 不是同一个东西。
最新新闻
2026-08-13 · GitHub · deepseek-ai/deepseek-harness · 官方
DeepSeek 开源 DeepSeek Harness(dsh):一切皆插件官方仓库 deepseek-ai/deepseek-harness 公开:MIT 许可、开发者预览、一行 `npx @deepseek-ai/dsh web` 起 Web UI。架构基于 Cordis,模型适配、工具、会话、Agent 循环都是可替换插件。
2026-08-03 · South China Morning Post · 媒体
南华早报:DeepSeek 邀请开源开发者测试即将推出的 Harness报道称 DeepSeek 在为把大模型变成可执行智能体的「harness」层做测试,并与 V4 系列的智能体能力放在同一叙事里。
老金精选
常见问题
- DeepSeek Harness 是什么?
- DeepSeek Harness(命令行名 dsh)是 DeepSeek AI 开源的 agent 运行时:给模型配上工具、文件系统、会话、循环和界面。它不是新模型,也不是 chat.deepseek.com 那个对话产品。官方定位是「一切皆插件」,底层用 Cordis。
- 怎么安装和启动 DeepSeek Harness?
- 先装 Node.js,然后执行 `npx @deepseek-ai/dsh web`。默认 Web UI 在 http://127.0.0.1:3080。从源码跑则 clone 仓库后 `pnpm install && pnpm run build && pnpm dsh web`。启动后在 Settings → Models 填 DeepSeek API Key,再选一个工作区才能发任务。
- DeepSeek Harness 是不是只能用 DeepSeek 模型?
- 不是。官方模型指南除了 DeepSeek Key,还支持目录厂商(如 Anthropic、OpenAI)以及自定义 OpenAI 兼容端点。密钥存在 `$DSH_HOME/.credentials.yaml`,改模型不必重启服务。
- DeepSeek Harness 和 Claude Code、Cursor 有什么区别?
- Claude Code 和 Cursor 是成熟的商业编程 Agent 产品。Harness 是 MIT 开源、仍处开发者预览的运行时:你可以替换模型适配、工具、沙箱和界面。它更像「可拆开的 agent 底盘」,不是已经打磨好的 IDE。官方 README 写明会有破坏兼容性的变更。
- dsh、profile、bundle 分别是什么?
- `dsh` 是启动器。profile 是一套插件组合(自带 web 和 headless 模板)。bundle 是一层可打补丁的插件包:`dsh-base` 提供模型/工具/沙箱,`dsh-web-app` 加浏览器界面,`dsh-headless` 做一次性无服务端运行。用户自己的覆盖写在 `cordis.patch.yml`。
- 现在能用于生产吗?
- 官方明确写着:目前是开发者预览,正在快速迭代,未来会有破坏兼容性的变更。适合学习架构、写插件、做实验;把核心业务流程绑死在当前 API 上风险很高。许可证是 MIT。
本页怎么更新
新闻往 src/content/deepseek-harness.ts 的 HARNESS_NEWS 头部追加;链接、FAQ、对比表同一文件。教程、导航、精选仍走各自的 append-only 文件,用 slug 挂回本页。核实不了的数字不写。
运营手册:docs/deepseek-harness/PLAYBOOK.md