v0.20.2

Hermes Agent v0.20.2

Overview

v0.20.2 — The Connections Patch（连接补丁）。 发布于 2026 年 8 月 16 日。自 v0.20.1 以来 合并约 397 个 PR · 967 个提交 · 改动 1,279 个文件（+128,522 / −7,622）。

在 v0.20.1 发布三天后，Hermes 带来了桌面端多年欠缺的结构性变化：连接模型从“一个全局连接 + per-profile 覆盖”变成真正的注册表。桌面端现在可以同时登记任意数量的命名 agent 源——本地运行时、远程网关、Hermes Cloud、SSH 主机；MCP 则新增 hermes:// 一键安装和后台健康检查；CLI 终于记住哪个会话属于哪个终端。

这是补丁版本，官方说明从简，完整文档随 v0.21.0 发布。本页覆盖该窗口最有价值的部分。

Highlights

1. 桌面端多连接注册表

Settings → Connections 现在是真正的命名 agent 源注册表：本地、远程网关（LAN/Tailscale/公网）、Hermes Cloud、SSH 主机，统一持久化，标签大小写不敏感且唯一。后端池按 (连接, profile) 路由，桌面端还有多源 agent 名单与 SDK。可发现性也补齐了：profile 栏的 “Connect another Hermes gateway…” 入口和 ⌘K 里的 Settings → Connections。

2. MCP 通过 hermes:// 深链一键安装

MCP 服务商和文档可以放置 “Add to Hermes” 按钮，跳转 hermes://mcp/install?name=NAME&config=B64。链接经过严格校验（名字 ^[A-Za-z0-9._-]{1,64}$、config 为 base64url 编码的 JSON），写入配置前还会弹出显式确认框。

3. MCP 后台健康检查

桌面端在网关连接时及每 30 分钟，扫描当前 profile 启用的 HTTP/SSE MCP 服务器。服务器一旦转入需要认证（或错误）状态，就触发应用内警告——“GitHub MCP needs re-authentication”——并带 Sign in 按钮直达该服务器配置页并高亮闪烁。stdio 服务器被排除，因为探测一次就是一次真实的进程启动。

4. 终端面包屑：-c 按终端恢复

裸 hermes -c / --continue 现在恢复当前终端（tty、tmux pane、kitty 窗口、wezterm pane、Zellij pane、Windows Terminal）自己的上次会话，而不是全局最近的会话。面包屑存放在 $HERMES_HOME/terminal-sessions/，原子写入，30 天过期。

5. chat -c 大声报错 + --create-if-missing

hermes chat -c "<标题>" 匹配不到时现在会向 stderr 报错并以退出码 1 结束（不再静默 no-op）。新增的 --create-if-missing 会创建同名新会话并直接进入——给脚本和插件提供“发到命名线程，没有就建”的确定性原语。

6. 图像放大改为默认关闭

8 月 8 日的改动让所有低于 2MP 的 FAL/Krea 生成都串联 Clarity Upscaler（明显劣化 GPT Image 2 的文字/CJK 渲染、Ideogram 排版、写实人脸），现已回退：放大默认关闭，仅在显式传 upscale: true 时执行。

7. 所有工具都可被中断

顺序工具执行器现在每秒轮询中断标志，3 秒宽限内放弃正在运行的工具；image_generate 还会协作式中止在途的 FAL 等待。Ctrl+C 真正结束工具，不再让回合被卡约 40 秒。

Improvements

  • Kitty 键盘协议恢复（CSI >1u），并补齐 294 项扩展键别名表——kitty 用户拿回 Ctrl+C，组合键也正常。
  • /status 不再把模型与来自其他回退路由的 provider/base URL 配对；持久化的模型路由保持一致。
  • Bedrock API key 通过命名 provider（custom:bedrock-mantle + key_env）传递，不再以 api_key="no-key-required" 发出。
  • skills.disabled 和 agent.disabled_toolsets 正确解析 hermes config set 保存的 JSON 数组字符串（["a","b"]）。
  • 流式 already_sent 回合现在正确完成 /loop tick（LOOP_COMPLETE 标记 + 裁判运行），不再被无限重排。
  • 多网关连接在删除/编辑时干净地拆除并回收，带连接池上限。
  • provider 自动检测键通过 profile 作用域解析；Bedrock 与认证路径尊重 per-profile 密钥作用域。

Fixes

  • Windows：进程扫描探测加界，慢速 WMI 扫描不再卡死 hermes update；含 NUL 的 cron 脚本路径在任何 Path 调用前被拒绝；systemd 的 hermes-serve 单元随网关一起重启。
  • 无 pidfile 的 Windows 计划任务网关不再被孤儿收割器误杀。
  • image_gen 目录不变量固定所有放大默认关闭。
  • 顺序工具调用受 timeouts.tools.sequential_call 约束；导致回归的工具去重/推理下限组合已回退并重做。
  • TUI：修改后的 Enter 与裸 LF 在 IDE 和 macOS 终端的 composer 中正确插入换行。

Upgrade

hermes update

升级后运行 hermes doctor 确认安装健康，重启网关（hermes gateway）让平台改动生效，并打开 Settings → Connections 体验新的多连接注册表。

← Hermes Agent Changelog