📜 Hermes Agent 彻底卸载与防止再生完整指南
本指南用于彻底清除 macOS 系统上的 Hermes Agent 及其所有关联组件,并切断导致 ~/.hermes/profiles 目录不断自动再生的后台源头。
🧹 第一部分:一键彻底清理脚本
请一次性复制并粘贴以下整合脚本到你的 Mac 终端(Terminal)中运行。该脚本会自动执行强杀进程、注销系统常驻服务、清理定时任务以及抹除核心文件:
bash
echo "=========================================="
echo " 开始彻底清理 Hermes Agent... "
echo "=========================================="
# 1. 强行终止所有存活的 Hermes 后台进程与守护线程
echo "⚡ 正在终止相关进程..."
pkill -9 -f hermes
# 2. 卸载并删除所有可能残留的 macOS 后台常驻服务 (LaunchAgents)
echo "📂 正在清理 LaunchAgents 自启项..."
launchctl unload ~/Library/LaunchAgents/ai.hermes.* 2>/dev/null
rm -f ~/Library/LaunchAgents/ai.hermes.* 2>/dev/null
sudo rm -f /Library/LaunchAgents/ai.hermes.* /Library/LaunchDaemons/ai.hermes.* 2>/dev/null
# 3. 安全移除 crontab 定时任务(防止定时心跳脚本自动重建目录)
echo "⏰ 正在检查并清除 crontab 定时任务..."
crontab -l 2>/dev/null | grep -v "hermes" | crontab -
# 4. 彻底删除本地所有核心配置、可执行文件及自动生成的 profiles 目录
echo "🗑️ 正在抹除核心文件及配置夹..."
rm -f ~/.local/bin/hermes
rm -rf ~/.hermes
# 5. 刷新终端环境配置
echo "🔄 正在刷新终端环境变量..."
source ~/.zshrc 2>/dev/null || source ~/.bash_profile 2>/dev/null
echo "=========================================="
echo " ✨ 清理完成!请按下方步骤进行验证 ✨ "
echo "=========================================="
🔍 第二部分:结果验证步骤
脚本执行完毕后,请在终端中依次运行以下命令,确保 Hermes Agent 已被彻底根除:
1. 验证目录是否已被彻底删除
bash
ls -la ~/.hermes
- 预期正常结果:终端明确提示
ls: .hermes: No such file or directory。 - 注意:建议在执行完脚本 静置 2~3 分钟 后再次运行此命令,以确保
profiles目录没有被未知的隐蔽源头重新初始化。
2. 验证后台是否还有残留进程
css
ps aux | grep -i hermes
- 预期正常结果:输出中仅包含一行你当前正在运行的搜索命令本身(例如
grep --color=auto -i hermes)。 - 异常情况:如果输出了其他包含
python、main.py或hermes-gateway的行,说明仍有父进程在周期性调用它。
🛠️ 第三部分:极端情况排查(可选)
如果执行完上述所有步骤后,~/.hermes/profiles 目录依然顽固再生,请检查以下两项:
- 开发工具插件:检查 VS Code、Cursor 或 Zed 是否安装了与 Hermes 相关的扩展,这些编辑器在启动时会自动激活插件环境并创建配置夹。
- Docker 容器:检查是否有正在运行的 Docker 容器挂载了宿主机的用户目录。可运行
docker ps进行排查。
如果目录依旧自动出现,请提供 ps aux | grep -i hermes 的最新终端输出,以便帮您精确定位隐蔽的父进程。