3.8 KiB
3.8 KiB
P2–P4 · 门禁之后的证据、返工与恢复
状态:代码与单测完成(56 项),宿主侧已在临时实例上跑通 /sansheng/state;桌面端需重启后生效。
P2 · 完整开发闭环:门禁 + 派发回执
| 文件 | 作用 |
|---|---|
sansheng/src/gate.js |
纯函数:角色、证据版本、返工预算、完成条件。预算取「原生阶段 reworks 累计」与「本地返工记录数」的较大值,revise 重建阶段清零点数也绕不过去 |
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 环绕钩子:先记录意图,再调用原生工具,最后写回执 |
一次目标动作的顺序:
group_goal被调用,tools.guard先用store.peek()同步校验(角色、当前阶段、同 revision 的审查记录、返工预算)。- 校验通过后才进入工具体;
tools/execute在调用前写入dispatch{status:'intent'}。 - 原生
group_goal改room.goal,revision + 1。 - 钩子写回执:
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 + 独立群 + 角色按绑定重算"。
测试
cd sansheng && npm test # 56 tests
覆盖:角色授权、未绑定放行、跨项目越权、版本过期、重复事件、返工预算、自动派单、重启对账、状态接口、客户端注册。
宿主验证
用临时 profile 起实例(不动桌面端):
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 被桌面端占用(单实例不会出现)。