v0.14.0

Hermes Agent v0.14.0 — The Foundation Release（基石版本）

概览

v0.14.0 — The Foundation Release（基石版本），2026 年 5 月 16 日发布。808 次提交 · 633 个合并 PR · 1,393 个文件变更 · 165,061 行新增 · 545 个 issue 关闭（12 个 P0、50 个 P1）· 215 位社区贡献者。

Hermes Agent v0.14.0 的主题不是炫技，而是把整个体验做扎实。一句话概括：Hermes 现在能在任何地方安装和运行，带上你真正要用的东西，扔掉那些你不需要的。pip install hermes-agent 首次在 PyPI 上可用。重型依赖改为首次使用时懒加载。冷启动缩短了约 19 秒。浏览器 CDP 调用加速了 180 倍。其他所有方面——provider、消息平台、工具、插件、skills——也都迎来了一次全面加固。

官方把这次更新命名为「The Foundation Release（基石版本）」，它回答了一个关键问题：一个 Agent 框架能不能从“很酷的项目”成长为“你每天都依赖的东西”？

重磅功能

1. PyPI 安装 + 依赖瘦身浪潮

Hermes Agent 现在是一个真正的 PyPI 包。一条命令就能跑起来：

pip install hermes-agent
hermes

官方 wheel 内置了 Ink TUI bundle 和 shell launcher——不再需要克隆仓库、跑 shell 安装脚本。升级也只需 pip install --upgrade hermes-agent。

更重要的是，基础安装体积大幅缩减。重型后端（Slack、Matrix、飞书、钉钉 adapter，图像生成 SDK，语音/TTS provider，Camofox，Codex app-server）改为首次使用时自动懒安装。[all] extras 删除了所有已被 lazy-deps 覆盖的依赖，安装器在 wheel 不适配当前平台时会分层回退。供应链安全检查器会扫描每次安装中的不安全版本。

实际意义： 安装更快、磁盘占用更小、传递性漏洞更少、新用户的入门门槛大幅降低。“安装太麻烦了，下次再说”的日子结束了。

相关 PR：#24220、#24515、#25014、#25038、#25766、#21818、#26593、#26148。

2. xAI Grok 通过 SuperGrok OAuth 接入 —— 1M 上下文窗口

如果你有 SuperGrok 订阅，现在可以通过 xAI 账号登录，在 Hermes 中直接使用 Grok——不需要 API Key，不需要单独付费。接入同时把 grok-4.3 升级到了 1M token 上下文窗口，整仓库、长篇资料、研究语料可以一次性输入。

# OAuth 登录后，直接在模型选择器里选 Grok
hermes model  # 选择 xAI > grok-4.3

额外补齐了 entitlement 错误处理，以及 SSH 到远程机器时如何完成 OAuth 流程的 tunnel 文档。

相关 PR：#26534、#26664、#26644、#26592。

3. OpenAI 兼容本地代理 —— 一份订阅，所有工具通用

多工具工作流的角色定位：hermes proxy 在本地启动一个端点，接口兼容 OpenAI API，但背后走的是你已登录的 OAuth provider——Claude Pro、ChatGPT Pro、SuperGrok。

# 启动代理
hermes proxy --provider anthropic --port 8080

# 任何支持 OpenAI API 的工具都能直接接入
export OPENAI_BASE_URL=http://localhost:8080/v1

任何期待 OpenAI 兼容端点的工具（Codex CLI、Aider、Cline、Continue、自写脚本）都可以复用你已有的订阅。一份订阅，所有工具通用。 这对在多个编码助手之间切换的开发者来说意义重大——不用每个工具都得配 API Key，不用分别付费。Hermes 成了你的订阅和工作流之间的统一路由层。

注意：端口只开本地，不要暴露到公网。

相关 PR：#25969。

4. x_search —— 内置 X（Twitter）搜索工具

Agent 现在可以直接搜索 X，不需要安装 skill 或手写集成。搜索时间线、查找 thread、定位具体帖子——在聊天中直接搞定。

# 在对话中直接让 Agent 搜索
"搜一下 X 上大家对 Claude 新版本的讨论"

鉴权支持 X OAuth 或用 API Key，看你有哪个。从“社区黑科技”升级为一等内置工具。

相关 PR：#26763。

5. Microsoft Teams —— 端到端接通

