# P2–P4 · 门禁之后的证据、返工与恢复 状态:**代码与单测完成(55 项),宿主侧已在临时实例上跑通 `/sansheng/state`;桌面端需重启后生效。** ## P2 · 完整开发闭环:门禁 + 派发回执 | 文件 | 作用 | | --- | --- | | `sansheng/src/gate.js` | 纯函数:角色、证据版本、返工预算、完成条件 | | `sansheng/src/gates.js` | 根 `ctx.tools.guard`,只拦 `group_goal` 的 10 个变更动作 | | `sansheng/src/digest.js` | 目标/阶段指纹,成果或目标一变,旧审查记录立即失效 | | `sansheng/src/identity.js` | 由执行会话反查真实调用者;角色按**绑定项目**重算 | | `sansheng/src/records.js` | 派发回执、返工判定、工具结果判定等纯函数 | | `sansheng/src/observe.js` | `tools/execute` 环绕钩子:先记录意图,再调用原生工具,最后写回执 | 一次目标动作的顺序: 1. `group_goal` 被调用,`tools.guard` 先用 `store.peek()` 同步校验(角色、当前阶段、同 revision 的审查记录、返工预算)。 2. 校验通过后才进入工具体;`tools/execute` 在调用前写入 `dispatch{status:'intent'}`。 3. 原生 `group_goal` 改 `room.goal`,`revision + 1`。 4. 钩子写回执:`confirmed`(成功,记 `revisionAfter`)或 `failed`,并发一条审计事件。 被拒绝的动作不会留下"已派发"的假记录:guard 抛在工具体之前。 ## P3 · 有证据的自动返工 - 尚书先 `sansheng_review action=stage_reject`(写 reject 记录:`goalRevision + stageIndex + digest`),再 `group_goal rework`;两者版本必须一致,否则门禁拒绝。 - `rework` 成功后 `detectRework()` 比对前后目标,找到 `reworks` 增加的阶段,按 `${goalId}:${revisionAfter}` 去重写一条返工记录。 - 自动返工:项目未设 `autoRework:false` 时,用尚书身份把返工单 `deliver` 到工部的群会话(`role:'request'`,文本含阶段号、驳回原因、`第 N/M 轮返工`)。投递失败只记 `autoRework:'failed: …'`,不影响原生结果。 - 预算按整个目标累计:`gate.budgetOf()` 直接求和 `stage.reworks`,不用另建计数器;默认 3,项目可覆盖;用尽后 `rework` 被拒,只能 `revise`/`stop`。 ## P4 · 隔离、恢复与对账 - 每个项目一套独立三 Bot + 独立群,绑定关系存在 `$DSH_HOME/sansheng/state.json`;跨项目复用的 Bot 会按绑定项目重算角色,不会串权。 - Main Bot 对已绑定项目一律拒绝改目标;未绑定的群保持 DS-Bot 原生行为(不误伤其它用法)。 - 重启对账:启动时把上次停在 `intent` 的派发标成 `unknown`(待核实),不重发、不假装成功。 - `sansheng_status` 会列出待核实条数。 - `sansheng_reconcile id=… verdict=done|not-done` 由尚书或用户核实;已核实的记录不会被再次改写。 - 记忆与文件隔离仍是 DS-Bot 上游能力边界(M-02/M-03 未做),当前隔离靠"每项目独立 Bot + 独立群 + 角色按绑定重算"。 ## 测试 ```sh cd sansheng && npm test # 55 tests ``` 覆盖:角色授权、未绑定放行、跨项目越权、版本过期、重复事件、返工预算、自动派单、重启对账、状态接口、客户端注册。 ## 宿主验证 用临时 profile 起实例(不动桌面端): ```sh dsh --profile dbg --port 2599 --no-open curl "http://127.0.0.1:2599/sansheng/state" # 200 + 项目/角色 JSON ``` 2026-11-10 实测:`示例项目` 返回三角色、群名、模型 `magpie/auto/deepseek-v4.1-flash`、`roomExists:true`。 临时实例上唯一的告警是 task-board 的 ledger 被桌面端占用(单实例不会出现)。