前言¶
DeepSeek Harness(DSH)的原生 Team 编队接口中,spawn_teammate 仅提供 name / description / prompt / context 四个参数,并不包含 model 字段。这意味着编队内的队员无法单独指定模型,只能继承主会话的默认配置。本插件通过包装 DSH 内部运行时接口,填补了这个空白,允许用户在设置页面为特定队员单独配置模型和推理档位。
插件简介¶
本插件 sequoiayunus-hue/dsh-subagent-model-config 的核心功能是为 DSH 原生 Team 编队的队员单独配模型和推理档位。它提供图形化设置界面,不修改任何官方文件,支持热生效,无需重启 DSH。
安装与启用¶
安装过程通过 DSH 的插件市场完成:
- 打开 DSH 设置。
- 进入“插件市场”。
- 搜索
dsh-subagent-model-config。 - 安装并启用。
核心功能¶
插件的核心逻辑基于一张规则表,通过队员名进行匹配并注入配置。
模型与推理配置¶
- Glob 匹配:支持
*(任意串)和?(单字符)通配符,匹配大小写不敏感。按顺序求值,第一条命中即生效。 - 推理档位:可下拉选择目标模型支持的推理档位。
- 待指定安全:如果只填写队员名而未填写模型,规则不生效,队员继承默认模型,不会产生副作用。
取证功能¶
开启 debug 模式后,每次 spawn 队员操作会追加一行日志到 .probe.l 文件中,便于排查问题。
视频预设配套¶
当父会话 preset 为 video 时,插件会自动进行两项配置:
* 队员名硬闸门:如果队员名以 video- 或 video_ 开头,但未命中任何规则,将拒绝启动该队员,报错并列出当前允许的命名清单。
* 能力限制:自动注入 request.persona(遮蔽主窗身份卡)和 request.toolFilter.allow(视频解析工具白名单,fail-closed)。白名单包括 watch_video、read、write、edit、glob、grep、pwsh、job_list、job_output、job_kill、skill、todo_write。
典型用法¶
在设置页的“Subagent Models”中添加规则。以下是一个配置示例:
{
"enabled": true,
"rules": [
{
"match": "verifier*",
"note": "独立验证员——便宜快的",
"provider": "…",
"model": "…",
"reasoningEffort": "low"
},
{
"match": "researcher*",
"note": "检索员——角色先建,模型后补"
}
]
}
注意事项¶
- 环境要求:
engines.dsh >= 0.1.7-alpha.1,Node >= 22。 - 兼容性测试:已测试 DSH 0.1.7-alpha.2 和 0.2.0 桌面端,
npm test143 用例全过。 - 接口依赖:插件钩在 DSH 内部运行时接口上,未来官方修改这些接口可能导致失效。
总结¶
该插件通过包装接口实现了对 DSH 原生编队模型的细粒度控制,零官方改动且易于回滚。对于需要精细化管理子代理模型和推理档位的用户,这是一个实用的工具。