完整的 Microsoft Graph 技术栈一次落地：鉴权 + client 基础、接收 Teams 事件的 webhook listener、pipeline plugin runtime、outbound delivery。配置好 bot 后，可以在 Teams channel、DM 或群聊中直接和 Hermes 对话。

Teams 集成从 v0.12.0 起部分可用，现在补齐了真正可用的端到端链路，可以投入生产使用。

相关 PR：#21922、#21969、#22007、#22024。

6. 性能：冷启动少约 19 秒，浏览器 180 倍加速

本次发布有两条性能主线：

冷启动优化（约 19 秒节省）：

  • 重型 adapter 导入延迟到首次使用（飞书、QQ、元宝、Google Chat、Teams、fal_client）
  • 模型 catalog 优先读磁盘缓存，缓存新鲜时跳过网络请求
  • Doctor 连通性检查并行执行，同时禁用 IMDS
  • chat -q 单查询模式直接跳过欢迎 banner
  • hermes tools All-Platforms 页面：14 秒 → 1.5 秒以内

浏览器 CDP：180 倍加速：

所有 browser_console 评估现在复用同一个持久化的 Chrome DevTools WebSocket 连接，不再每次开新 session。原来需要几秒的页面交互现在毫秒级返回。

相关 PR：#22138、#22120、#22681、#22790、#22808、#22831、#22859、#22904、#22766、#25341、#23226。

7. Claude 跨会话 1 小时 Prompt 缓存

用 Claude（Anthropic / OpenRouter / Nous Portal）时，prompt 前缀（system prompt、skills、memory）现在可以跨会话缓存 1 小时。开 /new 会话时，首轮响应更快、更便宜，因为上一轮的热缓存还在。后台 memory review 也能命中这份缓存。

如果你每天都用 Hermes + Claude，token 节省会非常可观——每次 /new 都复用昂贵的 system prompt 前缀，而不是按原价付钱。

相关 PR：#23828、#25434、#24778。

8. LINE + SimpleX Chat —— 总平台数达 22

两个新消息平台加入：

  • LINE —— 日本、韩国、台湾的核心通讯工具，接入 LINE Messaging API。
  • SimpleX Chat —— 无用户 ID 的隐私导向去中心化通讯，现在作为一等平台接入。

Hermes 的消息平台总数达到 22 个。无论你和团队在哪儿聊天，Agent 都能在那儿待命。

相关 PR：#23197、#26232。

9. /handoff —— 实时会话迁移

以前中途切换模型或 personality，意味着丢掉上下文从头开始。现在 /handoff 可以把当前完整会话——消息、工具调用、上下文——实时迁移到目标 model、persona 或 profile，一条不丢。

# 从快模型转交到深度推理模型
/handoff deep-reasoning

# 不同任务阶段切不同 profile
/handoff production-profile

经典用法：用快模型做苦力活，碰到硬骨头时 /handoff 给推理模型。不用开新窗口，上下文完整保留。

相关 PR：#23395。

10. Telegram / Discord 原生 Clarify 按钮

Agent 用 clarify 工具问你选择题时，Telegram 和 Discord 上现在会显示真正的平台原生按钮，而不需要你打字回选项编号。点一下按钮，Agent 就收到答案了。手机上再也不用费劲打字选编号。

相关 PR：#24199、#25485。

11. Discord 频道历史消息回填

Hermes 首次加入 Discord 频道或 thread 时，现在会自动读取最近的聊天记录，这样回复之前就知道大家在聊什么。不会再出现“我们在说什么？“的尴尬——Agent 进门就带着和所有人一样的上下文。

默认开启。相关 PR：#25984。

12. LSP 语义诊断 —— 写文件后即时检查

Agent 用 write_file 或 patch 修改文件后，Hermes 会调真实 Language Server 对编辑后的文件做增量诊断，在下一轮对话前就把新错误展示给 Agent。类型错误、未定义符号、缺失 import——当场揪出。

这比 v0.13.0 的语法级 lint 明显进了一步，因为背后是真实 Language Server 的语义分析。Agent 能在错误堆积之前自己发现并修正。

相关 PR：#24168、#25978。

13. 每轮文件变更校验摘要

每轮涉及文件写入或编辑后，Agent 现在会收到一段简短的 footer，精确总结磁盘上发生了什么变化——文件路径、行数、实际 diff。Agent 能自己发现写入没生效或被静默覆盖的情况，而不会信誓旦旦地说“我已经加了这个函数”——其实文件根本没保存。

