DeepSeek Harness 智能委派套件 (dsh-delegation-suite)

DeepSeek Harness (DSH) 的生態以插件化爲核心，允許用戶靈活擴展智能體的能力。dsh-delegation-suite 是一款由 wenheguo2 維護的插件，專注於解決智能體開發中的任務委派問題。它提供了一套基於角色的路由機制，能夠自動將任務分配給最合適的模型，並在模型失敗時自動切換，同時支持上下文繼承、可視化配置以及詳細的 Token 與餘額監控。

核心功能¶

該插件主要包含以下能力：

• 角色路由 + 失敗互備：通過 delegate_ranked 工具，系統根據任務角色從路由表中選擇模型。如果首選模型失敗（如欠費、限流、網絡錯誤），系統會自動嘗試列表中的下一個模型，並返回完整的嘗試日誌。
• Fork 委派：通過設置 fork: true，子代理可以繼承當前對話的上下文。這使得子代理能夠繼續之前的對話、進行追問分析或基於本線程進行審查，同時仍然遵循角色路由規則。
• 模型透明：每個被委派的子代理在名稱中會自動帶上 [provider/model] 角色 委派 的標籤。在子代理樹中，可以直觀地看到每個子代理所使用的具體模型。
• 行內思考強度：在路由表配置中，每行第三列可指定思考強度（off/low/medium/high/max）。這意味着同一個模型可以針對不同角色配置不同的推理深度。
• 可視化編輯：插件內置了 Web GUI（設置 → 預設工作室），允許用戶通過表格形式編輯路由表、預設和人格。修改後保存即時生效，無需重啓。
• 委派策略提示：內置了精簡的策略段，用於引導主代理在合適的時機進行委派，並在委派後彙報所使用的模型。
• 圖片轉寫（視覺委派）：當純文本模型收到圖片時，插件會自動派發一個 vision 角色的子代理將圖片轉寫成文字，再由主模型繼續處理。在插件設置中可以關閉此功能、指定專用模型或調整超時時間。
• Token 用量統計：自動記錄每個 provider/模型的 Token 消耗（本週、本月、年度），並與路由配置聯動，數據保存在本地。
• 餘額與配額查詢：支持自動刷新 DeepSeek、Kimi、GLM、CodeBuddy 等平臺的餘額和配額（如 Kimi Code 計劃用量、GLM Coding Plan 配額）。

安裝¶

推薦使用預構建的 tarball 安裝，以避免構建授權問題：

dsh plugin --profile web add https://github.com/wenheguo2/dsh-delegation-suite/releases/download/v1.0.0/dsh-delegation-suite-1.0.0.tgz

安裝前請檢查 profiles/web/cordis.patch.yml 文件。如果其中已存在 delegation-ranker、policy-hint 或 preset-studio 等同名工具或服務行，請先刪除這些行，以避免衝突。

基本用法¶

1. 使用委派工具¶

主代理調用 delegate_ranked 工具時，指定任務對應的角色。系統會根據該角色在路由表中的配置，按優先級選擇模型啓動子代理。

常用角色包括：
* frontend：前端、UI、CSS、TS 開發
* backend：後端邏輯、API、基礎設施
* reasoning：複雜分析、推理、架構設計
* review：獨立代碼審查
* adversary：挑刺、紅隊測試
* vision：圖像理解
* bulk：批量、機械性文件編輯
* analysis：大倉庫/文檔審查
* general：通用默認

2. 繼承上下文¶

若子代理需要基於當前對話繼續工作，在調用 delegate_ranked 時添加 fork: true 參數：

{
  "role": "review",
  "prompt": "請審查上面的代碼變更。",
  "fork": true
}

3. 配置思考強度¶

在路由表配置中，第三列（effort）可以設置思考強度。例如，讓 reasoning 角色使用 max 強度，而 bulk 角色使用 off 強度以提速。

路由配置¶

路由配置文件默認位於 $DSH_HOME/data/dsh-delegation-suite/routes.json（首次運行自動生成）。每行格式爲 [provider, model, effort]，列表順序代表模型優先級。

可以在 Web GUI 的「預設工作室」中可視化編輯此文件，修改後保存即生效。

示例配置：

{
  "reasoning": [
    ["kimi-coding", "k3-256k", "max"],
    ["zai-coding-cn", "glm-5.3", "max"],
    ["deepseek-official", "deepseek-v4-flash", "high"]
  ],
  "frontend": [
    ["deepseek-official", "deepseek-v4-flash", "high"]
  ]
}

圖片轉寫配置¶

要讓純文本模型能處理圖片，需確保路由表中的 vision 角色配置了支持圖像輸入的模型。

1. 在「設置 → 模型」中添加一個支持圖像的模型。
2. 在「設置 → 預設工作室 → 委派路由」中，給 vision 角色添加一行 [provider, model]。
3. 保存路由表。

若需關閉自動轉寫或指定專用模型，可在插件設置中調整 transcribeEnabled、transcribeModel 或 transcribeTimeoutMs。

數據統計與餘額¶

• Token 統計：進入「設置 → Token 統計」查看。支持按周/月/年查看每個模型/Provider 的消耗情況，支持一鍵清零。
• 餘額查詢：進入「設置 → 餘額與配額」，系統每 60 秒自動刷新。支持查看 DeepSeek 餘額、Kimi Code 計劃、GLM Coding Plan、CodeBuddy 積分等。

適用場景與注意¶

該插件適合需要精細控制模型分配、需要多模型並行處理任務或需要監控成本的場景。它以當前 DSH 進程的權限運行，請確保安裝前已閱讀源碼並確認許可證（MIT）。

注意事項：
* 第三方/私有網關可能不完全透傳 reasoning_effort 或 thinking 參數，導致思考強度設置無效。
* 部分網關（如騰訊 CodeBuddy）可能忽略 thinking 參數或拒絕 developer role，需根據具體網關行爲調整。

結語¶

dsh-delegation-suite 通過可視化的路由配置和自動化的容錯機制，降低了 DSH 智能體開發的複雜度。開發者可以更專注於業務邏輯，而將模型選擇、上下文繼承和成本監控交給插件處理。

• 目錄頁
• GitHub 倉庫