DeepSeek Harness 团队把内部用的「更自主一点的编码 Agent」拆了一份公开原型：dsh-superagent（仓库名 dsh-superagent-prototype）。它挂在 DeepSeek Harness 上，面向一个 GitHub 仓库：听 GitHub（可选飞书），有人按规则叫它干活时开工单，在独立 Session / 目录里做，再回到原对话——例如回帖或开 PR；网页面板标出需要人看的事。
官方写得很清楚：仅供参考的研究原型，不是正式产品；代码风格与工程质量可能不一致，发布版也不等于内部实现或文章《Exploring Super-agent Design: Towards a More Autonomous Agent System》里的全部设计。协议 MIT。仓库 deepseek-ai/dsh-superagent-prototype。资料查阅于 2026-11-03（查阅时约 1.31 万★）。
基本信息
| 项目 | 情况 |
|---|---|
| 类型 | 挂在 DeepSeek Harness 上的编码 Super-agent 研究原型（单仓库） |
| 版本 | 包名 dsh-superagent 0.1.0；需 DSH 满足 engines.dsh（查阅时示例安装钉 @deepseek-ai/[email protected]） |
| 许可 | MIT |
| 星数 | 查阅时约 13.1k |
| 运行时 | Node.js 22.19+ / 24+、pnpm、git 2.32+、tmux、Python 3.8+、GitHub CLI 2.48+；可选飞书 lark-cli |
| 入口 | Source：GitHub（必选向）；可选飞书聊天 |
| 形态 | 独立 DSH profile（文档称 superagent）+ 管理面板；Router / Worker 两套 Session 预设 |
| 仓库 | github.com/deepseek-ai/dsh-superagent-prototype |
它在解决什么
README 里的工作方式一句话：尽量少占人的注意力，尽量多交付结果。能替一整队行动的 Agent，也能浪费一整队的注意力——所以默认只在被点名、或团队写好的规则允许时动手；需要人拍板或结果可用时再说话。哲学见仓库 docs/000-philosophy.md。
和「你自己开 Claude Code / Codex，盯着终端聊一轮」不同：它更像仓库级值班员——请求从 Issue / 评论 /（可选）飞书进来，主 Session（Router）评估是否接单，Worker 在隔离会话里执行，结果写回原渠道。
架构怎么理解（不抠类名）
文档把领域流画成：
Source → Trigger → Thread → Eval →（接单则）Ticket + Mandate → Assignment → Executor → 经 Channel 回写 Source
粗分四块就够日常阅读：
-
Source（来源）
现成实现是 GitHub（通知、订阅的 Issue/PR、CI 变化等）和可选 飞书。把外部事件翻成不可变的 Trigger，挂到 Thread 上。 -
Eval（评估）
主 Session 做两层：先 Gate（准入）——谁可以发起、强度是明确请求还是推断候选；再按策略做研判，产出 Decision（接单 / 停止 / 忽略 / 未完成）。接单会生成带 Mandate（授权） 的 Ticket（工单）。 -
Executor（执行器）
每个 Ticket 对应独立的 Executor Session 与工作目录（DshExecutor）；可并行多个 Worker（受maxWorkers等限制）。进度、阻塞、提问以结构化 Report 回来；人要决策的会进面板「待人工」。 -
Policy + Panel
允许名单、机器人列表、admission 表、accept mode（默认文档建议从observe看「本会接单但不真接」开始）都进策略版本；管理面板看工单、来源健康度、设置与提示词。
实现上还有 Engine、SQLite Store、Effects 队列等，细节见 docs/007-architecture.md。对使用者更重要的是：授权边界在宿主策略里，不在聊天正文里——评论/引用改不了谁有权开单。
怎么装（官方路径）
官方故意把安装做成「让你现有的 coding agent 带你配」：克隆仓库后，对它说：
Read SETUP.md in this repository and set up dsh-superagent with me.
SETUP.md 要求代理一次只问一个短问题、收集完再给完整计划，确认后才执行；密钥不在聊天里要，需要你本机终端登录的步骤单独列出。
文档里的手工主路径（有改动以仓库当时 docs/006-deployment.md 为准）大致是：
- 准备依赖：Node / pnpm / git / tmux / Python /
gh；配置好 DSH 的模型提供方。 - 单独建一个 agent 用的 GitHub 账号（不要用你本人日常账号当 agent 身份），用独立
GH_CONFIG_DIR的gh包装登录；可选配置飞书机器人与lark-cli。 - 安装示例（部署文档给出的钉版本）：
npm install -g @deepseek-ai/[email protected]
git clone https://github.com/deepseek-ai/dsh-superagent-prototype.git dsh-superagent && cd dsh-superagent
pnpm install && pnpm build
dsh superagent --from-default-profile web --dump-config > /dev/null
dsh plugin --profile superagent add "link:$PWD"
- 按示例写好
cordis.patch.yml（stateDir、端口等），再：
scripts/dsh-superagent start
scripts/dsh-superagent status
面板侧栏进 Superagent。策略里先填「谁可以叫它干活」；允许名单为空时，请求变不成 Ticket。试跑：用名单内账号在仓库 Issue 评论里 @agent账号，约一分钟内 Overview 应出现工单。
升级前备份 stateDir 下的 orchestrator.sqlite；较新 schema 迁过的库不能被更老版本打开。
和 Claude Code / Codex 怎么摆
| 维度 | Claude Code / Codex（日常用法） | dsh-superagent |
|---|---|---|
| 典型场景 | 人对着终端 / IDE，当场改代码、跑命令 | 仓库值班：Issue/评论/飞书进来 → 评估 → 隔离干活 → 回帖/PR |
| 产品形态 | 厂商 CLI / 订阅产品 | DSH 插件式研究原型（MIT），依赖你自备模型与 Harness |
| 多任务 | 你开多个会话自己管 | Router 分派，多 Worker 并行，面板汇总待人工 |
| 授权模型 | 主要靠你盯着会话与权限提示 | Policy：允许名单、admission、accept mode、Mandate；聊天改不了权限 |
| 成熟度 | 面向日常编码的成品体验 | 官方标明研究原型，非生产就绪 |
一句话：Claude Code / Codex 是「你带着干」；dsh-superagent 是「仓库里挂一个可审计的值班编排」。本机还要给 Claude Code / Codex 换模型、看额度，可以继续用站内的 Magpie 和 QuotaPanel；更大的周边地图见 AI 编程 Agent 生态全景。若只想要「选文件夹 + 大白话」的桌面壳、同样站在 DSH 上，可对照 PawWork。
安全与边界（务必先读）
- 研究原型：可能有 bug；上生产前自行审查与改写。
- 权限档：Worker / Router 预设按文档以操作者 OS 用户跑，并带
danger-full-access一类高权限取向；进程隔离不等于账号隔离。文档建议敏感环境用只放 agent 凭证的独立 OS 账户。 - 能读到什么：Worker 可按路径执行程序、读操作者家目录等——边界取决于你怎么部署，不取决于聊天里「请小心」。
- 谁能开单：只认 Source 策略上的允许名单与 admission；默认从窄名单 +
observe学行为，再考虑auto。 - Agent 身份：GitHub 上所有评论 / 推分支 / 开 PR 都挂在 agent 专用账号；别把个人主账号绑上去。
- 密钥：SETUP 明确禁止在对话里要 secret；CLI 登录、飞书 app secret 等走本机终端。
- 企业 GitHub：文档写明面向 github.com，不支持 GitHub Enterprise Server。
适合谁、不适合谁
适合：已经在用或愿意装 DeepSeek Harness；希望 Issue / 评论驱动、可回 PR 的仓库级 Agent；能接受自己管模型账单、机器与策略；想读开源实现对照「Super-agent」论文/设计文章。
不适合：只想装个 App 开箱写代码（优先 Claude Code / Codex / 桌面壳）；不能接受高权限本机 Agent；需要企业版 GitHub 或开箱即用的 SaaS 运维。
入口：仓库 · 先让 Agent 读 SETUP.md · 编号文档从 docs/000-philosophy.md 顺序读。版本与安装钉以 2026-11-03 查阅的 README / SETUP / 006-deployment 为准。
