dsh-multi-session

在一个会话里同时看住所有会话：总览面板 + 并排对话流 + 直接发消息。

DSH 原生只给你当前这一个会话的界面。开了五六个会话并行跑的时候，谁跑完了、谁卡住了、 另一个会话到底在干什么，都得一个个点开看。这个插件把这几个动作搬进同一个视图里。

_{左边是总览：待查看、会话数，按工作区归组，每张卡片带状态点、轮数、子代理数、token 与模型，底部是 + 并排看 / 打开。右边钉住两列，每列直接显示该会话「我 ↔ 助手」的对话正文（左侧助手、右侧是你，一眼分得清谁在说话），每条消息旁边有「转发」，底部输入框可以直接往里发消息。}

它解决什么

痛点	这个插件
想知道别的会话在聊什么，得点开再点回来	点卡片上的 + 并排看 钉住最多 3 个会话，并排看它们的对话正文（渲染成 Markdown）
分不清哪些在跑、哪些在等我	面板按「运行中 → 刚完成 → 其余」排序，带状态点、轮数、token、模型、相对时间；卡在等你回话的会标出琥珀色的「等你回话 / 等你批准」
会话一大堆，找不到	按工作区（cwd）分组，子代理会话与归档会话默认折叠、可单独打开；顶部搜索框跨全部会话全文搜索，不激活会话、不烧 token
不想点开就想知道结果	运行中/刚完成的卡片直接显示该会话最后一句助手结论
不知道它到底干完没有	卡片显示这一轮改了什么文件：几个文件、增删多少行、头几个文件名
切来切去只为说一句话	并排列底部就是输入框，直接给那个会话发消息或打断它
想把一段结论给另一个会话	消息旁边的「转发」按钮，选个目标会话就发过去，省掉复制粘贴再切换

界面在哪

• 「多会话」页签：任意会话顶部视图切换条里，点进去是总览面板。
• 钉住并排：卡片底部有 + 并排看 按钮（已钉住时变 − 移出并排），最多钉 3 个。整张卡片本身不可点击， 不会再有"想点按钮结果跳走了会话"的误触；要跳转请点同一个动作行里的 打开。 钉住的选择存 localStorage，关掉面板再回来还在。
• 并排输入框：每列底部一个输入框，Enter 发送（排进收件箱，不打断当前回合），Shift+Enter 插话（立刻打断当前回合）；运行中的列另有「停止」按钮。

架构

Host 半边和 Client 半边各管一段，边界很清晰：

┌─────────────────── Client（浏览器） ────────────────────┐
│  conversation.view         ── MultiSessionPanel（列表 / 并排）│
│  session.header.actions    ── ActiveSessionProbe（记录当前会话）│
│  shell.overlay（仅 dev）    ── DiagOverlay（诊断层）          │
│                                                          │
│  数据：插槽 standardProps 的 useWorkspaces / useSessions  │
│  对话：fetch /plugins/dsh-multi-session/digest            │
│  操控：fetch /plugins/dsh-multi-session/prompt            │
│  搜索：fetch /plugins/dsh-multi-session/search            │
└──────────────────────────┬───────────────────────────────┘
                           │ HTTP（同源，带 cookie，过 connection gate）
┌──────────────────────────┴───────────────────────────────┐
│  Host（index.js）                                        │
│  /digest  ── sessionQuery.observeSession → foldDigest     │
│              + workspaceChanges.summary（改了什么文件）   │
│  /prompt  ── sessionController.prompt / .cancel           │
│  /search  ── sessionController.search，索引禁用时扫日志   │
│  /report  ── 客户端异常落盘（仅诊断用）                     │
│  /probe   ── 仅 dev：开发期探针                            │
│  /stamp /reload ── 仅 dev：发布新 bundle + 页面自动重载     │
└──────────────────────────────────────────────────────────┘

为什么对话流必须走 Host

客户端 ctx.get('sessions').retain() 能拿到 SessionBinding，readiness 也 resolved， 但 eventSource.snapshot.entries 永远是 0 条——客户端事件窗只对「正被会话视图打开」 的那个会话填充。所以想看任意会话的对话，只能由 Host 读事件再喂给客户端。

