dsh-lot2-metrics

lot2 后端会把数据库相关指标整理成「项目快照信封」式的采集结果，但真正用起来时，你往往还需要在 DSH 里问 agent「现在调用量怎样、有没有越界」、或者在开会话时扫一眼新鲜度和 Top-N，而不是反复打开原始 JSON 或自己去猜上一次数字是否还有效。本插件只做呈现与查询：读落盘快照，绝不自己去抓 /metrics，也绝不写任何文件，把「取数」和「触发采集」留给 lot2 与 DSH 采集链路，避免两套事实各说各话。

在 host 侧注册两个只读 agent 工具（概览与按条件查询）以及 /status、/snapshot 端点；client 侧提供会话 tab「lot2 指标」，按阈值结论、运行期 gauge、调用量 Top、放大倍数 Top 分区展示，并支持约 60 秒轮询与手动刷新。运行期与阈值遵循明确纪律：value 为 null 要显示原因、采集器声明但未上报的指标单独标「缺失≠0」、阈值结论只读采集器落盘的 collector-state，本插件不做第二套判定。契约版本不兼容、采集失败、快照过期或数据新鲜时，界面与工具都会如实区分，且回答带上 capturedAt 与快照路径以便追溯。

适合已经在跑 lot2 指标采集（dsfolder 脚本与 launchd）、希望在 DSH 里把指标变成「可对话、可面板」的运维与开发者；也适合需要 agent 在会话中引用最新快照、又不想让插件拖垮整棵 Cordis 树的场景——缺文件、坏 JSON 或缺字段一律降级留空并给出 reason，不向宿主抛异常。