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

想自己搭一个 AI Agent，真正动手之后大概率会撞上同一个问题：难的从来不是调用模型 API，而是模型之外那一层——工具有哪些、权限怎么给、执行流程怎么串、上下文怎么管。

框架太轻，什么都要自己补；框架太重，改一个环节要翻十几层代码，最后活生生变成黑盒。

如果你正在这个阶段，今天这个开源项目可以看一下。

01 它想解决的是什么问题

Agent 领域现在有个挺尴尬的现状：能力都在，组织方式很乱。

要接一个搜索、一个代码执行、一个文件读写，很多框架的做法是「内置」——写死在核心代码里。想换一个、删一个，就得动主干，改完还得担心别的地方崩掉。

DeepSeek Harness 的主张只有一句：一切都是插件（Everything is a Plugin）。

模型、工具、界面、执行流程，都被当成可插拔的模块来看待。不需要的不加载，想改的单独替换。

这个思路的好处不是「看起来优雅」，而是当你只想要一个小而确定的 Agent 时，不用背上一整套用不到的东西。

02 它到底是什么

DeepSeek Harness，简称 dsh，是 DeepSeek AI 开源的一个 Agent harness。

「harness」可以理解成跑 Agent 的那套底座或夹具：它不直接给你一个能聊天的成品助手，而是给你一套把模型、插件、执行流程组装起来的框架。

几个关键信息：

• 主语言 TypeScript
• 架构是「一切皆插件」，底层构建在 Cordis 之上，作者团队还专门写了一篇论文讲这套设计
• 插件用 GitHub 的 dsh-plugin 话题聚合，便于被发现
• 目前处于 developer preview 阶段

截至文章整理时，这个仓库的 Star 已经超过 13 万。这个数字只说明关注度高，不代表它已经成熟——这点后面会单独说。

03 最值得关注的三个点

一是插件化的粒度。

它把「模型」「工具」「界面」这些通常被写死在框架里的东西都做成了插件。对开发者的实际意义是：你可以在不动核心的前提下替换其中一个环节。

二是 Cordis 这层底座。

它是独立维护的项目，不是 dsh 内部随手写的一套加载器。设计思路被单独写成了论文，说明这套东西是奔着长期演进去的，不是临时脚手架。

三是插件生态的聚合方式。

用 dsh-plugin 话题标签做插件索引，这个做法很朴素但有效——想找现成插件时，直接搜这个话题就行，不用在文档里翻。

04 实际怎么跑起来

前置条件只有一个：本机装了 Node.js。

最快的启动方式：

npx @deepseek-ai/dsh web

这条命令会拉取并启动 dsh 的 Web UI，默认地址是 http://127.0.0.1:3080。浏览器打开就能看到界面。

如果你想看源码、做二次开发，就从仓库跑：

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

克隆仓库、装依赖、构建、启动，四步。用的是 pnpm，不是 npm，别跑错。

第一次建议先按默认配置把 Web UI 跑通，确认环境没问题，再去研究插件怎么加载。

05 一个具体的使用场景

假设你最近在琢磨「Agent 到底是怎么被组织起来的」这件事。

那可以从这几个地方入手：插件是怎么被注册和加载的、一个插件的生命周期是怎样的、执行流程是在哪一层被串起来的。仓库里有 development guide 和架构文档，配合源码看会比读 README 有效得多。

另一类场景是本地跑一个 Web 版本先熟悉交互。它默认服务在 127.0.0.1，属于本地运行，适合先摸清楚它到底长什么样，再决定要不要往自己的项目里接。

06 上手前必须知道的几件事

它明确说了会有破坏性变更。 README 里原话就写在显眼位置，不是含蓄表达。这意味着你现在基于它写的插件，过几个版本可能要改。

它还在 developer preview。 迭代很快，不适合直接往生产环境上放。想拿它做正式项目，最好先评估清楚版本锁定的成本。

它是底座，不是成品。 如果你期待的是装完就能用的 AI 助手，那它不解决你的问题。它解决的是「我要自己搭，但不想从零搭」的问题。

Cordis 这层需要额外学习。 插件化带来灵活性的同时，也意味着你得理解它的插件模型和依赖组织方式，不是复制粘贴就能上手的。

07 适合谁，不适合谁

比较适合：

• 想研究 Agent 架构、想看清「框架内部怎么组织」的开发者
• 准备自己搭一个 Agent 底座，但不想从零开始写加载和调度的人
• 对插件系统设计本身感兴趣的人
• 习惯本地跑工具、在意数据不出本机的人

不太适合：

• 只想找一个开箱即用的 AI 助手
• 不想折腾 Node.js 环境
• 需要生产级稳定性的项目
• 只想调 API、不想碰框架层的开发者

08 值不值得试

如果你的目标是学习 Agent 架构，这个项目值得花一个下午。插件化和 Cordis 这套设计，是目前比较少见的一种组织思路，即使最后你不用它，看一遍也能拿到东西。

如果你是想找一个能直接支撑线上业务的框架，那现在还不是时候。developer preview 加上明确的破坏性变更提示，意味着它更适合当研究对象，而不是生产依赖。

如果你只是好奇 DeepSeek 在 Agent 这条线上想做什么，那一条 npx 命令就能看到界面，试错成本很低。

我比较关注的是它后面插件生态能不能真的长起来。架构上「一切皆插件」听起来很美，但插件多了之后怎么管、怎么保证质量、怎么避免互相打架，才是真正的考验。

项目信息

项目：DeepSeek Harness（dsh） GitHub：https://github.com/deepseek-ai/deepseek-harness 技术栈：TypeScript 运行环境：Node.js 项目状态：Developer Preview（迭代快，可能存在破坏性变更） 适合人群：想研究 Agent 架构、想自己搭 Agent 底座的开发者

最后

如果你最近正好在折腾 AI Agent，可以把仓库 clone 下来跑一遍，重点看看它的插件加载流程。

你还在研究哪些 Agent 相关的开源项目？留言告诉我，我后面继续整理。

封面短标题（3 个）

1. 一切皆插件的 Agent 底座
2. DeepSeek 开源 Agent 底座
3. 一条命令跑起 Agent 框架

公众号摘要

自己搭 AI Agent，最难的是工具和执行流程怎么组织。这篇整理了 DeepSeek 开源的 dsh：插件化架构、一条 npx 命令就能跑起来，以及上手前必须知道的几个坑。

推荐标签

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

本期项目