前言¶
在 DeepSeek Harness（DSH）里跑长任务时，会话日志会不断累积。体积过大的 session 容易在长时间任务里触发 OOM；进程异常退出还可能留下未闭合的 turn（crash tail），恢复时虽然 dsh 会尝试修复，但你不一定知道问题已经发生过。手动翻目录、看文件大小既慢，也容易漏掉 event 数量膨胀这类前兆。
下面介绍社区插件 dsh-healthcheck（维护者 neufagents），在 只读 前提下扫描整个 session library，并对单个 session 做深度检查，帮助你在出大问题前发现异常。
这是什么¶
dsh-healthcheck 是面向 DSH 的运行时健康检查插件：对 session 库做汇总扫描，并可对指定 session 检查尾部是否像 crash 撕裂、tool-call 与 result 是否配对等。它不修改任何字节，零配置 即可使用。
- 仓库：github.com/neufagents/dsh-healthcheck
- 社区目录：SkillHub 插件页
- 分类：admin-security
- 许可证：MIT（资料见仓库 README）
- 当前 package 版本：0.1.1（编译产物在
dist/，供 Node 加载）
SkillHub 等为社区独立目录，与 DeepSeek / 幻方无官方从属关系；安装插件前仍建议自行查看源码与许可证。
核心功能¶
插件只暴露一个工具：health_check。
全库扫描（无参数）¶
调用 health_check（不传参）会扫描整个 session library，输出例如：
- 汇总：session 数量、总大小、event 总数
- 体积最大的若干 session
- ** oversized 告警**：session ≥10 MB 为 watch，≥30 MB 为 danger（长任务 OOM 的常见前兆）
- event 数量告警：≥3000 为 watch，≥8000 为 danger
单 session 深度检查¶
health_check session_id="<id>"
对指定 session 日志做深入检查，包括：
- tail balance：若存在未闭合的 turn，通常表示 crash tail；dsh 在 resume 时会自动修复，此处仅告知曾发生过
- tool-call / result 配对情况
- event 类型分布
以上操作均为 read-only，不会改写本地 session 数据。
安装与启用¶
安装要求 PATH 上可用 pnpm（dsh 插件安装会转发到 pnpm）。官方 README 给出的命令如下：
# requires pnpm on PATH (dsh plugin forwards to pnpm)
dsh plugin --profile web add github:neufagents/dsh-healthcheck
安装完成后 重启 dsh，再让 agent 执行检查即可。
典型用法¶
重启后，可直接用自然语言让 agent 调用插件，README 示例：
run a health check on my dsh sessions
需要盯某个 session 时，让 agent 带上 session_id 调用 health_check（参数形式以 agent 实际传参为准，语义为 session_id="<id>"）。
兼容性与版本注意¶
- 开发侧在 dsh 0.1.5-rc.2（developer preview）上做过测试；rc 线变动较快，遇问题可向仓库提 issue。
- 插件请使用 v0.1.1 及以上：v0.1.0 曾随包发布原始 TypeScript，Node 从
node_modules加载时会报ERR_UNSUPPORTED_NODE_MODULES_TYPE_STRIPPING；v0.1.1 起通过tsc编译到dist/再发布。
peer 依赖（见 package.json）包括 @deepseek-ai/cordis 与 @deepseek-ai/dsh-tools 等，需与当前 dsh 生态版本大致匹配。
适用场景与注意¶
适合谁
- 经常跑长任务、session 体积与 event 数持续增长的使用者
- 怀疑某次异常退出留下 crash tail，想在 resume 之外先确认日志状态
- 希望在改库、删文件之前，先用只读方式做一轮库级体检
务必注意
- 插件随 当前 dsh 进程权限 读取 session 路径；安装前应阅读仓库源码与 MIT 许可证，确认符合你的安全策略。
- 告警阈值（10/30 MB、3k/8k events）来自插件内置逻辑，资料中未描述可通过配置文件修改；若需定制，需以仓库后续文档或源码为准。
结尾¶
dsh-healthcheck 把「session 过大」和「crash 撕裂尾部」两类静默风险，收敛到一个只读工具 health_check 里：先全库看总量与 top session，再按需对单个 session_id 做 tail 与配对检查。零配置、不改数据，适合作为 admin-security 类运维习惯的一部分。