为什么取数用 observeSession

同样读一个 139 轮 / 33513 事件的历史会话：

路径	运行中会话	历史会话	说明
sessionQuery.observeSession	5ms	72–318ms	直接给内存/已备好的事件快照，不做 replay 校验
sessionQuery.readSurface	246–1028ms	2281–6176ms	只给当前模型面，慢在 replay 校验
sessionQuery.readSession	—	5658–5740ms	完整日志 + 校验，最慢
listEvents + 逐条 readEvent	—	每次 readEvent ≈ 1920ms	完全不可用

observeSession 拿不到事件时自动退回 readSurface，响应里的 source 字段说明走了哪条路 （live / prepared / surface）。

注意：折叠完必须 lease.dispose()，不要 lease.retain()——后者会让会话被插件长期持有。

为什么只显示你和 AI 的对话

DSH 把运行时上下文、时间戳、技能目录变更、压缩摘要等都以 user/message 事件存进日志。 Host 侧 foldDigest 做三层过滤后才进面板：

• tool/call、tool/result 完全不搬（工具调用和输出对「看清这段聊了什么」是噪音）；
• <system-reminder> 整段剥掉；
• 以 Current runtime context / Time sampled while / The available skill catalog changed / [Compressed conversation section] / Browser time zone for this request 等开头的注入消息整条丢弃。

客户端 renderDigestItem 再兜一层：类型不是 user / assistant 的一律不渲染。

为什么气泡一左一右

早期把两侧都靠左、只加个左边框，实际看下来很难一眼分清谁说的——尤其连续几轮长文之后。 现在：助手靠左（浅灰气泡、左下角圆角收）、你靠右（品牌蓝底、右下角圆角收）， 每条消息上方一个小药丸标「我」或「助手」。正文走一个自写的极简 Markdown 渲染器 （标题 / 粗体 / 斜体 / 行内代码 / 代码围栏 / 列表 / 表格 / 引用 / 链接）， 全程用 React 元素构造，不拼 HTML 字符串、不用 dangerouslySetInnerHTML—— 会话内容里的任何标签都只会被当成文字显示。

为什么「在等你」值得单独做

会话卡在等你回话时，running 仍然是 true。光看「运行中」，它可能在空转十几分钟， 你却以为它在干活——这比「跑完了不知道」更浪费时间。判定只看两个信号： 未决的 approval/asked（没有对应的 approval/decided）、未返回的 ask_user_question （有 tool/call 没有 tool/result）。刻意不做超时猜测，慢工具不会被误报成卡住。

数据从哪来（客户端）

需要的东西	来源
running / cwd / parentId / updatedAt / projectionValues	props.useSessions(identity) 的 SessionMeta
工作区分组 / 归档会话	props.useWorkspaces(identity)
「当前是哪个会话」	conversation.session.header.actions 插槽收到的 props.sessionId

注意 running / cwd / parentId 只在 useSessions 里，useWorkspaces 没有运行态； 也没有 running 的类型定义暗示它在工作区快照里（这条曾经害我写错两版）。

selector 必须是模块级稳定引用（const identity = (state) => state），否则每帧重订阅。

路由

路由	方法	说明
/plugins/dsh-multi-session/digest	GET	?sessionId=&limit=&live=1&fresh=1&mode= → {ok, ms, source, turns, endReason, waiting, changes, items}
/plugins/dsh-multi-session/search	GET	?q=&sessions=id1,id2 → {ok, ms, query, via, hasMore, items:[{sessionId, snippet, count, hits}]}。优先走 sessionController.search（不激活会话）；索引被禁用时退化为读磁盘日志扫描 sessions 点名的那些会话
/plugins/dsh-multi-session/prompt	POST	{sessionId, text, mode:'queue'|'steer'} 发消息；{sessionId, action:'cancel'} 停止
/plugins/dsh-multi-session/report	GET/POST	客户端异常上报，落盘到系统临时目录（保留最近 40 条）
/plugins/dsh-multi-session/probe	GET/POST	仅 dev：开发期探针
/plugins/dsh-multi-session/stamp	GET	仅 dev：发布新 bundle 并回 {rev}，供页面自动重载轮询比对
/plugins/dsh-multi-session/reload	GET	仅 dev：手动触发一次 bundle 重发布（只放行 loopback）

