想自己搭个 AI Agent？这个开源项目，一行命令就能跑起来

如果你也在折腾 AI Agent，大概遇到过这种情况：

想让它干点具体的事，结果发现框架是个大黑盒。想改一个环节，牵动全身。最后要么硬着头皮啃源码，要么干脆放弃。

最近我翻到一个项目，思路挺对我胃口，今天拿出来讲讲。

它是什么

DeepSeek Harness，简称 dsh，DeepSeek AI 开源的 agent harness。TypeScript 写的，GitHub 上 star 已经 21 万+。

它的简介只有一句话：

Everything is a Plugin.

这句话是整个项目的设计核心。

我的理解是：它不给你一个"什么都塞好"的大包，而是给你一套骨架，能力全靠插件往上装。你需要什么，装什么。

底层用的是 Cordis，一个专门做插件化组合的框架。

为什么这件事值得你在意

说人话就是：拆开，才可控。

• 你只需要读本地文件，就只装读文件那个插件；
• 用不到的能力不装，不占资源，也不会在你看不见的地方干别的事；
• 哪个环节不顺手，换掉那一个插件就行，不用把整个项目推倒重来。

对开发者来说，这比"开箱即用但改不动"舒服太多。尤其是 agent 这类东西，权限边界本身就是个敏感问题，能看清楚每一块在做什么，心里才踏实。

怎么跑起来

我按 README 给你捋一遍，两种方式。

方式一：npm 直接跑（最快）

前提是装好 Node.js，然后一行命令：

npx @deepseek-ai/dsh web

它会起一个 Web UI，默认地址 http://127.0.0.1:3080。本地跑的话，会自动帮你在浏览器里打开。

有两个小细节挺实在：

• 如果你是通过 SSH 连的服务器，它只会把地址打印出来，不会去尝试打开浏览器——因为本地转发地址是你 SSH 客户端或者编辑器管的，它管不着。
• 不想自动开浏览器，加个 --no-open 就行：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 直接用这些产物，不会重复构建。

上手前，先说三个坑

一，它是 developer preview。

README 里用全大写强调了一句话：会有破坏性变更。意思就是，今天能跑，明天可能因为一次更新就报错。别拿它上生产环境，当玩具、当学习样本都可以。

二，跑之前先看 SAFETY.md。

项目里专门放了一份安全说明。agent 类工具涉及执行权限，这一步跳过，后面出问题只能怪自己。

三，文档站记一下。

https://deepseek-harness.github.io/deepseek-harness/

它迭代快的时候，README 不一定是最新的，以文档站为准。

它适合谁

• 想找一个能自己拆、自己拼的 agent 底座的开发者；
• 想研究插件化架构怎么落到真实项目里的人；
• 需要一个本地跑的 agent 界面，不想把数据往云端送的场景。

反过来说一句实话：如果你只想要一个"开箱就能用、最好别让我配置"的成品，现阶段它未必适合你。developer preview 就意味着你得接受折腾。

我把这一点说在前面，免得你装完回来骂我。

项目地址： https://github.com/deepseek-ai/deepseek-harness

我会继续盯着它的迭代，等稳定一些再回来写一篇实际使用体验。

你要是已经跑起来了，评论区说说打算拿它做什么，或者踩到了什么坑——我先替你记着。

觉得有用，点个关注。「日常轻工具」，每周更新一个能直接上手的东西。

本期项目