dsh-multi-session

dsh plugin --profile web add dsh-multi-session

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 测试出口

…(truncated)