联合视图（dsh-union-view）
> 把好几个对话并排摊在屏幕上一起看；需要的话，还能把它们的历史装进一个新对话接着聊。
当前版本 0.4.0 · 更新记录 · MIT
先说这东西解决什么
假设你最近在干一件事，但聊得很散：
- 上周定需求，在 A 对话里
- 中间反复试错，在 B 对话里
- 最后结论和踩过的坑，记在 C 对话里
现在你想回顾整件事。怎么办？点开 A 翻一遍，退出来，点开 B 翻一遍，退出来，点开 C 翻一遍。翻到 C 的时候，A 里说的什么已经忘了一半。
联合视图就是为这个做的：勾上 A、B、C，三份对话同时摊在同一个屏幕上，左右对照着看。
┌ 对话 GAL视窗 [联合视图] 轨迹 ┐
│ 联合视图 3 个会话 · 1500 条消息 · 只读 │
│ ─── 定需求 ───┬─── 试错 ───┬─── 结论 ─── │
│ 你 14:02 │ AI 15:31 │ AI 23:44 │
│ 我想做… │ 报错了：… │ 所以最终… │
└───────────────┴────────────┴─────────────┘
三种摆法
浏览器里点一下就能换，随时切：
| 摆法 | 什么时候用 |
|---|---|
| 时间线 | 想知道"当时到底先发生什么、后发生什么" |
| 分栏 | 想知道"同一时间，两边各自在干嘛" |
| 轮次对齐 | 想知道"同一个问题，两边分别怎么回答的" |
最重要的一件事：它只是"看"
用联合视图的时候，它只读不写：
- 原对话里一个字都不会被改
- 不会把几份对话合并、搬来搬去
- AI 完全不知道你在这么看 —— 就像你把三份打印稿摊在桌上比对，桌上那台电脑（AI）并不知道
所以它很安全，随便试：看完关掉，世界和之前一模一样。
消息太多时它也不会卡死——每个视角只摆最近一段，上面会提示"更早的 N 条已折叠"。
它只显示你和 AI 说的话
对话记录里其实混着三种你不关心的东西，联合视图全部滤掉：
| 滤掉的 | 长什么样 | 为什么要滤 |
|---|---|---|
| AI 的思考过程 | 一大段"我需要先……所以我打算……" | 又长又碎，把真正的结论淹了 |
| 工具调用 | [调用 read_image]、[调用 pwsh] |
一行一条，几十条连着刷屏 |
| 系统注入 | Time sampled while preparing turn 12…、`、Current working directory…` |
这些是宿主塞给 AI 的，不是你说的话，混在你的对话框里看着莫名其妙 |
所以一屏看下去只剩干净的对话。代价是：如果那个对话里 AI 光在调工具没怎么说话，会显得内容很少——它本来就没说几句话。
如果你想让 AI 真的看见：/weld
> 会写东西的一步。落在你自己机器上：新建一个对话，原对话只读。只是并排看的话不需要它。
上面说了，联合视图 AI 是看不见的。要让它真的看见，用 /weld。
最省事的用法：在联合视图里勾几个对话，工具栏右边填「每个取最近 N 轮」，点「合并为新会话」。它替你把这些填进输入框并提交，下面那行提示写着结果。等一两秒，左边对话列表最上面会多出一个「未命名」，点开就是合并好的新对话。
也可以手打：
/weld 3f2a1b 9c8d7e --turns 20
（3f2a1b、9c8d7e 是两个对话的编号前缀，--turns 20 表示每个对话只取最近 20 轮）
不打参数直接 /weld 回车，会列出最近 12 个对话的编号、时间和第一句话，照着抄就行。
它会真的造出一个新对话，把这两个对话的历史装进去。这个新对话：
- 出现在你的对话列表里，点开就能看
- 可以接着聊 —— 这时候 AI 是真的看得见这些历史了
- 原对话一个字没改（只是被读了一遍）
- 思考过程和工具调用也不带进去，只装你和 AI 说过的话
✅ 现在这条路是通的：dsh 打开新对话时会校验日志结构，所以新对话不再由我们拼，而是先建一个空对话、把合并好的内容一条条交给 dsh 自己写进去 —— 结构天然合法。视图那部分一直是稳的。
打个比方：
| 联合视图 | /weld |
|
|---|---|---|
| 类比 | 把几份文件摊在桌上，自己比对 | 把几份文件装订成一本新的，递给 AI |
| AI 看得见吗 | 看不见 | 看得见 |
| 会多出一个对话吗 | 不会 | 会 |
| 原对话会变吗 | 不会 | 不会 |
为什么一定要 --turns：两个几百条消息的对话，加起来一万多条，AI 一次吃不下。所以必须截断，只取最近若干轮。
新对话的标题会显示「未命名」，因为原来的标题带引用关系，截断后对不上，干脆不要了。改个名字就行。
新对话里到底装了什么
只有你和 AI 说过的话。剥掉的是这四类：
| 剥掉的 | 为什么 |
|---|---|
| AI 的思考过程 | 又长又碎，而且它本来就不该算"说过的话"。内容块和 data.stream 里的逐 token 回放都要剥，漏一处就会从重建的节点里冒回来 |
| 工具调用与工具结果 | [调用 read_image] 这类记录，几十条连着刷屏，对接着聊没有价值 |
| 图片卸载、上下文压缩 | 这些是原对话的窗口管理动作，引用已经指向不存在的位置，带过去会让日志校验失败 |
| 会话开头重复的初始化事件 | 每个源都有一份，装几份进去结构就乱了 |
代价：如果某个源对话里 AI 光在调工具、没怎么说话，装进新对话的内容就会很少——原文本来如此，不是丢数据。
怎么知道对话的编号
通常在联合视图里点按钮就够了，不用记编号。真要手打，/weld 不带参数回车会列出来；也可以去 .dsh/sessions/ 目录下看，每个对话是一个以 session- 开头的文件夹，文件夹名就是编号。
安装
用插件管理器：
dsh plugin install dsh-union-view
装完重启 DSH Web（或刷新页面），对话页面的标签栏会多出一个「联合视图」。
从源码装
pnpm 用不了的时候走这条路：
node scripts/build-client.mjs # 把界面代码打包成 .dsh-plugin/client.js
node scripts/install-local.mjs # 装进 DSH
第二行脚本做三件事：把整个项目复制到 ~/.dsh/plugins/dsh-union-view、在 DSH 的 node_modules 里建一个目录联接（不需要管理员权限）、把插件名登记进配置。会先备份配置文件，可以反复跑。
用法
- 打开任意对话，点顶部的「联合视图」标签
- 点「选择会话」，勾上你想看的对话（可以多选，下次会自动记住）
- 换摆法看
- 「系统事件」开关：打开后能看到更细的过程（工具调用、轮次边界），平时关着更清爽
它不做什么
列清楚，免得误会：
- 不能在里面发消息：它是只读窗口。要接着聊，切回原对话，或者用
/weld造一个新对话 - 不会自动更新：新开的对话不会自己冒出来，点一下「刷新」
- 不显示思考过程：只显示你和 AI 的正式发言，AI 的推理过程不带
- 看不到已折叠的历史：如果某个对话之前被压缩过（上下文太长时 DSH 会折叠旧内容），联合视图看到的也是折叠后的样子
- 不做对比和评分：它只是并排显示，不计算差异、不判断谁对谁错
给想改代码的人
展开技术细节
界面部分怎么挂上去
注册在 DSH 的 conversation.view 槽位（id: 'union'，order: 6），和官方 gal-view 是同一个位置。
关键点：src/client.js 里必须写
export const inject = ['slots', 'sessions', 'uiConversation']
少写一个，DSH 就不会把对应服务挂到插件身上，ctx.sessions 永远是 undefined（插件会显示"宿主未暴露 sessions 服务"）。package.json 里的 dsh.client.inject: ["slots"] 只负责让界面代码被加载，两回事。
数据从哪来
const ref = ctx.sessions.retain(sessionId, { source: 'unionView' })
await ref.ready
const chat = ctx.uiConversation.binding(ref.binding).target('chat')
const nodes = chat.getSnapshot().legacy.nodes // 对话节点数组
纯客户端读取，只用 retain 的引用计数，不调 activate、不 prompt、不 fork。
怎么铺满整个对话区
根节点加 data-union-view，useEffect 往上找第一个 position !== 'static' 的祖先（实测是 .wSkVaW_body），给它加上 data-union-fill，定位规则写在注入的 CSS 里。
踩过的坑：定位一定要写在 CSS 里，不能写内联 style——内联的 position: relative 会盖掉 CSS 里的 absolute，面板会按内容高度一路涨到十几万像素。
/weld 怎么写入新对话
DSH 有个 ctx.sessions.create()，但它只准备内存里的会话对象，不落盘、不进侧栏账本（源码注释写得很直白：persistence is a plugin concern）。
手写日志这条路走不通：宿主对从磁盘读回的日志有很严的结构校验（turn 必须连续、引用不能悬空、assistant 消息要带 stream），照着报错猜了四轮结构，一次都没过。
现在的做法是让 dsh 自己写：
sessionPersistence.create({ version, id, createdAt, cwd, isSeeded: false, delegationDepth: 0 })建日志文件和写句柄。这一步不能省：持久化插件靠writers.get(session.id)路由session/event，没有写句柄时flush会静默返回——账本有 id、磁盘没文件。sessions.create()建活会话，把合并好的事件一条条append()。seq 由宿主自己发，天然连续，每一步还有surfaceManager.validateNext校验。handle.flush()落盘。
好处是报错从「turn/start does not open the expected turn」这种无从下手的话，变成了「image/offload: target seq 87 is not a current surface node」——直接点名事件类型和序号。
走这条路顺带踩到三个坑：图片卸载／上下文压缩这类事件带着指向 surface node 的引用，合并后必然悬空（直接丢弃）；assistant/message.data.stream 不能整段删（重建节点时会 for..of，字段没了就报 stream is not iterable），要留空数组；header 载荷不要带 type（会被判 unexpected field type），但必须带 version。
侧栏账本：对话列表不是扫目录得来的，是读 ~/.dsh/storages/workspace.json 里的 sessionIds 数组。所以最后还要调 workspaceRegistry.attachSession(newId)，它会校验 header 里的 cwd 和真实路径一致，通过后才把编号插进数组。
改 workspace.json 只能用 JSON 解析器改。用正则删数组元素会留下孤立逗号，JSON 一坏，整个界面会变成「暂无会话」。
目录结构
src/client.js 界面（联合会话视图、三布局、合并按钮）
src/merge.mjs 合并逻辑（纯函数，不碰磁盘）
.dsh-plugin/index.mjs Node 半边（注册 /weld 命令、写入新对话）
scripts/build-client.mjs 打包界面代码
scripts/install-local.mjs 本机安装
scripts/cleanup-test.mjs 清理测试会话（从账本和磁盘一起删）
scripts/e2e-verify.mjs 自动验收：三布局截图（需要浏览器调试端口）
scripts/probe-weld.mjs 自动验收：打开合并出来的新对话，检查有没有加载错误
已知限制
- 只读视图最多渲染最近 400 条消息（分栏每列独立计算）；轮次对齐最多 120 轮
- 消息正文按纯文本显示，保留
**、反引号原样——这是有意的，转录要保真 - 没有跨对话搜索、没有导出
/weld生成的新对话，第一批请求的缓存要从零建立（新对话全新前缀，这个省不掉）/weld每个源只取最近 N 轮：两个几百条消息的对话加起来上万条，不截断会顶满窗口/weld生成的对话标题显示「未命名」：原标题带引用关系，截断后对不上，干脆不搬/weld是数百毫秒到几十秒的操作（几千条事件逐条交给宿主写），中间没有进度条，等侧栏冒出新对话即可- 同一个对话同时只能有一个写入者：如果目标对话正被另一个 DSH 实例占用，命令会报
session/writer-held，换一个空闲对话提交即可
许可
MIT
