[Bug Report] 单个会话日志损坏使 session.list 整体 500，Web 侧边栏全部会话消失且无界面提示

[DRAG0NM]

摘要

一个会话日志物理格式损坏就会让 session.list 整体返回 500，Web 侧边栏所有会话消失（数据未丢，workspace.list 正常，错误仅存在于浏览器 console）。根因是列表聚合的单会话异常未隔离：listArtifacts 遍历会话时调用 readFirstZstdLine（内部 assertZstdHeaderFrame 对损坏头帧抛错），调用点没有 try/catch——而同一函数里"无法解析 → 跳过该会话"的容错设计（L1080-1082）存在，唯独抛错路径漏了隔离，一个坏文件把整个列表拖垮。

复现步骤

1. 取任意合法会话日志 ~/.dsh/sessions/<project>/<session>/session.jsonl.zstd（多帧容器：首帧仅一行 header）。
2. 用外部 zstd 压缩器把整个明文重写为单个帧并覆盖原文件（如 zstd.compress(whole_plaintext)）。
3. 打开 dsh web GUI 或 F5 刷新。
4. 观察：POST /api/session.list 返回 500: handler failure: Error: corrupt Zstandard session log: first frame is not exactly one header line；侧边栏全部会话消失（workspace.list 正常）；界面无任何提示（仅浏览器 console 有 500）。

社区已复现。该"损坏"文件内容其实可完整解码，只是容器布局不同（首帧不是恰好一行 header）——但单点失败不应清空整个列表。

根因（源码定位，rc.6）

1. 头帧校验抛错 — @deepseek-ai/dsh-session-persistence-jsonl/lib/index.js：
   • L741-742 assertZstdHeaderFrame：if (plaintext.length === 0 || plaintext.indexOf(10) !== plaintext.length - 1) throw new Error("corrupt Zstandard session log: first frame is not exactly one header line")；
   • L969（readZstdPrefix 内）：assertZstdHeaderFrame(headerFrame.value) —— 单帧重写文件在此抛错。
2. 列表聚合未隔离单会话异常 — 同文件 listArtifacts（L1060-1084）：
   • L1078：const first = this.compression === "zstd" ? await this.readFirstZstdLine(path, signal) : ... —— 调用点无 try/catch，抛错直接上抛 → session.list 整体失败；
   • 对照：同函数 L1080-1082 已有容错意图——if (first === void 0) continue;、if (meta === void 0) continue;（无法解析的条目被跳过），说明设计本意是"坏条目隔离"，但抛错路径（assertZstdHeaderFrame/其他校验）没有被纳入跳过逻辑。
3. 结果链：单会话损坏 → listArtifacts 抛错 → session.list RPC 500 → 前端会话列表整体清空；前端无 500 错误呈现（仅 console），用户看到的是"所有会话消失"。

建议修复

方案 A（推荐）· 列表聚合隔离单会话异常：在 listArtifacts 的会话循环内对 readFirstZstdLine/parseHeaderMeta/assertStoredIdentity 包 try/catch——corrupt 类错误记 warn 后 continue（与既有 L1080-1082 的跳过意图一致）。坏会话被隔离，其余会话正常列出；需要时可在返回元数据中标记该会话不可读。

方案 B · 前端呈现列表错误：session.list 失败时在 GUI 显示可见错误（banner/toast + 重试），而不是静默清空侧边栏——发帖人预期 2；与 A 互补（A 防根因，B 兜底呈现）。

方案 C · 读取器宽容单帧布局：对"可完整解码的单帧日志"兼容（发帖人预期 3）。该文件内容可解码，只是容器布局不同；但放宽格式契约有向后兼容风险（旧版本/工具链写入的合法多帧格式是约定），作为长期演进可考虑，短期 A 更稳妥。

影响

• 单个会话文件损坏（外部工具改写、写中断、磁盘异常）即可让所有会话从侧边栏消失——用户误以为数据丢失（实际 workspace.list 正常）；
• 无任何界面提示，故障仅在浏览器 console 可见，排查成本高；
• 与 回合中断后恢复续跑，会话日志出现 seq 重叠，历史加载报 corrupt session log #255/[Bug] 工具被中断后会话日志写入重复 seq，导致会话损坏无法恢复（resume 报 seq gap） #333/Bug: corrupt session log "seq gap in committed region" — duplicated seqs when two dsh processes write the same session (interrupted-turn closers race live resume appends) #420（seq 损坏家族）不同角度：那些是"单个会话打不开"，这里是"一个坏文件影响全局列表"。

环境

• 源码定位：0.1.0-rc.6（npx 缓存安装包，Node v24.16.0，Windows 11）
• 原报告：单个会话日志损坏时 session.list 整体 500,Web 侧边栏全部会话消失 #1043

验证材料

• 社区复现（zstd 单帧重写 → session.list 500 → 侧边栏全消失，workspace.list 正常）；
• rc.6 源码逐行核对：dsh-session-persistence-jsonl/lib/index.js L741-742/L969/L1060-1084；
• 机制推演：assertZstdHeaderFrame 抛错无捕获 → listArtifacts 整体失败 → session.list 500。

---

First analysis of discussion #1043. Happy to open a PR with fix option A.