DeepSeek Super Agent 入门：像给项目请个 AI 助手

你正在改一个网页。同事突然说：“启动说明里的命令跑不通，能顺便修一下吗？”

你只好停下手里的事，打开文件查原因。要是能把这个小任务交出去，等有结果时再回来检查，就省去了一次切换。

DeepSeek Super Agent 是一套会接单、分派任务的 AI 编程助手系统，能调度多个执行助手处理代码或文档，再把结果交给你检查。 它面向一个 GitHub 项目，也可以接入飞书。GitHub 是存放代码、讨论项目问题的平台。官方介绍

先记住一个前提：官方把它称为“研究原型”，还不是 DeepSeek 正式产品。公开代码与内部版本也有差别。原型说明

它能调度多个 Agent 吗？能，由 Router 分派给 Worker

能。它采用多 Agent 分工：一个 Router 管接单和分派，多个 Worker 分头处理任务。 Agent 就是能接任务、调用工具的 AI 助手。官方角色说明

可以把它想成一个小组：

谁	像什么	负责什么
Router	项目经理	看新请求，决定接单、分派，或把消息交给已有任务
Worker	具体办事的人	接手一张工单，也就是任务记录，在自己的会话和目录里工作
后台调度程序	排班表	管理执行名额；有空位才启动新任务，没空位就排队

这里的“会话”，就是一个助手处理任务时使用的对话和工作记录。多个 Worker 可以同时工作；并发上限由配置控制，后台程序负责执行排队规则。调度实现

简单流程：一个修文档，一个修表单

两个独立请求可以交给两个 Worker，各做各的，再分别交结果。

比如，你同时提出“修启动说明”和“修表单提示”两件事，Router 接单后，可以这样分派：

你提出两个请求
       ↓
Router：接单、分派
       ├─ 工单 A → Worker A：修启动说明 → 交结果 A
       └─ 工单 B → Worker B：修表单提示 → 交结果 B

普通新任务的并发名额设为 2 时，这两件事可以同时推进。名额只有 1 时，就要排队。任务 A 的后续评论，也能沿原有讨论送回对应的 Worker。并发规则、后续消息规则

能做到的分工，以及实际边界

它能管理多项工作的分派与接续；任务怎么拆、代码是否正确，仍要看具体执行结果。

• Worker 还能找帮手。 官方文档明确写到 Worker 使用子 Agent，也就是它在当前任务内再调用的助手。因此既有“Router 分派给 Worker”，也有“Worker 再调用子 Agent”这一层。子 Agent 机制
• 公开版面向一个 GitHub 仓库。 仓库就是一个项目存放代码的地方，调度对象是 DeepSeek Harness 这个运行底座管理的执行会话。项目范围、执行器实现
• 接单和拆活是两件事。 多个任务能分别推进，不代表一句“帮我做完整个网站”就一定会被拆好、做好。官方将公开代码定位为研究原型，设计文章里的部分方案尚未实现。公开版说明

它能帮你做什么

你可以把范围清楚的小任务交给它，再回来检查结果。

比如前面那份启动说明，就适合这样描述：

“请检查 README 里的启动命令，对照项目实际的启动脚本修正文档。”

README 就是项目说明文件。这个任务说清了查什么、依据什么改，比一句“帮我看看项目”容易检查。

修复网页问题，也可以先讲清现象：“表单没填完整，点提交却没有提示。请先确认能否复现，再修这个问题。”

这些是请求的写法。它最终能否完成，还要看问题本身和运行环境。按照项目设计，结果会回到原来的讨论里，也可能附上一个 PR——也就是一份“请你审阅这些改动”的申请。交付方式

适合谁 / 不适合谁

按当前研究原型的定位，它更适合愿意动手配置、也愿意检查结果的开发者。

下面是基于官方安装要求和原型状态给出的使用建议。

适合谁

已有 GitHub 项目、想尝试分派小任务的人，可以从测试项目开始。

例如，你经常处理文档修正或小缺陷，能把需求讲清楚，也能判断改动是否正确。团队还需要有人负责安装、账号和运行维护。安装要求

