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

5.5 KiB
Raw Blame History

三省六部 v0.1 实施状态

日期:2026-11-14。对应 第一版方案 第 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 或全局默认模型。