前言¶

在 dsh-TUI 的使用場景中，子代理通常繼承主會話的模型配置。如果需要子代理使用不同的推理強度或更輕量的模型來處理特定任務，默認行爲無法滿足需求。dsh-tui-model-switch 插件提供瞭解決方案，允許爲主會話和子代理配置獨立的模型路由。

插件簡介¶

dsh-tui-model-switch 是一個爲 dsh-TUI 設計的插件，允許子代理在不同的提供商、模型或推理努力下運行，同時保持主會話配置不變。該插件由 FUSU123fusu 維護，基於 MIT 許可證開源。

安裝與啓用¶

安裝插件需要執行以下命令。安裝後必須重啓 DSH 服務才能生效。

dsh plugin --profile dsh-tui add github:FUSU123fusu/dsh-tui-model-switch

核心功能¶

• 子代理模型路由：允許子代理在獨立的提供商、模型或推理努力下運行。
• TUI 配置界面：通過 /settings 屏幕的“模型路由”區塊進行配置。
• 實時生效：設置變更後自動重載，無需重啓。
• 跨平臺支持：在非 TUI 主機上也能工作，通過命令行查看狀態。

使用方法¶

1. 打開 TUI 界面，進入 /settings 屏幕並找到“模型路由”區塊。
2. 在“子代理模型”選項中選擇“自定義（Custom）”。
3. 從已配置的提供商和模型列表中選擇子代理使用的模型。如果列表不可用，可手動輸入 provider/model。
4. 可選：設置推理強度，支持 low、medium、high 或 max。留空則跟隨模型默認值。
5. 通過 /model-switch 命令查看當前生效的路由配置。
6. 若需恢復無插件狀態，可將子代理模型設爲“跟隨主會話（Follow main session）”。

工作機制與限制¶

• 優先級：調用方顯式指定的 provider/model 會覆蓋插件設置。
• 推理努力：僅通過攔截器注入，僅影響 origin: subagent 的會話。
• 計劃執行：計劃執行（plan-execute）階段的模型路由功能待 TUI 審批面板擴展後支持。
• 非 TUI 主機：設置配置在後臺持久化，但 /settings 界面不會渲染；可通過命令行查看路由狀態。

注意事項¶

• 安裝後務必重啓 DSH。
• 插件代碼託管在 GitHub，使用前請確認源碼與許可證。
• 插件不提供計劃執行階段的模型路由支持。