dsh-error-digest · 错误汇总
把 DSH 对话日志里的出错事实收集起来，跨会话合并、按出现频次排序，并在每条错误后面给出
三个动作：
| 按钮 | 做什么 |
|---|---|
| 分析 | 开启一个新对话，把这条错误的类别 / 来源 / 错误码 / 出现次数 / 最近时间 / 摘要填进输入框，任务是「查根因 + 影响范围 + 修复或规避步骤」 |
| 防范 | 开启一个新对话，任务是「判断该在哪一层拦住它（AGENTS.md 规则 / skill 说明 / 工具校验 / 插件代码 / 文档）+ 最小改动落地 + 后期自查清单」，目标是以后不再发生 |
| 忽略 | 不再在本面板显示这条错误。只影响本机、只影响显示，不删日志、不影响统计口径之外的任何东西 |
「分析 / 防范」走的都是宿主自己的「新建对话」通路（uiWorkspace.startSession），提示词落在
新对话的草稿输入框里：发送这一步仍由用户确认，不会替你按下回车。
打开方式：左侧栏底部的面板图标「错误汇总」。
安装
npm install dsh-error-digest
- 包内
dsh字段声明了插件两半：bundle.patch（宿主半，向投影写入错误账本）与client（侧栏面板的客户端半）； exports另外暴露./client（构建好的lib/client.js）、./locale/*.json、./icon与./package.json，均无需二次构建；- 仓库：
忽略
- 忽略是本机偏好：存在
localStorage的dsh-error-digest/ignored-v1，按签名记账，
连着摘要一起存（会话归档、错误消失后，「已忽略」里仍认得出是哪条）。 - 一定可恢复：面板顶部出现「已忽略 N 条」，点开就是列表，每条带「恢复」，
另有「全部恢复」。忽略后会自动展开一次，避免「点掉了找不回来」的错觉。 - 上限 200 条，超出时丢弃最早忽略的；脏数据（手改过的 JSON、旧版本残留）逐条校验后丢弃。
- 忽略只改「显示」：错误的统计仍然由投影照常累加，恢复后频次是完整的。
收集哪些错误
| 会话事件 | 含义 | 归类 |
|---|---|---|
tool/result + data.error 或 message.isError |
工具执行失败（命令非零退出、编辑找不到唯一匹配、参数校验拒绝……） | 工具失败 |
turn/end 且 reason.kind === 'error' |
整轮失败（重试耗尽后模型请求仍失败） | 回合失败 |
llm/retry |
一次模型请求失败并触发重试（限流 / 5xx / 超时） | 模型重试 |
为什么「合并」和「排序」
同一条错误在一个会话里常常重复几十次。每条错误写入时就压成一个签名
（类别 + 工具名/提供方 + 错误码 + 归一化后的首段摘要），同签名累加次数；归一化会抹掉
UUID、长十六进制、绝对路径、行列号、耗时与字节数，但保留 HTTP 状态码、退出码这类
真正的区分信息。界面上再按签名做一次跨会话合并，于是「同一个错误在 20 个会话里各出现
3 次」显示为一行 ×60。
实现
- 宿主半（
index.js+src/digest-fold.js）：注册dialogErrors会话投影，
由框架驱动折叠所有会话（含未打开的冷会话），并随会话列表 RPC 自动到达客户端。
附一个只读诊断路由POST /dsh-error-digest/debug（ping/debug），回答
「投影注册没有、每个会话折叠出了什么」。 - 客户端半（
src/digest-model.js+src/digest-ui.js+src/client-main.js
→ 构建成lib/client.js）：订阅会话列表快照，只做合并、排序、渲染与按钮动作。
不 retain 任何会话，因此不会激活别人的历史。
按钮是怎么「开启新对话」的
layout.selectPanel(null)先切回对话主面板——草稿初始化要求 composer 已挂载，
否则宿主内部的beforeOpen会抛错并静默中止整次打开；- 下一帧调
uiWorkspace.startSession(undefined, { prompt, whenDraftExists: 'append' })，
与官方「新建对话」完全同一条通路，且不覆盖用户已有草稿； - 300ms 后用「主视图是否变成空白会话」反查结果；没生效就再试一次，
仍不行则把提示词复制到剪贴板并在控制台留一份——绝不出现「点了没反应」。
uiWorkspace / layout 都声明为硬依赖（export const inject）：它们必须由
客户端 ctx 注入，只靠 ctx.get() 取服务会出现「点了没反应」。
按钮长什么样
三个动作是同一套控件：26px 高、7px 圆角、图标（13px 线性图标，currentColor）+ 文案，
靠层级而不是颜色噪声区分主次：
| 动作 | 视觉 |
|---|---|
| 分析（主） | 品牌色描边 + 品牌色淡底（color-mix 混 12% 透明）+ 品牌色文字 |
| 防范（次） | 中性描边 + 主文字色，hover 填 bg-layer-2 |
| 忽略（安静） | 无描边 + 次要文字色，hover 才提亮 |
颜色全部来自 --dsw-alias-* 令牌，没有一个字面色值——所以明暗主题、跟随系统时都对；
color-mix 前都留了一条纯令牌的降级声明，旧内核下只是少了淡底，不会失色。
计数用错误色淡底药丸、类别标签按 tool/turn/model 用对应状态色淡底，
前三名的序号加深为主文字色，视线自然落在高频项上。
排障入口（控制台）：
__DSH_ERROR_DIGEST__.snapshot() // 当前合并结果（与面板同一份逻辑）
__DSH_ERROR_DIGEST__.lastAction() // 最近一次按钮动作：{ mode, opened, reason, retries }
__DSH_ERROR_DIGEST__.canOpenConversation() // 新建对话通路是否可见
__DSH_ERROR_DIGEST__.trigger('analyze') // 直接触发第一条的分析动作
__DSH_ERROR_DIGEST__.ignoredSigs() // 已忽略的签名
__DSH_ERROR_DIGEST__.restoreAllIgnored() // 清空忽略表
宿主侧只读诊断：POST /dsh-error-digest/debug，回答「投影键注册没有、
每个在挂会话折叠出了什么」。注册失败时界面只会「一条错误都没有」，
这个入口是唯一能区分「没错误」与「没工作」的证据。
状态的形状与上限：
{ entries: [{ sig, kind, key, code, detail, count, firstTime, lastTime, lastSeq }],
calls: { [callId]: toolName } } // 在途工具调用，仅用于给结果认出工具名
- 每个会话最多 60 条不同签名（超出时先砍次数最少的）；
- 在途调用表最多 128 项；
- 摘要最长 240 字符。
开发
npm run check # 校验 lib/client.js 与源码一致 + 跑全部单测
npm run build # 只重新生成 lib/client.js
lib/client.js 是生成产物（build/bundle.mjs 把三个源文件内联进
window.__ModuleLoader__ 工厂），不要手改；改了 src/ 必须重新构建，
npm run check 会在忘记构建时直接失败。
单测分四层：
| 文件 | 覆盖 |
|---|---|
test/digest-fold-test.mjs |
哪些事件算错误、同类错误怎么合并、上限、schema、视图引用稳定性 |
test/digest-model-test.mjs |
跨会话合并、频次排序、范围口径、提示词 |
test/bundle-test.mjs |
产物是否最新、是否可解析、协议要素齐不齐 |
test/client-half-test.mjs |
用假 React / 假 ctx 真跑一遍 apply：插槽注册、文案键对齐、面板渲染、三个动作的实际调用、忽略的落盘与恢复 |
已知边界
- 只统计本机可见会话的错误；投影是懒物化的，很久没打开过的历史会话要等它被
物化一次（打开一次、或产生新事件）才会出现在统计里。 - 分叉出来的会话会把继承前缀里的错误再记一次（分叉即复制历史，符合预期）。
- 按钮把提示词放进草稿，不自动发送：这是刻意的取舍，避免在用户来不及调整目录 / 模型时
自动消耗一次请求。 - 「忽略」是按本机浏览器存储记的：换机器、换浏览器 profile、清站点数据都会丢失；
这是它「只影响显示、不进日志」的代价，也是刻意的。
