dsh-model-router:爲 DeepSeek Harness 添加角色路由

DeepSeek Harness 的默認行爲是統一對待所有的模型調用。dsh-model-router 插件通過將會話拆分爲“規劃者”和“執行者”兩個角色,解決了這個問題。

插件簡介

這是一個用於 DeepSeek Harness 的小型插件,由 thedeveloper256 維護。它將智能體會話分爲兩個角色:

  • 規劃者:默認使用 deepseek-flash(V4.1 Flash,原生多模態)。負責理解需求、設計路徑、審查結果、編寫最終答案。
  • 執行者:默認也使用 deepseek-flash。負責執行規劃者委託的具體任務。

在 V4.1-Pro 發佈前,兩者共享同一模型。這種角色分離保留在配置中,以便將來將規劃者切換回 Pro 模型,而不必爲每一個工具調用支付 Pro 的價格。

核心功能

插件通過以下三個核心機制實現路由:

  1. 請求路由:在請求管道的最外層重寫請求,給每個模型調用打上角色標籤。根智能體獲得規劃者標籤,委託的子智能體(如 subagent、subagent_fork、workflow workers)獲得執行者標籤。
  2. 提示詞注入:在智能體角色提示詞前插入一段簡短指令,明確告訴規劃者“你是思考者,去委託執行”,防止模型直接接管所有任務。
  3. 技能包:提供 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 中的圖像內容。一旦檢測到圖像,該會話在後續請求中將持續使用視覺模型,直到日誌被壓縮或修剪。

生態與許可

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