概述
hermes migrate 诊断你的 ~/.hermes/config.yaml，检测已退役的模型名称和废弃的配置项，并可选地自动重写为当前推荐的替代方案。这在 Hermes 大版本升级后特别有用，可以避免因模型名称变更导致的运行时错误。
hermes migrate [provider]子命令
无参数 — 全局诊断
hermes migrate扫描整个配置文件，列出所有需要迁移的项目。
[provider] — 指定供应商迁移
hermes migrate xai
hermes migrate openai只检查和迁移特定供应商的模型名称。
常见场景
大版本升级后迁移
# 1. 先更新
hermes update
# 2. 检查是否需要迁移
hermes migrate
# 3. 执行迁移（交互式确认）
hermes migrate供应商模型下线后处理
# X.AI 下架了旧模型，需要迁移到新模型名
hermes migrate xai
# 输出：grok-1 → grok-2, grok-vision-beta → grok-2-vision仅诊断不修改
# 先看看有哪些需要改的，但不执行
hermes migrate
# 出现提示时选择 "no" 跳过技巧
- 每次
hermes update后建议运行hermes migrate检查兼容性 - 迁移前会自动备份原始 config.yaml，可以安全回滚
- 如果某个模型你还在使用且不想迁移，可以在提示中选择保留
- 结合
hermes config show在迁移前后对比配置变化