dsh-sessions-diagnosis

DSH 在 harness 升级后会对旧会话日志做惰性迁移，其中一步是封闭词汇审计：每条消息的 source.kind 必须落在固定集合内，否则整次迁移中止且不会在磁盘留下痕迹。于是会话仍能在列表里出现，点开却只剩网关或内部错误；常见诱因是旧版本为 @ 路径提及写入的 at-file-mention。这类问题往往看起来像随机坏掉，实则只击中曾经用过 @ 的对话。

本插件用 DSH 官方发布的迁移链做诊断，给出的原因与 harness 实际撞上的完全一致，而不是自研猜测。它会把每个会话归类为正常、未迁移、可修复、不可修复、损坏、过新、空或未知，并指出具体字段；修复时生成经双重校验的当前格式后继文件，原文件字节级不动，内容完整性有门禁，还支持通过侧车记录回滚。

除命令行外，还在 Web 设置里提供「Session diagnosis」仪表盘：全库扫描、逐条查看结论与计划改动、一键修复且默认先 dry-run。Agent 侧注册 session_store_overview、session_diagnose、session_repair，便于在对话里做普查、诊断与受控修复。

适合在升级后遇到「能列不能开」的 DSH 用户、需要批量摸清会话健康状况的维护者，以及希望在不动原始日志的前提下安全试修的团队。