dsh-session-health

DSH 会话文件采用多帧 zstd 格式存储，但常规解码器可能只读取首帧，导致会话内容被误判为空或损坏。这给故障排查和自动化管理带来挑战。dsh-session-health 插件正是为解决这一痛点而设计：它通过独立的帧级扫描逻辑，深入分析会话文件的内部结构，识别如撕裂、损坏、空会话、异常大帧等问题，并输出清晰的健康报告和修复建议。

插件的核心能力在于其安全且细致的诊断方式。它坚持只读原则，绝不修改任何文件，确保诊断过程零风险。同时，通过路径围栏和真实路径检测，防止目录穿越等安全问题。对于需要更深层次分析的场景，插件支持可选的深度模式，尝试解码会话头与事件结构，提供更丰富的洞察。所有分析结果都以结构化 JSON 格式呈现，便于集成到监控或运维流程中。

无论你是 DSH 系统的管理员，需要定期检查会话文件的健康状态以预防问题；还是开发者，正在调试会话持久化相关的 bug，希望快速定位文件异常；甚至是 AI 模型，在自动化任务中需要评估会话数据的完整性，这个插件都能提供可靠的支持。它让会话健康检查从手工脚本变为可重复、可信赖的工具。