这个项目能做什么

本项目为 Hermes Agent 提供一个只读状态仪表盘,以单条置顶 Telegram 消息的形式呈现,并按计划原地编辑。更新器作为插件在网关内部运行,使用引擎自带的 Telegram 适配器,因此机器人令牌始终不会离开引擎。对于没有插件 API 的安装环境,可使用独立机器人的 cron 定时任务作为后备方案。 仪表盘消息以紧凑的手机屏幕格式显示:带日期数据戳的整体健康状态、网关与 Telegram 连接状态、上次备份时间与完整性、配置漂移(与基线不同的键)、各提供商(Claude、Codex、Grok、Kimi、Gemini)的账户限额及重置时间,以及正在运行的 Hermes 版本与上游最新版本。折叠的详情块包含确认时间、覆盖范围、备份详情、漂移检查时间、发布日期,以及任何缺失数据的原因。 新鲜度是核心要求:消息始终显示绝对数据时间和上次 Telegram 确认时间。连续两个周期未确认的消息会显示醒目的横幅。外部看门狗命令通过退出码报告新鲜度。插件探测的是能力而非版本号,在未知版本上会优雅降级为“不支持”。交付需要 Hermes 0.21.1 或更高版本;在 0.20.x 上只有 cron 后备方案可用。 安装可通过 Hermes Plugin Catalog(`hermes plugins install telegram_dashboard_probe`)或复制插件文件夹完成。配置通过 `config.yaml` 设置或环境变量进行,包括聊天 ID、话题 ID、周期、漂移报告、备份状态和限额来源。插件将交付记录写入插件状态,以便重启后编辑同一条消息。屏幕在适配器支持时使用 HTML,否则使用纯文本,并带有自动回退和重试逻辑。 账户限额在有官方提供商接口时来自官方接口,否则来自本地记账,或显示“无数据”并附原因。Gemini 在没有账单的情况下没有数字,改为显示上次拒绝时间。Hermes 版本行仅供参考,不提供更新建议。项目包含针对真实引擎对象运行的测试,以及记录已验证版本的兼容性矩阵。