Hermes Agent 在 Windows 上需通过 WSL2 部署，不支持原生运行；安装前须启用 WSL2、设置 Ubuntu 子系统、换国内源、执行一键脚本安装并配置 API Key，全程无需手动装 Python/Node/Git。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已完成 Hermes Agent 的使用或需更换部署方式，但发现重新安装后出现配置错乱、命令冲突或启动失败等问题，则很可能是旧版本残留文件未被清除。以下是彻底卸载并重装 Hermes Agent 的完整操作指南：
一、停止所有 Hermes Agent 进程
在执行任何清理操作前，必须确保 Hermes Agent 及其相关后台服务已完全终止，避免文件被占用导致删除失败。
1、打开 Windows 终端（PowerShell 或 CMD），以管理员身份运行。
2、执行命令查询正在运行的 Hermes 相关进程：ps -ef | grep hermes（WSL 环境下）或 tasklist | findstr "python node"（Windows 原生命令行）。
3、若发现匹配进程，记录 PID 后执行强制终止：kill -9 [PID]（WSL）或 taskkill /F /PID [PID]（Windows）。
4、关闭所有 WSL 实例：在 PowerShell 中运行 wsl --shutdown，确保 Ubuntu 子系统完全退出。
二、清除 WSL 中 Hermes Agent 全部残留路径
Hermes Agent 在 WSL 环境中默认将核心文件、虚拟环境、配置与记忆数据分散存储于多个目录，需逐一确认并删除。
1、启动 WSL：在 PowerShell 中输入 wsl，进入 Ubuntu 终端。
2、删除主程序目录：rm -rf ~/.hermes/hermes-agent。
3、删除本地数据与记忆库：rm -rf ~/.local/share/Hermes。
4、删除 Python 虚拟环境（如存在）：rm -rf ~/.hermes/env 或检查 ~/.venv/ 下是否含 hermes 前缀环境并一并移除。
5、清理 shell 配置中注入的 alias 或 PATH 条目：执行 nano ~/.bashrc，定位并删除包含 hermes 或 export PATH=.*hermes 的行，保存退出后运行 source ~/.bashrc 刷新。
三、清理 Windows 主机侧关联文件与注册表项
尽管 Hermes Agent 本身不直接写入 Windows 注册表，但部分依赖组件（如 Node.js、Python 安装器、Git）或用户手动配置可能遗留全局路径引用，需同步核查。
1、检查系统环境变量 PATH：右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，在“系统变量”和“用户变量”的 PATH 中查找并删除含 hermes、hermes-agent 或指向 WSL 用户目录的条目。
2、删除 Windows 侧可能存在的临时缓存：%TEMP%\hermes* 与 %LOCALAPPDATA%\Temp\hermes*（在文件资源管理器地址栏粘贴路径后回车，手动删除匹配文件夹）。
3、检查 Windows 应用与功能列表：打开“设置→应用→已安装的应用”，确认无名称含 Hermes 或 Agent 的条目；如有，点击“卸载”按钮执行标准卸载流程。
四、使用 HiBit Uninstaller 强制扫描顽固残留
针对手动清理后仍疑似存在隐藏注册表项、服务或启动项的情况，可借助专业卸载工具进行深度扫描与清除。
1、以管理员身份运行 HiBit Uninstaller。
2、在主界面选择“系统工具”→“注册表清理”，点击“扫描”按钮。
3、扫描完成后，在结果中筛选关键词：hermes、nousresearch、hermes-agent，勾选全部匹配项后点击“清理”。
4、切换至“启动项管理”，检查 Startup 标签页中是否存在异常启动项，尤其注意名称含 hermes 或指向 WSL 脚本的条目，右键选择“禁用并删除”。
5、返回主界面，点击“垃圾文件清理”，启用“临时文件”、“日志文件”、“缩略图缓存”选项，执行全盘扫描并清理。
五、验证残留是否清零并执行纯净重装
完成上述四步后，必须验证关键路径与命令是否已完全失效，方可开始重装，避免新旧版本混杂引发不可预知错误。
1、重启 WSL：在 PowerShell 中执行 wsl --shutdown 后再次输入 wsl 重新进入。
2、逐项验证以下命令是否返回“command not found”或“No such file or directory”：hermes --version、which hermes、ls ~/.hermes、ls ~/.local/share/Hermes。
3、确认无残留后，立即执行国内镜像一键安装：curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash。
4、安装完毕后，强制刷新 shell 配置：source ~/.bashrc。
5、运行健康检查：hermes doctor，确保所有检测项显示 ✅。
