DeepSeek Harness (DSH) 的核心設計理念是「一切皆插件」。在實際開發中，同一個邏輯模型 ID（如 deepseek-v4-flash）往往需要跨多家供應商或不同套餐調用。手動切換配置既繁瑣又容易出錯。welsione/dsh-model-router 插件通過統一 ModelID 路由，將多家供應商的候選模型聚合爲一個邏輯入口，實現了基於套餐的三檔分級、首 token 前故障轉移與健康度擇優。
插件簡介¶
welsione/dsh-model-router 是一個 DeepSeek Harness (DSH) 統一模型路由插件。它將一個邏輯 ModelID 映射爲多供應商候選鏈，支持按套餐（Route Group）劃分 tier1/2/3 三檔，並在首 token 前失敗時自動切換。插件內置管理面板，可配置思考級別、冷卻策略及模型能力，並自動持久化設置。
核心能力¶
插件主要包含以下功能：
* 多套餐路由：支持多個 Route Group 並存，每套餐獨立管理三檔候選鏈與自定義檔位名。
* 自動故障轉移：主候選在首 token 前失敗（限流/認證/網絡/空響應等）時自動切換；支持分級冷卻（限流短、服務端中、認證長）及指數退避（封頂 30 分鐘）。
* 健康度擇優：基於滑動窗口時間衰減與錯誤碼加權對候選進行評分重排，穩定成功的候選優先，頻繁失敗的延後。
* 三檔分級與手動檔位：tier1 輕量、tier2 標準、tier3 強大；對話窗口支持會話級手動選檔。
* 思考級別：每候選可配置 reasoningEffort，並在保存時預檢宿主支持的檔位。
* 模型能力寫回：管理面板可編輯自定義供應商模型能力（contextWindow/maxTokens），並寫回宿主 llm-pi-ai，支持熱重載。
* 管理面板：DSH 設置頁內置「模型路由」卡片，實時顯示路由統計、冷卻狀態與能力信息。
* 界面語言：支持 zh/en 雙語，通過 model-router 命名空間註冊表切換。
* 會話安全：支持跨 provider 自動清洗 replayState。
安裝與啓用¶
插件已發佈至 npm，可通過 DSH 插件命令安裝：
dsh plugin --profile web add @welsione/dsh-model-router
如需卸載：
dsh plugin --profile web remove @welsione/dsh-model-router
安裝完成後，DSH 設置頁將出現「模型路由」卡片，對話窗口的模型選擇器將變爲「套餐」選擇器。
配置與使用¶
打開 設置 → 模型路由，添加一個統一 ModelID（例如 deepseek-v4-flash），併爲 tier1/2/3 分別配置候選模型即可。插件修改會自動保存並即時生效。
權限與數據¶
插件運行時狀態爲內存態，手動檔位持久化到宿主 settings。它不會對外發請求、不讀寫工作區文件、不上報遙測，也不接觸 API Key。
兼容性¶
該插件僅支持 DSH 0.1.0-rc.x 至 0.1.5-rc.x 版本，需要 Node.js ≥ 22 環境運行。
結語¶
該插件通過邏輯 ID 統一與自動故障轉移機制，降低了多供應商模型管理的複雜度。完整配置表與示例見 GitHub 倉庫。
