tech
hermes 无法识别命令
# 安装 Hermes Agent 后运行 `hermes` 提示"无法识别命令"，怎么解决？
有朋友用 pip 成功安装了 Hermes Agent，但运行 hermes 时直接报错：
```bash
hermes --help
```
如果你看到的报错和下面这段一致，那就是同一个问题：
```
hermes : 无法将"hermes"项识别为 cmdlet、函数、脚本文件或可运行程序的名称。
```
先说结论：**Hermes 安装成功了，但安装路径不在系统 PATH 环境变量里，所以终端找不到它。**
## 为什么会这样
pip 默认把可执行脚本安装到 Python 的 Scripts 目录下。在你的电脑上，这个路径可能是：
```
C:\Users\你的用户名\AppData\Roaming\Python\Python312\Scripts
```
Windows 执行命令时，只在 PATH 环境变量列出的目录里找程序。如果这个 Scripts 目录没加到 PATH，终端就找不到 `hermes`。
## 解决方法
**方法一：使用完整路径运行（最快）**
不需要改任何配置，直接用完整路径：
```bash
C:\Users\kelvin\AppData\Roaming\Python\Python312\Scripts\hermes.exe --help
```
**方法二：添加到 PATH（推荐，一劳永逸）**
1. 按 `Win + R`，输入 `sysdm.cpl` 回车
2. 点击"高级" → "环境变量"
3. 在"用户变量"里找到 `Path`，双击编辑
4. 点击"新建"，添加你的 Scripts 路径：
```
C:\Users\你的用户名\AppData\Roaming\Python\Python312\Scripts
```
5. 确定保存，重新打开 PowerShell
**方法三：快速获取 Scripts 路径**
如果你不确定路径在哪，可以用这条命令查找：
```powershell
Get-ChildItem (python -c "import site; print(site.getsitepackages()[0])")\..\Scripts | Where-Object { $_.Name -like "*hermes*" }
```
或者更简单：
```powershell
python -c "import sys; print(sys.executable.replace('python.exe', 'Scripts'))"
```
## 验证是否解决
添加到 PATH 后，重新打开 PowerShell（一定要重新打开！），然后运行：
```bash
hermes --version
```
如果正常显示版本号，说明问题解决了。
## 补充排查
如果添加了 PATH 还是找不到：
1. **是否重启了 PowerShell？** 环境变量修改后必须重新打开终端才生效
2. **路径是否写对了？** 检查用户名、Python 版本号是否正确
3. **是否安装成功了？** 去 Scripts 目录看看有没有 `hermes.exe`