相关 PR：#24498。

14. vision_analyze 直接传原始像素

用 vision_analyze 指向一张图片，且当前模型确实有视觉能力（GPT-5、Claude、Gemini、Grok-vision）时，Hermes 现在直接把原始像素传给模型，而不是先转成文字描述再喂。你得到的是模型的真实视觉推理，而不是被文字摘要降级的二手货。

相关 PR：#22955。

15. 统一可插拔 video_generate

一个工具，接入任何视频模型。Hermes 自带了常见后端，但你可以把新的视频 provider 写成一个插件接入，不用动核心代码。下个月新出的视频模型，一个文件就能搞定，不需要 fork。

相关 PR：#25126。

16. computer_use CUA-Driver —— 非 Anthropic 模型也能用

Computer-use（Agent 控制你的鼠标键盘操作 GUI 应用）以前被锁在 Anthropic SDK 里。新的 cua-driver 后端对非 Anthropic provider 也适用，有正确的 focus-safe 操作，而且 hermes update 时会自动刷新。现在任何有视觉能力的模型都能操控你的桌面。

相关 PR：#21967、#24063。

17. 终端里可点击的链接

Agent 输出中的链接现在是真的 OSC8 超链接，在支持的终端（iTerm2、Kitty、Ghostty、现代 Windows Terminal 等）中悬停高亮。点击直接浏览器打开——再也不用从抄本里复制粘贴长 URL 了。

相关 PR：#25071、#24013。

18. 原生 Windows 支持（早期 Beta）

Hermes 现在可以在 cmd.exe 和 PowerShell 下原生运行，不需要 WSL。完整的 PowerShell 安装器处理了 MinGit 自动安装、Microsoft Store Python stub 检测、前台 Ctrl+C 处理。超过 40 个 Windows 专项修复落地，保证在干净 Windows 机器上的基本 loop 能跑通。仍标注为“early beta”——边角问题还在——但基本路径已经通了。

相关 PR：#21561。

新增 Provider 与模型改进

特性 描述
xAI Grok OAuth SuperGrok 订阅通过 OAuth 登录接入
NovitaAI 新增 provider，托管开源模型（Llama、Qwen、DeepSeek 等）
OpenRouter Pareto Code 路由 min_coding_score 旋钮——自动选到满足质量门槛的最便宜模型
Codex App-Server Runtime 可选运行时，底层驱动 OpenAI 的 Codex CLI，支持 session 复用、卡死 session 自动退役、OAuth 刷新分类
Qwen Cloud Alibaba Cloud 更名为 Qwen Cloud（配置向后兼容）
NVIDIA NIM 计费来源头支持

新增可选技能

9 个全新的可选技能加入生态：

技能 描述
Hyperliquid 永续合约与现货交易，通过 SDK + REST API
Yahoo Finance 实时行情、基本面、历史数据
api-testing REST 和 GraphQL 调试方案
Unified EVM Multi-Chain 一个技能覆盖以太坊 + L2 + Base
darwinian-evolver 进化式 prompt 与 skill 调优
osint-investigation 开源情报调查方案（人员/域名/组织）
pinggy-tunnel 将本地服务暴露到公网
watchers RSS / HTTP JSON / GitHub 轮询，通过 cron no_agent 模式
Notion 针对 2026 年 5 月 Developer Platform 的全面改造

另外，huggingface/skills 现在是 Skills Hub 的受信默认 tap——社区托管在那里的 skills 可以直接从 hermes skills 安装，无需额外配置。

相关 PR：#23582、#23583、#23590、#25299、#26760、#26729、#26765、#21881、#26612、#26219。

插件与扩展改进

ctx.llm —— 接入 Agent 的模型管道。 插件开发者现在可以通过当前激活的 provider 和凭证发起 LLM 调用——不需要手动搭客户端。插件拿到的是和核心 Agent 一样的模型路由和鉴权管道。

tool_override —— 替换内置工具。 插件可以干净地把一个内置工具替换为自己的实现。这关闭了一个社区长期诉求（#11049）。

通过 git 分享 profile。 可以把整套 Hermes profile（配置、skills、memory）通过 git 仓库分发——适合团队统一标准。

Zed ACP Registry。 Hermes 已列入 Zed 的 Agent Client Protocol registry，一键通过 uvx 安装，无 npm 依赖。

相关 PR：#23194、#26759、#20831、#26079、#26120、#26234。

新增内置工具与命令

