DeepSeek Harness 插件

dsh-session-repair

Session 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.(英文原文)

跳到安装方式

来源信息

GitHub 仓库
Equinox7379/dsh-session-repair
最近更新
2026年8月15日
分类
记忆
GitHub stars
1
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/Equinox7379/dsh-session-repair
插件名:dsh-session-repair
作者:Equinox7379

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

dsh-session-repair

DeepSeek Harness 插件:修复因未知事件类型导致无法打开的会话日志。

背景

dsh 0.1.0-rc.x 没有第三方事件类型注册机制。外置插件向会话日志写入自定义事件(如 message-edit/version)后,服务重启恢复该会话时抛出 SessionFormatUnsupportedError。官方读端支持 ignorable: true 标记,本插件即为这类事件补齐标记并按合规帧格式重写日志。

用法

  • 工具:session_repair
  • 参数:actionscan 只报告 / 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