dsh-session-repair
Manifest validSession log repair tool for DSH: scans zstd session logs for unknown event types and marks them ignorable with a compliant frame rewrite (backup included). Read-only scan by default.
dsh-session-repair
DeepSeek Harness 插件:修复因未知事件类型导致无法打开的会话日志。
背景
dsh 0.1.0-rc.x 没有第三方事件类型注册机制。外置插件向会话日志写入自定义事件(如 message-edit/version)后,服务重启恢复该会话时抛出 SessionFormatUnsupportedError。官方读端支持 ignorable: true 标记,本插件即为这类事件补齐标记并按合规帧格式重写日志。
用法
- 工具:
session_repair - 参数:
action(scan只报告 /repair修全部非 live /repair_id修指定会话)、sessionId
示例(scan 输出):
{ "action": "scan",
"files": [ { "file": "--E-surdet--/session-…/session.jsonl.zstd",
"unknown": { "message-edit/version": { "count": 1, "ignorable": 0 } }, "fixable": true } ] }
可靠性
scan默认零改动;repair只处理非 live 会话文件;- 修复前强制备份(
.before-ignorable),幂等(已标记事件不重复处理); - 帧格式合规:首帧恰为 header 一行,之后每行一帧,压缩带校验和;
- 解压失败/首行非法时中止该文件并报告,不强行写回;
- 零运行时依赖、无自定义会话事件、无 HTTP 路由。
安装
dsh plugin --profile web add link:/path/to/dsh-session-repair
# 重启 dsh web
License
MIT
Comments
Loading…
Similar plugins
by snow-The
Scans and repairs DSH session logs: re-encodes single-frame corrupt zstd files back to the multi-frame layout and marks unknown event types (e.g. llm/failover) as ignorable so older harnesses can load
★ 0
MIT
TypeScript
Nov 1, 2026
dsh plugin --profile web add @snow-the/dsh-session-repairby Zn-Dk
Diagnose and safely repair corrupted DSH session history: raw zstd/JSONL validation, tool-call ID repair, single-slot pre-repair backup, restore, and an audit trail.
★ 4
↓ 322/wk
MIT
TypeScript
Sep 29, 2026
dsh plugin --profile web add dsh-session-repairby zzdhsxk
Repairs legacy DSH session logs that the current build refuses to migrate, recovering missing tool-call ids and names from the log itself and verifying each repair against the real v0 to v3 migration
★ 1
MIT
JavaScript
Sep 11, 2026
dsh plugin --profile web add dsh-session-migration-repairby Coprexist
Recover deleted or corrupted dsh sessions (session.jsonl.zstd) and memory (memory.db) from the raw disk, and repair rebuilt sessions that fail to resume via the /session-repair command in the web UI.
★ 1
MIT
JavaScript
Aug 18, 2026
dsh plugin --profile web add dsh-session-recoveryby nateyu
A DeepSeek Harness settings plugin. It lists and deletes sessions the sidebar hides: archived sessions, or blank sessions whose log has no turn/start. A session whose log cannot be read is listed too,
★ 0
MIT
JavaScript
Sep 11, 2026
dsh plugin --profile web add dsh-session-vaultby EIGHTfs
Session management for DSH: archive/restore, batch & conditional delete, AI auto-rename, interrupted-session auto-resume, workspace grouping, undo last message, repair damaged session logs (seq-gap/EI
★ 1
NOASSERTION
HTML
Oct 21, 2026
dsh plugin --profile web add dsh-session-conductor