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

8.4 KiB
Raw Permalink 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 互不相同 → 持久化与幂等通过,重启不重复建会话。✅
  • 入口按用户要求移到“新会话”行右侧(sidebar.session.action),不再占底部;每个部门卡片统一为与丞相一致的蓝色边框,三省/六部仅保留文字分组标题。✅
  • 新增「全部汇报职责」入口:点开逐条列出十席各自职责与所用模型;冒烟测试连跑 3 轮,每轮十席 10/10 正常汇报、0 console 报错。✅
  • 每席模型独立显示:演示中礼部配置为 gemini 3.8flash(本机无该模型路由,仅配置展示、不可真跑),其余九席为 deepseek-v4.1-flash。✅
  • 工作台进入真实右侧 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 实测(1440 宽、整页重载、并已对每席 rename 标题):

  • 会话确实创建并注册:DSH_HOME/sessions/<默认工作区路径哈希>/<会话ID>/session.v4.jsonl.zstd;storages/workspace.json 的 sessionIds 里十席齐全。
  • 但左侧“工作区 / 默认工作区”列表不显示这些会话(DOM 中带 data-session-id 的元素数 = 0),给会话写标题也无济于事。
  • 源码级根因(@deepseek-ai/dsh-client-ui-workspace):工作区会话树用 orderByRecency(sessionIds, summaries) 渲染,没有 summaries[id] 的会话被直接跳过;极简 web 侧栏只出现了当前被 retained 的一条(工部),其余 9 个冷会话没有被同步进客户端 session summaries。
  • 已尝试并无效:给每席会话 resolveAgent 预热 + rename 写标题,仍不进该极简侧栏(data-row-key^=session: 仍只有 1 条)。这说明是客户端 session 列表同步层面的问题,不是简单建会话就能解决。
  • 判断:日常桌面版的侧栏更完整(含 better-sidebar 等),很可能能正常列出;极简 web 测试 profile 的侧栏只是“当前会话”。真正验收应到桌面版(C)。
  • 另:真实对话内容还需模型;隔离环境无可用模型路由(gemini 不存在,deepseek-v4.1-flash 仅属于当前会话进程)。

未改动

未安装到任何 DSH profile,未修改用户日常 DSH、node_modules 或全局默认模型。

v0.1.2(2026-11-17):旧数据兼容与侧栏入口

  • 旧格式 v2/v3 自动迁移到 v1:三角色会话直搬、其余七席 pending、旧业务记录存 legacy、leases 只存档;失败不覆盖原文件;重复加载幂等。
  • 错误分型:state-json / state-unsupported / state-corrupt / state-migrate-failed,只有可重试错误显示重试。
  • 左侧入口从 sidebar.session.action 移到 sidebar.panellist(order 32,记忆系统与“更多”之间),点击只开右侧工作台,中央聊天不被接管。
  • 测试 41 项全通过;client.js 已重建。
  • 未完成:隔离环境真实界面截图、v0.1.2 发布与市场索引、用户本地安装。