Hermes Agent 提示 command not found 怎么办？

如果 Hermes Agent 安装后输入 hermes 提示 command not found，先不要重装。最常见原因是 shell 还没重新加载 PATH，或者你在另一个终端环境里运行了命令。官方安装说明里也把“重载 shell”列为安装后的第一步。

先做三步快速检查

1. 执行 source ~/.bashrc，如果你用 zsh，则执行 source ~/.zshrc。
2. 重新打开一个终端，再运行 which hermes。如果能看到路径，说明命令已经生效。
3. 运行 hermes doctor，让它检查依赖、配置和缺失项。

还是找不到时看哪里

如果 which hermes 仍然为空，多半是安装脚本写入 PATH 的 shell 配置文件没有被当前终端读取。Linux、macOS、WSL2 的默认 shell 不一定相同，先用 echo $SHELL 看自己正在用 bash 还是 zsh，再改对应配置文件。

WSL2 用户还要确认自己是在 Linux 子系统里运行，而不是 Windows 原生 PowerShell。Hermes Agent 官方明确不支持原生 Windows，Windows 用户应进入 WSL2 后再安装和运行。

不要急着删目录重装

重装通常解决不了 PATH 问题，还可能让已有配置更乱。正确顺序是：重载 shell、确认当前终端环境、运行 hermes doctor。只有医生检查显示依赖缺失或仓库损坏时，再考虑执行更新或重新安装。