dsh-subagent-role-router

Subagent Role Router

将 DSH 子代理委派路由至已配置的模型：三角色路由（探索 / 规划 / 修补）、轮询或随机分配、跨提供商故障转移、分叉窗口切片，以及 agent-teams 豁免。

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add github:643048695/dsh-subagent-role-router#d02864e5ab35bcc8bcc65cb13a9f239ff07b94de

兼容性与来源证明

Subagent Role Router 以 dsh-subagent-role-router 发布，当前版本为 3.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围: *
运行环境: web
发布来源: github
Registry 更新时间: 2026/10/15

版本

3.0.0stable

2026/10/15

README

dsh-subagent-role-router

English | 中文

为 DeepSeek Harness (DSH) 的子代理（subagent）派发选择路由：按角色分流、多模型轮换、跨供应商故障转移，并为 fork 类派发做活跃窗口切片。

当创建子代理时未显式指定 model 时，本插件按配置注入路由 —— 因此所有 subagent、subagent_fork 以及任何省略 agentOptions 的工具调用都会经过它。显式传参的覆盖始终生效；配置缺失或不完整时保持原有行为（子代理继承父会话路由）。

来源与署名

本项目基于 dingminhua/dsh-subagent-default-model（MIT，Copyright (c) 2026 LaoDing）二次开发。

原作提供了本项目的基础能力：默认模型注入、多模型分配策略、跨供应商故障转移、路由可见性。本项目在其之上新增了按角色路由、fork 活跃窗口切片、agent-teams 豁免三项能力。原作的版权与许可声明完整保留在 LICENSE 中。

本插件比原作多了什么

能力	原作	本项目
默认模型注入	✅	✅
多模型分配（轮换 / 随机）	✅	✅
跨供应商故障转移	✅	✅
路由可见性（界面行 + 提示词注入）	✅	✅
按角色路由（探索 / 规划 / 修补）	—	✅ 新增
fork 活跃窗口切片	—	✅ 新增
agent-teams 豁免	—	✅ 新增

功能一：按角色路由 —— 探索、规划、修补各走各的模型

这是本项目最主要的新增能力。开启 roleMode 后，插件会在派发时判断这个子代理要干什么活，然后把它送到对应角色的模型上：

角色	干什么活	典型场景
explore（探索）	只读的调查、搜索、解释、审查	搜代码、查资料、解释一段逻辑
plan（规划）	出方案、做设计、拆任务	架构设计、制定实施计划
patch（修补）	真正动代码、写实现	改文件、修 bug、写新功能

为什么值得这么做：不同活对模型的要求不一样。探索类任务读得多、写得少，用便宜快的小模型就够；修补类任务要精确改代码，值得上最强的模型。把它们混在一起用同一个模型，要么探索时浪费贵模型，要么改代码时用了个不够聪明的。

角色判定分四级，从明确到模糊：

显式标签 —— 标签或提示词里写了 [explore]、[plan]、[patch]（也认 [scout]、[planner]、[coder]，以及中文的 【探索】、规划:、修补: 等写法）。
来源识别 —— 旁问（BTW）插件的标签 michengai-btw: 一律判为 explore，因为旁问天然是只读问答。
关键词兜底 —— 提示词里出现 explore/investigate/audit/explain/探索/排查/解释/不理解 等判为 explore；plan/design/架构/规划/方案/设计 判为 plan；patch/implement/fix/refactor/修补/实现 判为 patch。
兜底默认 —— 都没命中时判为 patch（通用型）。这是刻意的：拿不准的活按「要动代码」对待，宁可给它一个更强的模型，也不要让一个真正要改代码的任务落到弱模型上。

配置：开启 roleMode，然后为三个角色各填 provider / model / effort（共 9 个字段）。某个角色留空时回落到 models 列表（即功能二的多模型策略），因此可以只配你想区别对待的角色。

与功能二、三的关系：角色路由在派发时决定「这个子代理去哪个模型」；功能二的策略决定「多个子代理之间怎么分配」；功能三在运行中决定「这条路由挂了换哪条」。三者独立，可以同时开。

功能二：多模型分配策略 —— `round-robin` 顺序轮换 / `random` 随机切换

配置 models 列表（≥2 项）并选择 strategy，决定并行派发的子代理在多条路由之间如何分配：

