DeepSeek Harness 的默認行爲是統一對待所有的模型調用。dsh-model-router 插件通過將會話拆分爲“規劃者”和“執行者”兩個角色,解決了這個問題。
插件簡介¶
這是一個用於 DeepSeek Harness 的小型插件,由 thedeveloper256 維護。它將智能體會話分爲兩個角色:
- 規劃者:默認使用
deepseek-flash(V4.1 Flash,原生多模態)。負責理解需求、設計路徑、審查結果、編寫最終答案。 - 執行者:默認也使用
deepseek-flash。負責執行規劃者委託的具體任務。
在 V4.1-Pro 發佈前,兩者共享同一模型。這種角色分離保留在配置中,以便將來將規劃者切換回 Pro 模型,而不必爲每一個工具調用支付 Pro 的價格。
核心功能¶
插件通過以下三個核心機制實現路由:
- 請求路由:在請求管道的最外層重寫請求,給每個模型調用打上角色標籤。根智能體獲得規劃者標籤,委託的子智能體(如
subagent、subagent_fork、workflow workers)獲得執行者標籤。 - 提示詞注入:在智能體角色提示詞前插入一段簡短指令,明確告訴規劃者“你是思考者,去委託執行”,防止模型直接接管所有任務。
- 技能包:提供
pro-flash-routing技能,展示標準的執行節奏:Plan(計劃)、Delegate(委託)、Review(審查)、Report(報告)。
此外,插件還提供視覺路由功能(需手動開啓),用於處理圖像請求。
安裝¶
插件通過 npm 預構建,無需構建步驟。將其添加到 web 配置文件(可修改配置文件名):
dsh plugin --profile web add dsh-model-router
安裝後重啓配置文件,在 dsh web --dump-config 中應能看到 model-router 配置行。
配置與使用¶
GUI 設置¶
插件註冊了一個設置卡片,路徑爲 Settings → Plugins → Model router。
- 啓用/禁用:直接切換“Enabled”開關即可。更改會立即生效,並持久化到
settings.yaml的model-router鍵下。 - 視覺路由:在 v0.6.0+ 版本中,該卡片包含“Vision”開關,用於開啓圖像請求的路由功能。
注意:GUI 設置頁面僅在 Loopback 瀏覽器(localhost / 127.x)中可用。如果通過遠程瀏覽器訪問,設置卡片可能顯示只讀或不可用。此時需通過配置文件或 Patch 行來控制。
配置文件管理¶
設置會保存在配置文件的 settings.yaml 中:
model-router:
enabled: true
vision:
enabled: false
Patch 行控制¶
也可以通過 cordis.patch.yml 文件控制插件行爲。例如,在配置文件中添加以下行來禁用插件:
- enabled: false
視覺路由¶
視覺路由功能默認關閉。開啓後,當會話日誌中出現圖像時,後續的所有請求(無論來自規劃者還是執行者)都會被標記爲視覺請求,使用 deepseek-flash 模型處理。
插件會檢查 user/message、assistant/message 和 tool/result 中的圖像內容。一旦檢測到圖像,該會話在後續請求中將持續使用視覺模型,直到日誌被壓縮或修剪。
生態與許可¶
- 許可:MIT。
- 目錄:可在 skillhub.cn 查看詳情。
- 源碼:GitHub 倉庫。