队员模型配置 sequoiayunus-hue/dsh-subagent-model-config

dsh-subagent-model-config

给 DeepSeek Harness（DSH）原生 Team 编队的队员单独配模型和推理档位——在设置页点两下就配好，不改官方任何文件。

Per-teammate model & reasoning-effort configuration for DSH native agent teams — two clicks in the settings UI, zero official files modified.

这解决什么问题

DSH 原生 Team 编队的 spawn_teammate 只有 name / description / prompt / context 四个参数，没有 model（官方讨论 #6985）——所有队员只能继承主会话的默认模型：想给审查队员配个便宜快的、给写手配个强模型的，做不到。

本插件把这个缺口补上：按队员名配规则，每个队员跑在你指定的 provider / model / 推理档位上，全部在设置页点选完成。

- 零官方改动：不改官方文件、不打补丁；包装可逆，取消勾选「启用」即回到原生行为
- 热生效：保存规则后，下一次 spawn_teammate 即生效，无需重启
- 一张规则表管全部：队员名支持 / ? 通配、大小写不敏感，按顺序求值、第一条命中即生效；每条规则可加中文备注（纯显示，不注入）
- 待指定安全：只写队员名、模型留空的规则不注入任何东西（队员继承默认模型），UI 黄条提醒——可以先建角色、后补模型
- 取证开关：debug 开启后每次 spawn 追加一行到 .probe.jsonl 供排查，默认关闭

快速开始

安装

方式一（推荐）：DSH 设置 → 插件市场 → 搜索 dsh-subagent-model-config → 安装并启用。

方式二（手动）：克隆本仓库，在 profile 的 package.json 里加：

{ "dsh-subagent-model-config": "link:/path/to/dsh-subagent-model-config" }

并把它加入 profile 的 dsh.bundles，重启 DSH。

配置

打开 设置 → Subagent Models，添加规则：

| 字段 | 说明 |
| 队员名匹配 | glob 模式，如 verifier； 任意串、? 单字符 |
| 备注 | 中文名，只用于显示 |
| provider | 留空 = 继承主会话的供应商 |
| model | 留空 = 该 provider 的默认模型；整条规则 provider/model 全空 = 不注入 |
| 推理档位 | 下拉选择，候选 = 所选模型自己声明的档位；留空 = 目标模型默认档 |

设置页全貌——左侧入口、启用开关、常用角色一键条与规则卡：

设置页：入口、开关、常用角色与规则卡

典型配置（节选）：

{
"enabled": true,
"rules": [
{ "match": "verifier", "note": "独立验证员——便宜快的", "provider": "…", "model": "…", "reasoningEffort": "low" }, { "match": "writer", "note": "写手——强模型高思考", "provider": "…", "model": "…", "reasoningEffort": "high" }, { "match": "researcher", "note": "检索员——角色先建，模型后补" } ] }

通用工程编队的实际用法——验证员用强模型高思考、测试编队用 flash 省额度，一张规则表各跑各的：

通用工程编队规则示例

工作原理

插件在运行时包装两个 DSH 内部接口：agentTeams.spawnTeammate（采集队员名）与 SubagentRuntime.startContinuable（注入点）。派单发生时按队员名匹配规则表，把命中的 provider / model / reasoningEffort 写进官方原生支持的 SubagentStartRequest.agentOptions——只接上编队路径没接的线，不改任何官方行为。包装装在实例与原型两层（幂等防重入），内部异常一律只记录不抛出；配置为空或关闭时，行为与未装本插件完全一致。

兼容性与测试

- 声明范围：engines.dsh >= 0.1.7-alpha.1，Node >= 22
- 实测：DSH 0.1.7-alpha.2（首发实测）；DSH 0.2.0 桌面端（日常在用）
- npm test：143 用例（17 套件）全过
- 本插件钩在 DSH 内部运行时接口上，官方未来版本可能改变这些接口导致失效；遇到问题欢迎提 issue

视频预设配套：队员闸门与能力限制

这是 video 解析预设的配套约束。判定只看父会话 preset——不用视频预设的用户完全无感。

