Hermes Agent v0.17.0 发布说明

发布日期：2026 年 6 月 19 日 官方标签：v2026.6.19 与上一版对比：v2026.6.5...v2026.6.19

本页基于官方 GitHub Release 做了结构化中文整理，便于快速浏览。

• 官方发布页
• 完整变更对比

一句话概览

官方将本次更新命名为 「The Reach Release（触达版本）」，核心主题是：

v0.16.0 把 Hermes 带到桌面端，v0.17.0 则把 Hermes 推到更多入口、更深的工作流和更适合团队运行的管理面。

重点变化：

• Hermes 新增 iMessage via Photon：通过 Photon Spectrum 托管线路接入 iMessage，不需要自备 Mac relay 或维护 BlueBubbles 桥接服务。
• Raft agent network 成为新网关入口：Hermes 可以作为外部 agent 接入 Raft，通过 wake-channel bridge 被唤醒处理消息，唤醒载荷只携带事件元数据。
• 桌面端从预览走向日常主力：快捷键可重绑、原生系统通知、子代理 watch-window、模型选择器预设、VS Code Marketplace 主题、可调整终端面板、会话草稿和 RTL/bidi 文本方向识别都在本次补强。
• 后台子代理正式可用：delegate_task(background=true) 会立即返回 handle，主会话可以继续推进，子代理结束后再把完整结果带回当前对话。
• 图像工具支持编辑：image_generate 不再只生成新图，也可以接收已有图片并执行改色、去背景、草图转渲染等 image-to-image 编辑任务。
• Automation Blueprints 降低定时任务门槛：用户按模板回答问题即可创建自动化，不再需要记 cron 表达式或手写 slot=value 参数。
• xAI Grok 订阅可触达 Cursor Composer 模型：grok-composer-2.5-fast 进入 xAI OAuth 模型选择器，上下文窗口按 200k 对齐。
• Dashboard 管理能力继续扩展：浏览器里可以构建完整 profile，选择模型、技能和 MCP server；多 profile 管理统一到机器级视图，Skills Hub 也有了预览、安全扫描和 Featured 区域。
• memory 工具升级为原子批量操作：新增 operations 数组，能在一次调用中批量 add / replace / remove，并按最终字符预算原子提交，减少多轮写记忆失败的概率。
• 网关入口与消息渲染增强：新增官方 WhatsApp Business Cloud API adapter，Telegram 默认使用 Bot API 10.1 富文本消息，SimpleX、Discord、Slack、Matrix、QQBot、微信等平台也有可靠性修复。
• 安全、部署和 Windows 修复同步落地：包括 Dashboard 登录硬化、审批按钮 fail-closed、敏感信息脱敏、MCP 可疑 stdio 配置拦截、cron 子进程环境清洗、urllib3 / PyJWT CVE 更新，以及 Windows 安装、更新和 ConPTY 相关修复。

规模数据（自 v0.16.0 起）：约 1,475 次提交 · 约 800 个合并 PR · 1,693 个文件变更 · 235,390 行新增 · 50,730 行删除 · 300+ 个 issue 关闭 · 245 位社区贡献者。

我应该升级吗？

如果你属于以下任一场景，建议优先升级 v0.17.0：

1. 你依赖桌面端作为主入口 —— v0.17.0 对桌面端的交互、通知、主题、远程 Gateway、多窗口、终端和子代理观察体验都做了大幅补强。
2. 你希望 Hermes 出现在更多消息渠道 —— iMessage via Photon、Raft、WhatsApp Business Cloud API、SimpleX 与 Telegram 富文本都属于明显扩面。
3. 你经常把长任务拆给子代理 —— 后台子代理可以避免主会话被长任务阻塞，适合研究、构建、巡检、资料整理和多步骤执行。
4. 你用 Dashboard 管理自托管或团队环境 —— Profile Builder、多 profile 管理、Skills Hub 预览与安全扫描会降低配置、排错和推广成本。
5. 你重度使用长期记忆或技能库 —— memory 原子批量操作和 Curator 默认零辅助模型成本，会让长期运行更稳、更省。
6. 你需要图像编辑类工具链 —— image_generate 现在可以直接编辑已有图片，很多简单视觉修图任务不必再换工具。
7. 你关注生产环境安全默认值 —— Dashboard OAuth、审批按钮、MCP 配置、cron 子进程、调试日志和依赖 CVE 都有修复，暴露到网络或多人使用的实例尤其值得升级。
8. 你运行 Windows 或远程 Gateway —— v0.17.0 包含 Windows 安装更新、ConPTY、PATH、venv 锁文件、远程媒体和远程后端更新相关修复。

