前言¶
在 DeepSeek Harness（DSH）里做多子智能体协作时，常见做法是手动开多个会话、来回粘贴上下文，或在单一 Agent 里堆工具调用。父会话很难统一记录决策、子任务上报和审批策略，模型能力也往往固定在一档，子任务失败时只能人工换模型重试。
dsh-ladder-superagents 是社区维护者 Yukikaze-Ai 发布的 DSH bundle 插件（包 id：dsh-ladder-superagents），在 profile 里把选定会话升级为 SupA（Superagent）会话，思路延续 deepseek-ai/dsh-superagent-prototype：共享账本、显式 spawn 子智能体、父子上下文供给，并在此基础上增加十档模型阶梯、难度路由与失败降档重试。下面按定位、能力、安装与配置说明可核对的操作步骤。
这是什么¶
插件全称对应仓库 Yukikaze-Ai/dsh-ladder-superagents，在 SkillHub 社区目录中归类为工作流，简介为「Deepseek Harness Superagents with Dispatch」。当前 package.json 版本为 0.2.1，许可证 MIT。
它不是单独的聊天模型，而是一套注册到 Harness 的 Host/Client 补丁：向每个会话注入 SupA 工具与 system prompt 中的 SupA session charter，并在设置页提供 SupA settings（含模型阶梯与策略卡片类配置界面，见仓库文档配图）。
与原型对照，资料将机制概括为三条属性：
| 属性 | 本插件做法 |
|---|---|
| 尽量不卡在审批上 | 审批在进程内决策；能自诊自修的先修；autoApprove: true 为显式 opt-in，默认继承 Harness 策略 |
| 共享上下文 | 工作区账本 .dsh-supa/context.jsonl，会话可读写，并以 digest 注入 system prompt |
| 子智能体上下文由父决定 | supa_spawn 按父级选择打包上下文；子级可用 supa_context_request / 父级 supa_context_supply 补料 |
核心功能¶
注册的工具（每个会话可用）¶
资料列出的工具及用途如下：
| 工具 | 用途 |
|---|---|
supa_context |
对共享账本 write / read / search / list / digest |
supa_spawn |
用简报与显式上下文选择启动子智能体（账本 id/标签、文件、最近 N 条消息、附加文本等） |
supa_context_request |
子 → 父：请求未给的上下文 |
supa_context_supply |
父 → 子：下发上下文（可唤醒空闲子会话） |
supa_status |
模式、账本路径/大小、未完成 todo、存活子智能体 |
supa_report |
子 → 父：进度/结果写入父级入站队列，不唤醒父会话 |
supa_inbox |
父级 peek / drain / stats 入站队列，按子 lane 分组 |
supa_authority |
父级设置直接子级的 workspace / full 权限（不超过父级自身） |
supa_models |
管理模型阶梯：list、scan、add、remove、move、route |
另有会话级开关工具：supa_session enable / supa_session status（见下文启用方式）。
运行时行为（与审批、阻塞相关）¶
- SupA 会话对
approval/request默认按 Harness 继承策略处理；配置autoApprove: true时由插件代为应答，并在账本记录auto-approval。 - 默认允许
ask_user_question；设denyBlockingQuestions: true会使该工具失败并提示「自行决策并记入账本」。 - 回合以
blocked结束时可选唤醒（continueWhenBlocked，默认true），带频率上限（默认 10 分钟内最多 3 次 nudge）。 - 可选：
continueOnOpenTodos在仍有 open todos 且回合completed时继续推动（默认关闭）。
模型阶梯与 CLI 驱动¶
插件提供十槽位模型阶梯（supa_models），支持扫描、路由与失败时向更弱档位重试（retryOnFailure、maxRouteRetries 等配置项见下表）。
README 明确说明：0.1 阶段实现面向 Windows（package.json 中 os: ["win32"]）；macOS/Linux 上 LLM 档位可用，CLI 档位不可用。十个 CLI 驱动里，资料写明仅 codex 经核实可用；kimi、claude、gemini、qwen、cursor、opencode、aider、copilot、goose 按各 CLI 文档实现但未在可用账号上跑通，应视为实验性。
拓扑上，资料描述为「星形」：父 SupA 维护按子 lane 划分的入站队列，子级通过 supa_report 上报而不必唤醒父会话。
安装与启用¶
安装（以 README 为准）¶
该包通过 package.json 的 dsh.bundle.patch 声明为 bundle；安装后 Host 与 Client 同时生效，无需 rebuild，Client 为经 Harness 模块加载器加载的 JavaScript。
官方 README 给出的获取与安装步骤为：
git clone https://github.com/Yukikaze-Ai/dsh-ladder-superagents.git
随后在目标 Harness 中，用 Plugin Manager 的 install from a directory，指向上述克隆目录。安装完成后，工具会出现在每个会话中，charter 会加入下一次 prompt 组装，Settings 中会出现 SupA settings 页。
在会话中打开 SupA¶
默认 mode: session，不会自动把全会话变成 SupA。启用方式二选一：
- 会话标题栏 SupA 控件：绿点表示当前会话为 SupA，灰点为关闭；点击切换。
- 对话内调用
supa_session enable；supa_session status可查看状态。
关闭为软停止：拒绝新的 spawn，已在跑的子智能体继续工作，报告留在队列，下次再开 SupA 时仍可处理。
配置¶
在 bundle 的 cordis.patch.yml 里 supa 行上设置。常用项如下（默认值以 README 为准）：
| 键 | 默认 | 含义 |
|---|---|---|
enabled |
true |
总开关 |
mode |
session |
session / all / root / preset |
presets |
[] |
mode: preset 时的 preset id 列表 |
ledgerDir |
.dsh-supa |
账本目录（相对会话工作目录） |
autoApprove |
false |
true 时 SupA 自行应答全部 approval |
denyBlockingQuestions |
false |
拒绝 ask_user_question |
continueWhenBlocked |
true |
blocked 回合是否 nudge 继续 |
spawnProvider |
spawn |
supa_spawn 使用的 ctx.subagents provider |
childPreset |
'' |
子智能体 preset，空则继承父级 |
retryOnFailure |
true |
路由子智能体失败时降一档重 spawn |
maxRouteRetries |
2 |
最多降档重试次数 |
codexCommand |
'' |
codex CLI 绝对路径；空则自动发现 |
cliTimeoutMs |
900000 |
codex 运行超时 |
maxPackBytes |
24000 |
上下文包上限 |
完整列表见 GitHub README 的 Configuration 节。
典型用法（可复现路径）¶
- 按上文 clone 目录安装 bundle，在
cordis.patch.yml的supa段按需改mode、ledgerDir、autoApprove等。 - 打开目标工作区会话，点击 SupA 绿点或执行
supa_session enable。 - 用
supa_context写入任务目标、约束与中间结论到账本；父 prompt 会带上近期 digest。 - 用
supa_spawn派发子任务，并在参数中明确要选中的账本条目、文件或 transcript 片段。 - 子智能体缺料时走
supa_context_request，父级用supa_context_supply回复；子级进度用supa_report，父级用supa_inbox drain或peek汇总。 - 若使用 CLI 阶梯，在 Windows 上配置
codexCommand或依赖自动发现，用supa_models scan/route管理档位；非 Windows 或实验性 CLI 驱动前应先阅读 README 中的平台与验证说明。
适用场景与注意¶
适合：需要在 DSH 内做「父会话统筹 + 多子任务并行/串行」、希望上下文落在工作区账本而非散落聊天记录；并希望在 Windows 环境下把部分子任务路由到 codex 等 CLI 档位的开发者。
注意：
- 插件以当前 DSH 进程权限运行；安装前请阅读源码与 MIT 许可证，自行评估
autoApprove、子级authority与 shell 相关能力的风险。 - 社区目录 SkillHub 插件页 与 GitHub 仓库由社区维护，与 DeepSeek / 幻方无官方从属关系；DSH 生态遵循「一切皆插件」的扩展方式。
package.json仍声明os: ["win32"]，在 Linux/macOS 上若以 LLM 档位为主可评估使用，但勿依赖未验证的 CLI 档位做生产路径。
结尾¶
dsh-ladder-superagents 把 SupA 原型的账本、spawn 与上下文供给落到可配置的 DSH bundle 上，并叠加模型阶梯与失败降档，适合作为工作流类 SupA 编排入口。更多信息见社区目录 https://www.skillhub.cn/plugins/Yukikaze-Ai/dsh-ladder-superagents 与源码仓库 https://github.com/Yukikaze-Ai/dsh-ladder-superagents。
