Hermes 配置出错，先别急着重装。最常见的修复顺序是：先跑 hermes config check 看缺了什么，再用 hermes config migrate 补新项，最后用 hermes doctor --fix 做自动修复。大部分更新后报错，本质上都是旧配置和新版本不匹配。
三个命令分别做什么
| 命令 | 作用 | 什么时候用 |
|---|---|---|
| config check | 检查缺项和过期配置 | 升级后报错 |
| config migrate | 交互式补齐新选项 | 检查结果提示缺项 |
| doctor --fix | 做自动诊断和修复 | 服务、gateway、记忆都不稳 |
Hermes 的配置主要分在 ~/.hermes/config.yaml、.env 和 auth.json。如果是模型、终端、压缩、记忆这些非敏感项，优先看 config.yaml；如果是 API key、OAuth、token，就看 .env 和 auth.json。这个分层很重要，不然你会把问题改错地方。
最实用的经验是：config check 负责定位，config migrate 负责补齐，doctor 负责验证整套系统是否恢复健康。比起盲删目录，这样更稳，也更容易保留你已经调好的习惯配置。
一句话总结：Hermes 配置坏了，先查、再迁移、最后再修复，不要第一步就重装。
