前言¶

DeepSeek Harness（DSH）採用插件化架構。在使用官方子代理工具（subagent / subagent_fork）時，開發者往往需要對不同根會話的模型提供方、模型名稱或推理模式進行精細化控制，同時希望有一套統一的默認路由策略。

dsh-subagent-conductor 旨在解決這一問題。它作爲一個獨立的設置與默認路由層，運行在官方子代理工具的選擇邏輯之前，提供根會話選擇、角色模板管理和全局默認路由配置能力。

插件定位¶

該插件由用戶 YrracOwl 維護，屬於 admin-security 類別。它不修改 DSH 本體，也不替換官方工具 subagent 或 subagent_fork，也不註冊自己的委派工具。它主要提供運行在官方工具選擇邏輯之前的設置層，負責解析 Provider、Model 和 Reasoning Effort。

核心功能¶

1. 生命週期安全的路由與角色控制
   插件在子代理請求邊界運行，提供基於會話、角色和全局默認的層級化路由策略。

2. 輸入框根會話選擇
   在輸入框根會話選擇器中，用戶可以爲不同的根會話指定 Provider、Model 和 Reasoning Effort。該選擇器渲染在對話輸入區域的左側，支持查看各值的有效來源（默認角色、根會話、全局默認、官方或原生繼承）。

3. 角色模板與可視化編輯器
   支持創建和管理角色模板，包含 ID、顯示名稱、描述以及對應的 Provider/Model/Reasoning Effort 組合。提供可視化的增刪改查界面，支持通過 JSON 進行批量編輯和備份。

4. 全局默認路由配置
   允許設置全局默認的 Provider/Model 對及推理模式，當沒有特定根會話選擇時生效。

安裝與啓用¶

通過命令行安裝插件：

dsh plugin --profile web add dsh-subagent-conductor

安裝後需要重啓 DSH Web 進程，插件才能生效。

典型用法¶

1. 基礎配置：安裝並重啓後，在設置面板中管理全局默認路由和默認角色。
2. 批量管理：使用 JSON 導入/導出功能對角色進行批量編輯和備份。
3. 版本遷移：從 DSH 0.1.x 升級至 0.2 時，需手動在 profile patch 中配置 defaultRoute 和 sessionSelections。

適用場景與注意¶

• 版本兼容性：插件兼容 DSH <= 0.1.5 和 DSH >= 0.1.7-rc.2。
• 功能變更：v0.2 版本移除了 v0.1 中的 subagent_direct 工具和私有 marker 相關功能。v0.2 移除了 subagentProvider、backgroundMode、maxDepth、enableRunInBackground 等配置項，這些功能現在由官方工具行管理。
• 遷移注意：DSH >= 0.1.7 時，若存在 v0.1 的配置文件，插件啓動時會提示警告。需手動在 profile patch 中遷移 defaultRoute 和 sessionSelections 配置。
• 依賴項：插件依賴 @deepseek-ai/schemastery，版本約束需滿足 ^3.18.4。
• 許可證：使用 MIT 許可證。

總結¶

dsh-subagent-conductor 爲 DeepSeek Harness Web 提供了結構化的子代理路由管理能力。它不干擾官方工具的核心邏輯，而是通過前置層的設置，幫助用戶在根會話層面統一管理模型選擇和角色模板。

更多信息請訪問：
* GitHub 倉庫：https://github.com/YrracOwl/dsh-subagent-conductor
* 技能目錄：https://www.skillhub.cn/plugins/YrracOwl/dsh-subagent-conductor