dsh-health

运维和自动化里最难的不是「能不能读到一个数」，而是读数、健康标准、失败含义分散在各处，最后只剩一句含糊的「好像没事」。dsh-health 把这件事收成一次只读读数：你在声明里写清从哪读、怎样算健康、每种异常代表什么，插件组合已有来源（文件、JSON 接口、日志尾部等），返回单一总裁决，并附带每条读数的值、理由与盲区说明。它不写入、不持久化、也不充当事实来源，适合挂在 Agent 工作流里做「此刻是否可继续」的判断。

核心能力围绕「可解释的裁决」而非监控大盘。支持多种读数类型（文件年龄与大小、存在性、JSON 字段、JSONL 末行、文本正则计数、目录计数、HTTP JSON 等），用运算符定义健康条件；严重度从 ok 到 broken 汇总，且刻意让 unknown 比 notice 更重——读不到就不能假装一切正常。API 还内置三条硬规则：无法读取永远是 unknown 而非 0 或 false；selftest 能验证每条准则是否真的可被判为不健康；每条读数必须声明 blind，避免「看起来全面、实则没说清局限」。

适合需要把健康检查交给模型或编排、又不想引入独立监控栈的团队与个人：用 readings.json 描述你要看的信号，通过 health_readout 一次拿到结构化结论。若你需要跨行聚合、历史趋势、或与上次值对比，README 已说明这超出读数组合的范围——应在上游产出快照或交给专门的记录器；本插件专注「当前样本 + 单一裁决」的清晰契约。