2026年5月,Hermes Agent 两周内连发三版:v0.14.0 → v0.15.0 → v0.15.1。第三版是隔天紧急修复——Dashboard 无限重载,新装用户直接无法使用。
先说结论
所有用户直接升级到 v0.15.1。 不用停在 v0.15.0,它的 Dashboard 有 P0 级缺陷。
一张表看全貌:
| 版本 | 日期 | 代号 | 一句话定位 |
|---|---|---|---|
| v0.14.0 | 5.16 | Foundation | 全平台基础版本 |
| v0.15.0 | 5.28 | Velocity | 1302 commits 大重构 |
| v0.15.1 | 5.29 | Hotfix | 隔天紧急修复 |
v0.14.0 → v0.15.0:大版本跳跃
这不是小更新。v0.15.0 是 Hermes 历史上最大的单版本变更——747 个 PR、1302 个 commit、321 位贡献者。
核心代码大瘦身
run_agent.py 从 16,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 模式未绕过 session | yolo 模式实际没生效 |
| 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:
| |
从 v0.15.0 升级到 v0.15.1(必须)
v0.15.0 的 Dashboard 无限重载是影响所有新装和 Docker 用户的 P0 问题:
| |
升级后检查清单
| 检查项 | 说明 |
|---|---|
| Gateway 重启 | 升级后必须 hermes gateway restart |
API_SERVER_KEY | v0.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 实战经验和踩坑记录,持续更新中