dsh-sansheng-liubu/README.md

80 lines
4.6 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.

# 三省六部
> 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
```