dsh-sansheng-liubu/docs/p2-p4/README.md

67 lines
4.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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` 环绕钩子:先记录意图,再调用原生工具,最后写回执 |
一次目标动作的顺序:
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 # 56 tests
```
覆盖:角色授权、未绑定放行、跨项目越权、版本过期、重复事件、返工预算、自动派单、重启对账、状态接口、客户端注册。
## 宿主验证
用临时 profile 起实例(不动桌面端):
```sh
# dsh 不在 PATH 里,用桌面应用自带的 CLI(ELECTRON_RUN_AS_NODE,无窗口)
DSH="/c/Users/qyh15/AppData/Local/Programs/DeepSeek Harness/resources/runtime/cli/bin/dsh.cmd"
mkdir -p ~/.dsh/profiles/dbg
cp ~/.dsh/profiles/desktop/{package.json,cordis.patch.yml,cordis.yml,pnpm-workspace.yaml} ~/.dsh/profiles/dbg/
cmd //c mklink //J "$(cygpath -w ~/.dsh/profiles/dbg/node_modules)" "$(cygpath -w ~/.dsh/profiles/desktop/node_modules)"
cmd //c "$DSH" --profile dbg --port 2599 --no-open
curl "http://127.0.0.1:2599/sansheng/state" # 200 + 项目/角色 JSON
```
客户端侧用无头 Chrome 抓 console(`playwright-core` 可从 `ds-bot` 的依赖里 `createRequire`),关注 `entry did not activate` 与各插件告警。用完删掉临时 profile 的 junction 与文件,桌面 profile 不受影响。
2026-11-10 实测:`示例项目` 返回三角色、群名、模型 `magpie/auto/deepseek-v4.1-flash`、`roomExists:true`。
临时实例上唯一的告警是 task-board 的 ledger 被桌面端占用(单实例不会出现)。