dsh-conductor
> 单入口委托 · 后台执行 · 独立复核 —— 给 DeepSeek Harness（dsh）的「委托协议」。
为什么做它
重度使用 Agent 之后，瓶颈不再只是模型能力，而是委托不可靠：
- 派发没有统一入口，结果要在多个 Agent 界面之间人肉搬运；
- 任务失败不暴露，成功也可能只是“进程退出码为 0”的假成功；
- 多路并行产出的结论缺少独立复核，严重性没人校准；
- 中断之后不知道做到哪一步，也没法安全续跑；
- 做完之后没有可审计的 run 台账，复盘和汇报全靠回忆。
dsh-conductor 在 DSH 的对话入口与后台 Agent 之间补一层协议：你只跟主 agent 说话，它按任务契约派活、按证据回收、按负向用例复核、把需要你拍板的事集中起来，并把全过程记成可恢复的 run 台账。
它做什么
| 模块 | 职责 |
|---|---|
| 契约 Contract | 结构化任务卡：目标 / 范围 / 交付路径 / 证据锚点 / 验收标准（含负向用例）/ 失败判定 / 预算 / 待决项 |
| 派发 Dispatch | 后台运行 dsh headless（一期），后续扩 Codex / Claude；每步独立目录与日志 |
| 回收 Collect | 产物落盘自动回收；退出码 + 超时 + 结构化结果三重校验，缺一即 failed |
| 复核 Review | 独立 reviewer：按证据锚点抽查、校准严重性、跑“应当拒绝”的负向用例，输出「已证实 / 待验证 / 分歧」 |
| 决策 Decide | 需要人拍板的事项集中成聊天内卡片，支持“先别改 / 暂停 / 让 dsh 再看一遍” |
| 台账 Ledger | runs//（spec / spans / report / heartbeat）+ 可重放；中断后可续跑 |
一次委托长什么样
你：评审这份方案，重点看合规、进度和工具链，先给结论和修改建议。
主 agent：已生成任务契约（3 路并行 + 1 路独立复核，负向用例 2 条）。
[run #42 已启动] 预计 8 分钟；需要你决定的事项会单独列出。
（稍后）
主 agent：发现 3 个优先问题：2 个有直接证据（附原文锚点），1 个待负责人确认。
复核降级了 1 条“环境不可达”（证据不足）。失败的一路已标记原因，不并入结论。
[待你决定] ① 先改阶段门定义 ② 等启动会 ③ 让 dsh 再核一遍附录
设计原则
- 契约先行：没有写清交付物、证据与验收标准的任务不进入派发。
- 证据锚点：每条结论必须能定位到「文件 + 行号 + 原文引用」，机器自动校验。
- 负向验收：检查类任务必须包含“应当拒绝 / 应当失败”的用例，不能只测 happy path。
- fail-closed：退出码、超时、结构化结果任一缺失即判失败；失败如实标记，不包装成功。
- 可恢复、可审计：run 台账 append-only 可重放；不把心跳当成恢复能力已实现。
- 本地优先：台账与产物默认落工作区，不发送到任何服务器。
P0 影子试点（已完成）
在真实只读评审任务上验证了「派发 → 回收 → 复核 → 失败暴露」链路：
| 指标 | 结果 |
|---|---|
| 三路并行分析 + 一路独立复核 | 4/4 通过（退出码、超时、结构化结果、证据锚点校验） |
| 派发墙钟 | 138.9 秒（三路并行；复核 121.0 秒） |
| 失败注入 | 3/3（非零退出、超时、结构化缺失均判 failed） |
| 证据负向用例 | 2/2（不存在路径、越界行号均被拒绝） |
| 独立复核产出 | 确认 29 条、待验证 1 条、分歧 1 条（并下调了执行者的严重度） |
| 未验证 | 恢复/续跑、写操作回滚、权限强制边界、跨 harness、成本口径（n=1） |
完整报告：docs/pilot-p0.md
目录
dsh-conductor/
├── docs/
│ ├── design.md # 产品设计：契约、派发、回收、复核、台账
│ ├── pilot-p0.md # P0 影子试点报告（真实运行数据）
│ └── roadmap.md # M0–M6 路线图
├── templates/
│ ├── contract.schema.json # 任务契约 JSON Schema（v0.1）
│ └── playbooks/ # 6 个正向工作流模板
│ ├── review-panel.md
│ ├── contract-parallel.md
│ ├── negative-path.md
│ ├── root-entry.md
│ ├── evidence-grade.md
│ └── assumptions.md
└── LICENSE / README.md
路线图
- [x] M0 契约与影子试点 harness
- [x] P0 真实只读评审试点（4/4 通过，失败注入 3/3）
- [ ] M1 dsh headless adapter（派发 → 心跳 → 回收 → 三重校验）
- [ ] M2
/review独立复核与证据锚点校验 - [ ] M3
/run status//run resume台账与续跑 - [ ] M4
/decide聊天内决策队列 - [ ] M5 Codex / Claude adapter
- [ ] M6 npm 发布 + 插件市场收录
详见 docs/roadmap.md。
安装（M6 后可用）
# 需要 Node.js >= 22 与 dsh >= 0.2
dsh plugin add dsh-conductor
在 MVP 完成前，本仓库以设计、契约与试点证据为主，暂不提供可安装版本。
参与
欢迎 issue 讨论：真实委托场景、契约字段、复核隔离强度、失败判定口径。仓库已加 dsh-plugin topic。
License
MIT
English
dsh-conductor is a delegation protocol for DeepSeek Harness: you talk to one main agent, it dispatches work to background agents under an explicit task contract, collects artifacts fail-closed, runs an independent review with evidence anchors and negative test cases, queues decisions for you, and records everything in a resumable run ledger. P0 pilot passed (4/4 valid results, failure injection 3/3). Plugin MVP is in progress.
