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

3.2 KiB
Raw Blame History

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。当前不做。

宿主实测(2026-11-10,临时 profile:2599)

在不动桌面 profile 的前提下,用复制出来的 dbg profile 起了一个真宿主,验证了三件事:

  1. GET /sansheng/state → 200,返回「示例项目」的三角色、群名、模型与 roomExists:true(服务端路由注册成功)。
  2. 首页 __DSH_BOOT__ 的 entries 里有本插件: {"id":"dsh-sansheng-sansheng","url":"plugins/??dsh-sansheng-sansheng/client.js&rev=…","inject":["@deepseek-ai/dsh-client-ui-conversation","@deepseek-ai/dsh-client-ui-primitives"]} —— 说明 package.json 的 dsh.client + exports["./client"] 被宿主正确识别。
  3. 用同一 URL 取客户端 bundle → 200 / 12645 字节,内容含 ss-empty、dsh.sansheng.activeProject 等本插件标识,证明宿主确实把这个文件发给浏览器(不是只有清单条目)。

临时实例已关闭并删除;desktop profile 复核仍为 38 个 bundle、909 行 / 45 个补丁块、bili 门禁启用,node_modules 398 项未动。

验证

  1. 重启 DSH,打开任意会话,点右上「角色」。
  2. 右栏出现三张卡片;示例项目 显示丞相 / 尚书 / 工部与模型。
  3. 切到 DS Bot 页面再回来,卡片仍在(会话级重建)。
  4. 窄窗口(<768px)时右栏自动全屏,Esc 退出。

不变量

  • 不改 better-sidebar,不 shadow sidebar.workspaces 项目树。
  • 页面只读:所有写操作仍走工具与同一套服务端校验。