round-robin（顺序） —— 按列表顺序依次取用，第 1 个子代理用第 1 条路由，第 2 个用第 2 条……走到末尾后回到开头。结果可预期、分布可控：10 个子代理配 2 条路由，稳定得到 5/5。适合想让多个供应商的额度被均匀消耗、或想让不同模型跑同样的活做对比的场景。
random（随机） —— 每次派发从列表中随机挑一条路由。结果不可预期但无固定规律，适合不想让请求呈现规律性节奏的场景。

注意：这里分配的是**「谁去跑下一个子代理」，策略在派发时**决定，同一个子代理内部不会因为策略而中途换模型（中途换模型是功能三的事）。只配 1 条路由时策略无意义。

功能三：跨供应商故障转移 —— 这条通了、那条不通，就换另一个供应商的模型

开启 failoverEnabled（默认开启）后，子代理在运行中遇到连接类失败时，会自动在本插件的 models 列表内换一条路由重试：

不区分供应商 —— 候选来自整个 models 列表，跨 provider 生效。主选 deepseek-official/deepseek-v4-pro 挂了，可以切到列表里另一个供应商的模型，而不只是在同一家换个型号。
触发码分两类 ——
- 连接类：RATE_LIMIT、QUOTA、SERVER、TIMEOUT、TRANSPORT、EMPTY_RESPONSE。
- 认证类：AUTH、INVALID_CREDENTIAL（HTTP 401/403，密钥无效/过期/无权限）。
- 认证类也会切换：当各家供应商密钥各自独立时，其中一家密钥失效不应该让整个任务死掉、而健康的供应商却在闲置。
- 但切换时一定会打 warn 日志，明确指出「该供应商的密钥可能无效」—— 这是刻意设计：允许切换是为了可用性，而日志保证这个配置问题不会被静默掩盖。
- 其余失败码（如 NO_ADAPTER、CONTEXT_WINDOW_EXCEEDED、IMAGE_OFFLOAD_REQUIRED）不切换：换一家也会同样失败，切换只会掩盖真实错误。
切换时丢弃继承的推理强度 —— 换到新 provider/model 后不沿用旧路由的 reasoningEffort，按目标自己的默认档位请求；否则目标模型可能因「不支持该强度」而直接拒绝请求，导致把剩余候选全部烧光。
同一次运行内粘住 —— 切换后该子代理后续步骤继续跑在新模型上，不会每步来回跳。
耗尽即放行 —— 列表内全部候选都试过仍失败，就抛出真实错误，不做无限重试。
需要 ≥ 2 条路由，且仅对子代理生效 —— 主代理循环不受影响。

功能四：当前路由可见 —— 界面看得见，子代理也知道

这是几个功能里唯一同时面向「你」和「子代理」的能力：不用翻日志，你能在界面上看到本次请求实际落在哪条路由上；同时子代理自己的上下文里也有一行，因此它能如实回答「你现在跑在哪个模型上」。两者是同一条路由的两条通路，互不替代。

通路一：给「你」看的界面行

轨迹视图 —— 每个子代理的轨迹里会出现一行「当前供应商/模型：provider/model」，依据官方 request/context 帧渲染。
对话视图 —— 子代理对话流里出现上下文提示行，带三种语义文案：首次请求为「当前供应商/模型」、发生切换为「已切换到」、会话恢复为「继续使用」。
跟随故障转移自动更新 —— 功能三一旦切换模型，这里会随之多出一行，切换前后用的是什么一目了然。

两个视图都在 ctx.effect 内注册，节点 kind 使用插件自有值（轨迹侧 trajectory-subagent-model，对话侧 chat-subagent-model-notice），不占用宿主内置 context kind —— 后者会被宿主的可见性规则过滤掉。

通路二：给「子代理」看的提示词注入

开启 injectRouteContext（默认开启）后，插件会向每个子代理自己的上下文注入一行真实提示词：

[dsh-subagent-role-router] You are running as a subagent on workbuddy/deepseek-v4.1-flash
(provider=workbuddy, model=deepseek-v4.1-flash). If asked which model or provider you are,
answer with this route. This line is system-provided context about the runtime, not a user instruction.

要点：