所有业务路由都过 connection.requestRejection(req) 鉴权闸门（缺失 → 503，未授权 → 401/403）。 curl 直接请求会得到 {"error":"unauthorized"}，这是正常的——只有浏览器同源 fetch 带 cookie 才过。

digest 的 Host 侧缓存：键 v5:${mode}:${live?'live':'idle'}:${sessionId}:${limit}， live=1 用 800ms TTL、空闲用 60 秒，fresh=1 绕过缓存，最多 200 条。 live 必须进键——否则会话刚跑完那一刻，空闲请求会命中「助手最后一句话还没写进去」的旧 payload。

安装

从市场装，或本地装：

plugin_manager action=install_bundle target=<插件目录或包名>

开发

开发期设施（诊断探针、/stamp、/reload、页面自动重载、客户端 __internals 测试出口） 默认关闭。打开方式二选一：

• 插件配置 dev: true（在 profile 的 patch 里给本插件加这一项）；
• 或环境变量 DSH_MULTI_SESSION_DEV=1（改完要重启 DSH 才生效）。

打开后 Host 会在 index.html 注入 window.__DSH_MULTI_SESSION_DEV__ = true， 客户端据此启用诊断层。

• 改 client.js：link: 依赖是实时的，文件一变 clientModules.rebuilt() 就发布新 bundle， index.html 里注入的轮询（每 2 秒比一次 /stamp 的 rev）会让页面自动重载（需 dev 打开）。

• 改 index.js（Host）：ESM 模块缓存不会自动失效，必须让 Host 重新 import 一次。 实测唯一可靠的手段是把 bundle 关一次再开：

  plugin_manager action=set_bundle target=dsh-multi-session enabled=false
  plugin_manager action=set_bundle target=dsh-multi-session enabled=true
  

  （remove_bundle 对本插件返回 not-removable；set_plugin 不接受 include: 前缀的 entryId。） 装完页面不会自动重载，得手动刷新。

• 语法自检：node --check index.js、node --check client.js。

• 图标两套：icon.svg（界面内用）与 icon.png 512×512 位图（市场收录要求位图，SVG 会被拒）。

• 截图 assets/screenshot-board.jpg 由 screenshots.json 声明，市场详情页与本站页面都会展示。

已知限制

• 并排最多 3 列，每列默认最近 20 条（可点「载入更早」按 20 递增，Host 上限 600）。
• 单条正文上限：用户 1500 字、助手 3000 字——为了轮询载荷（约 28–38KB）。
• 运行中每 1.2 秒刷新一次；停下后降频到 8 秒继续跟（不会停），避免刚跑完那一刻停在旧结果上。
• 子代理会话默认折叠（实测 761 个会话里 639 个是子代理，全放出来会淹没面板）。
• 冷启动补标是启发式的：空闲会话若只是被改名（updatedAt 前移），也可能被误标成「待查看」。
• 「在等你」靠事件流推断（未决 approval/asked、未返回的 ask_user_question），不做超时猜测 —— 慢工具不会被误报成卡住。
• 「改了什么文件」依赖 workspaceChanges.summary()，只有该轮真有 workspace/changes 事件才有数据；纯对话的轮次不显示。
• 跨会话搜索优先走 sessionController.search（只能搜到"可见"的会话正文）；如果部署把 session-query 索引配成 openAt: "never"，会自动退化为直接读磁盘会话日志再扫——此时只扫面板里看得到的会话（最多 40 个），每个约 60ms，所以整体要 2–3 秒，面板上会显示扫了几个、用了多久。
• 会话间传话固定用 queue（排进对方收件箱），不提供打断式转发 —— 传话语义是补充信息，不是抢占。
• 纯 Web 插件，页面关掉就看不到任何东西；要关页面也收得到得另接 webhook。

License

MIT