mac安装hermes agent v0.18.2后command not found，根本原因是path未生效：需确认~/.local/bin/hermes存在且有执行权限，根据shell类型（zsh/bas）编辑对应配置文件添加export path="$home/.local/bin:$path"，source重载后验证echo $path | grep ".local/bin"，并检查系统“完全磁盘访问”授权及是否存在硬覆盖path的配置项。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Mac装Hermes Agent v0.18.2后PATH不生效，会导致终端始终提示command not found，哪怕安装脚本已成功执行、二进制文件真实存在于~/.local/bin/hermes，系统仍无法定位命令。
确认hermes二进制是否真在~/.local/bin目录下
先验证安装结果是否真实落地：执行ls -l ~/.local/bin/hermes。若返回“No such file or directory”，说明安装脚本未写入该路径——此时不是PATH问题，而是安装中断或权限拒绝导致的假成功，需重跑安装命令并观察末尾是否有Successfully installed hermes-agent字样。
若文件存在且权限为-rwxr-xr-x（即有可执行x权限），继续下一步；若权限缺失，运行chmod +x ~/.local/bin/hermes补全执行权。
检查当前shell类型并编辑对应配置文件
macOS Catalina（10.15）及之后版本默认使用zsh，但部分用户手动切换回bash，或通过iTerm等终端模拟器加载了不同shell。执行echo $SHELL确认当前shell路径：/bin/zsh对应~/.zshrc，/bin/bash对应~/.bash_profile。
打开对应文件：nano ~/.zshrc（zsh用户）或nano ~/.bash_profile（bash用户）。
在文件末尾添加这一行：export PATH="$HOME/.local/bin:$PATH"。注意不要漏掉$HOME/前缀，直接写~/.local/bin在某些shell中不展开，会导致PATH注入失败。
强制重载配置并验证PATH是否更新
保存配置文件后，必须显式重载才能生效：执行source ~/.zshrc（zsh）或source ~/.bash_profile（bash）。
立即验证PATH是否包含目标路径：echo $PATH | grep ".local/bin"。如果无输出，说明source命令未执行成功，或配置文件路径写错——常见错误是把.zshrc误写成.zshrcs或.zprofile。
再运行which hermes，应返回/Users/yourname/.local/bin/hermes。若仍为空，说明~/.local/bin根本没被加入PATH，回到上一步检查配置文件内容与shell类型是否严格匹配。
绕过PATH直接调用hermes验证二进制可用性
方法一：用绝对路径启动
执行~/.local/bin/hermes --version。若输出hermes v0.18.2 (v2026.7.15)，证明二进制完好，纯属PATH未生效；若报错dyld: Library not loaded，说明依赖库缺失，需运行brew install openssl@3补全动态链接库。
方法二：临时注入PATH启动
执行PATH="$HOME/.local/bin:$PATH" hermes --version。这行命令不修改任何配置，仅本次会话生效，能快速区分是配置问题还是二进制自身缺陷。
【关键前提】macOS 13+系统默认启用“完全磁盘访问”限制，Terminal.app若未获授权，source命令可能静默失败——前往「系统设置 → 隐私与安全性 → 完全磁盘访问」，勾选你正在使用的终端应用（如Terminal、iTerm2、Fig）。
终极排查：检查是否存在冲突的PATH覆盖
第一步：查看所有可能影响PATH的配置文件
执行ls -A ~ | grep -E "^\.(bash|zsh|profile)"，列出.bashrc、.zprofile、.profile等潜在干扰项。
第二步：逐个检查这些文件是否含PATH=赋值语句
例如cat ~/.profile | grep "PATH="。若发现某处用PATH="/usr/local/bin"（无$PATH拼接）粗暴覆盖，会清空原有PATH，导致~/.local/bin被彻底剔除。
第三步：定位并注释掉覆盖型PATH赋值行
用nano ~/.profile打开，找到类似PATH="/usr/local/bin"的整行，在开头加#注释，保存退出。这类硬编码PATH是Mac新手最常踩的坑，它会覆盖你在.zshrc里精心添加的所有路径。
第四步：重启终端应用，不再source，让系统从头加载全部配置链。【不可逆操作】不要执行unset PATH或export PATH=""，这会让当前终端彻底失去命令搜索能力，只能关闭窗口重建会话。
