hermes agent 安装后需通过五步验证：一、hermes --version 检查 cli 是否可用；二、hermesdoctor check 扫描环境；三、python 中 import hermesagent 验证模块导入；四、hermes chat "你好" 测试对话功能；五、curl http://localhost:8080/health 确认服务端口连通性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成 Hermes Agent 的安装流程，但不确定是否真正就绪，则需通过一系列标准化命令进行多维度验证。以下是覆盖基础识别、运行时环境、服务连通性与交互能力的测试命令大全：
一、检查 CLI 命令可执行性
该步骤验证 Hermes Agent 的主命令是否已正确注册至系统 PATH，是后续所有操作的前提。
1、打开终端（Linux/macOS）或 PowerShell（Windows，推荐以普通用户身份运行）。
2、输入 hermes --version 并回车。
3、若输出形如 Hermes Agent v0.8.3 的版本号，则 CLI 已全局可用；若提示 command not found 或 'hermes' is not recognized as an internal or external command，说明安装未完成或 PATH 未刷新。
二、执行基础环境自检（hermesdoctor check）
该命令调用内置诊断工具 hermesdoctor，在无参数状态下自动扫描 Python 运行时、核心模块导入、配置文件存在性及默认端口占用等关键项。
1、确保已安装 hermesdoctor（通常随 Hermes Agent 一同部署）。
2、执行 hermesdoctor check。
3、等待 5–15 秒完成扫描。
4、逐行查看输出：每项前缀为 [PASS] 表示通过；任一出现 [FAIL] 需按其后提示定位具体缺失项（如 Missing module 'pyyaml'）。
三、验证核心模块导入能力
该测试绕过 hermesdoctor 封装，直接在 Python 解释器中尝试导入 Hermes Agent 主包，可暴露虚拟环境隔离、包路径错误等深层问题。
1、激活 Hermes Agent 所用的 Python 环境（如已使用 venv，执行 source venv/bin/activate 或 venv\Scripts\activate）。
2、启动 Python 交互式解释器：python。
3、依次执行以下两行：
import hermesagent
print(hermesagent.__version__)
4、若无 ImportError 报错且成功打印版本号，表明核心包已正确安装并可被当前 Python 环境识别。
四、发起一次本地 CLI 对话测试
该步骤验证 Agent 启动流程、模型连接与基础响应链路是否完整，属于端到端功能验证。
1、确保 ~/.hermes/.env 中已正确配置至少一个模型 API Key（如 OPENAI_API_KEY）。
2、在终端中执行 hermes chat "你好"。
3、观察输出：若返回结构化响应（含时间戳、模型标识、自然语言回复），且无 ConnectionError 或 AuthenticationError 类报错，则对话通道已打通。
4、若首次运行卡顿超 30 秒，可中断后改用 hermes chat --timeout 10 "你好" 缩短等待阈值辅助判断。
五、探测默认服务端口连通性
当 Hermes Agent 以服务模式（如 hermes serve）运行时，此测试确认 TCP 监听是否生效，排除防火墙、端口冲突或绑定地址异常。
1、另启一个终端窗口，执行 hermes serve --port 8080 &（后台启动服务）。
2、等待约 3 秒，执行 curl -s http://localhost:8080/health | grep status。
3、若返回 "status":"ok"，表示服务进程正常响应；若返回空或 connection refused，说明服务未启动成功或未监听 localhost。
4、终止服务：kill %1（Linux/macOS）或 Stop-Process -Id $pid（PowerShell，需提前记录进程 ID）。
