DeepSeek Harness：13 万星的开源智能体框架，一切皆插件

2026 年 8 月，DeepSeek AI 正式开源了它的新一代智能体框架 DeepSeek Harness（dsh），一句 "Everything is a Plugin" 点明了它的核心设计哲学。项目上线短短数日便收获超过 13 万 Star，成为本周 GitHub Trending 上最受瞩目的项目。

什么是 DeepSeek Harness

DeepSeek Harness 是由 DeepSeek AI 官方推出的开源 agent harness（智能体框架），采用 TypeScript 编写，使用 MIT 许可协议，基于 Cordis 插件系统驱动。

它的核心理念非常清晰：整个产品由插件组成，没有特权核心。无论是模型适配器、工具注册表、会话日志，还是智能体循环本身，都是插件。你可以通过挂载插件的方式扩展 dsh，而且插件的注册是可逆的 effect——当插件卸载时，它注册的一切会自动"回卷"清理。

核心功能

技术特色

DeepSeek Harness 最值得称道的是它的架构可组合性。一个正在运行的 dsh 本质上是一棵"插件树"，在启动时由有序的 layer 组合而成：

1. 每个 bundle 按 profile 中声明的顺序应用；

2. 然后是 profile 的 cordis.patch.yml；

3. 再叠加 home 级补丁，最后是 --patch 覆盖。

通过 dsh --profile web --dump-config，你可以看到自己机器实际启动的完整插件树，其中 任意一行都可以用你自己的补丁替换。

在会话层面，它采用追加式日志（append-only SessionEvent log）作为模型可见上下文的唯一来源——deriveMessages() 从日志推导模型历史，保证了"模型可见即已记录"。fork、resume、transcript、telemetry、持久化全部由这条日志流派生。

详细使用步骤

### 通过 npm 运行（最简单）

前置条件：安装 Node.js。

npx @deepseek-ai/dsh web

命令启动后，Web UI 默认运行在 http://127.0.0.1:3080。

启动后，打开 Settings → Models，填入 DeepSeek API Key 并保存（无需重启服务即可生效）。接着点击 Choose workspace，选择你启动 dsh 时所在的项目目录。完成后即可开启会话，让 agent 读取并编辑工作区文件、运行命令、委派任务。

### 从源码运行

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

适用场景

一个提醒

需要注意的是，DeepSeek Harness 目前仍处于 开发者预览 阶段，迭代非常快，官方明确提示"未来将出现破坏兼容性的变更"。用于生产环境前请谨慎评估，但作为学习 agent 框架设计与插件化架构的范本，它无疑极具价值。

—

如果你对如何用 dsh 定制自己的工作流感兴趣，欢迎在评论区交流。也可以直接访问项目仓库（deepseek-ai/deepseek-harness）获取最新文档与社区动态。