HuanLinOTO/dsh-plugin-merge-tool-calls

dsh-plugin-merge-tool-calls

把 WebUI 会话流中连续相邻的同工具调用合并为一个「主卡片 + 紧凑子行」的树状展示，减少连续读文件/搜索/编辑/执行命令时多条卡片对流的占据。默认覆盖所有内置通用行工具（read/grep/glob/edit/write/bash/pwsh/web_search/web_fetch/run_code），也可配置白名单。

合并前：                         合并后：
[Read] foo ▸ 内容                 [Read] · 3 Files  ▸（点击展开子行）
[Read] bar ▸ 内容                   └ foo（子行，点击展开 foo 的内容）
[Read] baz ▸ 内容                   └ bar（子行，点击展开 bar 的内容）
                                    └ baz（子行，点击展开 baz 的内容）

主行只显示数量摘要（Read · 3 Files），具体文件路径全部下沉到子行；子行默认折叠，点击主行以动画展开/收起。单次调用（无合并）保持原行为（主行直接显示路径并展开内容）。

纯展示层合并：会话日志、模型可见数据、详情面板均不受影响；回放确定（合并结果是聊天快照的纯函数）。

工作原理

• 通过 keyed slot tool.call.toolview 的 shadow 机制（priority: -1，最低者渲染）接管工具的卡片；tools: [] 时接管全部内置通用行工具（见 src/client/tool-names.ts），非空列表为显式白名单（任意 wire 名均可）。
• 组件经 useChat 读取聊天快照，在 order + node store 中按 call id 定位自身节点，前后扫描连续调用，按 maxGroupSize 分组。一组只合并同名或同家族调用：同名必合；已知家族（grep+glob、bash+pwsh、read+web_fetch）跨名合；未知工具名（variant others）仅与自身合，不相关的工具不会混进同一张卡。
• 组首座位渲染合并卡片；组内其余座位渲染 null，由注入的样式规则 [data-chat-flow-kind="tool-call"]:has([data-slot="tool.call.toolview"]:empty) { display: none; } 将其从流中收起（与内置 .flowItem:empty 语义一致；渲染器为每个 toolview 包一层 data-slot 容器，故以该容器判空）。
• 主卡片镜像内置 ToolRow 的行面：按 variant 渲染标题/图标（Read/Search/Bash/Write/Edit/Code/Tool call，工具自定义标题如 Pwsh/Inspect 优先）。合并组的主行摘要改为数量（Read · 5 Files / Search · 3 Queries / Bash · 4 Commands 等，按 variant 选名词），不再显示首个调用的路径；单次调用（无合并）仍显示 args 摘要（读→路径、搜索→query、bash→description/command、未知工具带 工具名 · 前缀），read/write/edit 单行的摘要是可点击文件链接。行状态、错误首行、bash 失败退出码转红点均与内置一致。
• 子行紧凑（20px 高），结构为主行的尾部（sep 点 + 路径）。合并组内所有调用（含首个）均渲染为子行，所以每个文件路径都在子行上。对齐运行时自动测量：组件挂载后量取主行 sep 点相对卡片的偏移（并用 ResizeObserver 跟随字体/布局变化），以 --mtc-sep-left 自定义属性设置子行缩进——sep 点与主行 sep 点同列、路径与主行摘要同列，不依赖任何手工字体宽度常量，任意工具名均自动对齐。展开的子行卡片以负向 calc 抵消该缩进，左边缘与主卡片内容区对齐（占满卡片宽度，左侧不留白）。无可展开内容（如运行中的 read）的子行渲染为静态行。
• 子行默认折叠：主行点击展开时，子行块以 grid-template-rows: 0fr → 1fr + 透明度过渡动画滑出（200ms），收起时反向滑回；折叠期间子行仍在 DOM 中（grid 0fr + overflow: hidden 收起，不卸载），所以动画平滑无闪烁。每个子行仍可独立点击展开其内容卡片。