主从协作团队 kongbai9420/dsh-boss-worker

dsh-boss-worker

English · 简体中文

面向大型复杂工程项目的 DeepSeek Harness (DSH) 多模型主从协同插件：主控架构统筹，子模型并行执行，闭环严苛验收。

当前版本：v0.1.0-beta.2 (Preview)
专为大型重构、全栈开发、多模块审计等需要多模型高效配合的复杂场景打造。

下载 v0.1.0-beta.2 · 更新记录 · 兼容性验证

💡 为什么需要 Boss-Worker 模式？

面对复杂大型任务（如全栈系统开发、大型项目重构、深度代码审计）时，单个大语言模型常受限于上下文窗口膨胀、跨文件编辑易冲突、自写自检盲区等问题。此外，全流程使用单一顶尖大模型成本高昂，而全流程使用轻量模型又难以保证顶层架构质量。

dsh-boss-worker 为 DSH 引入了分层治理架构（Lead-Worker Pattern），深度融合 DSH 的多 Provider / 多 API 接入能力：
- 主控模型 (Lead / Boss · 架构大脑)：由当前会话的主模型担任，推荐选用顶层推理、逻辑与架构设计能力最强的模型（例如 GPT-6.1 Sol、Claude Opus 5.5 等）。专注全局拆解、边界把控与严苛审查；在开启 BOSS 模式 时被强制禁止直接写业务代码，专注系统统筹。
- 子模型集群 (Workers · 执行团队)：通过 DSH 接入的不同 API 渠道与模型，按工种自由搭配组合。例如配置高吞吐代码模型（如 DeepSeek-V4 Pro）专攻功能实现，搭配高速轻量模型（如 DeepSeek 4.1 Flash、Gemini Flash）负责测试用例运行与静态检查。
- 混合协作优势：兼具顶尖大模型的“架构智慧”与轻量模型的“低成本、高并发执行力”，多模型各扬所长，在保障工程质量的同时大幅缩短响应时间并降低 API 开销。
- 真实验收闭环 (Review Gate)：子模型交付成果后进入 review 状态，必须由主控逐项对照验收标准严格核验，通过后才解锁依赖；未通过则带着具体问题打回重做。
- 全自动托管 (Autopilot)：从规划、调度执行、主控独立审查到推进下一阶段的全自主闭环流水线，大幅解放人工干预。

✨ 核心特性

1. 异构多模型混合编排 (Heterogeneous Multi-Model Orchestration)

- 自由绑定任意 Provider & Model：完全继承 DSH 的多模型接入能力，团队中的每个角色（Coder、Tester、Reviewer 等）均可独立配置不同的 API 渠道与模型。
- 典型搭配示例：
- 主控决策：GPT-6.1 Sol 或 Claude Opus 5.5（负责顶层规划、接口设计与代码审查）。
- 模块编码：DeepSeek-V4 Pro（负责文件实现、逻辑编码）。
- 验证测试：DeepSeek 4.1 Flash（负责用例执行、断言验证与语法分析）。
- 任务级动态换脑：不仅预设团队成员可混搭模型，用户还可在 Web 界面随时针对特定的待执行任务临时更换专精模型，按需调遣。

2. 严格的文件写入范围隔离 (Write Scope Isolation)

子任务在规划时必须明确相对文件或目录路径 (writeScopes)。调度引擎严格确保任何重叠写入范围的任务串行化，无交集任务安全并行，从根源消除多模型并发编辑造成的文件覆盖和代码冲突。

3. 独立质量门禁与审查机制 (Quality Gate & Review)

- 子任务不设自动完成。模型交付后统一流转至 review 状态。
- 主控模型必须调用 lead_worker_review，依据明确的测试依据和代码产出进行独立判定。
- 验收通过：解锁依赖项；验收未通过：记录审查意见并流转至返工。

4. 权威可控的返工生命周期 (Authoritative & Bounded Rework Lifecycle)

- 精准返工预算反馈：主控系统提示词实时注入当前会话设定的 maxRetries，且 lead_worker_review 审查工具在每次打回时返回权威的返工预算清单 (reworkBudget：已耗次数、设定上限、剩余额度及状态指引)，从根源上杜绝大模型依据历史对话或旧默认值在未达上限（如设定 10 次而在第 3 次）时误判停滞。
- 授权延续与超限保护：同一任务在原范围内核准返工时保留任务级授权与历史记录；仅在真实达到上限 (RETRY_LIMIT_REACHED) 时挂起请求用户裁决。人工批准后追加单次执行机会，历史全量保留。
- 范围变更安全防护：任务若擅自扩大写入范围或修改关键依赖，旧执行授权立即自动失效，确保项目文件安全。

5. 任务专属模型动态路由 (Per-Task Model Routing)

- 支持在 Web 界面为特定任务自由切换专精模型（例如架构用主力模型，写代码用精通编程的模型，测试验证用轻量高速模型）。
- 专属路由严格绑定当前会话与特定任务，自动过滤任务私有路由 (task-route-*)，与全局共享成员配置严格解耦，既不污染全局成员列表，也不会因更新全局设置而回滚运行中的子任务。

