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

41 lines
2.2 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.

# P5 · 右栏三角色卡片(方案 A:零上游补丁)
状态:**已实现,宿主已识别 `sansheng/client.js`(临时实例的启动清单里可见),桌面端重启后出现。**
## 交付物
| 文件 | 作用 |
| --- | --- |
| `sansheng/client.js` | 浏览器侧伴侣插件:注册右栏页签 `sansheng-roles`,纵向三张卡片 |
| `sansheng/src/api.js` | 纯函数 `buildStatePayload()`:项目 / 三角色 / 目标 / 预算 / 待核实 |
| `sansheng/src/route.js` | 宿主 `GET /sansheng/state`,只读 JSON |
| `sansheng/package.json` | `exports["./client"]` + `dsh.client{platform:'web'}` |
## 行为
- 入口一:对话头部「角色」按钮 → 打开右栏页签(`betterSidebar.openTab` 优先,退回宿主 `sidebarRight.openTabIn`)。
- 入口二:右栏页签列表里的「三省六部 · 角色」。
- 卡片(上→下):丞相(定目标 · 最终验收)、尚书(调度阶段 · 核查证据)、工部(执行工单 · 提交证据)。
- 名称 · 模型、状态点、当前一句话、细节两行;项目多时顶部可切换。
- 状态色:灰=待命、蓝=进行、绿=完成、红=待核实/返工、橙=等待丞相验收。
- 数据每 4 秒轮询 `/sansheng/state`,与工具读同一份真相;页面不自己算状态。
- 宽度拖动、收起、全屏、深色、`<768px` 自动全屏都由宿主右栏提供,插件不自绘。
## 限制(选 B 的条件)
- 右栏页签是**会话级**的,切换会话后需要重开;`keepMounted: true` 保留内容但宿主仍按会话渲染。
- DS Bot 页面自绘右抽屉,与宿主右栏互斥(后开者占位)。若"常驻三卡"体验不足,才启用 M-04:
给固定 SHA 的 `ds-bot` 补丁,在 `conversation` 组加一个常驻 cell。当前不做。
## 验证
1. 重启 DSH,打开任意会话,点右上「角色」。
2. 右栏出现三张卡片;`示例项目` 显示丞相 / 尚书 / 工部与模型。
3. 切到 DS Bot 页面再回来,卡片仍在(会话级重建)。
4. 窄窗口(<768px)时右栏自动全屏,Esc 退出。
## 不变量
- 不改 better-sidebar,不 shadow `sidebar.workspaces` 项目树。
- 页面只读:所有写操作仍走工具与同一套服务端校验。