프로젝트 소개

이 프로젝트는 Hermes Agent용 읽기 전용 상태 대시보드를 제공하며, 일정에 따라 제자리에서 편집되는 하나의 고정된 Telegram 메시지로 표시됩니다. 업데이터는 게이트웨이 내부에서 플러그인으로 실행되며, 엔진 자체의 Telegram 어댑터를 사용하므로 봇 토큰이 엔진 밖으로 나가지 않습니다. 플러그인 API가 없는 설치를 위한 대체 수단으로 별도 봇을 사용하는 cron 틱을 사용할 수 있습니다. 대시보드 메시지는 휴대폰 화면에 맞는 간결한 형식으로 다음을 표시합니다. 날짜가 포함된 데이터 스탬프가 있는 전체 상태, 게이트웨이 및 Telegram 연결 상태, 마지막 백업 시간과 무결성, 구성 드리프트(기준선과 다른 키), 각 제공자(Claude, Codex, Grok, Kimi, Gemini)의 계정 한도와 재설정까지 남은 시간, 실행 중인 Hermes 버전과 최신 업스트림 릴리스입니다. 접힌 세부 정보 블록에는 확인 시간, 적용 범위, 백업 세부 정보, 드리프트 확인 시간, 릴리스 날짜, 누락된 데이터의 이유가 담깁니다. 신선도는 핵심 요구 사항입니다. 메시지는 항상 절대 데이터 시간과 마지막 Telegram 확인 시간을 표시합니다. 두 기간 동안 확인되지 않은 메시지에는 눈에 띄는 배너가 붙습니다. 외부 watchdog 명령은 종료 코드로 신선도를 보고합니다. 플러그인은 버전 번호가 아니라 기능을 탐지하며, 알 수 없는 버전에서는 'unsupported'로 우아하게 저하됩니다. 전달에는 Hermes 0.21.1 이상이 필요하며, 0.20.x에서는 cron 대체 수단만 작동합니다. 설치는 Hermes Plugin Catalog(`hermes plugins install telegram_dashboard_probe`)를 통해 또는 플러그인 폴더를 복사하여 수행합니다. 구성은 `config.yaml` 설정 또는 환경 변수를 통해 이루어지며, 채팅 ID, 스레드 ID, 기간, 드리프트 보고서, 백업 상태, 한도 소스가 포함됩니다. 플러그인은 전달 기록을 플러그인 상태에 기록하므로 재시작해도 같은 메시지를 편집합니다. 화면은 어댑터가 지원하면 HTML을 사용하고, 그렇지 않으면 일반 텍스트를 사용하며, 자동 대체 및 재시도 로직이 있습니다. 계정 한도는 가능한 경우 공식 제공자 표면에서, 그렇지 않으면 로컬 회계에서, 또는 이유와 함께 'no data'로 가져옵니다. Gemini는 청구 없이는 숫자가 없으므로 대신 마지막 거부 시간을 표시합니다. Hermes 버전 줄은 정보 제공용일 뿐이며 업데이트 조언은 없습니다. 프로젝트에는 실제 엔진 객체에 대해 실행되는 테스트와 검증된 버전을 문서화한 호환성 매트릭스가 포함되어 있습니다.