10 月 31 日 17:32，deepseek-ai 组织下多了一个仓库 dsh-superagent-prototype。到 11 月 2 日，它 9379 星、952 个 fork，而仓库里只有一个 commit。

它要做的事一句话能说清：接上一个 GitHub 仓库，有人在 issue 或飞书群里提需求，它自己开一张工单、自己建会话和目录干活，干完回到原对话提 PR，只在需要人拍板的时候出声。

这篇不讲它的架构哲学，只讲三件实操的事：它需要什么前置条件、怎么跑起来看、哪几个地方会卡住你。

文中命令来自官方文档；npm 包名与版本我核对过（@deepseek-ai/dsh 0.2.1-rc.5）。

一、它到底是什么：先分清两个仓库

很多人在这里绕。它不是一个独立应用，是跑在 DeepSeek Harness 上的一个 bundle。

仓库	作用	状态
deepseek-ai/deepseek-harness	dsh 本体，agent 工作台，提供会话、工具、沙箱、插件体系	开发者预览，官方明确会有破坏性变更
deepseek-ai/dsh-superagent-prototype	本文主角，装在 dsh 上的主动式 agent	研究原型，1 个 commit

主角仓库的规模数据：

项	值
创建时间	2026-10-31 17:32（UTC+8）
星数 / fork	9379 / 952
commit 数	1
协议	MIT
语言	TypeScript
独立安装包	无，作为 dsh bundle 加载

仓库里 docs/ 有十个编号文档，从 000 的哲学到 008 的开发手册。其中 007-architecture.md 单独有 70KB，把类、接口、文件对应关系全列了一遍。想把它的设计搞清楚，读这十个文档比读代码快得多，因为它们按顺序编写，每篇只依赖前面出现过的概念。

适合谁：一个团队共用一个仓库、每天有 issue 和 PR 要处理、而且这些事大多不需要设计决策的。
不适合谁：个人开发者；手上没有可接的 GitHub 仓库；不能接受开发者预览版不定期破坏兼容。

二、先用零安装的方式看一眼

不用 clone 任何东西。先看你以后要住在哪：

# 需要 Node.js
npx @deepseek-ai/dsh web

默认在本地 3080 端口起一个 Web 工作台，并自动打开浏览器。只想起服务不想被打开浏览器，加 --no-open。

这一步跑的是 dsh 本体，不是 superagent。但建议先跑，原因很实际：superagent 的全部能力都建立在 dsh 的会话（Session）、工作区（Workspace）、工具（Tool）、技能（Skill）这几个概念上。工作台没见过，后面翻文档会一直卡在名词上。

三种入口先说清楚，别一上来就选错：

入口	命令	适合
Web	npx @deepseek-ai/dsh web	想本地看界面，最省事
Desktop	装桌面版	不习惯命令行
Headless	dsh --profile headless "跑一下测试"	一次性任务，跑完退出

三、从源码跑 dsh

需要改它、或者要跟着版本走，就走源码：

# 项目仓库：deepseek-ai/deepseek-harness
git clone <该仓库地址>
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

pnpm run build 负责准备构建产物，pnpm dsh web 直接用这些产物启动、不再重新构建。所以改完代码要重新 build 一次。

再说 superagent 这个仓库本身。它没有独立的启动命令，挂到 dsh 上的方式是给 dsh 加一层 bundle 配置，而这一步官方故意设计成让 agent 陪你做：

# 项目仓库：deepseek-ai/dsh-superagent-prototype
git clone <该仓库地址>
cd dsh-superagent-prototype

然后对着你的编码助手说一句：

Read SETUP.md in this repository and set up dsh-superagent with me.

它会一次问一个短问题，把完整计划给你看一遍，再装和配。仓库里的 SETUP.md 就是它要遵循的流程。

这条路径是有意这样设计的，不是因为文档懒。安装要碰的东西包括：探哪个仓库、给哪些账号开白名单、配 workers 的环境变量和命令 shim、设置状态目录。这些都要按你团队的实际填，写成一份通用文档反而更容易配错。

如果想先验证代码本身的健康度，仓库给了统一的入口：

pnpm check    # 类型检查 + 测试 + 构建，一把跑完

每次 push 和 PR 都会跑同一套。

四、跑起来之后，能用在哪

当设计参考读。 docs/ 那十篇编号文档本身就是一份可用的 agent 工程资料。它按顺序编排，每篇只依赖前面出现过的概念，所以不会一开头就砸一堆名词。只想评方案、不想跑的话，读 000（哲学）和 007（架构）两篇收益最大。

抄它的提示词分层。 评估指令单独放在 prompts/admission.md，团队可编辑的部分用模板占位符组织，保存时做校验、保留默认值、支持预览。这套"提示词当配置管"的做法比把 prompt 硬编码在代码里好维护，可以直接借鉴到别的 agent 项目。

拿一个真实仓库试。 先在窄范围试：白名单只放两三个人，主动接活先设成"只记录不执行"的模式，看它本来会做什么，觉得对了再放开。这是官方在文档里给的推进方式，不是我自己加的保守建议。

五、几个坑，装之前先知道

• 它不是产品。 仓库第一句就是：研究原型，仅供参考，不是 DeepSeek 官方产品。当研究代码看，别当能上生产的软件。
• 可能有 bug，风格也可能不一致。 README 原话是编码风格和工程实践可能不一致，用之前自己审一遍、按自己环境改。
• 设计文章里有些方案没实现。 官方明确说，文章讨论的部分设计属于后续方向，这个原型里没有。所以别拿文章当它的功能清单。
• 依赖的 dsh 自己在开发者预览。 官方大写标注会有破坏兼容性的变更。你接的东西随时可能被上游改坏。
• 只有一个 commit，没有历史可查。 遇到问题没有 issue 讨论、没有 PR 记录、没有历史版本可以回退对比，只能读文档和代码。
• Router 没有 Bash 工具是刻意的。 新手第一反应常是"配置漏了"，其实是设计：它只判断不执行，这样才能保证它不会自己上手把活干了。
• 安装别照文档手敲。 要填的内容和你团队强相关（仓库、白名单、worker 环境变量、状态目录），官方设计成让 agent 陪你一步步做，手敲更容易配错。
• 实验数字别当承诺。 那组 12.4 分钟对 20.4 分钟的数据，负载是合成的、编程由只消耗时间的工具顶替、每档只跑五遍，团队自己标了初步实验。它测的是调度，不是写代码水平。

六、小结：按你的目的挑路径

你的目的	怎么做
只想看看它长什么样	npx @deepseek-ai/dsh web，十分钟能看完
评方案、做技术选型	读 docs/ 十篇，重点 000 和 007
想在自己团队搭一套	接一个真实仓库，先窄白名单 + 主动活只记录，跑几轮再放开
想学它的提示词设计	看 prompts/ 和 skills/ 两个目录

一句话结论：这是一个用架构保证"少打扰人" 的 agent 原型。它的代码规模不大，但设计文档写得很完整，值得当资料读；真要上生产，得等 dsh 自己先走出开发者预览。