🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI
广告☁️ 云服务器特惠阿里云首购 8 折 · 腾讯云合作特惠
DeepSeek Harness Hub
← 返回列表

po-et/dsh-session-rescue

DeepSeek Harnessspec-screened扫描:中风险在 GitHub 查看 ↗
⚠ 装前注意

修复 DeepSeek Harness 的 "history unavailable … corrupt…

基本兼容但装前注意:未发布到 npm registry,仅可从源码安装 · 最近上游提交 2026/9/10 · 已提供中文文档

修复 DeepSeek Harness 中的“损坏的会话日志”:诊断、安全修复并抢救损坏的 dsh 会话。零依赖。

综合分
28.8
GitHub 分
28.8
用户评分
—
★ Stars
0
周下载量
—
安装插件(需先安装 dsh CLI 引擎:npm install -g @deepseek-ai/dsh)
dsh plugin --profile web add po-et/dsh-session-rescue
未发布到 npm registry,仅可从源码安装,改用 GitHub 源安装
信任档位:仅索引本站尚未对其实装验证,仅收录元数据
是什么
dsh 原生插件 · other
装得上吗
静态安装检查有提示项,装前建议看一眼 README
安全吗
本站尚未对该插件做风险分级(暂未覆盖,不等同于无风险)
还在维护吗
活跃:最近一次提交在 15 天前

档位由下列信号合成:本站实装验证(真实安装,当前最高到 L4)· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →

数据截至 2026/9/21(元数据每日更新 · 实装验证按队列轮转,单条结论的验证时间见上方)
安装兼容性检查⚠ 装前注意

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✗npm 包dsh-session-rescue(未发布到 npm,仅可源码安装)
✓Node 引擎要求 >=22.15 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

未发布到 npm registry,仅可从源码安装

验证方式:npm registry 存在性 + package.json 静态校验 · 最后验证 2026/9/24 11:38:19

用户评分
还没有人投票,来当第一个
订阅周报,不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动

README

由 DeepSeek 最新模型翻译生成
dsh-session-rescue

修复 DeepSeek Harness 的 "history unavailable … corrupt session log"——安全、常见场景零丢失。

English

npx github:po-et/dsh-session-rescue

如果你见过这些报错,这个工具就是为你写的:

- corrupt session log: seq gap in committed region at line N (expected X, got Y)
- corrupt session log: unparsable committed event at line N
- first line is not a session header
- 崩溃 / 强杀进程 / 双开实例之后的 SessionPersistenceCorruptionError

dsh 的会话日志是 append-only 且严格校验的:崩溃恢复或第二个进程多写了一段重复事件,整个会话就永远打不开——但你的内容其实几乎都还在。dsh-session-rescue 按 dsh 加载器的原样规则定位损坏点,摘除冗余侧(重放行、过期的合成中断收尾块),重建一个可加载的日志。

快速开始

npx github:… 首次运行会从源码构建(约半分钟),之后有缓存。发布到 npm 后也可以用更短的 npx dsh-session-rescue。

1. 看哪些会话坏了(只读,绝对安全)
npx github:po-et/dsh-session-rescue

2. 深度诊断某个会话(路径或 id 片段均可)
npx github:po-et/dsh-session-rescue doctor 37374e34

3. 预览修复方案——此时不写任何东西
npx github:po-et/dsh-session-rescue repair 37374e34

4. 执行修复(自动保留带时间戳的备份;请先关闭 dsh)
npx github:po-et/dsh-session-rescue repair 37374e34 --apply

修不了的也能救回对话内容:

npx github:po-et/dsh-session-rescue export 37374e34        # 抢救对话全文为 Markdown
npx github:po-et/dsh-session-rescue quarantine 37374e34    # 把坏会话移出 dsh 视野,防止拖垮启动

在用 AI agent?直接对它说:"运行 npx github:po-et/dsh-session-rescue,把我损坏的 dsh 会话修好。"

能修什么

| 损坏 | 成因 | 修复方式 |
|---|---|---|
| 重放的重复行 | 崩溃 / 强杀 / write-behind 重放 | 去重——零丢失 |
| 合成收尾块与真实续写撞号 | 中断恢复 + 第二写入方 | 摘除合成块、保留真实内容——零丢失 |
| zstd 尾帧撕裂 | 写入中断电 | 无需处理(dsh 自愈,工具会明说) |
| header 损坏 | 手工编辑、部分写入 | 重建 header |
| 真实 seq 空洞(事件确实丢了) | 强制压缩、写入丢失 | 显式 --truncate 保住可加载前缀;export 抢救其余 |

两条修复路径都有按实地报告建模的回归测试:deepseek-harness#1497 里报告的两种损坏形态(中断收尾块与恢复后的真实工具结果撞号;从回收 seq 整尾重写),工具的输出与这些用户手工验证过的修法一致。

为什么安全

社区案例证明:外行修复可能把会话修死(悬空 sourceEventSeqs 毒化,永久报废)。本工具:

1. 不备份,不动原文件——带时间戳的备份就放在原文件旁边。
2. 写前验证:重建结果必须通过 seq 连续性与 sourceEventSeqs 引用检查(与 dsh 自身校验一致),不安全的方案直接拒绝执行。
3. 写后复检:修复完成立刻重扫,若仍无法加载会如实报告,备份完好无损。
4. 保留原始字节:保留的行原样复制,绝不重新序列化。
5. 按 dsh 的物理布局重建(zstd 帧 0 仅含 header 行)。

与其他工具的关系

| | dsh-session-rescue | doctor 类工具 | export 类工具 |
|---|---|---|---|
| 检测损坏 | ✅ | ✅ | — |
| 把会话修到能加载、能继续用 | ✅ | ❌ | ❌ |
| 修不了时抢救对话全文 | ✅ | ❌ | ✅ |
| 拒绝不安全写入 | ✅ | 不适用 | 不适用 |

范围与诚实声明

- 支持会话格式 version 0(当前 dsh developer preview),.jsonl 与 .jsonl.zstd,仅 JSONL 后端。dsh 处于 pre-1.0、无格式兼容承诺;遇到未知版本本工具会明确拒绝而不是乱猜。
- 修复时请关闭 dsh(至少保证该会话空闲)——活跃写入方会与文件替换竞争。
- 零依赖。Node ≥ 22.15(使用内置 zstd)。

许可证

MIT

上游仓库有新提交时邮件通知你(每天最多一封,无更新不打扰),随时一键退订。

同作者(po-et)的其他插件

💬 加入社群

插件用法、部署报错、新插件第一时间同步——群里问,比一个人翻文档快。

DPharness QQ 群二维码,QQ 扫码进群
QQ 扫码进群
DPharness 飞书群二维码,飞书扫码进群
飞书扫码进群