前言¶

在 DeepSeek Harness（DSH）中，子代理可以承担委派任务，但不同任务并不一定适合同一个模型。例如，简单检索、代码编辑、深度推理和关键审查，对模型能力、延迟和成本的要求并不相同。如果缺少统一配置，模型选择、路由说明和后台结果汇合容易分散。

dsh-subagent-model-router 把模型别名、路由说明、子代理委派、后台结果等待和设置页放在同一个 DSH 插件中。下面介绍它解决什么问题、提供哪些能力，以及如何安装和配置。

这是什么¶

dsh-subagent-model-router 是一个 DSH 插件，由 CypherNaught-0x 维护，许可证为 MIT。已核实资料中的 package.json 版本为 0.7.0，要求 DeepSeek Harness 0.1.0-rc.6 或兼容版本。

它面向 DSH Web profile 和内置 subagent conversation UI，用来配置“哪个子代理路由使用哪个模型”“什么任务适合某个模型”，并在委派后台子代理后等待终态结果，再进入汇总或最终回答。

核心功能¶

插件提供以下已核实能力：

• subagent_model：委派工具，model 参数限制为用户配置过的别名。
• wait-for-subagents：汇合工具，等待本代理未完成的可持续后台子代理，并返回终态结果。
• 模型路由信息：将每个模型的标签和路由说明嵌入工具 schema 与系统提示，供编排器选择模型。
• model_subagent_catalog：只读视图，展示已注册 LLM provider 提供的模型。
• configure_subagent_models：命名空间作用域的模型侧工具，可读取或更新插件设置，不需要文件系统访问。
• model-subagent-setup：引导技能，用于选择路由、生成路由指引、确认并通过受限配置工具保存。
• Web 设置页：Settings → Subagent Models，可手动添加、编辑和删除路由。
• 配置命名空间：在 ~/.dsh/settings.yaml 中提供热重载的 subagent-model-router 命名空间。
• 执行形态：支持前台执行和可持续的后台子代理。
• UI 标识：在打开的子代理 header 中显示 active-model chip；在父会话 subagent catalog 的健康行中显示 active-model chips；可选在 Better Sidebar 的 Tasks 行内显示 inline model chip。
• Better Sidebar 集成：无需修改 Better Sidebar 源码；未安装时扩展保持惰性。

边界行为：

• 当 models 列表为空时，catalog、配置、wait 工具和设置页/设置技能仍可用，但 subagent_model 不注册。
• 当其他插件已拥有或 scope-shadow wait-for-subagents 名称时，插件保持该名称不变，并抑制受影响代理的 wait 专属指引和跟踪。

安装与启用¶

先确认环境满足以下条件：

• DeepSeek Harness 0.1.0-rc.6 或兼容版本。
• Web profile 和内置 subagent conversation UI。
• 暴露正常 skill loader/tool 的 preset。
• Host spawn subagent provider，标准 DSH profiles 包含。
• 可选：兼容的 dsh-better-sidebar release，资料明确 0.15.2 和 0.16.x 支持。

README 给出的安装命令如下：

dsh plugin --profile web add dsh-subagent-model-router

需要注意：README 将 npm 安装标注为 once published，是否已发布未在已核实资料中确认。如果你从当前 checkout 安装，可使用：

dsh plugin --profile web add .

安装后，先重启 dsh web，再刷新页面。

配置方式¶

配置有两条常见路径：Web 设置页和引导技能。

1、打开 Settings → Subagent Models，或调用：

/model-subagent-setup

2、在 Subagent Models 设置页中配置以下项：

• model alias
• display name
• LLM provider route
• exact model id
• comma-separated routing tags
• when to use description
• optional per-model output-token caps
• subagent backend
• delegation depth
• background execution

3、也可以直接编辑 ~/.dsh/settings.yaml 中的 subagent-model-router 命名空间；资料说明该命名空间支持热重载。

关于 DSH rc.6 的设置接口：内置 Web settings API 只暴露固定 namespace allowlist，插件因此使用 package-owned、same-origin Host endpoint。该 endpoint 默认拒绝非 loopback 传输和跨源变更。

如果通过可信 loopback 反向代理接入，可以使用环境变量允许特定浏览器来源：

DSH_SUBAGENT_MODEL_ROUTER_TRUSTED_ORIGINS

即使配置了该环境变量，请求仍必须经 loopback 到达，且每个变更 Origin 必须同时精确匹配请求 Host 和 allowlist 来源。

典型工作流¶

经过上面的安装和配置，可以按下面步骤使用：

1、安装后重启 dsh web 并刷新页面。
2、进入 Settings → Subagent Models，或调用 /model-subagent-setup，完成模型路由配置。
3、在会话中发起委派。若委派通过 subagent_model 发起，模型参数只能选择已配置的别名。
4、完成预期后台委派后，orchestrator 必须调用 wait-for-subagents，再合成子结果或给出最终回答。
5、在 UI 中查看子代理 header、父会话 subagent catalog 健康行，以及可选 Better Sidebar Tasks 行中的模型标识。

适用场景与注意¶

这个插件适合需要统一管理 DSH 子代理模型路由、设置页、配置工具和后台汇合行为的 DSH Web 插件用户。它适合希望把模型别名、标签、用途说明和委派结果等待放在同一套配置中的场景。

不要把未确认信息当作事实：当前资料未明确星标数，也未明确“模型推理”分类；README 中的 npm 安装命令带有 once published 表述，发布状态未确认。

插件会以当前 dsh 进程权限运行，安装前应检查源码、许可证与依赖。当前资料确认许可证为 MIT，要求 DSH 0.1.0-rc.6 或兼容版本，并使用 Web profile、内置 subagent conversation UI、暴露正常 skill loader/tool 的 preset，以及 Host spawn subagent provider。Better Sidebar 是可选集成，未安装时相关扩展保持惰性。

链接¶

• 社区目录：https://www.skillhub.cn/plugins/CypherNaught-0x/DSH-Subagent-Model-Router
• GitHub：https://github.com/CypherNaught-0x/DSH-Subagent-Model-Router

社区目录是独立站点，不应理解为官方应用商店；DeepSeek 与幻方与该社区目录无官方从属关系。