Hermes Agent实时Token账单监控指南：【精算成本】
你是否在使用AI进行对话时，对每句话的Token消耗与费用感到不透明？每月账单上的数字常常令人困惑，不清楚是哪些模型或哪些会话产生了主要成本。通过Hermes Agent的Web界面，你可以直观地监控每条消息的资源消耗、费用明细及开销趋势，从而实现精细化的成本管理。
安装 Hermes-UI 监控面板
请在终端中依序执行下列命令，以部署监控面板：
git clone https://github.com/joeynyc/hermes-hudui.git → cd hermes-hudui → ./install.sh → hermes-hudui
此操作需在Hermes Agent已正常安装并运行的前提下进行。面板将读取位于~/.hermes/目录下的Agent运行状态数据。执行时请务必处于hermes-hudui项目根目录，以避免./install.sh因路径问题导致依赖安装失败。
安装完成后，终端将提示“Hermes HUD UI started on http://127.0.0.1:3001”。
查看 Token 消耗详情
通过浏览器访问 http://127.0.0.1:3001，进入主仪表盘。随后点击顶部导航栏的COSTS面板。
面板内汇总了总Token消耗量、总会话数与消息数。下方的表格则按模型维度进行了细分，清晰展示OpenAI/gpt-4o、Claude/sonnet等各模型的用量及对应的成本估算。
趋势图默认显示近7日的Token消耗折线。将鼠标悬停于任一数据点，即可查看该日的具体数值。
定位高消耗会话与消息
若需分析成本构成并识别优化点，可按以下步骤操作：
第一步：进入Sessions面板，点击“Tokens Used”列进行降序排序；
第二步：定位总消耗最高的会话条目，并点击其右侧的“View Details”；
第三步：在展开的详细消息流中，逐一检查每条AI回复旁标注的in/out tokens数值；
第四步：重点关注输出Token显著偏高的消息。这类回复通常包含冗长解释、未精简的代码块或冗余的JSON结构，是进行Prompt优化或输出长度控制的首选目标。
对比不同 Profile 的成本分布
在管理多个Profile时，可通过以下两种方式分析其成本差异：
方法一：前往Profiles总览面板，每个Profile名称旁会直接显示其累计Token消耗；
方法二：点击进入任一Profile的详情页，从左侧菜单选择Token Costs，即可查看该Profile独立统计下的模型调用明细与日度开销趋势。
请注意：各Profile的state.db数据相互隔离，因此成本统计天然独立。如果你发现default profile的消耗量异常突出，通常是因为启动时未通过-p参数明确指定profile，导致大量请求被默认归集至default。
设置 Token 预警阈值（需手动配置）
在终端中编辑Hermes Agent的主配置文件：vim ~/.hermes/config.yaml
在配置的全局区块下添加以下字段：token_budget:
daily_limit: 50000
notify_on_exceed: true
保存配置后，重启Hermes Agent服务（执行hermes stop后hermes start）。该预警不会直接显示在Web UI中，但会在终端日志生成WARNING记录，并尝试触发系统通知（需本地已配置notify-send或osascript等通知工具）。
