子代理模型路由 Garybot126/dsh-subagent-models

dsh-subagent-models

为 DeepSeek Harness 的子代理指定用哪个服务商、哪个模型、思考强度多深：设置页配一个全局默认，输入框旁的胶囊按对话覆盖。

- 宿主侧：路由存储 + agent/request 覆盖（index.js）
- Web 侧：设置页 + 输入框胶囊 + 全帧编辑器卡片（client.js）
- 运行时不依赖 dsh 包；无需构建步骤。

Screenshots / 截图

| Settings → 子代理 | Composer → 「⤳ 子代理」 |
| Settings page | Composer card |

Install / 安装

npm
dsh plugin --profile <profile> add dsh-subagent-models

or straight from this repository
dsh plugin --profile <profile> add github:Garybot126/dsh-subagent-models

如果插件行没有热加载，重启一次 dsh。

What it does / 做什么

| 位置 | 作用 |
| Settings → 子代理 | 委派子代理的全局默认路由 |
| Composer → 「⤳ 子代理」胶囊 | 当前对话的覆盖；「重置为全局」清除它 |

两个选择器都由实时 LLM 目录（ctx.llm）驱动：模型按服务商分组，思考强度列表取自该模型自己声明的
（resolveModelInfo().reasoning.efforts），因此不会给出不支持的档位。

How a route is applied / 怎么生效

委派工具（subagent）在智能体平面预设里组装，不在 Profile 补丁里，并且自带静态的 agentOptions。插件改不了这层组装，所以本插件把路由下沉一级应用：

agent/request (waterfall: "replace the frozen call configuration")

监听器只注册一次，并且只改写由另一个活跃智能体拥有的智能体——也就是被委派的子代理。顶层会话永远不动。
由此带来：

- 与官方 subagent 工具兼容，不用改预设，也不用给工具 schema 加选模型参数；
- 在子代理的下一次请求生效——不用重启，不用新开会话；
- subagent、subagent_fork 和 Agent Teams 成员都算被委派的智能体。

Precedence / 优先级

session preset route → session default → global preset route → global default → no override

「不覆盖」会让子代理保持组装时的原样，所以空配置的行为和没装插件完全一致。

预设级（presets[...]）已实现并会存储，但随附的预设组装还没把 agentPreset 传给委派工具，
所以目前实际生效的是两个 default 级。

Data / 数据

$DSH_HOME/plugin-data/subagent-models.json（回退到 ~/.dsh/plugin-data/），按 mtime 热重载，所以手动编辑也能生效：

{
"version": 1,
"global": {
"default": { "provider": "deepseek-official", "model": "deepseek-flash", "effort": "low" },
"presets": {}
},
"sessions": {
"<sessionId>": { "default": { "provider": "...", "model": "...", "effort": null }, "presets": {} }
}
}

能力声明：只读写这一个 JSON 文件；除 Web UI 使用的回环 HTTP 前缀 /plugin/subagent-models 外，不绑定任何网络端口；从不读取对话内容、凭据或任何其他文件。

Limits / 限制

- subagent_fork 的子级也会被覆盖。fork 与父级共用前缀，换模型就要重新计算 KV 缓存；如果在意这一点，就别动 fork（或者保留预设自带的 agentOptions）。
- 所选模型不支持的 effort 会让适配器校验失败——插件绝不会悄悄降级。
- 覆盖按请求生效。上下文窗口和计量元数据跟随实际生效的路由，而子级的创建选项仍保留预设里的值。

Relationship to similar plugins / 与同类插件的关系

市面上已有几个插件在做子代理路由：dsh-subagent-custom（通过 agent/request 按任务类别路由）、dsh-subagent-model-picker（按会话选择）、dsh-subagent-default-model（settings.yaml 默认值）、dsh-model-settings（设置面板）、dsh-orquestrator（固定强制路由）。本插件刻意保持小接口：不做任务分类，不加面向模型的额外参数，不改预设——只有两级（配置档和会话）、实时目录，以及一个覆盖点。

Verified / 已验证

在 dsh 0.2.1-rc.2（desktop 配置档）上：

- 存储里写无效模型 id → 子级失败；清空存储 → 成功；换一个真实的不同模型（deepseek-v4-pro + max）→ 成功；
- GET /plugin/subagent-models/state → 200，返回 3 个服务商 / 7 条路由，以及每个模型支持的 effort；
- POST /plugin/subagent-models/route → 200，磁盘上的 JSON 文件同步更新；
- 设置区块和输入框旁的 chip 都注册为活跃的插槽占用者。

License

MIT © Gary Gai