6. 完备的执行排空与断点恢复 (Draining & Recovery)

- 支持任务板暂停、中断、排空结算（Drain）与检查点（Checkpoint）保存。
- 停工或关机前，系统等待正在运行的子任务完整结算，核实磁盘一致性后方可标记安全状态。
- DSH 宿主重启后完整恢复现场状态，不丢失历史、不清空看板，杜绝陈旧执行覆盖。

7. 统一协作工作台与无缝 Web 交互 (Unified Floating Workspace)

- 一体化悬浮工作台：整合原独立设置弹窗与监控悬浮球，支持在同一悬浮窗内无缝切换【任务看板】、【角色团队】与【主控设置】三栏。
- 直达子智能体会话 (↗ 查看当前任务对话)：每个任务卡片与监控项均提供一键直达入口，通过 DSH 原生 uiWorkspace 注入服务精准打开本次执行对应的子智能体（Subagent）独立对话，无需在繁杂的历史会话列表中翻找。
- 自由拖拽与四周缩放：支持全窗口无极拖拽定位，四周边缘及四角均可随意拉伸调节尺寸，并支持轻量折叠收起与独立隐藏。收起或隐藏纯属前端视图折叠，绝不影响后台任务执行。
- 右对齐固定保存：角色与设置界面的保存按钮靠右固定于顶部，符合人机直觉手感，配置修改后随时一键生效。
- 双胶囊快捷开关：在对话输入框右侧提供 👔 BOSS 直派 与 🚀 全自动托管 胶囊开关，实时切换会话协作模式。
- 非侵入式关闭恢复：当关闭 BOSS 直派或全自动托管时，主模型完全恢复原生自主对话与直接编码能力，系统绝不干预或限制任何原生工具（包括原生 subagent、workflow、文件操作与终端命令）。

🔄 运行模式与工作流

模式配置说明

| 模式开关 | 作用域 | 说明 |
| 基本插件配置 | 全局共享 | 包括团队成员列表、并发上限 (maxParallel)、返工限制 (maxRetries)、模式 (mixed/auto/manual)。 |
| 👔 BOSS 直派 (Boss-Direct) | 会话私有 | 限制当前会话的主控模型直接执行编码工具，强制其拆分子任务并派发执行。 |
| 🚀 全自动托管 (Autopilot) | 会话私有 | 启用自动流水线。规划后自动派发，子任务交付后主控自动审查，全部完成后唤醒主控推进下一阶段。 |

提示：为避免多会话互相影响，BOSS 直派与全自动托管开关均在每个会话中独立管理与持久化。

工作流 A：常规人机协同模式 (Human-in-the-Loop)

graph TD
A[用户提出复杂需求] --> B[主控进行方案拆解与任务规划]
B --> C{是否启用计划审批?}
C -- 是 --> D[弹出交互式计划审批卡片]
D -- 用户批准 --> E[任务板生效, 进入准备状态]
D -- 用户拒绝 --> B
C -- 否 --> E
E --> F[调度引擎按依赖和文件范围并行派发]
F --> G[子模型执行并提交成果]
G --> H[成果进入待审查状态]
H --> I[主控独立审查并给出反馈]
I -- 审查通过 --> J{是否全部任务完成?}
I -- 打回返工 --> K{是否超过重试上限?}
K -- 未超限 --> F
K -- 已超限 --> L[挂起并请求用户介入]
J -- 是 --> M[阶段交付验收]
J -- 否 --> F

1. 主控调用 lead_worker_plan 规划阶段任务。
2. 用户在聊天界面确认任务清单与责任人。
3. 调度器在并发与文件范围约束下安全分发任务。
4. 子任务完成后，主控核验并通过，自动解锁后续后继任务。

工作流 B：全自动托管模式 (Autopilot)

开启输入栏的 🚀 全自动托管 胶囊开关：
1. 自动规划与派发：主控拆解任务后自动激活入队，首批无依赖任务即刻并行启动。
2. 自动闭环审查：子模型完成后触发主控审查，合格自动放行下阶段，不合格在预算内就地重试。
3. 阶段连续推进：当前阶段任务全部通过后，主控模型被阶段结算事件唤醒，结合项目全局目标调用 lead_worker_plan(append=true) 追加后续阶段任务，直至整个工程验收完成。

🛠️ 主控工具集 (Lead Tools)

主控模型通过以下 DSH 工具驱动完整协作网络：

| 工具名称 | 职责说明 |
| lead_worker_status | 查看当前任务板快照，包括任务状态、责任人、依赖进展及整体状态。 |
| lead_worker_plan | 拆解并提交任务列表，支持增量追加 (append: true) 与多阶段推进。 |
| lead_worker_dispatch | 触发安全调度，调度器自动在并发容量与无写冲突约束下启动就绪任务。 |
| lead_worker_review | 主控对子模型提交的结果进行独立审查（达标通过 / 不达标返工并附具体意见）。 |
| lead_worker_list_members | 动态查询当前可用成员数量、特长、配置模型与忙闲状态。 |
| lead_worker_approve | 人机审批流中，接收用户授权后正式激活任务板。 |
| lead_worker_recovery | 控制暂停、恢复、安全排空结算、保存断点或在故障后核查恢复。 |

