dsh-boss-worker: DeepSeek Harness 多模型主從協同插件

前言¶

在處理大型複雜工程項目（如全棧開發、系統重構或多模塊審計）時，單一大模型往往面臨上下文窗口限制、跨文件編輯衝突以及自檢盲區等問題。同時，全流程使用頂尖模型成本高昂，而全流程使用輕量模型則難以保證頂層架構質量。

DeepSeek Harness (DSH) 生態支持插件擴展。dsh-boss-worker 是一款針對上述場景設計的多模型主從協同插件，它引入了分層治理架構（Lead-Worker Pattern），通過主控模型統籌規劃、子模型並行執行以及嚴格的閉環驗收機制，實現工程質量的保障與成本的優化。

插件定位¶

名稱：dsh-boss-worker
定位：面向大型複雜工程項目的 DeepSeek Harness (DSH) 多模型主從協同插件
維護者：kongbai9420
核心價值：主控架構統籌，子模型並行執行，閉環嚴苛驗收

核心功能¶

該插件通過以下機制實現複雜工程的多模型協作：

異構多模型混合編排
支持任意 Provider 與 Model 的綁定。主控模型（Lead/Boss）負責全局規劃與架構設計，子模型集羣（Workers）負責具體執行。例如，主控可選用 GPT-6.1 Sol 或 Claude Opus 5.5，而執行層可搭配 DeepSeek-V4 Pro（代碼實現）與 Gemini Flash（測試驗證），各司其職。
嚴格的文件寫入範圍隔離
子任務規劃時需明確相對路徑（writeScopes）。調度引擎確保重疊範圍的寫入任務串行化，無交集任務可安全並行，從根源消除文件覆蓋與代碼衝突。
獨立質量門禁與審查機制
子模型提交成果後進入 review 狀態，必須由主控模型調用 lead_worker_review 逐項覈驗。只有通過審查，依賴項纔會解鎖；未通過則打回返工。
權威可控的返工生命週期
插件內置返工預算管理（maxRetries）。主控審查工具會返回權威的 reworkBudget（剩餘額度、已耗次數），防止模型因默認值誤判。僅在達到 RETRY_LIMIT_REACHED 上限時掛起請求用戶裁決。
任務專屬模型動態路由
支持在 Web 界面爲特定任務切換模型。專屬路由（task-route-*）綁定當前會話與任務，與全局成員配置解耦，既不污染全局列表，也不會因更新設置而回滾運行中的任務。
完備的執行排空與斷點恢復
支持任務板暫停、中斷、排空結算（Drain）與檢查點保存。關閉或重啓 DSH 宿主時，系統等待任務完整結算，恢復現場狀態，不丟失歷史與看板數據。
統一協作工作臺
提供懸浮式工作臺，整合任務看板、角色團隊與主控設置。支持一鍵直達子智能體對話窗口、自由拖拽縮放，以及非侵入式關閉恢復（關閉 BOSS 模式後恢復原生工具）。

運行模式與工具¶

插件提供兩種主要協作模式：

1. 常規人機協同模式¶

主控進行方案拆解 -> 用戶審批 -> 調度執行 -> 嚴格審查。用戶通過輸入欄的“👔 BOSS 直派”膠囊開關激活此模式。

2. 全自動託管模式¶

開啓輸入欄的“🚀 全自動託管”膠囊開關。系統自動規劃派發、自動閉環審查、階段連續推進，直至工程驗收完成。

主控工具集¶

主控模型通過以下工具驅動協作網絡：
- lead_worker_plan：拆解並提交任務列表，支持增量追加。
- lead_worker_dispatch：觸發安全調度。
- lead_worker_review：主控獨立審查。
- lead_worker_status：查看當前任務板快照。
- lead_worker_recovery：控制暫停、恢復、排空結算。

安裝與配置¶

前置要求¶

DeepSeek Harness (DSH) 運行時環境
Node.js 版本：^22.19.0 || >=24.0.0
DSH 兼容性：支持 0.2.0-rc.2、0.2.1-rc.2、0.1.7-rc.2

安裝步驟¶

獲取插件代碼：

    git clone https://github.com/kongbai9420/dsh-boss-worker.git

在 DSH 配置文件中引入插件：

    - insert:
        - id: lead-worker
          name: "dsh-boss-worker"
          config:
            defaultConfig:
              enabled: true
              mode: mixed
              maxParallel: 4
              maxRetries: 2
              members:
                # 子角色 A: 負責寫代碼
                - id: worker-coder
                  name: "Sol (代碼執行)"
                  provider: "deepseek-official"
                  model: "deepseek-v4-pro"
                  role: "負責代碼編寫、文件修改與邏輯實現"
                  instructions: "嚴格在任務範圍內編寫代碼並自測，提交改動文件與證據。"
                  enabled: true
                # 子角色 B: 負責測試與檢查
                - id: worker-qa
                  name: "QA (驗證測試)"
                  provider: "deepseek-official"
                  model: "deepseek-flash"
                  role: "負責測試運行、質量把關與靜態檢查"
                  instructions: "只讀審查，執行測試用例，提供真實測試依據。"
                  enabled: true

典型用法¶

插件通過 Cordis 機制注入服務。安裝後，DSH 會自動註冊監控組件與懸浮工作臺。

在配置成員時，建議根據任務類型綁定不同模型。例如：
- 主控決策：使用推理能力強的模型（如 GPT-6.1 Sol）進行頂層規劃。
- 模塊編碼：使用高吞吐代碼模型（如 DeepSeek-V4 Pro）進行文件實現。
- 驗證測試：使用輕量高速模型（如 DeepSeek 4.1 Flash）負責用例執行與斷言。

適用場景與注意事項¶

適用場景：大型重構、全棧開發、多模塊審計等需要多模型高效配合的複雜工程。
注意事項：插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。

結語¶

dsh-boss-worker 通過分層治理與嚴格的質量門禁，解決了大型工程中多模型協作的衝突與質量控制難題。它不僅提供了從規劃到執行的完整流水線，還通過非侵入式設計與斷點恢復機制，保障了任務執行的可靠性。

文檔目錄：dsh-boss-worker - SkillHub
源代碼：kongbai9420/dsh-boss-worker