问题的根本原因，其实是 Maven 的环境变量没有真正生效。解决方法并不复杂，关键在于先确认自己当前使用的是哪一种 shell：如果是 zsh，就修改 ~/.zshrc；如果是 bash，就修改 ~/.bash_profile。将 MAVEN_HOME 和 PATH 正确配置后，记得执行 source 让设置立即生效，最后再通过 which mvn 和 mvn -v 检查一遍，确认 Maven 已经可以被系统正确识别。
运行 Hermes Agent 时如果提示“mvn: command not found”或出现构建失败，通常说明系统无法找到 Maven 可执行文件。这并不是代码本身的问题，而是 macOS 上 Maven 没有被终端正确识别，属于典型的 Maven 环境变量配置未生效问题。
确认当前 Shell 类型并编辑对应配置文件
macOS Monterey（12.0）及之后版本默认使用 zsh，但也有一部分用户仍在使用 bash；如果 shell 配置混用，就很容易导致环境变量设置不生效。先打开终端执行echo $SHELL，如果输出/bin/zsh，就编辑~/.zshrc；如果输出/bin/bash，则编辑~/.bash_profile。
可以使用 Cursor 或 VS Code 打开对应文件：执行open -e ~/.zshrc（zsh 用户）或open -e ~/.bash_profile（bash 用户）。
【必须删除旧的重复 Maven 配置行】——如果你之前重复配置过多次，文件中可能残留多条export MAVEN_HOME=...或export PATH=$MAVEN_HOME/bin:$PATH，建议只保留最新且正确的一组，否则 PATH 可能被覆盖，进而导致 Maven 命令无法生效。
写入正确的MAVEN_HOME和PATH
在配置文件末尾新增两行（注意等号两边不要有空格）：
export MAVEN_HOME=/usr/local/maven
export PATH=$MAVEN_HOME/bin:$PATH
⚠️这里的路径必须与你实际解压 Maven 的位置完全一致。比如，如果 Maven 安装目录在/Users/yourname/main/apache-maven-3.9.9，那么这里就必须写成export MAVEN_HOME=/Users/yourname/main/apache-maven-3.9.9。
这一步本身并不复杂，直接复制并按实际路径修改即可，但只要路径填写错误，后续所有验证步骤都会失败，因此一定要仔细核对。
使配置立即生效并验证
执行source ~/.zshrc（zsh 用户）或source ~/.bash_profile（bash 用户），让新的环境变量立即生效。
接着运行which mvn，正常情况下应返回类似/usr/local/maven/bin/mvn的路径；如果没有任何输出，通常说明配置仍未生效，或者 Maven 安装路径填写有误。
然后再执行mvn -v，如果能看到 Apache Maven 版本、Java version 以及 Maven home 等输出信息，就表示 Maven 已成功加入系统环境变量并可被正常调用。
此时回到 Hermes Agent 项目根目录，执行mvn clean compile即可正常完成编译，不会再出现 Maven 命令找不到或 Hermes Agent 构建失败的问题。