安装成功需依次验证：一、hermesdoctor --version显示版本号；二、hermesdoctor check全[pass]；三、hermes --version有输出且hermes chat能响应；四、~/.hermes/.env含有效api key；五、hermesdoctor check --port确认端口可达。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成 HermesAgent 的安装流程，但不确定是否真正就绪，则可通过命令行工具 hermesdoctor 和核心命令 hermes 进行多维度验证。以下是确认安装是否成功的具体操作步骤：
一、检查 hermesdoctor 命令是否可识别
hermesdoctor 是 HermesAgent 官方提供的环境自检工具，其可执行性是验证 PATH 配置与安装完整性的重要前提。若该命令无法调用，说明安装未正确注入系统路径或存在中断。
1、打开终端（Linux/macOS）或 PowerShell（Windows，推荐以管理员身份运行）。
2、输入 hermesdoctor --version 并回车。
3、观察输出结果：若显示类似 hermesdoctor 1.2.0 的版本号，则命令已成功注册；若提示 command not found 或 'hermesdoctor' is not recognized as an internal or external command，需检查 PATH 环境变量或重新执行安装脚本。
二、运行基础环境自检
此步骤通过 hermesdoctor check 扫描 Python 运行时、必要模块、配置文件存在性及端口占用等关键项，覆盖多数常见部署失败场景，无需额外参数即可完成快速验证。
1、在终端中执行 hermesdoctor check。
2、等待扫描完成（通常耗时 5–15 秒）。
3、逐行查看输出中的标记：所有条目均显示 [PASS] 表示基础环境就绪；任一出现 [FAIL] 须依据其后提示信息定位对应问题（如缺失模块、配置文件路径错误等）。
三、验证核心命令 hermes 是否响应
hermes 命令是 HermesAgent 的主入口，其版本输出与基础交互能力直接反映主体程序是否安装并可调用。该验证独立于 hermesdoctor，用于确认 Agent 主体二进制/脚本的可用性。
1、在终端中执行 hermes --version。
2、若返回类似 hermes 0.8.3 的版本字符串，表明主程序已注册成功。
3、进一步执行 hermes chat "你好，介绍一下你自己"。
4、若终端中返回结构化响应（如包含 agent 名称、功能描述的 JSON 或文本输出），且无 ModuleNotFoundError 或 Command 'hermes' not found 类错误，则代表安装主体已生效。
四、确认配置文件与 API Key 可读取
HermesAgent 启动依赖 ~/.hermes/.env 中的有效配置，尤其是模型提供商 API Key。即使命令可执行，若配置缺失或格式错误，仍会导致后续运行失败。此步验证配置层完整性。
1、执行 ls -la ~/.hermes/.env，确认文件存在且权限非空。
2、运行 cat ~/.hermes/.env | grep -i "api_key\|key="，检查是否包含非空 API Key 行。
3、若输出为空或仅含注释行（# 开头），说明配置向导未完成或手动编辑遗漏；此时应重新运行 hermes setup 或直接编辑该文件填入有效 Key。
五、探测服务端口连通性（适用于已启动场景）
当 HermesAgent 已尝试启动（如执行 hermes start），但外部无法访问时，需确认其监听端口是否真实可达。该验证可区分“进程未启动”与“启动但未响应”两类问题。
1、确保已执行 hermes start 或等效启动命令。
2、查阅配置文件确认实际监听端口（默认为 8080，亦可能为 3000 或其他值）。
3、执行 hermesdoctor check --port 8080（将 8080 替换为实际端口）。
4、若返回 Port 8080 is reachable，表示服务正在监听并接受连接；若返回 Connection refused，则服务进程未运行、绑定地址非 localhost 或被本地防火墙拦截。
