Hermes Agent 源码解析 · 第 23 讲
Hermes Agent v0.16.0 → v0.17.0 版本对比 第 23 讲：迁移指南与最佳实践 基于 Hermes Agent 源码 · 2026-07-06 一、版本升级概览 本讲是 v0.16.0 → v0.17.0 对比系列的最后一讲。前两讲我们分析了 架构演进 （第21讲）和 新特性详解 （第22讲），本讲聚焦 实际迁移 ——从配置变更、命令迁移到最佳实践，帮你安全、无痛地完成升级。 ⚠️ 本次升级包含 2 个破坏性变更 （命令改名、默认值调整），升级前请仔细阅读。 二、破坏性变更清单 本次升级共涉及 2,225 个文件 ， 254,012 行新增 代码。以下是需要手动处理的破坏性变更： 2.1 认证命令变更：hermes login → hermes auth v0.16.0 使用 hermes login 登录 Nous Portal， v0.17.0 已统一为 hermes auth add nous 。 # ❌ v0.16.0（已废弃） hermes login # ✅ v0.17.0（新命令） hermes auth add nous # 其他 provider 也使用 auth 子命令 hermes auth add openai hermes auth add anthropic hermes auth add vertex 配置文件中相关注释也已同步更新： # cli-config.yaml.example 变更 - # "nous" - Nous Portal OAuth (requires: hermes login) + # "nous" - Nous Portal OAuth (requires: hermes auth add nous) 2.2 safe 工具集移除 MoA safe 复合工具集不再包含 mixture_of_agents 。如果你依赖 safe 工具集同时使用 MoA，需要显式添加： # cli-config.yaml.example 变更 - # safe - web + vision + moa (no terminal access) + # safe - web + vision (no terminal access) # 需要 MoA 的用户应显式声明： platform_toolsets: cli: enabled_toolsets: - web - vision - moa # 显式添加 三、配置变更对照表 以下是 v0.17.0 中所有新增和变更的配置项： 配置项 变更类型 旧值 新值 stale_timeout_seconds 默认值变更 300s 90s restart_drain_timeout 默认值变更 60s 0（立即中断） Telegram rich_messages 默认值变更 true false agent.verify_on_stop 新增 — auto agent.coding_instructions 新增 — [] agent.max_verify_nudges 新增 — 3 agent.verify_guidance 新增 — true worktree_sync 新增 — true compression.in_place 新增 — false dashboard.oauth.self_hosted 新增 — OIDC 支持 Telegram command_menu 新增 — max_commands: 60 Telegram rich_drafts 新增 — false 四、升级步骤 4.1 标准升级流程 步骤 1：备份现有配置 ⬇️ 步骤 2：执行 hermes update ⬇️ 步骤 3：检查配置迁移 ⬇️ 步骤 4：重新认证（如需要） ⬇️ 步骤 5：验证功能正常 4.2 具体操作 1. 备份配置和会话数据： # 备份 HERMES_HOME cp -r ~/.hermes ~/.hermes.backup.$(date +%Y%m%d) # 确认备份包含关键数据 ls ~/.hermes.backup.*/config.yaml ls ~/.hermes.backup.*sessions/ 2. 执行升级： …