@snow-the/dsh-session-repair

Session Repair

扫描并修复 DSH 会话日志：将单帧损坏的 zstd 文件重新编码为多帧布局，并将未知事件类型（例如 llm/failover）标记为可忽略，以便旧版测试框架加载较新的日志。

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add github:snow-The/dsh-session-repair#8736826ff17af25a68924f4e8a5348aad644a6d4

兼容性与来源证明

Session Repair 以 @snow-the/dsh-session-repair 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

0.1.0stable

2026/10/19

README

Scans and repairs DSH session logs (~/.dsh/sessions/**/session.jsonl.zstd).

Single-frame corrupt logs — a session file re-compressed as one zstd frame breaks the harness at boot (first frame is not exactly one header line). The plugin rebuilds the log in the canonical multi-frame layout: one JSON line per zstd frame.
Unknown event types — events written by newer harness builds (e.g. llm/failover) make older harnesses refuse the whole log (SessionFormatUnsupportedError). The plugin marks such events "ignorable": true (the event is kept; the harness skips it).

session_repair_scan — read-only report of every session log: zstd frame count, line count, header validity, parse errors, unknown event types.
session_repair_fix — repairs problem logs (or one sessionId). Backs up each file as <file>.bak-repair-<timestamp> before replacing it, then verifies the rebuilt layout (frames == lines). Restart the harness afterwards.

zstd CLI on PATH (Debian/Ubuntu: apt install zstd).
The known-type allowlist is conservative; pass extraKnownTypes to fix if a type is actually known to the running harness.