工具 / 命令 描述 用法
x_search 搜索 X（Twitter）时间线、threads、帖子 对话中直接让 Agent 搜 X
hermes proxy OpenAI 兼容本地代理，背后是 OAuth provider hermes proxy --provider anthropic --port 8080
/handoff 实时将会话迁移到其他 model/persona/profile /handoff deep-reasoning
/subgoal 向运行中的 /goal 追加额外完成标准 /subgoal 补充单元测试覆盖
/sessions 在 TUI 中浏览和恢复历史会话 /sessions
Brave Search 免费层级的网页搜索 provider 在 web-search 设置中配置
DDGS DuckDuckGo 采集器——免费，无需 API Key 在 web-search 设置中配置

改进

消息平台

  • Telegram：原生草稿流式发送（sendMessageDraft，Bot API 9.5+）、通知模式、访客提及模式、超长编辑自动拆分而非静默截断
  • Discord：多 Bot 场景的 thread_require_mention 支持
  • Slack：thread 中 !cmd 作为斜杠命令的替代前缀
  • WhatsApp：从 Baileys 中暴露引用回复的元数据
  • 飞书：原生更新提示卡片
  • Google Chat：修复 setup prompt 导入，遵循 relay 声明的 sender_type
  • Gateway：单个平台故障时保持运行，per-platform circuit breaker + /platform 命令

TUI & CLI

  • /sessions 斜杠命令浏览和恢复历史会话
  • 对话轮次之间用视觉分隔线区分
  • 支持连接到已有 gateway
  • Markdown 链接解析为可读页面标题
  • 宽度感知的 Markdown 表格渲染 + 纵向回退
  • YOLO 模式在 banner 和状态栏中的警告提示
  • 破坏性斜杠命令的确认提示

Kanban（多 Agent）

  • specify —— 辅助 LLM 充实分诊任务
  • Orchestrator 看板工具：kanban_list + kanban_unblock
  • stranded_in_ready 诊断——发现无人认领的任务
  • 去重通知投递——原子声明 + 失败回退

Google Workspace

  • Drive 写入操作 + Docs/Sheets 创建/追加

国际化

  • 所有 gateway 命令 + Web Dashboard 完成本地化，新增 8 种语言（共 16 种）

性能

  • 冷启动：通过懒导入、磁盘缓存模型 catalog、并发 doctor 检查、chat -q 跳过欢迎 banner，节省约 19 秒
  • 浏览器：browser_console 通过持久 CDP WebSocket 连接加速 180 倍
  • Telegram：优化发送节奏 + 短回复自适应快速通道
  • Prompt 缓存：Claude 前缀在 Anthropic / OpenRouter / Nous Portal 上跨会话缓存 1 小时
  • TUI：宽度感知表格渲染，提示等待期间可滚动抄本

安全与可靠性

安全加固

  • Sudo 暴力破解被封堵：sudo -S 尝试被归类为 DANGEROUS；stdin-fed 和 askpass-stripped 的 sudo 调用被捕获
  • 三个危险命令绕过路径被关闭（受 Claude Code 命令检测工作启发）
  • 工具错误净化：恶意文件或远程服务无法通过错误输出向 Agent 注入指令
  • SSRF 抓取路径在 skills-hub 中被覆盖
  • Dashboard 鉴权对插件 API 路由强制执行
  • 供应链安全检查器在每次安装时扫描
  • Kanban 评论作者净化——禁止调用方控制作者身份
  • Quick command 输出脱敏和环境变量清理
  • 减少不必要的 shell=True 在子进程调用中

关键 Bug 修复

  • SQLite：在 NFS/SMB/FUSE 上回退到 journal_mode=DELETE（修复网络挂载上的 /resume 问题）
  • Codex-runtime：卡死的 session 自动退役 + tool 后 watchdog + OAuth 刷新分类
  • Daytona：遗留 sandbox 查询迁移到基于 cursor 的 list()
  • MCP：停止对初始鉴权失败的重试，防止无限循环
  • ACP：内联文件附件资源
  • Profiles + banner：--clone-all 排除基础设施，修复过期的 update-check repo 解析

升级

hermes update

如果从 v0.14.0 之前的版本升级，建议先备份 ~/.hermes 目录。升级后运行 hermes doctor 验证一切正常。

全新安装：

pip install hermes-agent
hermes setup

GitHub 完整 Changelog

← Hermes Agent Changelog