DeepSeek 官方开源的通用 Agent 运行时(dsh),也是首个由头部模型厂商直接交付的 agent harness。它采用 everything-is-a-plugin 架构,跑在自研 Cordis 框架之上,只需 npx @deepseek-ai/dsh web 一条命令即可启动本地 Web UI,与 Claude Code、OpenCode 正面竞争。项目创建于 2026-08-13,不足一个月 GitHub stars 即突破 21 万,目前为开发者预览版,官方明确会有破坏性变更。 定价:开源免费(MIT)。编辑评分:⭐ 4.5。
DeepSeek Harness是什么?
一句话概括:DeepSeek 官方开源的通用 Agent 运行时,代号 dsh,中文名"DeepSeek 智能体运行时"。
如果你用过 Claude Code 或者 OpenCode,那这个概念很好理解——这类东西通常被称为 agent harness(智能体运行时/骨架)。模型本身只是发动机,harness 才是底盘、变速箱和传动轴:它负责把模型接到文件系统、终端、工具调用、上下文管理上,让模型真的能"动手干活",而不是只会在对话框里说话。
DeepSeek Harness 的特殊之处在于它的出身:这是首个由头部模型厂商直接交付的 agent harness。以前这类工具大多是第三方团队或社区做的,模型厂商自己下场做运行时,它算是第一个。项目托管在 GitHub(github.com/deepseek-ai/deepseek-harness),创建于 2026-08-13,采用 everything-is-a-plugin 的插件化架构,跑在 DeepSeek 自研的 Cordis 框架之上。
热度相当夸张:据 GitHub Trending 数据,项目创建后不足一个月,stars 就突破了 21 万(213,907)。这个量级基本说明整个开发者圈子都在围观它。
上手方式也很直白:
npx @deepseek-ai/dsh web
一条命令,本地起一个 Web UI。不过要注意,它目前是开发者预览版,官方明确说了会有破坏性变更——这句话不是客套,是真的会改。
核心功能
1. 通用 Agent 运行时 这是它的本体。它不是某个具体任务的工具,而是一个可以承载智能体任务的运行底座——你给它任务,它负责调度模型、调用工具、维护上下文。实际使用中,这类运行时决定了 agent 干活的上限,比模型本身更能拉开体验差距。
2. everything-is-a-plugin 架构 整套系统里几乎所有东西都是插件,功能以插件形式组装,而不是硬编码在核心里。这个设计的好处很直接:想加能力就写插件,想砍功能就卸插件,核心保持干净。对喜欢自己动手的人来说可玩性很高;反过来,想开箱即用的人会觉得"怎么什么都得配"。
3. 跑在自研 Cordis 框架上 Cordis 是 DeepSeek 自己的框架,DeepSeek Harness 构建在它之上。好处是官方能把整条链路捏在自己手里做优化;代价是目前这个框架的第三方资料和生态还处在很早期,遇到问题基本只能啃官方文档和源码。
4. 一条命令启动本地 Web UI
npx @deepseek-ai/dsh web 就完事,不用 clone 仓库、不用配一堆环境变量。对于习惯命令行工作流的人来说,这个门槛算是压得很低了。但前提是你本地得有 Node.js 环境——它不是纯云端服务,浏览器打开就能用的那种。
5. 开源可自托管,正面对标 Claude Code / OpenCode 代码在 GitHub 上公开,可以自己部署。这意味着你对自己的数据流向、运行环境有更多控制权。同时它的定位很清楚:就是冲着 Claude Code、OpenCode 这个赛道来的。对开发者来说是好事——同类工具多一个,横向对比和选型的空间就大一分。
版本/套餐对比
目前官方只提供了一个版本,没有分档套餐这一说,也没有公布收费信息。
| 项目 | 当前情况 |
|---|---|
| 发布状态 | 开发者预览版(官方明确会有破坏性变更) |
| 获取方式 | 开源,GitHub 仓库获取 |
| 使用成本 | 官方未公布收费信息,项目以开源形式发布 |
| 安装方式 | 本地 Node.js 环境 + npx @deepseek-ai/dsh web |
| 运行形态 | 本地 Web UI,可自托管 |
| 稳定性承诺 | 无,预览期不保证兼容性 |
简单说:现在没有"买哪个版本"的问题,只有"要不要玩预览版"的问题。
值不值得用?
优点:
- 出身可信。官方开源,还是首个头部模型厂商交付的 agent harness,不用担心来路不明。
- 插件化架构灵活,扩展方向基本不受限,适合有自己想法的人。
- 一条命令起 UI,上手动作极少。
- 热度极高,21 万 stars 意味着社区关注度和后续迭代速度都有保障。
- 和 Claude Code、OpenCode 同赛道,方便你放在一起对比选型。
缺点:
- 开发者预览版,官方明说有破坏性变更——拿它扛生产任务是不现实的。
- Cordis 是自研框架,插件生态和第三方资料都很早期,踩坑只能自己爬。
- 需要本地 Node.js 环境和 npx 启动,不是纯云端开箱即用。
结论: 如果你想研究 agent harness 到底该怎么设计,或者本来就活跃在 Claude Code / OpenCode 这类工具里、想多一个对比项,那 DeepSeek Harness 现在就很值得花一个下午去跑一跑。但如果你要的是能稳定交付、明天就要上生产的东西,现在还不是时候——等它走出预览版再说。
使用建议
- 别在生产仓库里试。 建个单独的目录或者 playground 项目,预览版工具的破坏性变更不只是代码层面,还包括它可能对你的文件做的操作。
- 锁版本。 预览期上游更新频繁且不兼容,装的时候把版本固定住,别用 latest 一路飘。
- 关注 changelog 和 issue。 这种阶段的工具,官方 release note 比任何教程都有用。
- 从最小插件集开始。 它的 everything-is-a-plugin 很容易让人一上来装一堆插件,结果出问题时分不清是谁的锅。先跑通核心,再逐个加。
- 做横向对比时用同一批任务。 想判断它和 Claude Code、OpenCode 谁更合适,别凭感觉,拿你真实工作里常做的几件事分别跑一遍。
- 注意凭证和权限。 一个能读写文件、执行命令的 agent,给它什么权限是你的责任,尤其是自托管场景。
- 把它当"研究项目"而不是"生产力工具"来预期。 心态对了,收获会大很多。
适合谁用?
推荐:
- 想搞清楚 agent harness 架构设计的开发者,尤其是对插件化系统感兴趣的
- 已经在用 Claude Code 或 OpenCode、想找个替代方案做横向对比的人
- 需要自托管、对代码和数据流向有掌控要求的团队
- 习惯折腾早期项目、能接受破坏性变更的早期采用者
可考虑:
- 想试试 agent 编程但还没入门的开发者——门槛不算高,但预览期的坑可能会劝退你
- 有 Node.js 环境、动手能力不错的产品或技术负责人,想评估这类工具的方向
不推荐:
- 要把 agent 能力接进生产系统的团队,预览版 + 破坏性变更的组合风险太高
- 需要长期稳定 API、成熟插件生态和大量中文资料的场景
- 不想碰命令行、期待打开网页就能用的用户——它至少需要你本地有 Node.js 环境
- 指望它现在就能替代成熟商业工具的团队,现阶段它更像是一个方向明确但还在施工中的项目