自己搭 AI Agent 总被框架限制？DeepSeek 开源了一个全插件化的底座

真正动手搭一个 Agent，容易卡住人的往往不是接模型。

工具怎么注册、权限怎么管、上下文怎么拼、多步执行怎么编排、中间结果怎么回传——这些活一旦开始做，会发现每个环节都能单独写一篇长文。

框架太轻，等于没帮你做什么，最后还是自己补；框架太重，改一个地方要读一堆源码，改着改着就变成一个黑盒。

如果你最近正好在这个问题上纠结，可以看看 DeepSeek 开源的 dsh。

01 它解决的是什么问题

一句话说，它想当 Agent 下面那层底座。

现在很多 Agent 项目的问题是，能力都糊在一起：加一个工具要顺手改执行流程，改一个流程又要动配置，最后代码谁也不敢碰。

dsh 的思路是把这些拆开——工具、模型接入、界面、流程控制，各自按插件组织。核心保持薄，能力往外挂。

方向是对的。落地到什么程度，得看代码，但从架构选择上能看出团队想清楚了一些事。

02 它到底是什么

DeepSeek AI 开源的一个 Agent harness，TypeScript 写的，核心设计只有一句：everything is a plugin。

底层跑在 Cordis 上，官方对应一篇讲「时空可组合性」的论文。翻成大白话就是，每个能力都是独立单元，可以单独装、单独卸、单独替换。

截至文章整理时，GitHub 上大约 4 万 Star。项目目前标着 developer preview，这一点后面会专门说。

03 几个值得关注的地方

全部插件化。 你不用改主干代码就能往上加东西，也不用为了一个需求去 fork 整个项目。对想二次开发的人来说，这个边界很重要。

一条命令能跑。 装好 Node.js 之后：

npx @deepseek-ai/dsh web

这条命令会拉取并启动 Web UI，默认地址是 http://127.0.0.1:3080。不用先配一堆环境变量。

自带 Web 界面。 对刚上手的人友好，先看到东西，再回头研究代码，比一上来读架构文档效率高。

插件有公开入口。 官方让插件仓库打上 dsh-plugin topic，找现成插件、参考别人怎么写，都有地方可去。

04 我为什么觉得它值得看

我更在意的不是它现在有多少功能，而是插件化的边界划在哪。

一个 Agent 框架好不好改，往往不取决于功能多少，而取决于「新能力」和「核心流程」之间有没有一道清晰的线。dsh 把这道线交给统一的插件机制，这个设计比堆功能更值得研究。

另一个现实原因是，DeepSeek 的模型很多人已经在用了。官方自己做 harness，意味着模型和框架之间的适配能少一层折腾。

05 动手跑起来

最简单就是上面那条 npx。

如果想读代码或者改代码，走源码方式：

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

pnpm install 装依赖，pnpm run build 构建，pnpm dsh web 启动界面。前置条件是把 Node.js 和 pnpm 装好。

06 拿它具体能干点什么

最直接的一个场景：研究 Agent 的执行链路怎么组织。

Clone 下来，从 Web UI 进去跑一个任务，然后回头看插件之间怎么传消息、工具调用怎么被拦截和记录。这比自己从零设计一套流程快得多。

另一个场景是加自己的东西。比如你有一个内部工具想接进去，按插件规范写一个挂上就行，不用动主干。

07 几个要先知道的事

还在 developer preview。 README 写得很直白，会有破坏性变更。现在拿它当生产项目的地基，时机不对。

它不是一个开箱即用的 AI 助手。 面向的是想搭 Agent 的开发者，不是想找个工具聊天的人。装完就想直接干活，会失望。

迭代快，文档可能滞后。 遇到问题去 GitHub Discussions 搜一下，比硬啃源码强。

08 适合谁，不适合谁

适合：

• 想搞明白 Agent 框架内部怎么运转的开发者
• 准备自己搭 Agent、需要一个可改底座的人
• 对插件化架构感兴趣的工程师

不太适合：

• 只想找个现成 AI 工具用的普通用户
• 近期就要上线、需要稳定版本的项目
• 不想折腾 Node.js 环境的人

09 如果是我，会先看这三处

一个 4 万 Star 的项目，光看 README 看不出什么。如果由我来研究，会按这个顺序：

1. Cordis 那套设计对应的实现，插件怎么被加载和组合
2. 工具调用这一段，权限和边界怎么控制
3. 一次对话从输入到返回，中间经过了哪些插件

这三块看明白，再去看别的 Agent 框架，很多设计就能对上号了。

项目信息

| 项 | 内容 | |---|---| | 项目 | DeepSeek Harness（dsh） | | GitHub | https://github.com/deepseek-ai/deepseek-harness | | 技术栈 | TypeScript，基于 Cordis | | 运行环境 | Node.js、pnpm | | 项目状态 | developer preview，迭代中，可能有破坏性变更 | | 适合人群 | 想研究或自建 Agent 的开发者 |

最后

如果你最近正在琢磨 Agent 到底该怎么搭，建议先 clone 下来跑一遍，比读十篇架构文章直观。

这类偏底座的 AI 开源项目我后面还会继续整理。你最近在关注哪个，可以留言说一声，我看看值不值得写。

封面短标题（3 个）

1. DeepSeek 的 Agent 底座开源了
2. 全插件化的 Agent 框架
3. 一条命令跑起 dsh

摘要

DeepSeek 开源的 Agent 框架，一条命令跑起来，能力全部插件化，适合研究架构和二次开发。

推荐标签

#开源项目 #GitHub #AI Agent #DeepSeek #TypeScript #插件化架构 #程序员 #开发者工具

本期项目