72 lines
6.1 KiB
Markdown
72 lines
6.1 KiB
Markdown
# 三省六部 v0.1 实施状态
|
||
|
||
日期:2026-11-14。对应 [第一版方案](v1-plan.md) 第 7 节实施顺序。以下“已实现”指代码就位并通过 fake ctx 单元测试;
|
||
真实宿主/桌面 App 的接线验收仍需在获得安装授权后另做,本文不把未核验项说成已完成。
|
||
|
||
## 进度总览
|
||
|
||
| 步骤 | 内容 | 状态 |
|
||
|---|---|---|
|
||
| 1 | 对照 Web / dsh-go 两份样式确认第一版范围 | ✅ 已完成(见 v1-plan、preview) |
|
||
| 2 | 项目内身份及十席会话绑定(创建/恢复/失败重试/跨项目隔离) | ✅ fake ctx 测试 + 隔离测试 DSH 真机建席验证 |
|
||
| 3 | Web 导航入口 + 右侧工作台 | ✅ 已在隔离测试 DSH 真机验证(见下) |
|
||
| 4 | dsh-go 原生面板 | 🟡 源码就位,触摸/返回/会话跳转待真机核验 |
|
||
| 5 | 双项目联调、打包发布 | ⬜ 未开始 |
|
||
|
||
## 包结构(`sansheng/`)
|
||
|
||
- `index.js`:宿主入口。`inject=[workspaceRegistry, sessionController, agents, llm, systemPrompt, connection]`;注册动态 `systemPrompt.section` 与 `POST /api/sansheng` 路由。
|
||
- `src/shared/roles.js`:十席固定定义(id/label/duty/responsibility)与布局分组,Web/原生/宿主三端共用。
|
||
- `src/shared/schema.js`:版本 1 项目状态 schema 与严格校验(非法 JSON/错误版本/非十席一律视为损坏)。
|
||
- `src/host/store.js`:单 JSON 原子写、串行 mutate、失败回滚、不静默回退。
|
||
- `src/host/provision.js`:先持久化计划 sessionId 再创建;已存在按原会话恢复不重建;返回 ID 不一致立即停止后续创建并保留记录;失败保留已完成、重试只补未完成。
|
||
- `src/host/model.js`:走 `agent.model.select`(会话级事件),**不调用** `sessionController.selectModel`(不写 profile 全局默认);调用前用 `llm.resolveCallConfig` 校验并复核 Agent 未变。
|
||
- `src/host/prompt.js`:仅对十席会话注入本席角色文本,其它会话返回空串。
|
||
- `src/host/service.js` / `api.js`:项目视图、启用、配置、模型目录与 HTTP 分发。
|
||
- `src/client/`:Web 工作台(纯视图模型 + React 接线 + 传输层 + 白蓝/深色样式)。
|
||
- `src/native/`:dsh-go 原生面板(纯视图树 + bridge 接线,容量/只读/无自由文本约束内建)。
|
||
|
||
## 测试证据
|
||
|
||
```
|
||
cd sansheng && node --test test/*.test.js
|
||
# tests 36 pass 36 fail 0
|
||
```
|
||
|
||
覆盖:十席固定与两字名;状态损坏拒绝;创建十席全部绑定;已存在会话不重建;返回 ID 不一致停止;失败重试只补一个;
|
||
模型只走 agent.model.select(selectModel 调用次数断言为 0);非法模型拒绝;跨项目会话/模型隔离;重启不重复建会话;
|
||
HTTP 处理器端到端;systemPrompt 只注入十席;Web 纯视图模型(十席/未选模型显示“请选择模型”/无 inherit/切换保留草稿);
|
||
原生视图树(≤120 节点、≤8 深度、选项≤8、无自由文本控件、选中高亮);宿主项目视图直接喂给 Web 纯视图模型与原生面板的跨端一致性。
|
||
|
||
## 待真机核验(尚未完成,不能宣称已适配)
|
||
|
||
- Web:左侧 `sidebar.footer.action` 入口、右侧 `sidebarRight` 标签页注册签名、会话导航 API、当前项目权威来源、`POST api/sansheng` 实际挂载。
|
||
- dsh-go:面板入口位置、会话跳转 effect(现有 effect 无 navigation)、由 sessionId 反查项目、原生模型选择持久化、触摸面积与深浅色由宿主渲染。
|
||
- 打包:`client.js` 需 `npm run build`(依赖 esbuild devDependency)生成;当前环境未安装 esbuild,故未产出 `client.js`。
|
||
|
||
## 真实 DSH 真机验收(隔离环境,不触碰日常 DSH)
|
||
|
||
方式:用本机 dsh CLI 在独立 `DSH_HOME=.dsh-test-b` 新建 `sansheng-test` profile(由 web 模板生成),把插件装入该 profile 的 node_modules,起独立 web 服务(127.0.0.1:5988),无头 Edge 经 CDP 驱动。
|
||
|
||
结果(截图 `preview/live-01-entry.png`、`live-02-workbench.png`、`live-03-enabled.png`;脚本 `preview/check-live.mjs` 可复现):
|
||
|
||
- 左侧出现「三省六部」入口(追加型 `sidebar.footer.action`,未替换工作区/项目树)。✅
|
||
- 点击后工作台渲染十席,顺序与两字名正确:丞相/中书/尚书/门下/吏部/户部/礼部/兵部/刑部/工部;丞相居中、三省一排、六部两排。✅
|
||
- 当前项目 default-workspace 正确识别,显示「10 个角色 · 0 个会话」「启用此项目的十席」。✅
|
||
- 点「启用此项目的十席」→ 宿主真实建成 10 个独立 root session:项目 ready、10 席 bound、failed=0、无报错。✅
|
||
- 重启 DSH 进程后重开:仍「10 个角色 · 10 个会话」、无「启用」按钮、10 个会话 ID 互不相同 → 持久化与幂等通过,重启不重复建会话。✅
|
||
- 入口按用户要求移到“新会话”行右侧(`sidebar.session.action`),不再占底部;每个部门卡片统一为与丞相一致的蓝色边框,三省/六部仅保留文字分组标题。✅
|
||
- 新增「全部汇报职责」入口:点开逐条列出十席各自职责;冒烟测试连跑 3 轮,每轮十席 10/10 职责正常汇报、0 console 报错。✅
|
||
- 工作台进入真实右侧 dock(`inDock=true`、非浮动面板),无 console 报错。✅
|
||
- 点角色(工部)→ 真机切到该席独立会话(提示“已切换到工部会话”),无报错。✅
|
||
|
||
真机发现并已修复:客户端 bundle 模块 id 原写 `sansheng`,与包名 `dsh-sansheng` 不一致导致重复注册(duplicate factory)使入口未激活;改为 `dsh-sansheng` 后正常。
|
||
|
||
右侧标签页已按宿主 `sidebarRightTabs.register` 真实契约接通(注册 tab 类型 + 正文/标题 slot,slot key=类型 id),工作台真实进入右侧 dock;此前降级为浮动面板的问题已修复。
|
||
|
||
仍未验证(不能宣称完成):dsh-go 手机 App 原生面板(第 4 步,需真实客户端/设备);运行中改模型即时生效;双真实项目联调;第 5 步打包发布。
|
||
|
||
## 未改动
|
||
|
||
未安装到任何 DSH profile,未修改用户日常 DSH、node_modules 或全局默认模型。
|