概述
hermes logs 用于查看、跟踪和过滤 Hermes Agent 的日志文件 — agent.log、errors.log、gateway.log、gui.log 和 desktop.log。你可以选择要读取的日志、限制行数、实时跟踪，并按级别、会话 ID、时间或组件过滤。
用法
hermes logs [-h] [-n LINES] [-f] [--level LEVEL] [--session ID] [--since TIME] [--component NAME] [log_name]日志名称
log_name 为可选参数，用于选择要查看的日志：
| 名称 | 日志文件 |
|---|---|
agent（默认） |
agent.log — Agent 活动 |
errors |
errors.log — 错误条目 |
gateway |
gateway.log — 网关/平台活动 |
gui |
gui.log — GUI 活动 |
desktop |
desktop.log — Electron 应用启动/后端 |
list |
列出可用的日志文件及其大小 |
选项
| 选项 | 说明 |
|---|---|
-n LINES, --lines LINES |
显示的行数（默认：50） |
-f, --follow |
实时跟踪日志（类似 tail -f） |
--level LEVEL |
显示的最低日志级别（DEBUG、INFO、WARNING、ERROR） |
--session ID |
过滤包含该会话 ID 子串的行 |
--since TIME |
显示自 TIME 之前以来的行（例如 1h、30m、2d） |
--component NAME |
按组件过滤：gateway、agent、tools、cli、cron、gui |
示例
# 显示 agent.log 的最后 50 行
hermes logs
# 实时跟踪 agent.log
hermes logs -f
# 显示 errors.log 的最后 50 行
hermes logs errors
# 显示 gateway.log 的最后 100 行
hermes logs gateway -n 100
# 实时跟踪 gui.log
hermes logs gui -f
# 实时跟踪 desktop.log（Electron 应用启动/后端）
hermes logs desktop -f
# 只显示 WARNING 及以上级别
hermes logs --level WARNING
# 按会话 ID 过滤
hermes logs --session abc123
# 只显示与工具相关的行
hermes logs --component tools
# 显示最近一小时内的行
hermes logs --since 1h
# 从 30 分钟前开始跟踪
hermes logs --since 30m -f
# 列出可用的日志文件及其大小
hermes logs list技巧
- 组合使用过滤器：例如
hermes logs gateway --level ERROR --since 2h查看最近的网关错误。 - 使用
hermes logs list查看存在哪些日志文件及其大小。 --follow非常适合实时调试 — 在另一个终端窗口中运行它，同时复现问题。--session便于跨日志追踪单个会话。- 日志文件位于
~/.hermes/logs/目录下，你也可以直接查看。