dsh-sansheng-liubu/docs/p1
qyh15 d037f1ee57 fix(sansheng): 返工预算与本地记录取大值,revise 清零绕不过累计上限 2026-11-10 17:52:53 +08:00
..
README.md fix(sansheng): 返工预算与本地记录取大值,revise 清零绕不过累计上限 2026-11-10 17:52:53 +08:00

README.md

P1 · 三角色独立工作

状态:代码与单测完成,本机插件已安装;DS-Bot 运行时待重启后验证。

交付物

文件 作用
sansheng/package.json、sansheng/cordis.patch.yml 宿主插件清单,insert sansheng
sansheng/index.js 加载自有状态、只读 DS-Bot 状态,安装门禁与工具
sansheng/src/store.js $DSH_HOME/sansheng/state.json 原子写、项目绑定、审查记录
sansheng/src/dsbot-state.js 只读 $DSH_HOME/bot/state.json,会话 → Bot/群反查
sansheng/src/identity.js 由执行会话解析真实调用者(用户 / Bot / 角色 / 项目)
sansheng/src/gate.js 纯函数角色与证据校验(可单测)
sansheng/src/gates.js 根 ctx.tools.guard,拦截 group_goal 变更
sansheng/src/digest.js 目标/阶段指纹,证据随成果版本失效
sansheng/src/tools.js sansheng_provision / sansheng_bind / sansheng_status / sansheng_review
sansheng/test/*.test.js 22 个纯逻辑测试(P2–P5 后共 56 个,含 provision 流程与客户端渲染)

角色与门禁(P1 已生效)

动作 丞相 lead 尚书 shangshu 工部 gongbu
group_goal draft/start/revise/pause/resume/stop 拒 放行 拒
group_goal task(派工) 拒 放行,目标只能是工部 拒
group_goal pass 拒 放行,需当前阶段 + 同 revision 的 stage_pass 记录 拒
group_goal rework 拒 放行,需同 revision 的 stage_reject 记录,且累计返工 < 预算 拒
group_goal complete 拒 放行,需全部阶段 passed + 同 revision 的 goal_pass(reviewerRole=lead) 拒
sansheng_review stage_* 拒 放行 拒
sansheng_review goal_* 放行 拒 拒
  • 只有绑定过的项目群受门禁约束;未绑定群保持 DS-Bot 原生行为。
  • Main Bot(mainBotIds)对已绑定项目一律拒绝变更。
  • 角色按绑定项目重新计算,跨项目复用的 Bot 不会串权。
  • 门禁内部异常 fail-closed:报“目标校验失败……本次修改未执行”。

安装与重启

# 已执行(profile: desktop)
dsh plugin --profile desktop add C:/Users/qyh15/三省六部/sansheng
dsh plugin --profile desktop add C:/Users/qyh15/三省六部/ds-bot

# 关键:pnpm 的 link 依赖不会安装被链接包自己的 dependencies。
# 不装这一步,ds-bot 会报 "Cannot find package 'deep-view'",整条 bundle 激活失败。
cd ds-bot
node <pnpm.mjs> install --prod --ignore-scripts --config.auto-install-peers=false
  • sansheng 已被运行中的宿主热加载,四个工具可直接调用。
  • ds-bot 已写入 profile 依赖与 bundles;dsbot-runtime 服务需重启 DSH 后才可用(未重启时 sansheng_provision 会明确报“没有找到 DS-Bot 运行时”)。
  • M-02:上游补丁会关闭 DSH 原生设置页(ui-settings-general),改由 DS Bot 在 Bot 页面里绘制;新装还没有 Bot 时侧栏就没有任何设置入口。ds-bot/cordis.patch.yml 已移除这条 disabled,保留原生设置页。
  • 重启影响:DS Bot 页面出现;web 搜索提供方被覆盖为 auto。回退见 docs/p0/README.md。

重启后的验收步骤

  1. sansheng_provision({ project: "示例项目" }) → 三个 Bot + 一个群(尚书为管理员)。
  2. sansheng_status() → 三角色、群、模型、预算齐全。
  3. 在群里以尚书身份试 group_goal 的 start;用工部/丞相身份试改目标,应被拒。
  4. 尚书 sansheng_review(stage_pass) 后 group_goal pass 应通过;未审查时 pass 应被拒且提示缺证据。
  5. 返工:sansheng_review(stage_reject) → group_goal rework 通过;第 4 次累计返工应被预算拒绝。
  6. 丞相 sansheng_review(goal_pass) 后 group_goal complete 通过;无丞相记录时应被拒。
  7. 两个项目各建一套三角色,确认模型与会话互不影响。

单测

cd sansheng && node --test --test-isolation=none test/*.test.js

当前 22/22 通过。