① 视频队员名硬闸门 视频解析任务用哪个模型、开不开思考，必须人工点名。名字以 video- / video_ 开头却未命中任何规则 ⇒ 抛错拒绝启动（错误码 DSH_SUBAGENT_MODEL_CONFIG_UNROUTED_VIDEO），报错实时列出当前规则表允许的命名清单。fail-closed：配置缺失、损坏或规则为空时，视频名一律拒绝。非视频名字与 enabled: false 完全不受影响。

② 队员侧能力限制（父会话 preset 为 video 时注入）

| 注入项 | 作用 |
| request.persona | 队员角色卡，遮蔽部署 persona（主窗身份卡对队员不再生效） |
| request.toolFilter.allow | 工具白名单（fail-closed）：watch_video / read write edit glob grep / pwsh / job_list job_output job_kill / skill / todo_write |

白名单只列「继承层」工具；团队通信工具（send_message / team_task_ 等）注册在成员自己的 scope，天然保留。standard / cordis / minimal 模式的子代理完全不受影响。

它解决什么问题

在 DSH 原生智能体团队里，spawn_teammate 只接收 name / description / prompt / context —— 没有 model 参数（上游讨论 #6985）。每个队员都继承主会话的默认模型：你没法给评审员配个便宜快速的模型，也没法给写手配个强模型。

这个插件补上这个缺口：按名字匹配规则，每个队员跑在你选定的服务商 / 模型 / 推理强度上 —— 全部可在设置界面里改，下次 spawn 生效。

- 零官方改动：不改任何官方文件；包装可逆 —— 取消勾选「enabled」就回到原生行为
- 热重载：保存的规则对下一次 spawn_teammate 立即生效，不用重启
- 一张规则表决定谁跑在什么上：glob 匹配（ / ?，不区分大小写），先命中先赢；每条规则可写显示备注
- 安全的「模型待定」规则：模型留空的规则不注入任何东西（队员继承默认值）；界面用琥珀色标出来 —— 先建角色，后填模型
- 证据开关：debug: true 时每次 spawn 往 .probe.jsonl 追加一行；默认关闭

快速开始

安装：DSH 设置 → 插件 → 搜索 dsh-subagent-model-config。手动安装：克隆本仓库，在你的配置档 package.json 里链接它，加进 dsh.bundles，重启 DSH。

配置：设置 → Subagent Models —— 添加规则，填名字模式，可选服务商 / 模型 / 推理强度（下拉候选来自所选模型本身）。

工作原理

插件在运行时包装 DSH 的两个内部实现：agentTeams.spawnTeammate（捕获队员名字）和 SubagentRuntime.startContinuable（注入点）。spawn 时拿名字去匹配规则表，把解析出的字段写进 SubagentStartRequest.agentOptions —— 这个字段 DSH 原生支持，但团队路径从没接上。包装同时装在实例和原型上（幂等）；内部错误只记日志，绝不抛出；配置为空或已禁用时，行为与没装插件完全一致。

兼容性与测试

- engines.dsh >= 0.1.7-alpha.1，Node >= 22
- 已在 DSH 0.1.7-alpha.2 和 0.2.0 桌面版上测试（日常使用）
- npm test：143 个用例，17 个套件，全部通过
- 插件会挂钩 DSH 内部运行时 API，这些 API 在未来版本中可能变化——如果出现故障，请提 issue

视频预设配套：门禁与队友限制

仅对 video 分析预设生效——检测读取父会话的预设，所以其他模式不受影响：

1. 视频队友名称硬门禁：以 video-/video_ 开头、又匹配不到任何规则的名称会被直接拒绝（错误码 DSH_SUBAGENT_MODEL_CONFIG_UNROUTED_VIDEO），并附上实时可用的名称列表。失败即关闭：配置缺失、损坏或为空时，拒绝所有视频名称。
2. 队友侧限制（父预设为 video 时注入）：request.persona（遮蔽部署配置档）和 request.toolFilter.allow（失败即关闭的白名单：watch_video、read/write/edit/glob/grep、pwsh、job_list/job_output/job_kill、skill、todo_write）。团队沟通工具位于成员自己的作用域，自然保留。standard / cordis / minimal 子代理不受影响。

License

MIT