Hermes HUD — 给 AI Agent 装一块意识监控仪表盘

想象一下：你的 AI Agent 正在后台默默工作——它记了哪些事、调用了多少 Token、花了多少钱、哪个模型表现最好——但你只能靠猜。Hermes HUD 就是来解决这个盲区的：它把 Hermes Agent 的所有内部状态，完整地呈现为一个浏览器里的可视化仪表盘。

图1：Executive Dashboard（执行概览），显示健康状态、花费脉冲、TOP 模型、风险评估等关键信号

这个项目来自独立开发者 Joey Rodriguez，GitHub 收获 1645 颗星，是目前最受关注的 Hermes 生态可视化工具之一。它的前身是一个 TUI（终端界面）版本，后来作者将完整功能移植到了 Web 端，交互体验大幅提升。

痛点：Agent 越强，越需要一个「透明黑箱」的窗口

当你让 AI Agent 执行复杂任务时，它在后台经历了什么？

• 记忆层面：它读取了你的 ~/.hermes/ 记忆文件，哪些被用上了，哪些接近容量上限？
• 成本层面：这次对话花了多少钱？不同模型价格差异巨大，MiniMax 和 Claude 的性价比如何？
• 能力层面：它的 Web Search 工具走了哪个网关配置？Skill 插件是否正常运行？
• 安全层面：它有没有执行过 Sudo 级别的敏感操作？

这些信息 Hermes Agent 本身是有的，但默认不暴露给用户。Hermes HUD 的核心价值，就是把这些藏在文件系统里的状态数据捞出来，做成直观的 Web UI，让运维人员和开发者对 Agent 行为有完整的可见性。

核心功能：18 个标签页，覆盖 Agent 运营全维度

执行概览（Executive Dashboard）

启动后的默认视图，显示最关键的几个指标：

• Health Pulse：文件系统 + WebSocket 实时健康状态
• Spend Pulse：今日/本周花费走势
• Top Model：Token 消耗最多的模型
• Provider/Gateway Risk：多 Provider 并发使用时的配置漂移风险
• Action Items：诊断问题清单（来自健康检查、Provider 告警、Gateway 状态）

耗性能的刷新路径均做了节流（throttle），避免频繁请求拖慢页面。

Gateway Tools（网关工具可见性）

图2：Gateway Tools，清晰展示每个工具的路由方式（Nous Tool Gateway / Direct Key / Unavailable）

当你配置了 Web Search、图像生成、TTS、Browser 自动化等工具时，这里能看到每个工具的路由策略：是通过 Nous Gateway 代理，还是直连 API Key，还是完全不可用。"Update Hermes" 按钮故意设计为两步骤操作，并展示最近运行日志，降低误触风险。

Plugin Hub（插件管理）

图3：Plugin Hub，显示已安装插件、运行时状态、所需认证命令，支持安全的启用/禁用/更新

Dashboard 插件和 Agent 插件分别展示，包含扩展入口点、运行状态、必要认证命令，以及安全的启用/禁用/更新操作。这是运维友好性设计的典型体现——安全操作不能一步完成，必须有确认步骤。

Hermes Replay（运行回放）

图4：Hermes Replay，将 Agent 运行过程序列化为可分享的脱敏回放文件

这是最有意思的差异化功能。它能将任意一段 Agent 运行会话转化为脱敏可分享的回放文件，包括：

• Redacted JSON 回放
• GitHub 风格的 Markdown 报告
• 独立运行的 HTML 页面
• 1200x630 PNG 分享卡片（适合社交媒体）
• Fork-safe fork.json

Safe Share Mode 是默认导出策略：在写入分享文件之前，会先脱敏处理——原始工具参数、Terminal 输出、推理过程、Token 值、邮箱、路径等敏感字段都会被替换为占位符。导出的文件包含本地哈希和 Ed25519 签名，证明文件在本地未被篡改，但不提供任何外部第三方验证。

可选的远程发布功能可将回放同步到 GitHub Pages，生成静态画廊页面。公共回放出现在画廊索引，未公开的回放只能通过不可预测的哈希路径访问。

Model Analytics（模型分析）

图5：Model Analytics，可视化各模型的 Token 消耗、请求量、成本分布