不适合谁

希望开箱即用、把全部决定都交给 AI 的人，目前先别急着接入重要项目。

如果你只想下载一个聊天软件，或者还无法检查代码修改，准备和审核工作可能会成为负担。官方也提醒，这份研究代码可能仍有问题，需要使用者审阅和调整。官方定位

3 步上手

先连一个测试项目，跑完一件小事，再考虑扩大使用范围。

这三步是一条上手路线。具体依赖和账号设置，仍需跟着官方安装说明完成。

第 1 步：准备项目、账号和模型服务

先决定让它在哪个项目里工作，以及用谁的身份工作。

准备一个测试用的 GitHub 项目，再给 Agent 一个专门的 GitHub 账号。还要准备可用的模型服务，供它思考和生成内容。准备清单

它依赖 DeepSeek Harness，可以把 Harness 理解为“让助手运行起来的底座”。底座和插件需要版本兼容。完整的环境要求放在文末，安装时再对照即可。

第 2 步：取得源码，让编程助手带着安装

从官方安装说明出发，先看计划，再做配置。

如果你会使用终端，可以先把源码下载到本机：

git clone https://github.com/deepseek-ai/dsh-superagent-prototype.git
cd dsh-superagent-prototype

然后，让你正在使用的 AI 编程助手阅读这个目录中的 SETUP.md。这是官方提供的安装入口。安装说明

可以这样说：

请阅读本仓库的 SETUP.md，协助安装 dsh-superagent。
先问清需要的配置，给我看完整计划，再执行。
只连接我指定的测试项目，保持 observe 模式，由我审核和合并。
账号登录和密钥输入，请给我在本机终端完成的步骤。

这里的 observe 是“先观察、先记下可能要接的活”。切到 auto 前先看看它记下了哪些活。

第 3 步：发一个小请求，检查结果

第一次只做一件容易核对的事，比如修正文档命令。

设置完成后，用允许发起任务的账号，在 GitHub 的问题讨论区新建一条问题或发表评论，点名 Agent。可以改写这个模板：

@你的-agent-账号
请检查 README 里的启动命令，对照项目实际的启动脚本修正文档。
只改必要的文字，不改应用代码。
请说明改了哪里、依据是什么；没验证的地方也请说清楚。
由我审核和合并。

结果返回后，打开 PR，看看修改是否符合请求。网页表单问题也可以用相似写法，但要补上操作步骤和预期结果。

查看进度：先确认请求收到，再看是否需要你回答

Harness 网页里的 Superagent 面板，就是这组助手的任务看板。

它把需要人处理的事项放在前面。你可以查看请求是否收到、有没有接单，以及任务正在工作，还是等你回答或审核。面板说明

参考资料

项目能力和安装步骤以官方文档为准，社区讨论用于了解他人的使用经历。

1. 官方仓库与 README：项目范围与研究原型声明。
2. package.json：版本、许可证和兼容要求。
3. 000 Philosophy：协作与沟通原则。
4. 001 Domain model：事件、工单、授权及订阅。
5. 002 Authorization：准入、主动接单模式与后续消息。
6. 003 Execution：工作目录、执行状态和交付。
7. 004 Prompts：团队提示词与技能配置。
8. 005 Panel：面板入口与记录查询。
9. SETUP.md：安装入口与问题清单。
10. 006 Deployment：配置、启动与运行前提。
11. Profile 示例：面板监听地址与状态目录。
12. 社区讨论 #11700：服务识别与通知处理报告。
13. 社区讨论 #11706：端到端使用经历及配置问题。
14. 社区讨论 #11970：延迟通知的复现时间线。
15. 007 Architecture：执行器、并发名额与会话调度。
16. GeekCoding101：从 Issue 到 PR 的操作记录：分派、追加需求与工单恢复。
17. Turquoise UFO 部署记录：改造部署、权限问题和自建聊天入口。
18. 社区讨论 #11818：团队对部署记录的分享。