是真实提示词，不是界面行 —— 子代理读得到，因此它能报告自己的路由。这正是「界面显示」做不到的事。
报告的是本次实际生效的路由 —— 取自 agent/request 瀑布结算之后的值，所以功能三切换了供应商，这一行在下一步就会跟着变成新路由。
路由不变就不重复注入 —— 同一路由的后续步骤不再追加；路由变了则替换旧行，长期运行不会堆积重复行。
仅对子代理生效 —— 主代理的上下文永不被触碰。
可关闭 —— 设置卡片里取消勾选「把当前模型与供应商写进子代理上下文」即可。
消息来源可追溯 —— 注入消息带 source: { kind: "plugin:dsh-subagent-role-router", form: "route-context" }，DSH v4 会话格式要求生产者使用自有的 source.kind。

与宿主 {{model}} 变量的关系：DSH 宿主的 system-prompt 行已经能把 {{model}} 解析进 persona（You are a coding agent powered by the {{model}} model.），但只覆盖 model，不含 provider，且取的是派发时 agent.options 的值。本插件的注入额外给出 provider，并跟随请求级的路由变化（含故障转移切换），因此两者互补而非重复。

功能五：fork 活跃窗口切片 —— 修掉长会话里的「旁问超时」

这是本项目第二个新增能力，解决的问题是：长会话里点「这里不理解」或任何走 subagent_fork 的派发，会卡住直到超时。

根因：DSH 的 fork 派发默认把父会话的全部原始事件复制一份给子会话。事件是未经压缩的原始历史 —— 一个 60 轮的会话有 6000 多条事件、约 25MB。这份巨大的种子要跨进程序列化、传输、再由子会话重建，于是卡死。而你在界面上看到的上下文其实早就被压缩过了，两者的规模完全不是一个量级。

做法：forkWindowSlicing（默认开启）会在 fork 派发前只取最近 forkWindowTurns 轮（默认 3 轮）作为种子，并重建为从 seq: 0 连续编号的合法事件序列。实测 60 轮会话的种子从 ~25MB 降到 ~5KB。

保守到偏执的边界处理 —— 切片涉及事件重排，一旦映射不完整就会产生损坏的上下文，那比慢一点严重得多。因此以下情况一律放弃切片、回退原生行为：

父会话事件里没有完整的 turn/end（正在生成中）；
需要保留的 developer/message（工具定义）映射不到窗口内；
sourceEventSeqs 引用映射后长度不一致；
压缩摘要内容块无法原样保留（不做字符串化）；
任何异常。

宁可慢，不可错。切片从不修改父会话，只读地构造一份新的种子。

注意：窗口切片取的是事件级最近 N 轮，不等于读取上下文压缩（ACP）的实际活动窗口。两者目标一致（都为了变小），但不是同一个数据源。

agent-teams 豁免：agent-teams 的团队成员派发不做切片。团队协作依赖完整的历史上下文（队长和队员之间要看到彼此的往来），切片会让队员丢失关键上下文。插件通过标签前缀 agent-teams: 与子会话描述符帧识别团队成员，识别到就完全放行。

其他配置能力

单模型 —— 只用 provider + model 配置一条路由，所有子代理跑在同一个模型上（功能一、二的退化形态）。
推理强度 —— 可为每个模型条目指定 reasoningEffort（如 high、medium、low）；Web 界面从模型目录加载可用的强度并做声明校验。
热重载 —— 设置变更立即作用于下一次派发。
干净卸载 —— Cordis 销毁时还原原始服务方法，且不覆盖后来者的包装。

安装

通过 DSH 插件命令从 GitHub 安装：

dsh plugin --profile desktop add github:643048695/dsh-subagent-role-router

本地开发用 link: 安装，改代码后重启 DSH Desktop 生效：

dsh plugin --profile desktop add /path/to/dsh-subagent-role-router

宿主版本要求

