自己搭 AI Agent 总被框架卡住？这个开源项目换了个思路
想自己搭一个 AI Agent，真正动手之后会发现，麻烦的往往不是调模型接口。
工具怎么注册、权限怎么校验、上下文怎么传、插件之间怎么通信，这些东西如果没有一个现成的结构，最后大概率会堆进同一个文件里。
框架太轻，什么都得自己补；框架太重，改一处牵动全身，慢慢就变成一个不敢动的黑盒。
如果你也卡在这一步，可以看看 DeepSeek 开源的 deepseek-harness，它给出的答案是：把一切都拆成插件。
01 它想解决的问题
Agent 项目写到一定规模，代码通常会变成这样：
模型调用、工具定义、权限判断、执行流程，全耦合在一起。想换掉某个工具的实现，得动核心代码；想加一个能力，得改主流程；想把这个能力摘掉，又不知道会牵连到谁。
deepseek-harness 的思路是反过来：核心只负责组装，其余全部做成插件。
02 它到底是什么
项目全称 DeepSeek Harness，命令叫 dsh，是 DeepSeek AI 开源的一个 agent harness。
TypeScript 编写，底层基于 Cordis 这个插件框架，设计思路写在论文《A Programming Paradigm for Spatiotemporal Composability》里。项目的 Slogan 很直白：Everything is a Plugin。
目前处于 developer preview 阶段，迭代速度很快，README 里明确标注了会有兼容性破坏的变更。
03 几个值得关注的点
插件化架构。工具、能力、执行流程都不在核心里，而是以插件形式挂载。对需要长期往上叠功能的人来说，这个结构决定了你是在"改框架"还是在"加插件"。
一行命令起 Web UI。npx 直接跑，不需要先克隆仓库。
基于 Cordis。Cordis 本身要解决的是插件的时空可组合性，说白了就是插件的加载、卸载、依赖顺序这类问题。这套机制怎么落到 Agent 上，是它比较特别的地方。
社区入口已经铺开。GitHub Discussions、Discord 频道，以及给插件仓库用的 dsh-plugin topic 都已经就位。
04 实际怎么跑
前置只有一个：装好 Node.js。
npx @deepseek-ai/dsh web
这条命令会启动 Web UI，默认地址是 http://127.0.0.1:3080。本地启动时会自动打开默认浏览器。
如果你是在 SSH 里跑，它只会打印出 host URL，不会尝试打开浏览器，因为本地转发地址归 SSH 客户端或编辑器管。
不想让它自动开浏览器，加 --no-open。
想从源码跑：
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 起一个本地实例，然后顺着插件加载的顺序往外看：哪些是核心，哪些是插件，一个工具是怎么被注册进去的，任务在执行过程中又经过了哪些环节。
另一个场景是研究插件框架本身。把 Cordis 的论文和它的实现对照着看，比单纯读代码更容易理解设计意图。
06 使用前要注意
第一，它是 developer preview。会有破坏性变更，这一点项目自己写得很清楚，不要拿它做生产环境。
第二，源码方式依赖 pnpm，环境要先准备好。
第三，插件生态还在早期。别指望装完就有一堆现成插件可用，它现在更像是给愿意自己写插件的人准备的底座。
第四，文档和架构说明在仓库的 docs/ 目录下，动手前先过一遍 development 和 architecture 两份文档，会省不少时间。
07 适合谁，不适合谁
适合：想自己搭 Agent 的开发者、想研究插件系统设计的人、想学习 Agent 执行流程怎么组织的程序员。
不太适合：只想找一个开箱即用 AI 助手的人、不想折腾开发环境的人、需要生产级稳定性的项目。
08 值不值得试
如果你的目标是学习 Agent 架构，或者你正在自己搭一套需要长期维护的 Agent，那它的插件设计值得花时间研究。
如果你只是想找个能直接聊天的工具，那现阶段它的成熟度和配置成本，可能都不是你要的。
我会重点看什么
如果是我研究这个项目，会重点看三个地方：
一是插件怎么注册和加载，边界在哪里； 二是 Agent 的执行流程怎么组织，状态存在哪； 三是工具调用和权限相关的部分怎么控制。
这三点基本决定了这套架构能不能撑住后续的扩展。
项目信息
- 项目：DeepSeek Harness（dsh）
- GitHub：github.com/deepseek-ai/deepseek-harness
- 技术栈：TypeScript
- 运行环境：Node.js
- 项目状态：Developer preview，可能有破坏性变更
- 适合人群：想搭 Agent 的开发者、想研究插件系统的程序员
截至文章整理时，项目的 Star 数在 16 万量级。Star 只是个参考，不代表它适合所有人。
如果你最近正在研究 AI Agent 的架构，可以先把这个仓库 clone 下来跑一遍。你还在关注哪些 Agent 相关的开源项目？留言告诉我，我后面继续整理。
适合做封面的短标题
- Agent 的一切都是插件
- 把 Agent 拆成插件
- 开源 Agent 底座能跑了
摘要
自己搭 AI Agent，最麻烦的往往不是调模型，而是工具和流程怎么组织。这篇介绍 DeepSeek 开源的 dsh：一行命令跑起来，看看它的插件化思路适不适合你。
推荐标签
#AI #开源项目 #GitHub #程序员 #AIAgent #TypeScript #效率工具 #DeepSeek
本期项目
评论区