🧩

dsh-session-repair

admin-security 更新于 2026.08.25

在终端中运行以下命令：

dsh plugin install Equinox7379/dsh-session-repair

将以下提示词粘贴到 DeepSeek Harness 对话框中：

在 DeepSeek Harness 中运行命令 dsh plugin install Equinox7379/dsh-session-repair 即可安装该插件，项目源码位于 https://github.com/Equinox7379/dsh-session-repair 。

插件介绍

在 dsh 0.1.0-rc.x 中，没有第三方事件类型的注册机制。当外置插件向会话日志写入自定义事件（例如 message-edit、version）后，服务重启时恢复该会话会抛出 SessionFormatUnsupportedError，导致该会话彻底无法打开。dsh-session-repair 正是为这个痛点而生。

插件核心提供 scan、repair、repair_id 三个操作：scan 零改动、仅报告问题会话；repair 对所有非 live 会话补齐官方读端已支持的 ignorable 标记，并按合规帧格式重写日志（首帧恰为 header 一行，后续每行一帧，压缩附带校验和）；repair_id 则针对指定会话做同样修复。修复前强制生成 .before-ignorable 备份，已标记事件不会重复处理，幂等安全。若解压失败或首行非法，插件中止该文件并报告，绝不强行写回。

适合在 DeepSeek Harness 中部署了会写自定义事件的外置插件、且遭遇会话日志损坏的管理员。插件零运行时依赖、不引入新的会话事件、不暴露 HTTP 路由，属于轻量级的修复工具。