升级前仍建议备份 SOUL.md、MEMORY.md、skills/、Gateway 配置、profile 配置和长期会话数据。自托管 Dashboard、远程 Gateway、多 profile、消息平台、MCP、Docker / Nix、Windows 原生安装用户尤其建议先在一台实例上验证再推广。

重点亮点

iMessage via Photon 与 Raft：Hermes 触达更多入口

v0.17.0 新增 iMessage platform plugin，基于 Photon Spectrum 的托管线路池接入。用户可以运行 hermes photon login，按 device code 完成认证后收发 iMessage，不再需要把一台 Mac 留在角落跑 relay，也不需要维护 BlueBubbles bridge。

Raft 则把 Hermes 接入 agent network。新的 bundled Raft platform adapter 让 Hermes 通过 wake-channel bridge 作为外部 agent 响应事件。官方特别强调 wake payload 只携带事件 ID、时间戳等元数据，不携带消息正文，这让 Hermes 可以在新的协作网络里出现，同时保留较清晰的隐私边界。

主要 PR：#32348、#42582、#44713、#48210。

Hermes Desktop：从“能用”走向“日常主力”

v0.16.0 的主角是桌面端首发，v0.17.0 的主线则是把桌面端打磨到更适合长期使用。用户现在可以重绑快捷键，按通知类型控制原生系统通知，给子代理打开独立 watch-window 观察执行过程，在 composer 里选择模型和预设，安装任意 VS Code Marketplace 主题，并使用可调整大小的 VS Code 风格终端面板。

桌面端也补齐了不少真实工作流细节：每个 thread 可以保存 composer 草稿，聊天内容能自动识别 RTL / bidi 文本方向，Mac 风格 session switcher、worktree-aware 侧边栏分组、hover-reveal 折叠侧栏、消息来源文件夹、流式输出跟随底部、jump-to-bottom 按钮和一等公民的 cron 侧边栏都在本次更新里出现。

远程 Gateway 体验也更完整。远程媒体 relay 让用户可以通过远程连接附加图片和 PDF，并显示 agent 写出的图片；桌面端增加客户端 / 后端版本按钮、远程后端更新流程、远程文件浏览，以及睡眠唤醒后重新校验后端来恢复聊天的逻辑。

主要 PR：#45866、#40660、#47060、#46959、#43292、#44596、#41336、#42634。

后台子代理：长任务不再卡住主会话

delegate_task(background=true) 是这次最实用的 agent loop 变化之一。过去把研究、构建、巡检这类长任务交给子代理时，主会话往往需要等待结果；现在 Hermes 会立即返回一个 handle，主会话继续工作，后台子代理完成后再把完整结果作为新 turn 带回对话。

这个能力适合需要一边推进主任务、一边让子代理跑深度搜索、代码审查、日志分析、资料整理或环境验证的场景。桌面端 watch-window 的加入，也让用户能更自然地观察被委派出去的代理到底在做什么。

主要 PR：#40946、#46968。

Dashboard：Profile Builder、Skills Hub 与安全登录

Dashboard 本次继续向“浏览器里的完整管理面板”演进。Profile Builder 可以在网页中完成模型、技能和 MCP server 的组合，不必手工编辑 config.yaml；多 profile 管理被统一到机器级视图，并提供全局 profile switcher、profile-scoped skills / toolsets 和 Chat tab 上的 session switcher。

