多智能体仲裁 improveTheWorld/dsh-quorum

Quorum

为 DeepSeek Harness 打造的深度多智能体推理，强制对抗式验证（灵感来自 Antigravity /boost）。

Quorum 是什么？

如果你是从 Google Antigravity 或多智能体编排框架过来的，Quorum 把深度推理的 /boost 协议带到了 DeepSeek Harness（dsh）。

在普通的 harness 会话里，LLM 常常表现出自满：不跑测试套件就宣布任务「已修复」，漏掉回归，或者陷进对话循环里出不来。

Quorum 从构造上解决了这个问题：
1. 策略先行 —— 编排器先检查工作区，拆解目标，在委派之前写下可验证的验收标准。
2. 并行扇出 —— 工作在一轮内派发给角色隔离的子代理，上下文零污染。
3. 强制对抗式验证 —— 独立验证器在前台运行，针对真实测试套件和入口点，激进地尝试证伪方案。没有原始执行输出证明结论，就不交付任何结论。

三套定制预设

Quorum 在 Settings → Agent Presets 下安装三套可选智能体预设：

| 预设 | 基础 Harness 预设 | 工具呈现与执行 | 适用场景 |
| Quorum (PTC) | ptc.patch.yml | 程序化工具调用（run_code + 生成的 TypeScript SDK），由所有子代理递归继承 | 极致 token 效率、复杂工作流、高速自动化代码生成 |
| Quorum (Standard) | standard.patch.yml | 原生工具调用（直接调用 JSON schema）+ 工作流引擎 | 标准模型与原生工具检查 |
| Quorum (Shell) | minimal.patch.yml | 裸持久 shell（pwsh/bash，跨轮保持状态） | 交互式 shell 任务、有状态的构建环境 |

三种隔离的 Worker 角色

子代理创建时带有严格的机械边界（toolFilter）：

┌───────────────────────────────┐
│ Quorum Orchestrator Lead │
│ (Strategy, Plan, Integrate) │
└───────────────┬───────────────┘
│
┌─────────────────────────┼─────────────────────────┐
▼ ▼ ▼
┌─────────────────────┐ ┌─────────────────────┐ ┌─────────────────────┐
│ subagent_investigate│ │ subagent_implement │ │ subagent_verify │
│ (DeepInvestigator) │ │ (DeepCoder) │ │(Adversarial Verifier│
├─────────────────────┤ ├─────────────────────┤ ├─────────────────────┤
│ • 只读 │ │ • 限定范围差异 │ │ • 前台运行 │ │ • 拒绝写入 │ │ • 单元测试 │ │ • 拒绝写入 │ │ • 拒绝委派 │ │ • 拒绝委派 │ │ • 证伪 │ └─────────────────────┘ └─────────────────────┘ └─────────────────────┘

* subagent_investigate（DeepInvestigator）：严格只读（拒绝 write、edit、git commit）。追踪调用图、检查日志，用原始证据排除假设。
* subagent_implement（DeepCoder）：负责限定范围内的文件差异，并编写测试。不能委派。
* subagent_verify（Adversarial Verifier）：在前台独立运行。用真实测试套件和边界输入攻击实现。拒绝转述——只接受原始命令输出。

七个配套宿主服务

Quorum 不只是一段提示词；它挂载了七个久经考验的基础设施服务：

1. boost-job-relay —— 当子工作进程提前完成时，把后台任务结算通知重新路由到根会话。
2. dsh-detached-jobs（run_detached） —— 把所有权挂到根会话上，让长时间运行的构建/测试在一次性工作进程结束后依然存活。
3. dsh-boost-channel（channel_post / channel_read） —— 工作进程与主导者之间的带类型、限流的异步反向通道（decouverte、avancement、question、resultat、echec）。
4. dsh-boost-context-budget —— 上下文占用计量器（context_occupancy）与分叉保护阈值。支持请求式压缩（context_compact）。
5. dsh-guard-surrogate —— 在会话记录之前，拦截并修复工具结果中不成对的 UTF-16 代理项，防止致命的 HTTP 400 INVALID_REQUEST 错误。
6. agent-teams-shield —— 当宿主配置档中启用了 @deepseek-ai/dsh-experimental-agent-team 时，自动保护 Quorum 会话免受工具遮蔽。
7. boost-status-command（/boost-status） —— 命令面状态监视器，即使工具调用正在进行中也能响应。

快速开始与安装

方式 1：从 GitHub 克隆安装

git clone https://github.com/improveTheWorld/dsh-quorum.git
dsh plugin add ./dsh-quorum

方式 2：安装到指定配置档

dsh plugin --profile web add C:\path\to\dsh-quorum

在 Web GUI 中选择：

进入 Settings → Agent Presets，然后选择 Quorum (PTC)、Quorum (Standard) 或 Quorum (Shell)。

Présentation en Français

Le mode Quorum pour DeepSeek Harness

Ce dépôt consolide les sources et l'infrastructure du mode Quorum : une famille de trois presets d'agent DSH pour le raisonnement profond multi-agents avec vérification adversariale obligatoire, conçue pour éliminer les complaisances et les hallucinations d'ingénierie.

Pourquoi « Quorum » ?

在分布式系统中，quorum 是让决策生效所需的最少成员数。在这个模式下，只要独立验证器还没有基于原始凭证伪造并验证结果，编排器就无法交付任何东西。

聚合器 bundle 挂载的 10 行

cordis.patch.yml 恰好挂载以下 10 行：

preset-quorum-ptc · preset-quorum-standard · preset-quorum-shell · boost-job-relay · boost-status-command · dsh-detached-jobs · dsh-guard-surrogate · dsh-boost-channel · dsh-boost-context-budget · dsh-boost-lessons

| 包 | 作用 | 测试 |
| packages/boost-mode/ | 3 个 Quorum 预设（quorum-ptc、quorum-standard、quorum-shell） | 根级防漂移 |
| packages/boost-relay/ | 把孤儿 job 的结算中继回根级的主机中继 | 29/29 |
| packages/boost-status/ | /boost-status 命令，工具调用进行中也能读 | 10/10 |
| packages/detached-jobs/ | run_detached 工具，用于挂到根级的持久 job | 58/58 |
| packages/guard-surrogate/ | 修复孤立的 UTF-16 surrogate + Agent Teams 免疫护盾 | 31/31 |
| packages/boost-channel/ | 双钱包类型化通道（channel_post、channel_read） | 52/52 |
| packages/boost-context-budget/ | 占用测量、fork 守卫和按需压缩 | 36/36 |
| packages/boost-lessons/ | 被动记录根级压缩 | 14/14 |

测试与验证

完整测试套件用 Node.js 原生 runner 运行：

node --test

结果：291/291 测试通过，0 失败。

* test/aggregate.test.mjs：严格的防漂移测试，保证根级聚合器补丁与各子包之间绝对一致。
* 在超过十亿 token 的实测语料上经过真实环境检验。

许可证

MIT © bilel GATRI（@improveTheWorld）