dsh-sansheng-liubu/docs/implementation-status.md

68 lines
5.5 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.

# 三省六部 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 互不相同 → 持久化与幂等通过,重启不重复建会话。✅
真机发现并已修复:客户端 bundle 模块 id 原写 `sansheng`,与包名 `dsh-sansheng` 不一致导致重复注册(duplicate factory)使入口未激活;改为 `dsh-sansheng` 后正常。
真机遗留:右侧标签页 API 报 `no tab type is registered as "sansheng-workbench"`,当前自动降级为右侧浮动面板(功能可用);正式对接标签页类型注册需再核验。
仍未验证(不能宣称完成):dsh-go 手机 App 原生面板(第 4 步,需真实客户端/设备);运行中改模型即时生效;双真实项目联调;第 5 步打包发布。
## 未改动
未安装到任何 DSH profile,未修改用户日常 DSH、node_modules 或全局默认模型。