dsh-sansheng-liubu/docs/p2-p4
qyh15 3f20f89bd5 docs: 修正临时宿主验证步骤(dsh.cmd 路径、junction、无头 Chrome) 2026-11-10 18:57:54 +08:00
..
README.md docs: 修正临时宿主验证步骤(dsh.cmd 路径、junction、无头 Chrome) 2026-11-10 18:57:54 +08:00

README.md

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 + 独立群 + 角色按绑定重算"。

测试

cd sansheng && npm test        # 56 tests

覆盖:角色授权、未绑定放行、跨项目越权、版本过期、重复事件、返工预算、自动派单、重启对账、状态接口、客户端注册。

宿主验证

用临时 profile 起实例(不动桌面端):

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