前言¶
DeepSeek Harness (DSH) 的默認行爲通常依賴 Provider 的默認設置。當需要精細控制不同組件（如子代理、網頁搜索、繪圖）使用特定模型時，手動配置容易出錯。dsh-model-switch 插件提供了一套顯式的路由機制，強制指定主模型、子代理、計劃執行等場景的模型與推理級別。
核心功能¶
-
多場景顯式路由
- Main 模型：爲新建會話指定默認 Provider 和模型，現有會話不受影響。
- Subagents：可跟隨父級路由，或在創建 Subagent 前注入固定路由。
- Web Search：保持官方web_search行爲，部署後通過選定的動態 Provider Search Adapter 路由。
- Image Generation：提供穩定的generate_image工具路由，通過選定的 Codex 或 Grok Adapter 執行。
- Plan Review：在計劃審批前選擇執行模型。 -
交互式選擇器
- Composer Picker：用於選擇當前會話模型，提交精確的 Catalog Model ID。
- Plan Review Picker：在發送審批響應前選擇執行模型。 -
發送時上下文保護
- 在發送消息前檢查目標模型/上下文是否超預算。
- 超限時自動壓縮歷史記錄（僅針對 DSH 可壓縮歷史）。
- 可通過設置開關控制此行爲（默認開啓）。 -
模型變體分組
- 支持按 Provider 和模型 ID 後綴（如-fast,-128k）分組。
- 支持推理級別。
典型用法¶
-
配置主模型與子代理
打開 Settings → Model Switch。修改 Main 僅影響新會話。配置 Subagents 時，可選擇“跟隨父級”或指定固定的 Provider 和模型。 -
使用 Composer Picker
在會話中，通過 Composer Picker 選擇模型。該選擇器會提交官方 DSH Model Catalog 中存在的模型 ID。 -
使用 Plan Review Picker
在計劃審批界面，使用 Picker 選擇執行模型，確認後提交。 -
啓用上下文保護
在 Settings → Model Switch 中，找到 Check and compact context on send 選項並啓用。
注意事項¶
- 瀏覽器兼容性：在 DSH 0.1.7-alpha.2 版本中，非 Loopback 瀏覽器的 ConfigForms 僅存儲在內存中。在非 Loopback 環境下，請通過 Host 的 Loopback URL 打開 Settings 以避免配置丟失。
- 模型發佈要求：插件不會將任意字符串轉換爲模型。必須通過 Provider 插件將模型發佈到官方 DSH Model Catalog，插件才能識別並路由。
- 無靜默回退：無效、不可用或不支持的路由會直接報錯，不會嘗試切換到其他模型或 Provider。
- 不影響範圍：該插件不修改
web_fetch、Vision 路由、Provider 登錄憑證、官方 Agent 預設或 Native External Agent 的運行時歷史。
總結¶
該插件通過提供顯式的路由規則和交互式選擇器，幫助開發者精確控制 DSH 中的模型調用。它不干預 Core 層或憑證管理，專注於推理層面的路由策略。
- GitHub: https://github.com/NOirBRight/dsh-model-switch
- 目錄頁: https://www.skillhub.cn/plugins/NOirBRight/dsh-model-switch
