dsh-session-health¶

⭐ 8 · ✅ 活跃 · 插件


类型	插件	分类	记忆与上下文
星数	⭐ 8	状态	✅ 活跃
作者	omdsh-dev	更新时间	2026-08-21
子分类	🔍 上下文审计	能力	observability, files

一句话介绍¶

多帧 zstd 会话文件的帧级扫描诊断：撕裂/损坏/空会话检测，零依赖只读。

详细介绍¶

English DSH 会话健康检查插件 —— 对 $DSH_HOME/sessions 下的多帧 zstd 会话文件做帧级扫描诊断（torn / 损坏 / 空会话 / stray 文件），输出健康报告与清理建议。只读：绝不修改或删除任何文件。仓库：https://github.com/omdsh-dev/dsh-session-health（public）

✨ 核心特性¶

只读保证：绝不修改/删除任何文件（测试覆盖"扫描后文件字节数不变"，见 files.spec SH-06 用例）
路径围栏：session id 严格目录名白名单（防 ../ 穿越）；绝对路径与最终文件均做 fs.realpath 真实路径 containment（防符号链接/junction 逃逸）；枚举用 lstat 拒绝 symlink
零业务依赖：zstd 帧扫描器为独立实现（DataView 读字节，RFC 8878 结构，与官方 scanZstdFrames 差分一致）
深度分析可选：deep: true 时动态 import 官方解码器；解析失败明确降级 deep: "unavailable"，绝不静默
输入范围固定（sessions 目录），无网络、无执行面

📦 安装¶

# 交互式（web）profile
dsh plugin --profile web add github:omdsh-dev/dsh-session-health
# 一次性任务（headless）profile —— dsh run 默认使用 headless
dsh plugin --profile headless add github:omdsh-dev/dsh-session-health

🚀 快速开始¶

dsh plugin --profile web add dsh-session-health-*.tgz

📚 更多信息¶

示例

session_health { action: "scan" } → {"root":"C:\Users\admin\.dsh\sessions","scanned":39,"errors":{...},"suspicious":{...},"suggestions":[...]} session_health { action: "file", path: "session-abc123", deep: true } → 单文件报告（含事件分布与中断检测）

安装

DSH 0.1.2-rc.1（npm）下，插件通过 dsh plugin --profile <profile> add <source> 安装，source 支持 GitHub 仓库或 npm pack tarball。

从 npm pack tarball 安装

npm pack 产物可直接作为 source 安装： dsh plugin --profile web add dsh-session-health-.tgz 包内 dsh.bundle.patch 会在安装后自动把插件加入 profile 的 layer stack（row id：tool-session-health）。插件缺失的 peer 依赖（@deepseek-ai/cordis、@deepseek-ai/dsh-tools）由 profile 的 healed profiles/node_modules 回退安装提供。 > ⚠️ web 与 headless 是不同 profile*：web 安装不会自动覆盖 headless；dsh run 默认使用 headless profile。Windows 路径使用正斜杠（C:/...）。

旧场景：monorepo / 本地路径安装

monorepo 方式已标注为旧场景（本地 junction/symlink、手动编辑 profile 层、不支持 GitHub/tarball source 的旧快照）： dsh plugin --profile web add "C:/path/to/dsh-session-health"