前言¶

在 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 與幻方與該社區目錄無官方從屬關係。