Skills Hub 也做了重构。Dashboard 现在支持 connected hubs、Featured 区域、安装前完整预览和技能安全扫描，可信 tap 中的 OpenAI、Anthropic、HuggingFace、NVIDIA 等来源不再只是扁平列表，而是更像一个可浏览、可评估的技能市场。

安全侧，Dashboard OAuth gate 后的 token-required endpoint 会正确返回 401，WebSocket 认证使用实际提供的 Dashboard token，并会在 public_url override 被拒绝时给出警告。对需要把 Dashboard 暴露到局域网或公网的用户来说，这是一次重要硬化。

主要 PR：#39084、#44007、#40384、#43398、#42578、#43214。

图像编辑、记忆批量操作与文件读取增强

image_generate 现在支持 image-to-image 编辑。用户可以把已有图片连同提示词传给工具，让 Hermes 完成改色、去背景、草图转渲染等任务；实现上会路由到后端的 edit endpoint，并覆盖所有受支持的图像 provider。

memory 工具新增原子批量操作也很关键。过去模型可能需要先删除旧记忆再添加新记忆，中间任何一步失败都会导致状态不完整；现在 operations 数组可以在一次调用里同时 add / replace / remove，并按最终字符预算整体提交。长期运行的 Hermes 更容易把记忆压缩、更新和新增放在一次可靠操作中完成。

另外，search_files 做了 lossless densification，用更少 token 保留同样的匹配结果；read_file 可以把 .ipynb、.docx、.xlsx 抽取成文本；上下文文件支持可配置截断上限和警告，压缩摘要也加入时间锚点。

主要 PR：#48705、#48507、#47866、#37082、#47251、#41102。

模型与 provider：xAI Composer、GLM 5.2 与更稳的模型目录

xAI OAuth 模型选择器新增 grok-composer-2.5-fast，官方把它描述为 Cursor 背后的快速 coding model，并将上下文窗口对齐到 200k。对已经有 xAI Grok 订阅的用户来说，这是不额外准备 API Key 就把 Composer 能力接入 Hermes agent loop 的路径。

模型目录方面，本次还加入或补齐 z-ai/glm-5.2、anthropic/claude-fable-5、laguna-m.1、nemotron-3-ultra 等条目，并把 MiniMax-M3 的 1M 上下文信息修正为真实窗口。模型选择器新增 Refresh-Models 控件，可以绕过陈旧缓存；Nous 推荐模型会落盘，并在 Portal 不可用时回退。

主要 PR：#47908、#47371、#47391、#45695、#48691、#43338。

Automation、Fleet 与 Gateway Relay：团队运行能力继续补齐

Automation Blueprints 让用户按模板创建自动化。一个 blueprint definition 可以同时出现在 Dashboard 表单、CLI / TUI / 消息平台 slash command、agent 对话和文档目录中。用户选择模板后回答必要问题即可，不必手写 cron 表达式。

Fleet 侧新增 managed scope，允许管理员把用户不可变的配置和 secrets 固定在 root-owned /etc/hermes 下。多 profile 也可以 opt-in 复用一个 gateway 进程。CronScheduler 变为可插拔，并出现 Chronos managed-cron provider，面向 scale-to-zero 的托管运行方式。

Gateway-Gateway relay 推进到多个阶段，包含 relay adapter、capability descriptor、connector 与 gateway 间的 channel auth、signed HTTP inbound、enroll CLI、WS-only inbound 和 managed boot self-provision client。这些变化对团队部署、托管环境和跨 Gateway 连接更重要。

主要 PR：#41309、#49098、#48273、#48275、#48078、#48147、#48294。

消息平台：WhatsApp Cloud API、Telegram 富文本与多平台修复

除了 iMessage 和 Raft，本次还新增官方 WhatsApp Business Cloud API adapter。它与现有 Baileys bridge 并存，适合希望走 Meta 官方托管路径、减少桥接进程和扫码维护成本的用户。

Telegram 现在默认使用 Bot API 10.1 rich messages，长消息、格式化和原生 markup 的表现更接近用户预期，同时保留 opt-out。SimpleX 支持 groups、native attachments、text batching 和 auto-accept。Discord、Slack、Signal、Email、Teams、Matrix、QQBot、微信等平台也有授权、附件、线程、CPU 占用和限流相关修复。

