73 lines
4.0 KiB
Markdown
73 lines
4.0 KiB
Markdown
# 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
|
||
|
||
# 关键:pnpm 的 link 依赖不会安装被链接包自己的 dependencies。
|
||
# 不装这一步,ds-bot 会报 "Cannot find package 'deep-view'",整条 bundle 激活失败。
|
||
cd vendor/ds-bot
|
||
node <pnpm.mjs> install --prod --ignore-scripts --config.auto-install-peers=false
|
||
```
|
||
|
||
- `sansheng` 已被运行中的宿主热加载,四个工具可直接调用。
|
||
- `vendor/ds-bot` 已写入 profile 依赖与 bundles;`dsbot-runtime` 服务需**重启 DSH** 后才可用(未重启时 `sansheng_provision` 会明确报“没有找到 DS-Bot 运行时”)。
|
||
- **M-02**:上游补丁会关闭 DSH 原生设置页(`ui-settings-general`),改由 DS Bot 在 Bot 页面里绘制;新装还没有 Bot 时侧栏就没有任何设置入口。`vendor/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. 两个项目各建一套三角色,确认模型与会话互不影响。
|
||
|
||
## 单测
|
||
|
||
```bash
|
||
cd sansheng && node --test --test-isolation=none test/*.test.js
|
||
```
|
||
|
||
当前 22/22 通过。
|