自己搭 Agent 总被框架限制？这个开源项目把一切都拆成了插件
想自己搭一个 AI Agent，真正动手之后会发现，难的往往不是调模型。
模型接口调通只要半天，剩下的时间全花在别的地方：工具怎么接、权限怎么管、执行流程怎么串、新能力怎么加进去。
框架太轻，什么都要自己补；框架太重，改一个地方要翻半天源码，最后变成一个不敢动的黑盒。
如果你也在这一步卡过，可以看看今天这个项目。
01 它想解决的问题
DeepSeek 开源的 DeepSeek Harness，简称 dsh，是个 Agent 运行时框架。
它最核心的一句话写在仓库简介里：Everything is a Plugin. 一切皆插件。
这句话听着像口号，但放在 Agent 框架这个场景里，指向的是一个很具体的问题：现有框架大多把「工具调用」「权限控制」「上下文管理」「执行流程」写死在核心里，你想换掉其中一块，就得动主干代码。
dsh 的思路是，这些统统做成插件。核心只负责把插件跑起来、让它们能互相找到、能组合。
换句话说，你不需要在框架上「开洞」，而是直接在它上面拼。
02 它到底是什么
项目由 DeepSeek AI 开源，主语言是 TypeScript。
底层基于一个叫 Cordis 的框架，仓库里还提到一篇讲「时空可组合性」编程范式的论文，这个方向做得比较学术，但落到使用上就是一句话：模块之间可以更灵活地组装和拆分。
目前项目处于 Developer Preview 阶段，迭代很快，仓库里明确写了会有破坏性变更（COMPATIBILITY-BREAKING CHANGES）。
Star 数截至文章整理时在 19 万以上，接近 20 万这个量级。这个数字只能说明关注度高，不代表它已经适合所有人。
03 几个值得关注的点
一是插件化的边界拉得很开。 不是只有「工具」能做成插件，而是整个 Agent 的能力构成都可以拆。对想改架构的人来说，这一点价值最大。
二是 TypeScript + Web UI。 启动之后自带一个 Web 界面，不用自己先写个前端才能看到效果。对习惯 JS/TS 生态的开发者，上手成本低不少。
三是仓库带中文 README。 文档有中文版，对国内开发者省了一步翻译的功夫。
四是和 Cordis 生态的关系。 如果你之前接触过 Cordis，会更容易理解它的组织方式；没接触过也问题不大，从插件目录开始看反而更直观。
04 怎么跑起来
最简单的运行方式，一行命令：
npx @deepseek-ai/dsh web
这条命令会拉取并启动 dsh 的 Web UI，默认地址是 http://127.0.0.1:3080。
本地启动时它会自动打开浏览器；如果你是在 SSH 环境里跑，它只打印访问地址，因为端口转发由你的 SSH 客户端或编辑器负责。
不想自动开浏览器，加一个参数：
npx @deepseek-ai/dsh web --no-open
前置条件只有一个：机器上装了 Node.js。
如果你想从源码跑：
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web
pnpm run build 负责准备好构建产物，pnpm dsh web 直接使用这些产物启动，不会重新构建。
05 一个具体的使用场景
假设你想研究「一个 Agent 的运行流程到底是怎么被组织的」。
你可以先把 dsh 跑起来，在 Web UI 里发一条指令，然后回头看它是怎么把这条指令分发给不同插件的：哪个环节负责理解意图，哪个环节决定调用什么工具，权限在哪一层被拦住。
对想自己写 Agent 的人，这比读一篇架构文章直观得多。
再往下，你可以试着把其中某个环节替换成自己的实现，看看改动是不是真的限制在一个插件里。这是我比较关注的地方——「一切皆插件」到底是架构原则，还是只在部分模块成立。
如果是我研究这个项目，会重点看三处：
- 插件之间怎么注册和发现
- Agent 的执行流程在哪一层被串联
- 工具调用和权限校验是怎么做的
06 跑之前要注意的几点
第一，它是 Developer Preview。不要拿它上生产，接口随时可能变。
第二，仓库里有单独的安全说明文件（SAFETY.md），README 明确要求运行前先读一遍。涉及本地执行和工具调用的项目，这一步别跳过。
第三，从源码构建需要 pnpm，不是 npm。
第四，插件化是双刃剑。核心轻，意味着很多能力要你自己挑插件、自己配。指望它开箱即用，可能会失望。
07 适合谁，不适合谁
适合：
想学习 Agent 架构、想研究插件系统怎么设计、想自己搭一个可改的 Agent 底座的开发者。
平时就在 TypeScript 生态里，愿意折腾配置。
不太适合：
只想找个现成 AI 助手直接用的人。
需要生产级稳定性的项目。
不想碰命令行和构建流程的人。
08 值不值得试
如果你的目标是理解 Agent 框架该怎么组织，dsh 值得花一个晚上跑起来看看，重点研究它的插件设计思路。
如果你只是想找个开箱即用的工具，那它现在的成熟度和配置成本，可能都不太合适。
想清楚自己要的是「可改」还是「可用」，答案就清楚了。
最近你还在研究哪些 AI Agent 相关的开源项目？可以留言告诉我，我后面继续整理。
项目信息
- 项目：DeepSeek Harness（dsh）
- GitHub：https://github.com/deepseek-ai/deepseek-harness
- 技术栈：TypeScript，基于 Cordis
- 运行环境：Node.js
- 项目状态：Developer Preview，快速迭代，存在破坏性变更
- 适合人群：想研究 Agent 架构、插件系统的开发者
封面短标题
- 一切皆插件的 Agent 底座
- 一条命令跑起 Agent 运行时
- Agent 框架还能这么拆
摘要
自己搭 Agent，最麻烦的往往是框架太死板。DeepSeek 开源的 dsh 把能力全做成插件，一行命令就能跑起来，这篇文章告诉你怎么用、适合谁、有哪些坑。
推荐标签
#AI #AI Agent #开源项目 #GitHub #程序员 #TypeScript #效率工具 #DeepSeek
本期项目
评论区