前言¶
在 DSH 中運行 agent 時,一個現實問題是:不同請求對模型能力的需求差別較大。簡單問答、小範圍代碼修改、複雜多步任務如果都綁定同一個模型,容易在成本和效果之間失去平衡。
dsh-auto-model-router 是爲 DeepSeek Harness(DSH)編寫的第三方模型路由插件。它把請求路由到 L0–L3 四個能力層級,並提供 heuristic lock、固定層級和 fully-auto 三種用戶模式,同時支持成本控制、失敗回退鏈和可選 LLM 分類器。
下面介紹它的能力、安裝方式和典型用法。DSH 的擴展通過插件完成;本文提到的社區目錄頁是獨立站點,不是 DeepSeek 或幻方官方應用商店。
這是什麼¶
dsh-auto-model-router 由 ADVeRTs13 維護,許可證爲 MIT。npm 包名爲 @adverts13/dsh-auto-model-router,包版本爲 0.1.1。
它會在 DSH 模型選擇器中註冊虛擬 auto provider 和 Auto Router 組,讓使用者可以直接選擇 Auto;如果顯式選擇真實模型,插件會把請求原樣通過,不干預路由。
核心功能¶
- 四級能力路由:
L0–L3 - 三種用戶模式:
heuristic lock、固定層級、fully-auto - 基於文本寬度閾值的零延遲啓發式鎖定
fully-auto模式下的關鍵詞評分,權重和區間可配置- 評分爲 0 時可選用 LLM 分類器
- 失敗回退鏈
- 預算控制,支持
cost-first、quality-first、balanced - 瀏覽器設置頁展示當前路由策略
- 可通過 AI 修改
cordis.patch.yml調整配置 - 顯式選擇真實模型時,請求按原選擇通過
安裝與啓用¶
該插件的 Node 引擎要求爲:
^22.19.0 || >=24
對依賴項的要求包括:
@deepseek-ai/dsh-llm 0.1.0-rc.6
@deepseek-ai/dsh-tools 0.1.0-rc.6
使用 npm 包安裝:
dsh plugin --profile web add @adverts13/dsh-auto-model-router
也可以先安裝再添加:
npm install @adverts13/dsh-auto-model-router
dsh plugin --profile web add @adverts13/dsh-auto-model-router
如果使用本地目錄:
dsh plugin --profile web add ./dsh-auto-model-router
啓用方式是在 DSH 模型選擇器中選擇 Auto Router 下的 Auto。選擇 Auto 會立即生效,沒有確認彈窗;選擇真實模型則不會經過該路由。
典型用法¶
下面是文檔給出的使用方式:
- 選擇
Auto,讓會話經由L0–L3層級路由。 - 選擇任意真實模型,讓請求原樣通過。
- 在聊天中讓 AI 修改配置,例如:
-change L2 to deepseek-v4-flash with max reasoning
-switch cost mode to cost-first
AI 會編輯 cordis.patch.yml;修改後需要重啓 DSH 才能生效。
4. 也可以直接往 profile 的 cordis.patch.yml 中追加配置,相關配置項包括 levels、rules、heuristic、scoring、costControl。
幾個配置行爲需要留意:
rules默認爲空,且只在fully-auto模式下參與路由。- 每個已配置層級需要
reasoningEffort,省略時默認爲off。 - 未配置的層級可以留空;路由器會按成本模式落到最近的已配置層級。
適用場景與注意¶
這個插件適合希望按任務複雜度切換模型能力、希望在成本優先、質量優先和平衡之間切換策略、並且希望在 DSH 模型選擇器中直接選擇 Auto 的使用者。
安裝前建議先檢查源碼和許可證。該插件會以當前 dsh 進程權限運行,修改模型路由、預算策略和 fallback 行爲時,應確認自己理解這些配置項的含義。通過 AI 修改 cordis.patch.yml 後,需要重啓 DSH 才能應用。
另外,client.js 是一個自包含的 ModuleLoader bundle;維護者可以用 pnpm run build:client 從 client/ 重新生成它。
鏈接¶
- 插件目錄頁:https://www.skillhub.cn/plugins/ADVeRTs13/dsh-auto-model-router
- GitHub:https://github.com/ADVeRTs13/dsh-auto-model-router