会话健康诊断Shizuku-keop/dsh-health

dsh-health

DeepSeek Harness 会话循环健康度诊断：振荡 / 卡住 / 参数漂移 / per-tool / token / 压缩画像 + 可审计健康评分。

npm 包名：dsh-health-cli（dsh-health 在 npm 已被占位保留）；命令仍是 dsh-health。
当前里程碑：M7 + D（web 健康卡片 + 侧栏健康面板，本机已生效）。设计文档见 DESIGN.md，进度见 docs/PROGRESS.md。

界面预览

🟢 健康会话（100/100，无告警）与 能定位具体问题的诊断（80/100：参数漂移、per-tool 报错）

🔴 会话循环失控时实时标红：振荡循环 / 参数漂移 / per-tool 报错，每条发现附带可执行建议与证据 seq

直接嵌入 DSH 对话流（dsh-health-live 纯观察 bundle，不注入任何消息）。

安装

npm i -g dsh-health-cli      # npm 发布版（命令 dsh-health）
或源码安装：npm i -g D:\path\to\dsh-health

零运行时依赖，要求 Node ≥ 22.19（内置 node:zlib zstd 与 node:sqlite 支持）。

快速上手

dsh-health               # 等价 scan：列出最近会话
dsh-health scan          # 列出会话（--sort time|score|tokens）
dsh-health diag      # 解码一个会话，打印 meta + 事件统计
dsh-health report    # 全检测器分析：健康评分 + 发现清单
dsh-health verify        # 自检：后端可读 + 检测器可跑（30 秒）
dsh-health --help

CLI 自动定位本机 $DSH_HOME/sessions；--root  可覆盖（隔离环境/测试）；--sqlite  显式指定 SQLite 库（默认自动探测）。

当前能力（M1–M7 + D 完整）

- 双后端会话读取：JSONL+zstd（多帧容器、packed 行展开、seq 校验、torn-tail）与官方 SQLite 存储（schema 17、只读打开、packed 行/zstd blob/varint 解码、外库拒绝）——统一接口自动嗅探；
- 7 检测器 + 0–100 可审计评分：振荡 / 参数漂移 / 卡住 / per-tool / token 成本 / 压缩健康 / 综合评分；每条发现带建议动作与证据 seq；
- live 实时镜像（dsh-health-live bundle）：静态 cordis 插件监听 session/event 增量落盘 $DSH_HOME/.dsh-health/.jsonl——纯观察，不注入、不干扰 harness 循环；
- watch 实时告警：watch  单会话跟随（从日志 seed 历史 + live 增量 fold）、watch --all 多会话概览、--interval 控制轮询（默认 2s）；
- scan 排序：--sort time（默认，header-only 快）/ --sort score|tokens（全量分析，--max-scan 上限防慢，默认 50）；
- 三格式输出：--format text|json|md（report 与 scan 均支持）；
- 退出码门槛：report 时 score

License

MIT