执行hermes doctor，确认【Model: connected】、【Memory: initialized】、【Tools: enabled】全部绿色通过；再运行hermes doctor --deep --no-cache和--target memory排查技能、缓存与记忆异常。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要快速判断 Hermes Agent 是否配置正确、依赖完整、服务就绪，而不是反复重启或盲目修改配置文件。
基础健康检查：5秒确认核心组件是否就绪
在终端任意目录下执行：hermes doctor。
观察输出中三项关键状态是否全部显示绿色 【Model: connected】、【Memory: initialized】、【Tools: enabled】——缺一不可。若任一项为红色 error 或 missing，说明底层未通过初始化校验，后续所有操作都可能失败。
这一步不依赖网络代理或模型实际响应，只验证本地配置加载、SQLite 记忆库可写、内置工具二进制文件存在且有执行权限。
深度诊断：定位技能失效、缓存污染、元数据损坏
方法一：全量扫描技能与依赖完整性
运行 hermes doctor --deep。该命令会逐个读取 ~/.hermes/skills/ 下每个技能的 manifest.yaml，校验字段完整性、Python 依赖声明、入口函数签名，并检测是否存在已卸载但残留元数据的“幽灵技能”。
方法二：强制跳过缓存，验证真实配置状态
添加 --no-cache 参数：hermes doctor --deep --no-cache。避免因 stale cache 导致的模型配置误判——比如你刚改了 config.yaml，但 hermes doctor 仍显示旧模型，就是缓存未刷新所致。
方法三：聚焦记忆模块时间戳与摘要一致性
执行 hermes doctor --target memory。它直接读取 ~/.hermes/state.db，输出最近 5 条会话摘要及对应时间戳，用于排查跨会话记忆丢失、时间倒流（如系统时钟被手动调整）等异常。
端口与服务连通性诊断
第一步：确认 Hermes 正在监听指定端口
先确保 Hermes 已启动（例如执行过 hermes --tui 或 hermes start），再运行 hermes doctor --port 3000（若你配置的是其他端口，请替换为实际值）。
第二步：区分两类失败原因
若提示 Connection refused，说明 Hermes 进程未绑定该端口，需检查 hermes config 中 server.port 设置，或确认是否误用了 --no-server 启动参数；若提示 Connection timeout，则大概率是防火墙拦截或 Docker 网络桥接未开放端口。
第三步：验证绑定地址是否为 localhost
默认情况下 Hermes 只监听 127.0.0.1。若你在远程服务器部署并希望从外部访问，必须显式配置 server.host: "0.0.0.0" 并重新启动，否则 --port 检查永远失败。
生成离线诊断包：提交问题前必做
① 在终端执行：hermes doctor --archive --output /tmp/hermes-diag-$(date +%s).tar.gz。
② 归档自动包含三类脱敏快照：config-summary.json（仅保留结构，API Key 全部掩码）、env-check.txt（只记录 .env 中各变量是否存在及长度，不输出值）、skills-report.csv（技能名、安装时间、最后调用时间戳）。
③ 将生成的 .tar.gz 文件发给社区支持或协作排查——它不含任何原始对话、密钥、文件路径明文，符合最小必要原则。
注意：该命令不上传任何数据到外部服务器，所有打包动作均在本地完成。
高级日志诊断：捕获静默失败的堆栈
当 hermes doctor 显示全部 PASS，但 Hermes 仍无法启动或某项功能无响应时，启用全量调试日志：
执行 hermes doctor --verbose --log-file /tmp/hermes-debug.log。
该命令会输出模型请求头、工具调用栈、内存状态快照，以及 Python import 链路中的每一环节。滚动查找以 ERROR 开头的行，重点关注 Failed to import module 或 Permission denied 类提示——它们往往指向虚拟环境冲突或文件权限错误。
日志文件生成后，可直接用 less /tmp/hermes-debug.log 查看，或用 grep -i error /tmp/hermes-debug.log 快速过滤关键线索。
