自己搭 AI Agent 总被框架限制？这个开源项目把能力全拆成了插件

想自己搭一个 AI Agent，真正动手之后会发现，难的往往不是调模型接口，而是工具、执行流程、扩展能力这些东西怎么组织起来。

框架太轻，什么都要自己补；框架太重，又容易变成一个改不动的黑盒。你想换个工具调用方式，得翻进去改核心代码。

如果你也卡在这一步，可以看看 DeepSeek 开源的 DeepSeek Harness。

01 它想解决的是什么问题

大部分 Agent 框架都有一个"核心"。

核心负责调度，插件负责补充。听起来没问题，但真用起来，边界往往很模糊：有些能力必须写进核心，有些扩展只能挂在边缘，想动一下就牵一发动全身。

DeepSeek Harness 换了个思路：Everything is a Plugin。所有能力都做成插件，核心只负责把它们组合起来。

这个思路背后的支撑是一个叫 Cordis 的框架，官方给它的定位是"时空可组合性"的编程范式。听不懂没关系，落到实际使用上就是一句话：能力可以随时插拔，而不是焊死在框架里。

02 它到底是什么

DeepSeek Harness，简称 dsh，是 DeepSeek AI 开源的 Agent harness（可以理解成 Agent 的运行底座）。

• 主语言是 TypeScript
• 底层基于 Cordis 构建
• 提供 Web UI 界面
• 完全开源，截至文章整理时 GitHub Star 在 20 万量级

它不是一个"开箱即用的 AI 助手"，更像是一套给开发者用的 Agent 骨架。

03 最值得关注的地方

第一，插件化的架构设计。 这是它最大的特点，也是最值得研究的部分。能力全部以插件形式存在，意味着你可以按需组合，而不是接受框架作者预设的那一套。对想自己定义 Agent 行为的人来说，这比"功能多"重要得多。

第二，跑起来几乎没有成本。 不需要 clone、不需要装依赖，一条 npx 命令就能起一个本地 Web UI。这点对只想先看看效果的人很友好。

第三，本地运行。 默认起在 127.0.0.1，数据和执行过程都在本机，不用先把东西传到别人的服务器上。

04 怎么跑起来

最简单的路径，先装好 Node.js，然后：

npx @deepseek-ai/dsh web

这条命令会拉取 dsh 并在本地启动 Web UI，默认地址是 http://127.0.0.1:3080，同时自动打开浏览器。

如果你不想让它自动开浏览器：

npx @deepseek-ai/dsh web --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 直接用产物启动，不会重新构建。改代码的时候这个区别挺省时间。

有一个细节需要注意：如果你是 SSH 连到远程机器上启动，它不会自动打开浏览器，只会打印出 host URL，因为端口转发归 SSH 客户端或编辑器管。

05 一个具体的使用场景

假设你想搞清楚"一个 Agent 到底是怎么把工具调用串起来的"。

自己从零写一遍成本太高，直接读别人的框架又容易被各种抽象绕晕。这时候可以把它 clone 到本地，跑起来之后，重点看插件是怎么注册、怎么被核心加载、插件之间怎么通信的。

输入是一套插件结构，中间是核心的调度逻辑，最终你能得到的是一个可以自己改、自己删、自己加能力的 Agent 底座。

比起看文档，直接改一个能跑的东西，理解速度会快很多。

06 避坑

这部分必须说清楚。

它还在 Developer Preview 阶段。 README 里写得很直接：会有破坏性的兼容变更。意思是你今天写的插件，下个版本可能就跑不了了。

运行前建议看一遍 SAFETY.md。 项目专门放了安全说明，说明作者自己也认为这里有需要提前知道的东西。

别拿它直接上生产。 预览阶段的项目，迭代速度快，稳定性不是它的卖点。

Node.js 环境要先准备好。 npx 方式虽然简单，但前提是本地有可用的 Node.js。

07 适合谁，不适合谁

适合：

• 想研究 Agent 架构怎么设计的开发者
• 想自己搭 Agent、又不想从零造轮子的人
• 对插件系统、组合式架构感兴趣的人
• 想本地跑 AI 工具、在意数据在哪的人

不太适合：

• 只想找个开箱即用的 AI 助手
• 不想碰命令行和开发环境
• 项目要求生产级稳定性

08 值不值得试

如果你的目标是学习 Agent 的架构设计，这个项目值得 clone 下来读一读，插件化的思路本身就是个不错的参考。

如果你只是想找一个能马上干活的 AI 工具，那先别急，它现在的定位还不是这个。

我比较关注的一点是：当所有能力都变成插件之后，插件之间的边界和通信成本会怎么控制。这决定了这套架构是真的灵活，还是只是把复杂度换了个地方放。这个问题，得跑起来看代码才有答案。

项目信息

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

如果你最近正在研究 AI Agent 的架构，可以先把它 clone 下来，重点看插件系统那部分。你最近还在折腾哪些 Agent 相关的开源项目？留言告诉我，我后面继续整理。

封面短标题

1. 所有能力都是插件
2. DeepSeek 开源了 Agent 底座
3. 自己搭 Agent 的新思路

摘要

想自己搭 AI Agent，却总被框架的结构限制住？DeepSeek 开源的 Harness 把所有能力拆成插件，一条 npx 命令就能在本地跑起来。这篇文章讲清楚它怎么用、适合谁、有哪些坑。

推荐标签

#AI #开源项目 #GitHub #程序员 #AIAgent #TypeScript #DeepSeek #效率工具

本期项目