主要 PR：#44331、#43921、#44829、#45584、#45953、#42584。

安全、可靠性与 Windows

安全修复集中在默认失败方式和敏感信息边界上。v0.17.0 会在自定义 policy gateway adapter、Slack / 飞书 / Discord 审批按钮缺少 allowlist 时 fail-closed；调试请求 dump 会脱敏 secrets；公共 status 会隐藏 host metadata；MCP stdio 配置在 probe 前会拦截疑似外传形态；shell-escape denylist 绕过、缺失 approval module、cua-driver MCP 启动环境、cron job-script 子进程环境和 TodoStore 内容边界也有补丁。

依赖侧升级 urllib3 和 PyJWT 以清理 CVE；Langfuse 对 base64 data URI 的处理改为脱敏而不是截断成无效 base64。Windows 侧则补齐 Dashboard /chat tab 的 ConPTY 支持、PowerShell 路径解析、winget 注册修复、PATH 合并、venv 重建时 _bcrypt.pyd 锁释放、注册表读取 HERMES_HOME、hermes.exe 更新隔离、JOB-breakaway watcher 和原生 confirm modal。

主要 PR：#45634、#41226、#46637、#46083、#40591、#49207、#40179、#42251、#44084。

其他值得注意的变化

• cli.py、gateway/run.py 和 run_agent.py 继续拆分“巨型文件”，把 subcommand parser、slash command handler、授权逻辑、Kanban watcher 和 turn loop 状态抽出到更清晰的模块。
• CLI / TUI 新增 /version slash command、交互式 /billing、状态栏展示距离上一条最终回复的时间、profile alias 展示、从任意来源 clone profile、TUI 插件 Hub overlay 和更好的审批 / clarify / sudo / secret modal。
• TTS 支持 Gemini persona prompts、xAI 自动 speech tags、speed / streaming knobs、Piper speaker_id，以及 Telegram auto-TTS 的 OGG 输出。
• MCP catalog 新增官方 Unreal Engine 5.8 MCP server，并支持 MCP elicitation、late-connecting tools、HTTP keepalive、prompt-only server capability gate 和 Windows 环境变量保留。
• Skills 侧新增 simplify-code，支持三代理并行 code review 与清理；也支持查找 / diff 用户修改过的 bundled skills、可选支付技能、CLI shop skill 和 per-source browse progress。
• Curator 默认继续 prune stale skills，但 LLM consolidation 改为 opt-in，日常后台整理不再消耗辅助模型 token。
• Docker / Nix / Installer 修复集中在镜像体积、supervised gateway、s6 supervisor 检测、npm lock、Electron 依赖 hash、autostash 前清理 unmerged git index 和安装方式 stamp 范围。
• 本窗口有两个变更被回滚，html-artifact skill 折叠方案和 cron per-job profile support 不在 v0.17.0 中交付。

升级建议

常规升级仍然使用：

hermes update

如果你使用包管理器、Docker、Nix 或 Windows 原生安装，请按对应安装方式升级到当前稳定版。升级前建议先确认当前安装路径、Git remote、Dashboard 登录方式、Gateway 暴露方式、消息平台凭据、MCP 配置和长期记忆路径。

升级后建议做五件事：

1. 运行 hermes --version，确认版本已经到 v0.17.0。
2. 打开 Dashboard，检查 profile builder、模型选择、Skills Hub、MCP 和登录状态是否正常。
3. 如果使用桌面端，测试本地会话、远程 Gateway、子代理 watch-window、模型选择器和系统通知。
4. 如果使用消息平台，至少验证一个常用入口，例如 Telegram、WhatsApp、iMessage via Photon、Discord 或 Slack。
5. 如果使用长期记忆，观察一次 memory 写入或替换流程，确认升级后仍符合你的记忆治理预期。

参考链接

• 官方 v0.17.0 Release
• v2026.6.5...v2026.6.19 完整对比
• 官方 GitHub Releases