Hermes Agent 升级指南:v0.14.0 → v0.15.1,为什么要隔天发补丁

Hermes Agent 两周连发三个版本。v0.15.0 核心代码缩减76%、会话搜索提速4500倍,但隔天紧急推送 v0.15.1 修P0缺陷。完整升级路线、Breaking Changes 和升级后检查清单。

2026年5月,Hermes Agent 两周内连发三版:v0.14.0 → v0.15.0 → v0.15.1。第三版是隔天紧急修复——Dashboard 无限重载,新装用户直接无法使用。

先说结论

所有用户直接升级到 v0.15.1。 不用停在 v0.15.0,它的 Dashboard 有 P0 级缺陷。

一张表看全貌:

版本日期代号一句话定位
v0.14.05.16Foundation全平台基础版本
v0.15.05.28Velocity1302 commits 大重构
v0.15.15.29Hotfix隔天紧急修复

v0.14.0 → v0.15.0:大版本跳跃

这不是小更新。v0.15.0 是 Hermes 历史上最大的单版本变更——747 个 PR、1302 个 commit、321 位贡献者。

核心代码大瘦身

run_agent.py16,000 行重构到 3,800 行,缩减 76%。不是删功能,是把职责拆分到独立模块。

性能实测数据:

指标变化
每轮工具调用-195ms
每轮函数调用-240ms(-47%)

session_search 重写:4500x 提速

会话搜索引擎从 LLM 驱动改为纯 FTS5 实现。搜索速度快了 4500 倍,而且不再消耗 token。

Kanban 演进为多 Agent 平台

Kanban 模块经过 104 个 PR 打磨,从任务看板变成了多 Agent 协作平台。支持任务分解、子 Agent 分发、跨 Agent 依赖管理。

安全防护:Promptware Defense

新增 promptware 防御机制,防止恶意提示词注入攻击 Agent 系统提示。

新集成

  • Bitwarden Secrets Manager:密钥管理集成
  • Krea 2 + FAL 插件:两个新图像生成提供商
  • Nous 官方 MCP 目录:审核过的 MCP 服务目录
  • ntfy 平台:第 23 个消息平台
  • mTLS 支持:MCP 连接支持 TLS 客户端证书

Breaking Changes

变更说明
API_SERVER_KEY 强制API Server 现在强制要求 Key,无 Key 不再允许请求
web_crawl 移除该工具及相关 provider 已被移除
context engine新增外部上下文引擎接口,需配合新配置

v0.15.0 → v0.15.1:为什么隔天就发补丁

v0.15.0 发布后隔天社区报告了多个阻断性问题。

🔴 Dashboard 无限重载循环(P0)

这是 v0.15.1 存在的唯一理由。

在 loopback 模式下(Docker 部署 / 托管环境 / 全新安装),Dashboard 的 SPA 在 token 过期后陷入死循环:401 → 重新登录 → 又 401 → 无限刷新。用户看到页面不停闪烁,完全无法使用。

修复方式:/api/auth/me 返回 401 时不再触发整页重载,改为 SPA 内部处理 token 刷新。

🔴 Kanban Worker SIGTERM 不终止

发送 SIGTERM 后进程没有正确终止,任务超时或手动取消时僵尸进程堆积。

🟡 其他修复

问题影响
/model 和模型选择器列表不统一CLI 和 gateway 显示不同模型列表
/yolo 模式未绕过 sessionyolo 模式实际没生效
Skills 目录不完整858 → 19,932,只拉取了部分条目
.md 媒体投递被误拦截Gateway 把正常 Markdown 附件也拦了
Web URL 被误脱敏URL 参数被错误替换

Docker 安全加固

  • --insecure 标志必须通过环境变量显式启用
  • MCP bare command(npx/npm/node)明确解析到 /usr/local/bin
  • arm64 CI 缓存问题修复

升级指南

从 v0.14.0 升级(推荐)

直接跳到 v0.15.1,不需要中间停 v0.15.0:

1
2
3
4
5
6
7
# 源码安装(推荐)
git clone https://github.com/NousResearch/hermes-agent
cd hermes-agent
pip install -e .

# 或 PyPI
pip install --upgrade hermes-agent

从 v0.15.0 升级到 v0.15.1(必须)

v0.15.0 的 Dashboard 无限重载是影响所有新装和 Docker 用户的 P0 问题:

1
pip install --upgrade hermes-agent

升级后检查清单

检查项说明
Gateway 重启升级后必须 hermes gateway restart
API_SERVER_KEYv0.15.0+ 强制要求,检查 ~/.hermes/.env
Browser Use 配置需配置 BEARER_TOKEN 匹配 API_SERVER_KEY
Kanban 备份并发加固后更稳定,但建议备份 ~/.hermes/kanban.db
Docker --insecure必须显式设置环境变量

版本号背后的逻辑

v0.15.1 不是计划内版本。大版本(v0.15.0)涉及 1300+ commits 变更,回归测试不可能覆盖所有部署环境。Dashboard 无限重载只在 loopback/Docker 场景触发,CI 没覆盖到。

发现问题后团队在隔天内发布修复——这是健康开源项目的标准响应速度。

建议所有用户直接使用 v0.15.1。

关注 varkm,一起学习,一起成长

更多 AI Agent 实战经验和踩坑记录,持续更新中