dsh-health

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

当前里程碑：M5（dsh-health-live bundle + watch，已本机真机验证）。设计文档见 DESIGN.md，进度见 docs/PROGRESS.md。

安装

npm i -g dsh-health          # 或 npm link（源码目录）

零运行时依赖，要求 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 库（默认自动探测）。

当前能力（M5）

双后端会话读取：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

dsh-health

AI 分析

安装

说明文档

dsh-health

安装

快速上手

当前能力（M5）