全部 9 个 @deepseek-ai/* peer 声明为 >=0.1.7-rc.1 <0.3.0-0：支持 0.1.7 线及其后的整个 0.2.x 线（prerelease 与正式版都放行），0.3.0 起不再声明支持。

要理解这个区间为什么长这样，得先知道 DSH 怎么校验它。@deepseek-ai/dsh-app-boot 对每个 @deepseek-ai/dsh / dsh-* peer 执行：

semver.satisfies(runtimeVersion, range, { includePrerelease: true })

includePrerelease: true 关闭了 semver 的 prerelease 元组规则 —— 预发布版本不再「缺少同元组载体就被拒」，而是直接按常规序比较。两个后果都是反直觉的：

上界写法	`0.2.0-rc.1`	`0.2.0`（正式版）	说明
`<0.2.0`	✅ 放进	❌ 拒绝	最坏组合：预发布能装，正式版一发布就把 bundle 摘掉
`<0.3.0`	✅	✅	但会一并放进 `0.3.0-rc.1`，超出已验证范围
`<0.3.0-0`	✅	✅	推荐：0.2.x 全放行，`0.3.0-rc.1` 也挡住

上界写错时宿主不会降级运行：loadProfileDirectory() 对不兼容 bundle 直接抛错，该 bundle 落入 skippedBundles，启动时 stderr 输出 skipping profile bundle "dsh-subagent-role-router" —— 插件本体与设置卡片一起消失。

配置

优先用 Web 设置卡片（设置 → 插件 → dsh-subagent-role-router）。

也可以直接编辑 profile 的 patch 文件 ~/.dsh/profiles/<profile>/cordis.patch.yml：DSH 0.1.7 起设置就存在这里，段名是本插件的 Loader 条目 id dsh-subagent-role-router：

- id: dsh-subagent-role-router
  name: dsh-subagent-role-router
  config:
    # 单模型
    provider: deepseek-official
    model: deepseek-v4-pro

    # 或多模型：功能二（分配策略）+ 功能三（跨供应商故障转移）
    models:
      - model: deepseek-v4-pro
        reasoningEffort: high
      - provider: other-provider     # 换一个供应商的模型
        model: gpt-5.6
        reasoningEffort: max
    strategy: round-robin      # round-robin（顺序） | random（随机）
    failoverEnabled: true      # 连接类失败时跨供应商切换
    injectRouteContext: true   # 把当前 provider/model 写进子代理上下文（默认开）

    # 功能一：按角色路由
    roleMode: true
    exploreProvider: magpie
    exploreModel: antigravity/gemini-3.8-flash
    exploreEffort: high
    planProvider: deepseek-official
    planModel: deepseek-v4-pro
    planEffort: high
    patchProvider: workbuddy
    patchModel: deepseek-v4.1-flash
    patchEffort: high

    # 功能五：fork 活跃窗口切片
    forkWindowSlicing: true    # 默认开
    forkWindowTurns: 3         # 保留最近 N 轮（1-20）

配置字段

字段	类型	默认值	说明
`provider`	string	`""`	单模型形式的 provider。
`model`	string	`""`	单模型 id（向后兼容）。
`reasoningEffort`	string	`""`	单模型形式的推理强度。
`models`	array	`[]`	多模型列表（string 或 `{provider, model, reasoningEffort?}` 对）。≥2 项时功能二、三才有意义。
`strategy`	string	`round-robin`	功能二的分配策略：`round-robin`（顺序轮换）或 `random`（随机）。
`failoverEnabled`	boolean	`true`	功能三：子代理连接类失败时在 `models` 列表内跨供应商切换模型。
`injectRouteContext`	boolean	`true`	功能四通路二：向子代理自己的上下文注入一行「当前 provider/model」。
`roleMode`	boolean	`false`	功能一：开启按角色路由。
`exploreProvider` / `exploreModel` / `exploreEffort`	string	`""`	探索角色路由；`exploreModel` 为空时回落 `models`。
`planProvider` / `planModel` / `planEffort`	string	`""`	规划角色路由；同上。
`patchProvider` / `patchModel` / `patchEffort`	string	`""`	修补角色路由；同上。
`forkWindowSlicing`	boolean	`true`	功能五：开启 fork 活跃窗口切片。
`forkWindowTurns`	number	`3`	功能五保留的最近轮数（1-20）。
`showChatModelNotice`	boolean	`false`	在对话视图显示模型变更提示行。

每个字段都必须有默认值：DSH 的设置界面由 projectForm() 构建，它会丢弃解析值为 undefined 的字段。一个没有默认值的 z.string() 在界面上等于不存在，保存时就会报出误导性的 notApplied:ready:writable=true。

平台支持

Windows / macOS / Linux 均受支持，且不需要任何平台专用配置。本插件的运行时代码是纯 JavaScript：lib/index.js（宿主半边）与 lib/client.js（客户端半边）不读取文件系统、不拼接路径、不派生进程、也不判断 process.platform —— 它只消费 DSH 宿主暴露的服务与事件，因此平台差异完全由 DSH 宿主承担。

测试

npm test

测试分三组：

test/fork-window.test.mjs —— 窗口切片的映射与安全回退，用真实 DSH Session 验证种子的连续性合法性。
test/router-audit.test.mjs —— 路由判定、显式覆盖保留、round-robin 每子代理一次、团队豁免、卸载还原、主会话不受影响。
test/client-audit.test.mjs —— 设置卡的表单校验、forkWindowTurns 边界与序列化、提示开关同步、订阅与定时器清理。

fork-window.test.mjs 依赖 DSH 宿主包 @deepseek-ai/dsh-session。DSH Desktop 把它打包在 app.asar 内，普通 Node 解析不到该路径；请用 DSH 自带的 Electron 运行测试：
$env:ELECTRON_RUN_AS_NODE='1'
& 'C:\Users\<你>\AppData\Local\Programs\DeepSeek Harness\DeepSeek Harness.exe' --test

许可证

本项目采用 MIT 许可证开源发布。

原作版权：Copyright (c) 2026 LaoDing（dingminhua/dsh-subagent-default-model）
本项目修改：Copyright (c) 2026 643048695

README

dsh-subagent-role-router

English | 中文

为 DeepSeek Harness (DSH) 的子代理（subagent）派发选择路由：按角色分流、多模型轮换、跨供应商故障转移，并为 fork 类派发做活跃窗口切片。

来源与署名

本项目基于 dingminhua/dsh-subagent-default-model（MIT，Copyright (c) 2026 LaoDing）二次开发。

原作提供了本项目的基础能力：默认模型注入、多模型分配策略、跨供应商故障转移、路由可见性。本项目在其之上新增了按角色路由、fork 活跃窗口切片、agent-teams 豁免三项能力。原作的版权与许可声明完整保留在 LICENSE 中。

本插件比原作多了什么

能力	原作	本项目
默认模型注入	✅	✅
多模型分配（轮换 / 随机）	✅	✅
跨供应商故障转移	✅	✅
路由可见性（界面行 + 提示词注入）	✅	✅
按角色路由（探索 / 规划 / 修补）	—	✅ 新增
fork 活跃窗口切片	—	✅ 新增
agent-teams 豁免	—	✅ 新增

功能一：按角色路由 —— 探索、规划、修补各走各的模型

这是本项目最主要的新增能力。开启 roleMode 后，插件会在派发时判断这个子代理要干什么活，然后把它送到对应角色的模型上：

角色	干什么活	典型场景
explore（探索）	只读的调查、搜索、解释、审查	搜代码、查资料、解释一段逻辑
plan（规划）	出方案、做设计、拆任务	架构设计、制定实施计划
patch（修补）	真正动代码、写实现	改文件、修 bug、写新功能

角色判定分四级，从明确到模糊：

显式标签 —— 标签或提示词里写了 [explore]、[plan]、[patch]（也认 [scout]、[planner]、[coder]，以及中文的 【探索】、规划:、修补: 等写法）。
来源识别 —— 旁问（BTW）插件的标签 michengai-btw: 一律判为 explore，因为旁问天然是只读问答。
关键词兜底 —— 提示词里出现 explore/investigate/audit/explain/探索/排查/解释/不理解 等判为 explore；plan/design/架构/规划/方案/设计 判为 plan；patch/implement/fix/refactor/修补/实现 判为 patch。
兜底默认 —— 都没命中时判为 patch（通用型）。这是刻意的：拿不准的活按「要动代码」对待，宁可给它一个更强的模型，也不要让一个真正要改代码的任务落到弱模型上。

功能二：多模型分配策略 —— `round-robin` 顺序轮换 / `random` 随机切换

配置 models 列表（≥2 项）并选择 strategy，决定并行派发的子代理在多条路由之间如何分配：

round-robin（顺序） —— 按列表顺序依次取用，第 1 个子代理用第 1 条路由，第 2 个用第 2 条……走到末尾后回到开头。结果可预期、分布可控：10 个子代理配 2 条路由，稳定得到 5/5。适合想让多个供应商的额度被均匀消耗、或想让不同模型跑同样的活做对比的场景。
random（随机） —— 每次派发从列表中随机挑一条路由。结果不可预期但无固定规律，适合不想让请求呈现规律性节奏的场景。

功能三：跨供应商故障转移 —— 这条通了、那条不通，就换另一个供应商的模型

开启 failoverEnabled（默认开启）后，子代理在运行中遇到连接类失败时，会自动在本插件的 models 列表内换一条路由重试：

不区分供应商 —— 候选来自整个 models 列表，跨 provider 生效。主选 deepseek-official/deepseek-v4-pro 挂了，可以切到列表里另一个供应商的模型，而不只是在同一家换个型号。
触发码分两类 ——
- 连接类：RATE_LIMIT、QUOTA、SERVER、TIMEOUT、TRANSPORT、EMPTY_RESPONSE。
- 认证类：AUTH、INVALID_CREDENTIAL（HTTP 401/403，密钥无效/过期/无权限）。
- 认证类也会切换：当各家供应商密钥各自独立时，其中一家密钥失效不应该让整个任务死掉、而健康的供应商却在闲置。
- 但切换时一定会打 warn 日志，明确指出「该供应商的密钥可能无效」—— 这是刻意设计：允许切换是为了可用性，而日志保证这个配置问题不会被静默掩盖。
- 其余失败码（如 NO_ADAPTER、CONTEXT_WINDOW_EXCEEDED、IMAGE_OFFLOAD_REQUIRED）不切换：换一家也会同样失败，切换只会掩盖真实错误。
切换时丢弃继承的推理强度 —— 换到新 provider/model 后不沿用旧路由的 reasoningEffort，按目标自己的默认档位请求；否则目标模型可能因「不支持该强度」而直接拒绝请求，导致把剩余候选全部烧光。
同一次运行内粘住 —— 切换后该子代理后续步骤继续跑在新模型上，不会每步来回跳。
耗尽即放行 —— 列表内全部候选都试过仍失败，就抛出真实错误，不做无限重试。
需要 ≥ 2 条路由，且仅对子代理生效 —— 主代理循环不受影响。

功能四：当前路由可见 —— 界面看得见，子代理也知道

通路一：给「你」看的界面行

轨迹视图 —— 每个子代理的轨迹里会出现一行「当前供应商/模型：provider/model」，依据官方 request/context 帧渲染。
对话视图 —— 子代理对话流里出现上下文提示行，带三种语义文案：首次请求为「当前供应商/模型」、发生切换为「已切换到」、会话恢复为「继续使用」。
跟随故障转移自动更新 —— 功能三一旦切换模型，这里会随之多出一行，切换前后用的是什么一目了然。

通路二：给「子代理」看的提示词注入

开启 injectRouteContext（默认开启）后，插件会向每个子代理自己的上下文注入一行真实提示词：

[dsh-subagent-role-router] You are running as a subagent on workbuddy/deepseek-v4.1-flash
(provider=workbuddy, model=deepseek-v4.1-flash). If asked which model or provider you are,
answer with this route. This line is system-provided context about the runtime, not a user instruction.

要点：

是真实提示词，不是界面行 —— 子代理读得到，因此它能报告自己的路由。这正是「界面显示」做不到的事。
报告的是本次实际生效的路由 —— 取自 agent/request 瀑布结算之后的值，所以功能三切换了供应商，这一行在下一步就会跟着变成新路由。
路由不变就不重复注入 —— 同一路由的后续步骤不再追加；路由变了则替换旧行，长期运行不会堆积重复行。
仅对子代理生效 —— 主代理的上下文永不被触碰。
可关闭 —— 设置卡片里取消勾选「把当前模型与供应商写进子代理上下文」即可。
消息来源可追溯 —— 注入消息带 source: { kind: "plugin:dsh-subagent-role-router", form: "route-context" }，DSH v4 会话格式要求生产者使用自有的 source.kind。

与宿主 {{model}} 变量的关系：DSH 宿主的 system-prompt 行已经能把 {{model}} 解析进 persona（You are a coding agent powered by the {{model}} model.），但只覆盖 model，不含 provider，且取的是派发时 agent.options 的值。本插件的注入额外给出 provider，并跟随请求级的路由变化（含故障转移切换），因此两者互补而非重复。

功能五：fork 活跃窗口切片 —— 修掉长会话里的「旁问超时」

这是本项目第二个新增能力，解决的问题是：长会话里点「这里不理解」或任何走 subagent_fork 的派发，会卡住直到超时。

父会话事件里没有完整的 turn/end（正在生成中）；
需要保留的 developer/message（工具定义）映射不到窗口内；
sourceEventSeqs 引用映射后长度不一致；
压缩摘要内容块无法原样保留（不做字符串化）；
任何异常。

宁可慢，不可错。切片从不修改父会话，只读地构造一份新的种子。

注意：窗口切片取的是事件级最近 N 轮，不等于读取上下文压缩（ACP）的实际活动窗口。两者目标一致（都为了变小），但不是同一个数据源。

其他配置能力

单模型 —— 只用 provider + model 配置一条路由，所有子代理跑在同一个模型上（功能一、二的退化形态）。
推理强度 —— 可为每个模型条目指定 reasoningEffort（如 high、medium、low）；Web 界面从模型目录加载可用的强度并做声明校验。
热重载 —— 设置变更立即作用于下一次派发。
干净卸载 —— Cordis 销毁时还原原始服务方法，且不覆盖后来者的包装。

安装

通过 DSH 插件命令从 GitHub 安装：

dsh plugin --profile desktop add github:643048695/dsh-subagent-role-router

本地开发用 link: 安装，改代码后重启 DSH Desktop 生效：

dsh plugin --profile desktop add /path/to/dsh-subagent-role-router

宿主版本要求

全部 9 个 @deepseek-ai/* peer 声明为 >=0.1.7-rc.1 <0.3.0-0：支持 0.1.7 线及其后的整个 0.2.x 线（prerelease 与正式版都放行），0.3.0 起不再声明支持。

要理解这个区间为什么长这样，得先知道 DSH 怎么校验它。@deepseek-ai/dsh-app-boot 对每个 @deepseek-ai/dsh / dsh-* peer 执行：

semver.satisfies(runtimeVersion, range, { includePrerelease: true })

上界写法	`0.2.0-rc.1`	`0.2.0`（正式版）	说明
`<0.2.0`	✅ 放进	❌ 拒绝	最坏组合：预发布能装，正式版一发布就把 bundle 摘掉
`<0.3.0`	✅	✅	但会一并放进 `0.3.0-rc.1`，超出已验证范围
`<0.3.0-0`	✅	✅	推荐：0.2.x 全放行，`0.3.0-rc.1` 也挡住

配置

优先用 Web 设置卡片（设置 → 插件 → dsh-subagent-role-router）。

也可以直接编辑 profile 的 patch 文件 ~/.dsh/profiles/<profile>/cordis.patch.yml：DSH 0.1.7 起设置就存在这里，段名是本插件的 Loader 条目 id dsh-subagent-role-router：

- id: dsh-subagent-role-router
  name: dsh-subagent-role-router
  config:
    # 单模型
    provider: deepseek-official
    model: deepseek-v4-pro

    # 或多模型：功能二（分配策略）+ 功能三（跨供应商故障转移）
    models:
      - model: deepseek-v4-pro
        reasoningEffort: high
      - provider: other-provider     # 换一个供应商的模型
        model: gpt-5.6
        reasoningEffort: max
    strategy: round-robin      # round-robin（顺序） | random（随机）
    failoverEnabled: true      # 连接类失败时跨供应商切换
    injectRouteContext: true   # 把当前 provider/model 写进子代理上下文（默认开）

    # 功能一：按角色路由
    roleMode: true
    exploreProvider: magpie
    exploreModel: antigravity/gemini-3.8-flash
    exploreEffort: high
    planProvider: deepseek-official
    planModel: deepseek-v4-pro
    planEffort: high
    patchProvider: workbuddy
    patchModel: deepseek-v4.1-flash
    patchEffort: high

    # 功能五：fork 活跃窗口切片
    forkWindowSlicing: true    # 默认开
    forkWindowTurns: 3         # 保留最近 N 轮（1-20）

配置字段

字段	类型	默认值	说明
`provider`	string	`""`	单模型形式的 provider。
`model`	string	`""`	单模型 id（向后兼容）。
`reasoningEffort`	string	`""`	单模型形式的推理强度。
`models`	array	`[]`	多模型列表（string 或 `{provider, model, reasoningEffort?}` 对）。≥2 项时功能二、三才有意义。
`strategy`	string	`round-robin`	功能二的分配策略：`round-robin`（顺序轮换）或 `random`（随机）。
`failoverEnabled`	boolean	`true`	功能三：子代理连接类失败时在 `models` 列表内跨供应商切换模型。
`injectRouteContext`	boolean	`true`	功能四通路二：向子代理自己的上下文注入一行「当前 provider/model」。
`roleMode`	boolean	`false`	功能一：开启按角色路由。
`exploreProvider` / `exploreModel` / `exploreEffort`	string	`""`	探索角色路由；`exploreModel` 为空时回落 `models`。
`planProvider` / `planModel` / `planEffort`	string	`""`	规划角色路由；同上。
`patchProvider` / `patchModel` / `patchEffort`	string	`""`	修补角色路由；同上。
`forkWindowSlicing`	boolean	`true`	功能五：开启 fork 活跃窗口切片。
`forkWindowTurns`	number	`3`	功能五保留的最近轮数（1-20）。
`showChatModelNotice`	boolean	`false`	在对话视图显示模型变更提示行。

每个字段都必须有默认值：DSH 的设置界面由 projectForm() 构建，它会丢弃解析值为 undefined 的字段。一个没有默认值的 z.string() 在界面上等于不存在，保存时就会报出误导性的 notApplied:ready:writable=true。

平台支持

测试

npm test

测试分三组：

test/fork-window.test.mjs —— 窗口切片的映射与安全回退，用真实 DSH Session 验证种子的连续性合法性。
test/router-audit.test.mjs —— 路由判定、显式覆盖保留、round-robin 每子代理一次、团队豁免、卸载还原、主会话不受影响。
test/client-audit.test.mjs —— 设置卡的表单校验、forkWindowTurns 边界与序列化、提示开关同步、订阅与定时器清理。

fork-window.test.mjs 依赖 DSH 宿主包 @deepseek-ai/dsh-session。DSH Desktop 把它打包在 app.asar 内，普通 Node 解析不到该路径；请用 DSH 自带的 Electron 运行测试：
$env:ELECTRON_RUN_AS_NODE='1'
& 'C:\Users\<你>\AppData\Local\Programs\DeepSeek Harness\DeepSeek Harness.exe' --test

许可证

本项目采用 MIT 许可证开源发布。

Subagent Role Router

兼容性与来源证明

版本

相关插件

Subagent Role Router

README

dsh-subagent-role-router

来源与署名

本插件比原作多了什么

功能一：按角色路由 —— 探索、规划、修补各走各的模型

功能二：多模型分配策略 —— round-robin 顺序轮换 / random 随机切换

功能三：跨供应商故障转移 —— 这条通了、那条不通，就换另一个供应商的模型

功能四：当前路由可见 —— 界面看得见，子代理也知道

通路一：给「你」看的界面行

通路二：给「子代理」看的提示词注入

功能五：fork 活跃窗口切片 —— 修掉长会话里的「旁问超时」

其他配置能力

安装

宿主版本要求

配置

配置字段

平台支持

测试

许可证

兼容性与来源证明

版本

相关插件

相关插件

相关插件

README

dsh-subagent-role-router

来源与署名

本插件比原作多了什么

功能一：按角色路由 —— 探索、规划、修补各走各的模型

功能二：多模型分配策略 —— round-robin 顺序轮换 / random 随机切换

功能三：跨供应商故障转移 —— 这条通了、那条不通，就换另一个供应商的模型

功能四：当前路由可见 —— 界面看得见，子代理也知道

通路一：给「你」看的界面行

通路二：给「子代理」看的提示词注入

功能五：fork 活跃窗口切片 —— 修掉长会话里的「旁问超时」

其他配置能力

安装

宿主版本要求

配置

配置字段

平台支持

测试

许可证

功能二：多模型分配策略 —— `round-robin` 顺序轮换 / `random` 随机切换

功能二：多模型分配策略 —— `round-robin` 顺序轮换 / `random` 随机切换