前言¶
DeepSeek Harness (DSH) 採用「一切皆插件」的架構。在使用多模型或搭建智能體時，供應商路由的穩定性與可維護性是核心痛點。dsh-smart-route 是一款解決這些痛點的插件，它作爲 polyglot 的替代方案，提供了更精細的錯誤處理和路由管理能力。
插件介紹¶
名稱：dsh-smart-route
維護者：Semidia
簡介：智能路由：供應商自動路由（polyglot 替代）— 全錯誤碼降級、一鍵啓停、不污染模型列表。
核心功能¶
渠道鏈與全錯誤降級
插件按順序配置真實 provider（如 deepseek-official、yunzhou、mze 等，必須是 DSH 已註冊的 provider）。從上到下嘗試，只要鏈上任意渠道報錯（包括 4xx、HTTP_xxx、鑑權失敗、傳輸錯誤等），都會自動嘗試下一家。鏈上全部失敗才返回最終錯誤。
冷卻機制
某個渠道失敗後，會進入冷卻期（指數退避 + 抖動），冷卻期內跳過，避免重複請求導致服務異常。
一鍵啓停與多鏈管理
對話欄按鈕和設置卡都能一鍵啓用/停用整個路由。停用後 smart-route 虛擬 provider 直接拒絕請求（錯誤碼 DISABLED），提示用戶啓用。設置卡支持新建、刪除和切換默認鏈。
乾淨的模型列表
插件只註冊一個虛擬 provider smart-route，不註冊一堆 configurable provider。模型選擇器不會冒出一堆渠道模型。
重試策略與渠道級配置
支持通過 settings 配置 retryPolicy（重試次數、退避延遲、抖動比率）。每個渠道可聲明 baseUrl 或 apiKeyEnv，聲明瞭 baseUrl 的渠道走內置 OpenAI 兼容分派。
安裝與啓用¶
使用官方安裝命令：
dsh plugin --profile web add github:Semidia/dsh-smart-route
dsh web
重啓 dsh web 後刷新頁面。默認鏈爲 deepseek-official + deepseek-v4-flash，可在設置卡或 cordis.patch.yml 裏修改。
典型用法¶
對話欄按鈕
模型選擇旁會出現“智能路由”膠囊按鈕（綠點 = 啓用）。點擊彈出面板，可切換啓用/停用，查看冷卻中的渠道。
設置卡
進入 設置 → 插件 → 智能路由，編輯默認鏈的渠道順序，保存後下一個請求即生效。
注意事項¶
已知問題（rc.6）
設置 UI 依賴上游白名單，設置卡可能顯示“命名空間未暴露”。核心路由功能不依賴設置 UI，無配置也能按默認鏈工作。上游進展見相關討論。
停用行爲
停用後請求會被直接拒絕，提示用戶在對話欄或設置中啓用。
結語¶
dsh-smart-route 提供了一套完整的供應商路由解決方案，適合需要高可用性和精細控制的 DSH 用戶。
