DSH Plugins
返回列表
🧩

dsh-session-doctor

admin-security 更新于 2026.11.06

在终端中运行以下命令:

dsh plugin install aturzone/dsh-session-doctor

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

在 DeepSeek Harness 中执行 dsh plugin install aturzone/dsh-session-doctor 安装本插件,源码见 https://github.com/aturzone/dsh-session-doctor。

插件介绍

当 DeepSeek Harness 会话日志里某条事件的 turn/step 坐标或作用域与当前读取器规则不一致时,整份存档可能无法加载,界面往往只提示「会话损坏」,却看不出是哪一条、哪一类签名出了问题。这类故障在社区讨论里反复出现:一个坏坐标拖垮整段可复盘的历史。

dsh-session-doctor 以只读方式解码各代 canonical 的 session.vN.jsonl(含 zstd),按当前 V4 读取器重放同一套规则,并报告具体的序号、事件类型以及不再成立的那条期望。它检查 turn/start、turn/end 与 step 的嵌套与顺序、步号在未闭合 turn 内异常重启、以及 request、tool、assistant 等事件是否写在错误作用域内,也会标出无效 JSON、缺 header 等非事件行。工具从不改写会话文件,定位的是与现行读取器对齐的「签名级」缺陷,而非完整消息体校验或迁移逻辑。

适合维护 Harness 环境、排查无法打开的会话、或在升级读取规则后核对存量日志的管理员与开发者。需要 CLI 批量审计,也可通过插件注册面向模型的 session_doctor 工具,在指定 sessions 根目录下得到与命令行一致的结构化报告。若你只关心每个会话目录下最高一代文件,默认可满足;要审计保留的旧代文件,需显式选择扫描全部代次。

使用场景

  • Harness 提示会话损坏、无法加载存档时需要定位具体坏事件
  • 升级或对齐 V4 读取规则后抽查存量 session 日志是否仍合规
  • 排查 turn/step 嵌套错乱或作用域外写入导致的整段会话不可用

适合人员

  • 维护 DeepSeek Harness 与 sessions 目录的平台管理员
  • 排查无法打开会话的插件与 Harness 开发者
  • 负责安全与稳定性、需只读核查会话完整性的运维人员