教程 01 · 认识 dsh
dsh 是什么:和 Claude Code 这类工具的区别
DeepSeek Harness(dsh)是什么:DeepSeek 开源的智能体框架,MIT 协议、基于 Cordis、一切皆插件、当前为开发者预览。讲清它和 Claude Code 这类工具的区别、装完为什么只是一个地基,以及插件在其中的位置。文中命令均可在官方仓库核对,数据更新于 2026-11-20。
一句话回答
DeepSeek Harness(命令行里叫 dsh)是 DeepSeek 开源的 agent harness,官方 README 把它描述为「open-source agent harness」,建立在 everything-is-a-plugin(一切皆插件)的架构上,底层用 Cordis 依赖注入框架,MIT 协议,当前是 developer preview。官方明确提醒:会有破坏兼容性的变化。
它和 Claude Code 这类工具差在哪里
Claude Code、Codex 这类工具通常把「模型 + 工具 + 界面」打包成一个相对完整的产品;你能用的能力由产品决定。dsh 换了个思路:先给你一个能跑的最小框架,模型接入、工具、沙箱、会话存储、界面都可以用插件替换或扩展。
直接后果是:你装完 dsh 得到的不是一个完整产品,而是一个地基。 它能不能干活,取决于你在上面装了什么、模型怎么配、权限怎么给。
技术上它是什么
- 开源仓库:
deepseek-ai/deepseek-harness,MIT 协议。 - 架构:everything-is-a-plugin,基于 Cordis。
- 运行方式:
npx @deepseek-ai/dsh web启动 Web UI,默认127.0.0.1:3080;也可以从源码用 pnpm 构建运行。 - 插件:包在
package.json里声明dsh.bundle,通过 npm 或 Git 分发;发现靠 GitHub 的dsh-plugin话题和社区目录。 - 状态:developer preview,接口和行为可能变。
为什么「预览」两个字要当真
官方 README 用大写提醒会有 breaking changes,SAFETY.md 还写明项目没有经过安全审计、沙箱和权限控制不保证隔离。这意味着两件事:第一,不要把关键生产流程完全押在某个插件上;第二,升级宿主前先看插件的兼容说明,留好回滚方案。
适合先用它做什么
从本地、可验证的任务开始:读一个项目、改一小块代码、跑测试、把报错归类。这些任务出错了你一眼能看出来。不建议一上手就接一堆外部服务、桌面控制或远程访问,那些涉及凭据和权限,等你熟悉 profile、插件和备份之后再碰。
接下来读什么
先把它跑起来:读安装与第一次启动。然后理解插件是怎么被发现的:dsh.bundle 与 dsh plugin add。最后按「你要换掉哪一块」去看八类分类,不要从 star 榜开始乱装。
相关插件
- dsh-market 怎么安装使用:DSH 内的插件市场,用来浏览、安装和更新插件。
- dsh-purge 怎么安装使用:社区维护的宿主策略补丁,装之前先看边界。
常见问题
dsh 是 DeepSeek 官方做的吗?
是。官方仓库是 github.com/deepseek-ai/deepseek-harness,README 写明由 DeepSeek AI 开发,MIT 协议。本站是第三方目录,不是官方站。
dsh 和 Claude Code 能一起用吗?
它们是不同的 agent harness,各自有插件和配置体系。有些插件可以把一方的模型或 CLI 接到另一方,但那属于插件行为,装之前看 README 的权限和数据流向。
现在适合把 dsh 用在生产环境吗?
官方把它标为 developer preview,并明确说会有破坏兼容性的变化、没有经过安全审计。生产环境要自己承担风险,至少用最小权限、隔离环境和备份。