v0.20.1

Hermes Agent v0.20.1


Overview

v0.20.1 — 闷声干活的补丁版。 发布于 2026 年 8 月 13 日。v0.20.0 以来 ~656 个合并 PR · 1,444 个提交 · 2,172 个文件变更(+233,872 / −75,244)· ~481 个 issue 关闭

Hermes 没有敲锣打鼓,但把家底又夯实了一圈:官方消息平台一口气扩到 18 家,Windows 安装器不再让用户干等一整夜,Anthropic prompt 缓存悄悄回归,state.db 学会了在数据库文件被换掉时自愈——还有更多藏在补丁里的效率改进。

这一版没有新功能发布会的排场,但 656 个 PR 里全是“你迟早会用到”的修复。完整精选发布文档将随 v0.21.0 发布,本篇记录的是其中最有价值的核心。


Highlights

1. 消息平台扩展到 18 家

Telegram、Discord、Slack、WhatsApp(个人版 + Cloud API)、Signal、Email、Matrix、IRC、QQ、元宝、飞书、微信、iMessage(BlueBubbles)、LINE、钉钉、Google Chat、SMS——全部由单一 gateway 进程统一接入,对话跨平台无缝衔接。

2. Windows 安装不再无限挂起

“Installing Node.js dependencies” 阶段曾让安装器无限期卡死(有用户挂了一整夜,计时器显示 744:38)。现在每个步骤都有墙钟超时、失败即报错;Already up to date 也不再跳过修复损坏的依赖。

3. Anthropic prompt 缓存恢复

自定义 Anthropic 兼容端点(api_mode: anthropic_messages)可按模型声明 prompt_caching: true|false,裸别名(如 fableclaude-fable-5)也能重新拿到 cache_control 断点——长对话的 token 成本立省。

4. 会话恢复还原模型

hermes --resume / /resume 恢复会话实际使用的模型、provider 与端点,不再静默回退到配置默认值;/model 切换的完整路由也会持久化到会话记录。

5. state.db 全面自愈

底层数据库文件被替换时自动一次性重连,不再卡死等重启;WAL checkpoint 全面改用 PASSIVE 模式;hermes sessions recover --allow-partial 能捞回以前会静默丢掉的尾部行,还有 lost_and_found 兜底通道。

6. Slack 原生直播卡片

Slack 上的回复以 live-typing 流式展示,可选开启 plan/task 进度卡片——在 Slack 里也能看到“它在想什么、做到哪一步”。

7. cron 告警开始说真话

脚本任务的失败、超时、回退链与漂移如实上报,不再伪装成 provider 错误;漂移告警每个任务只响一次,不再每 tick 轰炸。

Improvements

  • 模型目录刷新改用 ETag 条件请求,热路径不再阻塞网络(models.dev)。
  • 新增模型:google/gemini-3.7-flashgrok 4.6
  • CLI 输入冻结自愈:终端 termios 漂移自动恢复,不再需要外部 stty 救援。
  • 建议条(suggestion pills)等词完成触发,MCP 连接目录覆盖翻倍。
  • 语音/唤醒 RPC 池化路由,STT 懒安装(约 50MB)不再阻塞 WebSocket 发送。
  • image.generate 统一走 provider 分发器,插件注册的图片 provider 与 Krea 路由不再被绕过。
  • 阻塞提示期间输入的消息自动并入下一回合。
  • 桌面端建议条“点过一次变死按钮”的幽灵问题修复。

Fixes

  • context_length 缓存防投毒:拒绝持久化非正值、原子写入、丢弃过期 32K 元数据。
  • cron 不再误匹配“429”数字、误报 provider 错误。
  • 会话恢复时 openrouter provider 丢失的问题修复。
  • 大量 Windows 相关修复:MCP PATHEXT 解析、python3python、文件重命名冲突、审批系统覆盖 Windows 破坏性命令。

Upgrade

hermes update

升级后建议运行 hermes doctor 检查安装状态,并重启 gateway(hermes gateway)使平台改动生效。

← Hermes Agent Changelog