dsh-session-health

How to install

About

dsh-session-health English DSH 会话健康检查插件 —— 对 $DSH_HOME/sessions 下的**多帧 zstd 会话文件**做帧级扫描诊断（torn / 损坏 / 空会话 / stray 文件），输出健康报告与清理建议。**只读**：绝不修改或删除任何文件。 仓库：https://github.com/omdsh-dev/dsh-session-health（public） 动机 8/7 调查 issue #376 时对 39 个会话文件做了全量解码分析，过程中发现一个关键事实：**DSH 会话文件是多个 zstd frame 的串联**（一个 19MB 会话 = 119,952 个 frame），用单帧解码 API 读多帧文件只能看到 header——曾导致"会话全空"的误判。这套诊断逻辑值得产品化为工具：模型可以直接问"我的会话文件健康吗"，而不是靠人手工写脚本。 与 dsh-session-repair-skill（修复损坏会话）互补：本工具**只读诊断发现** → repair 技能**修复**。 安全模型 **只读保证**：绝不修改/删除任何文件（测试覆盖"扫描后文件字节数不变"，见 files.spec SH-06 用例） **路径围栏**：session id 严格目录名白名单（防 ../ 穿越）；绝对路径与最终文件均做 fs.…

Recommendation signals

Meta

License

MIT

Language

TypeScript

GitHub stars

8

mo. downloads

–

Last push

2026-09-10

Created

2026-08-08

Links

Basic safety check

Findings

curated 收录但无 npm 包/安装命令

Sources

curated:awesome-dsh-plugin.com, curated:awesome-dsh-plugin/awesome-dsh-plugin

Topics

diagnostics, dsh, dsh-plugin, health-check, zstd