hermes agent三版本不可混用：v0.7纯命令行依赖config.yaml；v0.9起启用web dashboard与soul.md/agents.md双轨制；v0.16转向桌面工作台，配置由远程gateway统一调度。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你正在为Hermes Agent选版本，但发现v0.7、v0.9、v0.16的安装路径和配置方式完全不同，直接套用旧教程会卡在第一步——比如用v0.7的config.yaml覆盖安装v0.16，【dashboard将完全空白，所有模型列表消失】，连基础聊天都启动不了。
先看清楚：三个主流版本的本质区别
v0.7.x是纯命令行时代，所有规则写在单个config.yaml里，靠终端交互驱动；v0.9.0是分水岭，首次引入Web Dashboard和SOUL.md/AGENTS.md双轨制，废除config.yaml；v0.16.0已彻底转向桌面工作台模式，本地不再存模型密钥，全部由远程Gateway统一调度，桌面端通过WebSocket连接服务端获取配置。
如果你现在打开终端输入hermes --version，显示的是v0.7.3或v0.8.5，说明你还在旧架构里；如果显示v0.16.0，那你的~/.hermes目录下根本找不到config.yaml，只有SOUL.md和AGENTS.md两个文件。
Windows用户怎么选安装方式
方法一：快速体验（适合临时测试）
打开PowerShell，执行：
irm https://res1.hermesagent.org.cn/install.ps1 | iex
安装完关闭窗口再重开，输入hermes验证。这一步操作起来很简单，直接回车就行，但【长期使用会遇到路径乱码、权限拒绝、Git Bash兼容性差等问题】，尤其当你需要调用浏览器自动化或微信消息网关时，大概率失败。
方法二：WSL2安装（推荐新手和长期使用者）
① 以管理员身份运行PowerShell，执行wsl --install，重启电脑
② 进入Ubuntu后，运行curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
③ 执行source ~/.bashrc → hermes
这一步必须做完，否则bash无法识别hermes命令。WSL2环境能完整跑通iMessage桥接、BlueBubbles webhook注册、D-Bus系统级通知等高级功能，且避免Windows特有的编码坑。
方法三：桌面版一键安装（适合不想碰终端的用户）
访问https://hermes-agent.nousresearch.com/docs/getting-started/desktop下载安装包，双击运行。它会自动拉取最新v0.16.0代码并配置Ollama本地模型后端，但【国内用户可能因GitHub直连超时导致卡在“正在下载依赖”界面】，建议先用命令行方式装好基础环境，再安装桌面版。
版本升级不是覆盖安装，而是重构式迁移
第一步：确认当前版本是否为语义化格式
在终端运行hermes --version，输出必须形如v0.7.3。如果显示dev-20240115或commit abc1234，说明你安装的是开发分支快照，【不能直接用 hermes update 升级，必须先切回最近的 v0.7.x tag】。
第二步：备份两处关键路径
执行以下命令：
cp -r ~/.hermes/SOUL.md ~/backup_SOUL.md
cp -r ~/.hermes/AGENTS.md ~/backup_AGENTS.md
注意：v0.7.x用户没有这两个文件，只备份config.yaml即可；v0.9+用户若跳过此步，升级后角色语气和项目规则将永久丢失。
第三步：分阶段迁移
v0.7.x → v0.9.1：先卸载旧版，再用install.sh重装，手动把config.yaml中的model_provider、tools、memory_size等字段拆解到SOUL.md和AGENTS.md中
v0.9.1 → v0.16.0：运行hermes setup --portal，登录GitHub绑定Nous Portal订阅，桌面端会自动从Gateway同步模型列表和工具开关状态
