80 lines
4.6 KiB
Markdown
80 lines
4.6 KiB
Markdown
# 三省六部
|
||
|
||
> 2026-11-10 收敛:只保留两个子包——`sansheng/`(治理插件)与 `ds-bot/`(团队底座)。
|
||
> 旧方案(「上朝」preset、右侧十席面板、独立工作台 v0.1)已删除,历史仍在 Git 里(`git log --all`)。
|
||
|
||
## 结构
|
||
|
||
| 目录 | 包名 | 作用 |
|
||
|---|---|---|
|
||
| `sansheng/` | `dsh-sansheng-sansheng` | 三角色(丞相 / 尚书 / 工部)绑定、目标门禁、审查与派发记录、右栏三卡 |
|
||
| `ds-bot/` | `ds-bot` | 长驻 Bot 团队、Bot 间消息与群聊(Fei2411/DS-Bot 的 vendored 副本,本地改动见 `ds-bot/PATCHES.md`) |
|
||
| `docs/` | — | [DSBot 开发方案](docs/DSBot-三省六部开发方案.md) 与 P0 / P1 / P2–P4 / P5 证据 |
|
||
|
||
## 能做什么
|
||
|
||
| 入口 | 说明 |
|
||
| --- | --- |
|
||
| 项目树 / 入口 | 左栏沿用宿主项目树;底部「三省」打开右栏工作台;右栏提供「Bot 切换」折叠列表,不把 Bot 列表塞进左栏 |
|
||
| 右栏「角色」页签 | 当前项目的丞相 / 尚书 / 工部三张卡片;点击角色打开真实会话;配置、历史审查与 Bot 切换默认折叠 |
|
||
| `sansheng_provision` | 创建项目:三 Bot + 项目群(尚书是管理员);默认名重名时自动加项目后缀,保证全局唯一 |
|
||
| `sansheng_bind` | 把已有群绑成项目(校验三角色齐全、管理员是尚书、Bot/群唯一) |
|
||
| `sansheng_status` | 项目、群、角色、模型、目标阶段、返工预算、写租约、成果代次、待核实派发 |
|
||
| `sansheng_review` | 尚书记阶段通过/驳回,丞相记目标验收;自动生成并绑定成果快照,最新判决与摘要/代次不一致即失效 |
|
||
| `sansheng_submit` | 提交成果快照(Git / 非 Git manifest),推进提交代次 |
|
||
| `sansheng_config` | 只改本项目的模型/返工预算/自动返工/交付范围;角色卡也可直接切换模型 |
|
||
| `sansheng_control` | 用户暂停/恢复/停止/取消目标 |
|
||
| `sansheng_lease` | 项目写租约 + 真实写入口按工作根独占(同根串行) |
|
||
| `sansheng_reconcile` | 重启后核对"结果未知"的派发(不重发、不假装成功) |
|
||
|
||
`group_goal` 仍是阶段进度的唯一权威;尚书是唯一操作者,丞相只验收,工部只执行。项目隔离由服务端治理服务 `sansheng-governance` 落到 ds-bot 的投递与记忆边界,不只靠提示词。
|
||
|
||
2026-11-14 审查修复:Q01–Q12 的状态/schema、治理故障拒绝、unknown 权限、记忆群域、派发先记账、事务草稿、成果完整性、真实写根租约、核实项目一致性、draft/start 分类、模型配置原子性、跨项目缓存已补回归;仍未做真实模型 E2E,见 `docs/verification/02-test-matrix.md`。
|
||
|
||
根目录 `package.json` 只是工作区清单(`workspaces: sansheng, ds-bot`),本身不是 DSH 插件,也不进 `dsh.profile.bundles`。
|
||
|
||
## 装进 DSH
|
||
|
||
两个子包都以 `link:` 依赖挂进 `~/.dsh/profiles/desktop`,并写进 `dsh.profile.bundles`:
|
||
|
||
```json
|
||
"ds-bot": "link:C:/Users/qyh15/三省六部/ds-bot",
|
||
"dsh-sansheng-sansheng": "link:C:/Users/qyh15/三省六部/sansheng"
|
||
```
|
||
|
||
```json
|
||
"bundles": [ ..., "dsh-sansheng-sansheng", "ds-bot" ]
|
||
```
|
||
|
||
改完 profile 必须彻底重启 DSH 才生效。
|
||
|
||
## 验证
|
||
|
||
```sh
|
||
node --test --test-isolation=none sansheng/test/*.test.js # 144 tests
|
||
node --check sansheng/client.js && node --check sansheng/index.js
|
||
```
|
||
|
||
Node >= 22。测试覆盖:门禁最新判决、成果快照、项目隔离、派发幂等/恢复、状态投影、客户端注册与渲染、provision 流程。
|
||
|
||
WP0–WP7 的实施与验收状态见 [docs/verification/00-baseline.md](docs/verification/00-baseline.md)、[01-contracts.md](docs/verification/01-contracts.md)、[02-test-matrix.md](docs/verification/02-test-matrix.md)、[03-host-smoke.md](docs/verification/03-host-smoke.md)。当前是**候选版本**:隔离测试 profile 已验证真实宿主加载、右栏入口、初始化项目和角色会话;真实模型 E2E 与日常 profile 升级未执行。
|
||
|
||
重启后自检:
|
||
|
||
1. `sansheng_status()` 能列出「示例项目」三角色与模型。
|
||
2. 对话右上「角色」→ 右栏三张卡片。
|
||
3. `curl http://127.0.0.1:<port>/sansheng/state` 返回项目 JSON。
|
||
|
||
## 历史
|
||
|
||
- 第一代(11-07 ~ 11-09):`dsh-sansheng-liubu-mode`(上朝 Agent Preset)+ `dsh-sansheng-liubu-panel`(右侧十席面板)。
|
||
- 第二代(11-10 上午):`dsh-sansheng-liubu-workbench`(自建数据层 / Host 服务 / HTTP / 前端的独立工作台 v0.1),同日 12:19 被 DS Bot 方案取代。
|
||
- 当前(11-10 起):`ds-bot` + `sansheng`。
|
||
|
||
删除的内容都能从 Git 取回,例如:
|
||
|
||
```sh
|
||
git log --all --oneline -- panel
|
||
git show <sha>:panel/lib/client.js
|
||
```
|