会话数据急救包 mengjiemy/dsh-session-tools

DSH 会话与数据急救包

原名：session-doctor + session-oracle + validate-storage 一句话：动 DSH 的聊天记录或配置数据之前，先用这三个工具验一遍 —— 因为弄坏了找不回来。

为什么需要它

DSH 的聊天记录不是普通文本文件，是多帧压缩的特殊格式。
不懂这个格式就动手改，结果是会话直接从侧栏消失。

这三个工具，每一个都是被一次事故逼出来的。

三个工具

一、session-doctor —— 会话体检 + 安全截断

它干什么
- 给会话文件做四项体检
- 需要截断时，只按「帧边界」切，绝不重写内容

为什么必须「按帧」我当时的做法：解压 → 裁掉尾巴 → 重新压缩成一个整块结果：会话从侧栏消失（DSH 认不出这个结构了）

正确做法：只在【帧和帧之间】切，其他一个字节都不动

★ 关键安全设计：它从不覆盖原文件，截断结果写到新文件。

二、session-oracle —— 会话「真校验器」

它干什么：用 DSH 自己的代码去读会话文件，报的错跟客户端一字不差。

为什么需要客户端报「历史加载失败：… is corrupt」—— 看不出具体哪里坏自己写个校验器 —— 我的校验规则可能跟 DSH 的不一样，验过了也没用

⇒ 只有走 DSH 自己的读路径，才能问出真话

★ 用法：改会话文件之前先跑它。没通过就别上线。

三、validate-storage —— 工作区数据校验

它干什么：用 DSH 自己的 schema 校验 ~/.dsh/storages/ 下的数据。

为什么需要我按「字段名」重建了工作区注册表，把 createdAt 写成了数字 ⇒ 但 DSH 要的是 ISO-8601 字符串 ⇒ 整个工作区列表打不开

教训：★「备份了 + JSON 合法」≠ 合规判据必须是 DSH 自己的 schema，不是我造的

★ 一个容易踩的坑：同名字段在不同地方规则相反
- 工作区里的 createdAt 要是字符串
- 会话缓存里的 createdAt 要是数字

⇒ 所以它按域加载规则，不搞「一套规则通用」。

适合谁

- 遇到会话损坏 / 聊天记录打不开的人
- 想手动改 ~/.dsh/storages/ 的人
- 做 DSH 数据相关工具的人

⚠️ 使用前提

这三个工具都依赖 DSH 客户端内部的代码结构。 ⇒ DSH 版本升级后可能失效，到时需要更新。

当前状态：三个都能用，正在把它们依赖的「从 app.asar 抽代码」逻辑抽成共享模块。

怎么装

方式一：不装，直接用
npx dsh-session-tools doctor <会话文件>

方式二：装到全局
npm i -g dsh-session-tools
dsh-session-tools doctor <会话文件>

三个子命令

dsh-session-tools doctor <会话文件> # 会话体检（要截断会写新文件，从不覆盖原文件） dsh-session-tools oracle <会话文件> # 用 DSH 自己的代码验（报错与客户端一字不差） dsh-session-tools validate <域> # 用 DSH 自己的 schema 校验 storages

⚠️ 重要前提

这三个工具都依赖 DSH 客户端内部的代码结构（会从 app.asar 里读框架自己的包）。
⇒ DSH 版本升级后可能失效，到时需要更新。

安全设计

- doctor 从不覆盖原文件 —— 截断结果写新文件
- 三个都不写任何配置文件
- validate 按域加载规则 —— 同名字段在不同地方规则相反，不能一套规则通用

许可

MIT

维护策略

这是一个个人项目，按现状发布（as-is）。

- Issue / PR 欢迎，但不保证及时回复 —— 我有正职，这是业余时间做的
- PR 我会看 diff 再决定要不要合并 —— 不会盲目合并（安全起见）
- 不接受「催更」 —— 有需要欢迎自己 fork 改
- 如果你发现了好用的改进，欢迎提 PR；如果我长期没回，你完全可以 fork 走

这个项目不承诺任何 SLA。 用之前请自己评估。