技术架构：前后端分离 + 文件系统观测 + WebSocket 实时推送

后端：FastAPI + ThreadPoolExecutor 并行采集

后端使用 FastAPI 框架，API 路由覆盖 18 个数据域（state、memory、sessions、skills、cron、projects、health、profiles、patterns、corrections、agents、timeline、snapshots、dashboard、token_costs、cache、chat、sudo、providers、gateway、model_info、plugins、replay）。

数据采集层（collectors/）使用 ThreadPoolExecutor 并行采集，Config 优先执行（因为内存限制需要提前计算），然后 Memory、Skills、Sessions 三个线程并发运行，最后合并为 HUDState 对象。

智能缓存机制（cache.py）：核心设计亮点。对耗时操作（如读取大量记忆文件）做内存缓存，缓存键基于文件 mtime（修改时间）计算 MD5 哈希，文件变化自动失效，无需手动清理。这比简单的 TTL 缓存更精准。

文件监听（file_watcher.py）：启动时监控 ~/.hermes/ 目录的文件变化，触发数据重采集，并通过 WebSocket 推送到前端，实现免刷新实时更新。

前端：React 19 + TypeScript + Vite + Tailwind v4

前端技术栈非常新：React 19、TypeScript、Vite 构建工具。UI 框架使用 Tailwind CSS v4，配合 @tailwindcss/vite 插件。状态管理用 SWR（stale-while-revalidate），API 调用层用了 @ai-sdk/react 和 ai SDK（用于 chat 功能）。

主题系统：内置 5 套主题，通过 t 快捷键切换，默认主题为 Neural Awakening（青色系）。语言支持中英文，切换后 Agent 回复语言也会同步切换。

部署特点

• 前后端一体化：通过 uvicorn 运行后端，Vite 开发模式下前端独立；生产模式下前端构建产物由 FastAPI StaticFiles 托管，单进程服务
• 无数据库依赖：数据直接读自 ~/.hermes/ 文件系统，不额外维护数据库
• WebSocket 实时：双向通信，后端文件变化主动推送，前端无需轮询
• 本地优先：Replay 功能默认只写本地文件系统，不上传任何数据到第三方

上手体验：install.sh 全自动，门槛低

安装流程极度友好：

git clone https://github.com/joeynyc/hermes-hudui.git
cd hermes-hudui
./install.sh    # 自动检测平台，安装 Python venv + Node 依赖
hermes-hudui    # 启动服务

脚本会自动检测 Python 3.11+ 和 Node.js 18+，创建虚拟环境，安装后端依赖（fastapi、uvicorn、pyyaml、watchfiles、pillow、cryptography）和前端依赖。启动后浏览器打开 http://localhost:3001 即可。

限制条件：需要本地已运行 Hermes Agent 且生成了 ~/.hermes/ 数据目录。纯新用户首次安装时，Dashboard 会显示为空（提示"未发现 Hermes 数据"），需先让 Hermes Agent 工作一段时间积累数据。

局限性：不支持 Docker，也不适合纯小白

项目没有提供 Dockerfile 或 docker-compose.yml，不能容器化部署。依赖宿主机 Python 3.11+ 和 Node.js 18+ 环境，且假设 ~/.hermes/ 目录存在——在服务器/CI 环境下的自动化部署场景中，这带来了额外适配成本。

此外，这是一个开发者工具，面向已经运行 Hermes Agent 且有一定运维能力的用户。完全不了解 Hermes Agent 的用户，在首次打开时会看到一片空白的数据面板，可能产生困惑。

行业意义：让 AI Agent 从「黑箱」变成「玻璃箱」

随着 AI Agent 逐渐承担复杂任务，Agent 可观测性（Observability）将成为刚需。LangSmith、Honeycomb、Weave 等工具解决的更多是 LLM 调用层面，而 Hermes HUD 填补了一个空白：面向个人开发者的本地 Agent 状态可视化。

它的 1645 星和持续迭代（已发布 0.9.1 版本，CHANGELOG 记录详细）表明这个方向有真实需求。随着 Hermes Agent 用户群扩大，对应的 HUD 需求会同步增长。Replay 功能的 Safe Share 设计也很有意思——它在"可观测性"和"隐私安全"之间找到了一个务实的平衡点。