在 DeepSeek Harness (DSH) 的開發流程中,子代理(Subagent)通常默認繼承主對話的模型配置。當需要爲子代理指定不同的模型或推理努力(Reasoning Effort)時,現有機制缺乏靈活性。爲了解決這一場景,社區維護了 dsh-subagent-model-picker 插件。
該插件爲 DSH 子代理提供獨立的模型和推理努力控制,不改變主對話的模型配置。由用戶 chr003 維護,基於 MIT 協議開源。
核心功能¶
該插件主要提供以下能力:
- 獨立模型選擇:在主對話模型旁邊提供獨立的
Sub:選擇器,用於爲新子代理指定模型和推理努力。 - 會話級配置:支持按會話設置,默認策略爲
Inherited(繼承),即保持 DSH 的正常選擇(通常爲父模型)。 - 狀態持久化:現有的子代理在繼續對話或重啓 DSH 後,會保持其綁定的模型和推理努力。
- 只讀視圖:子對話的視圖爲只讀,僅允許在根對話進行配置修改。
安裝與啓用¶
安裝此插件需要滿足以下環境要求:
* DSH Web 版本:0.1.2-rc.1
* Node.js 版本:22.19+(22.x 系列)或 24+
* 系統需安裝 Git 和 npm
在運行 DSH 的機器上,進入目標目錄並執行以下命令(假設 Web 配置文件名爲 web):
git clone --branch v0.1.0 --depth 1 https://github.com/chr003/dsh-subagent-model-picker.git &&
cd dsh-subagent-model-picker &&
npm run setup &&
npm run check &&
dsh plugin --profile web add "link:$PWD"
安裝完成後,重啓 DSH 實例並刷新 Web 頁面,即可在主對話模型選擇器旁邊看到 Sub: 選項。
典型用法¶
- 配置新子代理:在主對話中選擇提供商、模型和推理努力,然後在
Sub:中選擇不同的模型或推理努力。 - 使用繼承策略:選擇
Inherited,子代理將使用 DSH 的正常選擇(通常爲父模型),但父模型生成的工具調用選項仍可能覆蓋此設置。 - 覆蓋默認行爲:在
Sub:中的明確選擇會覆蓋父模型生成的工具調用選項。 - 後代繼承:新創建的後代會使用當前根對話最新的明確策略;如果策略爲
Inherited,則使用 DSH 的正常選擇。
適用場景與注意事項¶
該插件控制的是標準進程內的 DSH 子代理,並非獨立的 Codex 或 Claude CLI 產品。在部署前請注意以下事項:
- 平臺兼容性:目前插件已在 Linux 平臺測試通過(測試環境 Node 22.22.3 / 24.19.0 和 DSH 0.1.2-rc.1),macOS 和 Windows 尚未驗證。
- 權限與上下文:插件以當前 DSH 進程的權限運行,屬於進程內插件。
- 數據隱私:插件會存儲相關配置數據。
- 已知限制:如果新子代理的初始綁定保存失敗,重啓 DSH 後該子代理可能未被管理,需重新創建。
總結¶
dsh-subagent-model-picker 爲 DSH 用戶提供了細粒度的子代理模型控制能力。通過獨立的 Sub: 選擇器和持久化配置,開發者可以在不干擾主對話模型的情況下,靈活調度子代理的資源。
- GitHub 倉庫: https://github.com/chr003/dsh-subagent-model-picker
- 插件目錄: https://www.skillhub.cn/plugins/chr003/dsh-subagent-model-picker