dsh-sansheng-liubu/docs/p1/README.md

66 lines
3.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.

# 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 个纯逻辑测试 |
## 角色与门禁(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:报“目标校验失败……本次修改未执行”。
## 安装与重启
```bash
# 已执行(profile: desktop)
dsh plugin --profile desktop add C:/Users/qyh15/三省六部/sansheng
dsh plugin --profile desktop add C:/Users/qyh15/三省六部/vendor/ds-bot
```
- `sansheng` 已被运行中的宿主热加载,四个工具可直接调用。
- `vendor/ds-bot` 已写入 profile 依赖与 bundles;`dsbot-runtime` 服务需**重启 DSH** 后才可用(未重启时 `sansheng_provision` 会明确报“没有找到 DS-Bot 运行时”)。
- 重启影响:DS-Bot 页面出现;`ui-settings-general` 被其补丁禁用;`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. 两个项目各建一套三角色,确认模型与会话互不影响。
## 单测
```bash
cd sansheng && node --test --test-isolation=none test/*.test.js
```
当前 22/22 通过。