Hermes Agent CLI提供五种交互式日志分析方法：一、hermes logs实时捕获带颜色标记的日志流；二、hermes log inspect菜单式解析JSON会话；三、hermes log search语义关键词检索；四、hermes log diff对比会话差异；五、hermes log trace启用分布式链路追踪。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 Hermes Agent 过程中发现日志内容杂乱、格式不一、字段嵌套深或缺乏上下文，导致难以快速识别问题根源，则很可能是未启用 CLI 交互式分析能力或未按语义层级组织日志流。以下是通过 Hermes Agent 内置 CLI 工具开展交互式日志分析与调试的具体方法：
一、使用 hermes logs 实时启动交互式日志流
hermes logs 命令直接接入主进程 stdout/stderr，支持实时滚动、行内高亮与动态过滤，是唯一能捕获未持久化到文件的初始化错误和缓冲日志的入口。该命令默认启用 ANSI 颜色标记，ERROR 行自动标红，便于视觉聚焦。
1、执行 hermes logs 启动日志流，终端将开始持续输出带毫秒级时间戳的日志行。
2、在另一终端触发待诊断操作（如发送“查询昨日会议纪要”指令）。
3、返回日志终端，按下 Ctrl+S 暂停滚动
4、使用方向键上下浏览，定位含 "Traceback" 或 "Failed to initialize" 的关键行。
5、按下 Ctrl+Q 恢复滚动
二、调用 hermes log inspect 交互式解析单一会话
hermes log inspect 命令专为 JSON 会话日志设计，可自动加载 ~/.hermes/sessions/ 下最新文件，并提供菜单式字段导航，避免手动 jq 语法错误。它会预解析 event_type、status、tool_name 等高频字段并生成摘要视图，支持按事件类型筛选与错误跳转。
1、运行 hermes log inspect 启动交互界面，系统自动检测并加载最近会话 JSON 文件。
2、按 Tab 键切换字段视图
3、输入 /error
4、选中某条 error 记录后，按 Enter 键展开完整堆栈
5、按 q 键退出并返回上一级菜单
三、执行 hermes log search 语义关键词交互检索
hermes log search 不依赖正则表达式，而是基于内置 NLP 分词器对日志文本进行语义理解，支持同义词扩展与上下文感知匹配。例如输入“连不上飞书”，将自动匹配 “feishu connection refused”、“lark auth failed”、“gateway timeout” 等变体表述，适用于非技术用户快速定位。
1、执行 hermes log search 进入交互搜索模式。
2、输入自然语言描述问题，例如：“技能安装失败但没报错”
3、系统返回匹配度 Top 3 的日志片段，每条附带来源文件与时间偏移。
4、选择编号进入详情页，按 → 键查看前后 3 行上下文
5、按 s 键保存当前匹配结果至 ~/.hermes/debug_search_$(date +%s).json
四、运行 hermes log diff 对比两次会话行为差异
hermes log diff 支持选取两个会话 JSON 文件（如一次成功 + 一次失败），自动提取工具调用序列、模型响应长度、错误状态码等维度，生成结构化差异报告。该功能可识别静默失败（如 status 字段缺失）、工具调用顺序错乱、响应截断等隐蔽问题。
1、执行 hermes log diff 启动对比向导。
2、按提示依次输入两个会话文件路径，或直接输入 latest
3、确认对比维度：默认启用 tool_calls、model_response_length、error_status 三项。
4、查看差异矩阵，其中 红色单元格表示失败会话特有项
5、按 d 键导出 HTML 格式对比报告至 ~/Downloads/hermes_diff_report.html
五、启用 hermes log trace 启动分布式链路追踪
hermes log trace 在启动时注入 OpenTracing 上下文标识，将跨组件（Agent Core / Gateway / Tool Plugin）的日志自动关联同一 trace_id，支持在单条命令中聚合全链路日志。该模式需配合环境变量 HERMES_TRACE_ENABLED=true 使用，适用于排查网关转发失败、插件超时等跨层问题。
1、设置环境变量：export HERMES_TRACE_ENABLED=true。
2、重启 Agent：hermes stop && hermes start。
3、触发目标操作后，执行 hermes log trace --span session_start 查看从会话创建起的完整链路。
4、在输出中查找 trace_id: "trc_abc123"
5、执行 hermes log trace --id trc_abc123 提取该 trace 下全部组件日志并按时间排序。
