67 lines
4.5 KiB
Markdown
67 lines
4.5 KiB
Markdown
# 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 被桌面端占用(单实例不会出现)。
|