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