想自己搭 AI Agent？这个开源项目把底座准备好了
想自己搭一个 AI Agent，真正动手之后才会发现，难的往往不是调模型 API。
工具怎么接、权限怎么控、执行流程怎么组织、插件之间怎么通信——这些事框架不帮你处理好，最后全得自己补。
补到最后，项目变成一坨只有自己能看懂的代码。
如果你正在这个阶段，可以看看 DeepSeek 开源的这套 Agent 底座。
01 它解决的是什么问题
现在做 AI Agent 的团队和个人，基本绕不开一个矛盾：
用现成框架，灵活度受限，想改底层逻辑很费劲；完全从零写，工程量不小，而且容易在架构上走弯路。
DeepSeek Harness 想做的事，是把 Agent 的底座先搭好。
它的核心理念只有一句话：Everything is a Plugin.
模型、工具、权限、UI——所有能力都以插件形式存在。你需要什么就装什么，不需要的可以不加。
02 项目基本情况
这是 DeepSeek AI 开源的一个 Agent harness，项目代号 dsh。
底层基于 Cordis 框架构建，Cordis 的设计思路来自一篇关于“时空可组合性编程范式”的论文。主语言是 TypeScript。
通俗点说：它不是一个给你直接用的 AI 助手，而是一套让你自己组装 Agent 的底层架构。
截至文章整理时，GitHub Star 约 18 万（素材来源有两个数字，仅供参考）。项目目前处于 developer preview 阶段，官方明确写了会有破坏性变更。
03 值得关注的几个设计
插件化架构
所有能力都是插件。想加一个工具？写插件。想换一套权限逻辑？替换插件。这种设计的好处是，Agent 的每个环节都可以单独替换和测试，不用动整体结构。
基于 Cordis 的底层
Cordis 本身是一个强调组合能力的框架。放在 Agent 场景里，它管的是插件生命周期、依赖关系和通信机制。如果你对“怎么把一堆松散能力组装成一个可运行的 Agent”这件事感兴趣，这部分值得研究。
一键启动 Web UI
不需要复杂配置。装了 Node.js 之后，一条命令就能跑起来。
开源
代码在 GitHub 上，可以自己读、自己改。
04 怎么跑起来
前置条件：安装 Node.js。
然后直接执行：
npx @deepseek-ai/dsh web
这条命令会下载并启动 dsh，默认在本机 http://127.0.0.1:3080 打开 Web UI。
如果你不想自动打开浏览器：
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 直接使用构建好的产物启动，不需要重复构建。
说实话，这个上手门槛已经很低了。
05 几个使用场景
场景一：自己搭一个 Agent
你可以在 dsh 之上写自己的插件，接入想要的模型和工具，组装出一个符合自己需求的 Agent。不用从零处理插件加载、生命周期管理这些底层逻辑。
场景二：研究 Agent 架构
如果你对“Agent 框架应该怎么设计”这个问题感兴趣，这个项目的插件系统、执行流程、权限控制都是可以读代码学习的。特别是 Cordis 在里面的角色，值得花时间看。
场景三：本地运行
Web UI 跑在本地，数据不出机器。适合对隐私有要求、或者想在内网环境跑 Agent 的场景。
06 避坑提醒
这部分很重要。
项目处于 developer preview 阶段。 官方 README 里明确写了：“THERE WILL BE COMPATIBILITY-BREAKING CHANGES.” 意思是后续版本可能出现不兼容的改动。如果你现在拿它做生产环境的东西，要有心理准备。
生态还在早期。 插件机制虽然灵活，但目前可用的现成插件应该不会太多，很多能力可能需要自己写。
文档还在完善中。 目前有 Web UI guide，但整体文档丰富度还在建设中。
07 适合谁 / 不适合谁
适合：
- 想研究 Agent 底层架构的开发者
- 需要高度定制 Agent 能力的人
- 对插件化系统感兴趣的程序员
- 想本地跑 Agent、关注数据隐私的人
不太适合：
- 想找一个开箱即用的 AI 助手的人
- 不想折腾开发环境的人
- 需要生产级稳定性的项目
08 我会重点看什么
如果是我研究这个项目，我会优先看三个地方：
- 插件系统怎么设计——插件的注册、加载、依赖管理是怎么做的
- Agent 的执行流程怎么组织——从输入到输出，中间经过哪些环节
- 权限和工具调用怎么控制——Agent 要用工具的时候，权限校验在哪一层做
这三个问题想清楚了，自己搭 Agent 的时候会少走很多弯路。
项目信息
- 项目： DeepSeek Harness（dsh）
- GitHub： https://github.com/deepseek-ai/deepseek-harness
- 技术栈： TypeScript
- 运行环境： Node.js
- 项目状态： Developer Preview
- 适合人群： 想研究或定制 AI Agent 的开发者
如果你最近正在研究 AI Agent 的架构设计，可以把这个项目 Clone 下来看看。哪怕不直接用，它插件化的思路也值得参考。
你最近还在关注哪些 AI 开源项目？欢迎留言告诉我。
适合做封面的短标题：
- 自己搭 Agent 的底座来了
- 一切皆插件的 Agent 框架
- 一条命令跑起来的 Agent
摘要：
想自己搭 AI Agent 但不想从零造轮子？DeepSeek 开源的 dsh 用插件化架构把底座准备好了。一条 npx 命令就能跑，本文告诉你它能解决什么问题、怎么上手、有哪些坑。
推荐标签：
#AI #开源项目 #GitHub #AI Agent #DeepSeek #程序员 #效率工具 #TypeScript
本期项目
评论区