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 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
↓ 105/wk
MIT
TypeScript
Aug 31, 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 Yicijiuhaobala
Adds a "Delete session" item to the DSH session-row context menu (next to rename/fork/archive) — permanently removes session logs from disk, with live-session protection.
★ 0
MIT
JavaScript
Aug 24, 2026
dsh plugin --profile web add dsh-session-deleteby xiaoshenming
Repair DeepSeek Harness sessions that refuse to load. 修好打不开的 DSH 会话文件。
★ 9
MIT
JavaScript
Sep 27, 2026
dsh plugin --profile web add dsh-session-surgeonby seth-hg
dsh-session-port is a DeepSeek Harness plugin that bundles a session — its log, subagents, media, and referenced workspace files — into one portable ZIP and restores it on any DSH.
★ 0
MIT
TypeScript
Sep 2, 2026
dsh plugin --profile web add dsh-session-portby SZMY-haruhi
Sidebar archive directory for DSH Web: restore a session to its original workspace slot, delete the session log, or edit-and-branch a user message into a new conversation.
★ 2
↓ 96/wk
MIT
TypeScript
Aug 17, 2026
dsh plugin --profile web add dsh-session-plus