📦 安装与接入

前置要求

- DeepSeek Harness (DSH) 运行时环境
- 最新 DSH 要求 Node.js ^22.19.0 || >=24.0.0；兼容性 CI 使用 Node.js 24。

DSH 兼容性

截至 2026-10-17，支持 npm latest 的 0.2.0-rc.2、官方最新 next 的 0.2.1-rc.2，并保留 0.1.7-rc.2 兼容。

beta.2 适配新版 startActivation、启动后的中断/释放、新版提示词上下文及首页入口；旧版继续使用 start。新版已移除启动参数 persona，成员指令随子任务文本传递。版本声明不会跳过 DSH 自身的兼容性检查。

CI 对三个版本分别安装官方依赖，使用真实 Cordis、工具、提示词、HTTP 和子任务服务进行离线验证，并检查官方前端插槽声明。模型执行使用可控测试后端；不调用模型 API，不代表已完成桌面端视觉验收。详细记录见 COMPATIBILITY.md。

接入 DSH 插件体系

插件通过 Cordis 机制注入 DSH 宿主服务，并在 Web 前端自动注册监控组件：

1. 获取项目代码：将本仓库克隆至 DSH 的插件管理目录或项目依赖中：
git clone https://github.com/kongbai9420/dsh-boss-worker.git

2. 配置补丁声明 (cordis.patch.yml)：在 DSH 配置文件中添加插件引入：
- insert:
- id: lead-worker
name: "dsh-boss-worker"
config:
defaultConfig:
enabled: true
mode: mixed
maxParallel: 4
maxRetries: 2
confirmPlan: true
askApprovalPrompt: true
members:
子角色 A: 负责写代码，可选用高性价比/高吞吐代码模型
- id: worker-coder
name: "Sol (代码执行)" provider: "deepseek-official" model: "deepseek-v4-pro" role: "负责代码编写、文件修改与逻辑实现" instructions: "严格在任务范围内编写代码并自测，提交改动文件与证据。"
enabled: true
readOnly: false
子角色 B: 负责单元测试与静态检查，可选用轻量高速模型
- id: worker-qa
name: "QA (验证测试)" provider: "deepseek-official" model: "deepseek-flash" role: "负责测试运行、质量把关与静态检查" instructions: "只读审查，执行测试用例，提供真实测试依据。"
enabled: true
readOnly: true

💡 异构模型自由搭配技巧：
- 主控角色 (Lead / Boss)：直接继承当前 DSH 会话的主模型（例如在界面顶部选择 GPT-6.1 Sol、Claude Opus 5.5 等推理大脑），无需在 members 中重复声明。
- 子执行角色 (Workers)：在 members 列表中自由绑定 DSH 接入的任意 Provider 与 Model（如 deepseek-official / deepseek-v4-pro、deepseek-flash 等），各司其职，最大化发挥多 API 混合协作的性价比与并发吞吐。

3. 数据持久化与 Profile 支持：
- 插件自动探测宿主当前运行的 Profile 上下文，将配置与任务状态独立持久化在各自的 Profile 数据目录下。
- 包含跨会话配置安全合并机制与版本 CAS 防并发覆盖保障。

💻 开发者与测试

项目包含完备的单元测试、调度隔离测试与前端模拟套件：

运行全量核心与调度测试
npm test

运行前端组件与状态流模拟测试
npm run test:client

验证发布包完整性与白名单过滤
npm pack --dry-run

对隔离安装的官方宿主运行兼容测试（传入绝对 bin.js 解析锚点）
npm run test:host -- /absolute/path/to/isolated-host/bin.js
npm run test:client-host -- /absolute/path/to/isolated-host/bin.js

测试体系包含 289 项自动化测试、独立前端客户端模拟及真实宿主兼容性检查，覆盖：
- 任务生命周期与严格依赖拓扑调度
- 跨任务写入范围重叠冲突与无交集并行校验
- 精准返工额度注入与真实超限授权安全门禁
- 统一悬浮工作台内嵌切换、双向拖拽缩放与保存流
- 子智能体会话注入导航与原生受控服务解耦
- 关闭模式非侵入式放行与 DSH 原生工具零干扰保障
- 多 Profile 数据隔离持久化与配置版本 CAS 防并发覆盖

🙏 致谢与参考开源项目

本项目的设计与实现深受以下开源项目的启发，在此致敬与感谢：

- DeepSeek Harness (DSH)：提供了坚实的宿主底座、Subagent 执行系统与 Web 前端插槽扩展机制。
- Cordis：提供了优雅的微内核服务架构、上下文生命周期与插件依赖注入体系。
- ChatDev & MetaGPT：多智能体协作中软件工程标准作业程序（SOP）、分工角色化与主从质检机制的核心设计灵感来源。
- Schemastery：模块化强类型 Schema 验证与运行时配置驱动规范。

📄 开源许可证

本项目基于 MIT 许可证 开源。欢迎自由使用、学习与贡献！