跳到主要內容

Hermes Agent v0.13.0 發佈說明

發佈日期：2026 年 5 月 7 日
官方標籤：v2026.5.7
與上一版對比：v2026.4.30...v2026.5.7

本頁基於官方 GitHub 發佈說明做了結構化中文整理，便於快速瀏覽。

一句話概覽​

官方將本次更新命名為 「The Tenacity Release（韌性版本）」，核心主題是：

Hermes Agent 現在能把開始的事情做完。

重點變化：

  • Kanban 正式上線 —— 以持久化多代理協作板的形式提供，自帶心跳檢測、任務 reclaim、殭屍 worker 檢測、未完成退出自動 block、按任務重試上限、幻覺恢復機制等可靠性保障。
  • /goal 持久目標 —— 讓代理在多輪對話中始終鎖定目標，Ralph loop 從此成為一等原語。
  • Checkpoints v2 —— 徹底重寫狀態持久化，引入真正的剪枝機制，消除孤兒 shadow 倉庫。
  • 會話耐受性大幅提升 —— Gateway 重啟、/update 升級、源文件 reload 之後，會話自動續上，不再丟失上下文。
  • Cron 新增 no_agent 看門狗模式 —— 可完全跳過 Agent，只跑腳本。
  • 集中安全加固 —— 關閉 8 個 P0 漏洞：脫敏默認開啟、Discord 角色授權按 guild 範圍限制、WhatsApp 默認拒絕陌生人、auth.json 與 MCP OAuth 關閉 TOCTOU 競態窗口。
  • Google Chat 成為第 20 個平臺，Provider 升級為可插拔架構，7 國語言 i18n 落地（中、日、德、西、法、烏、土）。

規模數據（自 v0.12.0 起）：864 次提交 · 588 個合併 PR · 829 個文件變更 · 128,366 行新增 · 282 個 issue 關閉（含 13 個 P0、36 個 P1） · 295 位社區貢獻者。

我應該升級嗎？​

如果你屬於以下任一場景，建議優先升級 v0.13.0：

  1. 希望 AI 團隊真正把活幹完 —— 開啟 Kanban，配置心跳 / reclaim / 重試預算 / 幻覺門，多代理並行執行，自動認領與移交任務。
  2. 需要 /goal 做長任務 —— Ralph loop 此次作為一等原語實現，跨輪對話鎖定目標、始終不偏離。
  3. 以前常被 Gateway 重啟 / /update 弄丟上下文 —— 本次會話耐受性大幅加強，重啟後自動續接。
  4. Docker / Compose 部署用戶 —— 官方鏡像現在拒絕以 root 身份運行 gateway，node_modules 歸屬 hermes 用戶，HERMES_DASHBOARD=1 可一鍵啟動 dashboard。
  5. 關注安全 —— 本次集中關閉 8 個 P0：脫敏默認開啟、Discord guild 範圍授權、WhatsApp 拒絕陌生人、auth.json + MCP OAuth 關閉 TOCTOU 競態、SSRF 下限、cron 掃描 prompt injection、hermes debug share 上傳脫敏。強烈建議升級。
  6. 國內 IM 用戶 —— QQBot 終於有了與 Telegram / Discord 一致的原生審批鍵盤；微信消息按內容指紋去重；飛書可配置接入策略。
  7. 需要本地 / 替代搜索 —— SearXNG 原生搜索專用後端上線，Web 工具按能力拆分後端。
  8. 遠程 / 多端 IDE 協作 —— ACP /steer + /queue 可在 Zed / VS Code / JetBrains 中直接干預運行中的代理。
  9. 開發 plugin / 自定義 provider —— Provider 升級為可插拔架構，配合 transform_llm_output hook，第三方 provider 與內容過濾器可直接接入。
  10. 多語言用戶 —— CLI / gateway 靜態消息支持 7 種語言，文檔站新增簡體中文 locale。

所有用戶 都建議在測試後升級：本次關閉了 282 個 issue，包含 13 個 P0 和 36 個 P1，集中在 Kanban、會話耐受、安全、流式、工具調用等關鍵路徑。

重點亮點​

多代理 Kanban：讓 AI 團隊真正把活幹完​

  • 持久化多 Profile 協作板：創建一個看板，將任務分發上去，多個 Hermes worker 自動認領、移交、關閉。
  • 可靠性保障：心跳檢測 / reclaim / 殭屍檢測 / 重試預算 / 幻覺門——杜絕 worker「假裝做完」的現象。
  • 一次安裝，多個看板：原生支持 multi-project 設計。
  • 主要 PR：#17805、#19653、#20232、#20332、#21330、#21183、#21214。

/goal 持久目標：代理不再忘記任務​

通過 /goal 命令將代理鎖定到一個目標上，跨輪對話始終不偏離。Ralph loop 從此升級為一等原語，並嚴格遵循配置中設置的回合預算。

主要 PR：#18262、#18275、#21287。

video_analyze：原生視頻理解​

新增 video_analyze 工具，支持 Gemini 等多模態模型的原生視頻理解（@alt-glitch，#19301）。

語音克隆​

xAI Custom Voices 作為 TTS provider 正式上線，支持聲音克隆（@alt-glitch，#18776）。

7 國語言 i18n​

Gateway 靜態消息與 CLI 提示現已支持 7 個語言環境：中文（zh）、日文（ja）、德文（de）、西班牙文（es）、法文（fr）、烏克蘭文（uk）、土耳其文（tr）。文檔站也新增了 zh-Hans 簡體中文 locale。

主要 PR：#20231、#20329、#20467、#20474、#20430、#20431。

Google Chat：第 20 個消息平臺​

新增 Google Chat 集成。同時引入通用平臺插件 hook（env_enablement_fn / cron_deliver_env_var），第三方適配器無需修改核心代碼即可接入——IRC 與 Teams 已率先遷移至新架構。

主要 PR：#21306、#21331。

會話能扛重啟​

Gateway 中途重啟、/update 升級後重啟、源文件 reload——重新拉起後會話自動續接，保留待處理提示、home-channel 線程路由、緩存的活躍會話路由與 assistant 元數據。

主要 PR：#21192。

安全加固：集中關閉 8 個 P0​

  • 脫敏默認開啟（v0.12.0 臨時改為關閉，本次迴歸默認）。
  • Discord 角色授權按 guild 範圍限制（修復 CVSS 8.1 的跨 guild DM 繞過漏洞）。
  • WhatsApp 默認拒絕陌生人，且永不在 self-chat 中回覆。
  • auth.json 與 MCP OAuth 關閉 TOCTOU 競態窗口。
  • 瀏覽器強制 cloud-metadata SSRF 下限。
  • Cron 掃描組裝後的完整 prompt（含 skill 內容），防範 prompt injection。
  • hermes debug share 上傳時再次脫敏。
  • .env / auth.json / state.db 恢復為 0600 權限。

主要 PR：#21193、#21241、#21291、#21176、#21194、#21228、#21350、#19318。

Checkpoints v2：徹底重寫狀態持久化​

採用單存儲架構，引入真正的剪枝機制與磁盤護欄，徹底消除孤兒 shadow 倉庫（#20709）。

代理寫完後自動 lint​

write_file 與 patch 之後自動執行 post-write delta lint，在進程內校驗 Python / JSON / YAML / TOML 語法。語法錯誤在寫入時即刻暴露，而非等到下游消費時才報錯（#20191）。

Cron no_agent 模式：純腳本看門狗​

Cron 任務現在可以完全跳過 Agent，僅執行腳本。腳本無輸出則靜默，有輸出則原文投遞（#19709）。

全平臺 allowlist​

allowed_channels / allowed_chats / allowed_rooms 配置已覆蓋 Slack、Telegram、Mattermost、Matrix、釘釘（#21251）。

Provider 升級為可插拔架構​

通過 ProviderProfile ABC 與 plugins/model-providers/ 目錄，第三方 provider 可作為插件直接接入，無需修改核心代碼（#20324）。list_picker_providers 支持按已有憑證過濾可選 provider。

API Server：每會話獨立長期記憶​

新增 X-Hermes-Session-Key header，為記憶 provider 提供穩定的會話 ID，實現按會話隔離的長期記憶（#20199）。

MCP 全面加強​

  • 支持 SSE 傳輸 + OAuth 轉發。
  • stale-pipe 失敗按 session-expired 自動重試。
  • 圖像類工具結果以 MEDIA tag 暴露，不再被丟棄。
  • 長生命週期等待加入 keepalive 機制。

主要 PR：#21227、#21323、#21289、#21328、#20209。

Curator 新增子命令​

hermes curator archive、prune、list-archived 上線。手動執行 hermes curator run 改為同步模式——不再需要輪詢日誌查看結果（#20200、#21236、#21216）。

ACP：/steer 與 /queue​

在 Zed / VS Code / JetBrains 中可實時干預正在執行的代理，或排隊後續任務。同時實現會話原子持久化、reasoning 元數據跨重啟保留（@HenkDz，#18114、#20279、#20296、#20433）。

TUI 打磨​

  • /model 選擇器全面重寫，對齊 hermes model 行為，支持 inline 鑑權（@austinpickett，#18117）。
  • 啟動 banner 各部分可摺疊——skills、system prompt、MCP（@kshitijk4poor，#20625）。
  • 狀態欄顯示 context compression 計數（#21218）。

Dashboard 成長​

  • Plugins 頁面：管理插件、啟用 / 禁用、查看鑑權狀態（@austinpickett，#18095）。
  • Profiles 管理頁面（@vincez-hms-coder，#16419）。
  • 分析表格列支持交互式排序（#18192）。
  • default-large 18px 內置主題（#20820）。
  • 支持 X-Forwarded-Prefix 反向代理部署（#21296）。
  • Docker 中通過 HERMES_DASHBOARD=1 啟動 dashboard 副進程（@benbarclay，#19540）。

SearXNG + Web 工具拆分​

SearXNG 作為原生搜索專用後端上線；Web 工具支持按能力（搜索 / 抽取 / 瀏覽）選擇不同後端（@kshitijk4poor，#20823、#20061、#20841）。

OpenRouter 響應緩存​

對支持緩存的模型暴露顯式 cache control（@kshitijk4poor，#19132）。

[[as_document]]：技能媒體路由指令​

技能可強制 gateway 將輸出作為文檔投遞，前提是目標平臺支持（#21210）。

transform_llm_output 插件 hook​

新增生命週期 hook，插件可在 LLM 輸出進入對話之前對其進行重塑或過濾，適用於上下文壓縮器與內容過濾器（#21235）。

Nous OAuth 跨 profile 共享​

通過共享 token store 實現登錄一次，所有 profile 自動繼承會話（#19712）。

QQBot：原生審批鍵盤​

與 Telegram / Discord 的審批體驗對齊：支持分塊上傳、引用附件、原生 inline 審批鍵盤（#21342、#21353）。

6 個新 optional skill​

  • Shopify（Admin + Storefront GraphQL）（#18116）。
  • here.now（#18170）。
  • shop-app：個人購物助手（#20702）。
  • Anthropic financial-services bundle 移植（#21180）。
  • kanban-video-orchestrator（@SHL0MS，#19281）。
  • searxng-search（@kshitijk4poor，#20841）。

新模型​

  • deepseek/deepseek-v4-pro 加入 OpenRouter + Nous Portal（#20495）。
  • x-ai/grok-4.3 加入 OpenRouter + Nous Portal（#20497）。
  • openrouter/owl-alpha（free 層）加入 curated 列表（#18071）。
  • tencent/hy3-preview OpenRouter 付費路徑（@Contentment003111，#21077）。
  • Arcee Trinity Large Thinking：溫度 + 壓縮 override（#20473）。

100 條新啟動 tip​

隨機 tip banner 新增 100 條，覆蓋 cron / kanban / curator / 插件 / 冷門 flag 等主題（#20168）。

多代理 Kanban（持久化）​

協作板核心​

  • 持久化多 Profile 協作板：#17805 在 revert 後重新實現，原生支持多 Profile 架構。
  • 多項目看板：一次安裝即可運行多個 kanban（#19653、#19679）。
  • 跨 Profile 共享：board、workspace 與 worker 日誌可在多個 profile 間共享（#19378）。
  • 幻覺門 + 恢復 UX：防止 worker 自創卡片後虛假報告完成（#20232）。
  • 通用診斷引擎：為任務 distress signal 提供統一的診斷能力（#20332）。
  • 每任務 max_retries 覆寫：支持按任務單獨設置重試上限（#21330）。
  • inline-create 標題改為多行 textarea（#21243）。

Kanban Dashboard​

  • Inline create 表單新增 workspace kind 與 path 輸入（#19679）。
  • 每平臺的 home-channel 通知獨立開關（#19864）。
  • home-channel 開關對比度增強，新增 drop → running 操作（#19916）。
  • Dashboard API 不再允許直接將狀態切換為 running（#19705）。
  • Dashboard board pin 優先於服務端 current file（#21230）。
  • Dashboard event-stream 取消時按正常關閉處理（#21222）。
  • Dashboard board 按所選 tenant 過濾（#21349）。
  • 所有主題下 code/pre 樣式修復，不再串色（#21247）。
  • Dashboard 內 <code> 背景色重置（#20687）。
  • 保留 dashboard 完成摘要，新增 kanban 編輯功能（#20195）。
  • 修復 failure-column 重命名引發的脆弱性問題（#20855）。

Worker 生命週期與可靠性​

  • 心跳 + reclaim + 殭屍檢測 + 重試上限（#21183）。
  • 未完成退出的 worker 自動 block，修復關停競態（#21214）。
  • darwin 平臺殭屍 worker 檢測（#20188）。
  • 統一失敗計數：spawn / timeout / crash 三種場景共用同一套計數器（#20410）。
  • Destructive 工具調用強制任務所有權檢查：worker 不得操作不屬於自己任務的文件（#19713）。
  • 從 KANBAN_GUIDANCE 中移除 worker 身份聲明（#19427）。
  • 跳過分配給非 profile 通道的任務（#20165）。
  • on-disk assignee 枚舉包含 default profile（#20170）。
  • 忽略陳舊的 current board 指針（#20183）。
  • 自定義 root 部署下 profile 發現時忽略 HERMES_HOME（#19020）。
  • 允許 orchestrator profile 通過 toolsets 配置看到 kanban 工具（#19606）。

批量 Salvage（歷史 PR 搶救合併）​

  • Tier-1：metadata 測試、max_spawn 配置、run-id 生命週期守護（#20440）。
  • Tier-2：doctor、started_at、parent-guard、latest_summary、selects、linked-children（#20448）。

文檔​

  • 參考文檔中補充 multi-board 說明（#19704）。
  • 文檔化 /kanban slash 命令（#19584）。
  • 文檔化推薦的交接 evidence metadata（#20415）。
  • 修復 orchestrator + worker 技能配置說明（#20958、#20960）。

持久目標、Checkpoints 與會話耐受​

/goal：跨輪持久目標（Ralph loop）​

  • /goal 命令實現跨輪持久目標（#18262）。
  • 新增功能文檔頁：Persistent Goals (/goal)（#18275）。
  • 修復：正確讀取並遵循配置中的 goal 回合預算（#21287）。

Checkpoints v2​

  • 單存儲重寫 + 真正的剪枝 + 磁盤護欄（#20709）。

會話耐受性​

  • Gateway 重啟後會話自動恢復（#21192）。
  • 待處理 update 提示跨重啟保留（#20160）。
  • 重啟通知保留 home-channel thread 路由（#19271）。
  • 從已緩存的活躍會話源保留 thread 路由（#21206）。
  • 會話分叉時保留 assistant metadata（#18222）。
  • /update 進度與提示保留 thread 路由（#18193）。
  • 合併隊列事件時保留 document 類型（#18215）。

安全與可靠性​

安全加固（8 個 P0 關閉）​

  • 脫敏默認開啟（#21193）。
  • Discord：DISCORD_ALLOWED_ROLES 按發起 guild 範圍限制，修復 CVSS 8.1 漏洞（#21241）。
  • WhatsApp：默認拒絕陌生人，永不在 self-chat 中回覆（#21291）。
  • MCP OAuth：保存憑證時關閉 TOCTOU 競態窗口（#21176）。
  • hermes_cli/auth.py：憑證寫入關閉 TOCTOU 競態（#21194）。
  • 瀏覽器：混合路由強制 cloud-metadata SSRF 下限（#21228）。
  • hermes debug share：上傳時再次脫敏（#19318）。
  • Cron：掃描組裝後的 prompt（含 skill 內容），防範 prompt injection（#21350）。
  • .env / auth.json / state.db 恢復為 0600 權限（#19699）。
  • Dashboard 插件腳本的 SRI integrity 校驗（#21277）。
  • Meet node server 綁定 localhost，token 文件限定 owner 可讀（#19597）。
  • 敏感寫檢測擴展到 shell RC 文件與憑證文件（#19282）。
  • YOLO 模式 env 解析加固，防止 quoted-bool 字符串被誤解析（#18214）。
  • CI 引入 OSV-Scanner + Dependabot（僅限 github-actions）（#20037）。

可靠性：關鍵 Bug 修復​

  • CLI 啟動崩潰 Invalid key 'c-S-c'（P0，prompt_toolkit 不支持 Shift 修飾鍵）（#19895、#19919）。
  • CLOSE_WAIT 文件描述符洩漏審計：涵蓋 httpx keepalive、WhatsApp aiohttp 洩漏、飛書清理（#18766）。
  • 缺少 OPENROUTER_API_KEY 時不再以空 key 創建 AIAgent：fallback provider 現在被正確啟用。
  • 後臺 review + curator 受保護，不再覆寫 bundled / hub 技能（#20194）。
  • TUI 壓縮 continuation：清理元數據不全的幽靈會話。
  • hermes mcp add 不再靜默拉起 chat 而不註冊 MCP server（#21204）。
  • 後臺 review fork 正確繼承 provider / model / 憑證（接續 v0.12.0 #16099 的工作）。
  • Docker 後端：入站文檔將 host 路徑映射為容器路徑（#21184）。
  • Matrix gateway：高速模型下 auto-redaction 與消息投遞的競態修復。
  • Telegram：活躍會話期間 /new 無響應的問題修復。

消息平臺（Gateway）​

新平臺​

  • Google Chat（第 20 個平臺） + 通用 env_enablement_fn / cron_deliver_env_var 平臺插件 hook（IRC 與 Teams 已遷移至新架構）（#21306、#21331）。

跨平臺通用​

  • 全平臺 allowlist：allowed_channels / allowed_chats / allowed_rooms 配置覆蓋 Slack、Telegram、Mattermost、Matrix、釘釘（#21251）。
  • 每平臺 gateway_restart_notification 獨立開關（#20892）。
  • busy_ack_enabled：抑制忙碌 ack 消息（#18194）。
  • Slash 命令系統通知 TTL 到期後自動刪除（#18266）。
  • opt-in 清理臨時進度氣泡（#21186）。
  • [[as_document]] 指令：技能媒體路由（#21210）。
  • hermes gateway list：跨 profile 狀態查詢（#21225）。
  • 重啟後自動恢復中斷會話（#21192）。
  • 原子重啟標記 + Windows 運行時鎖偏移（#18179）。
  • config.yaml 優先於 .env：agent / display / timezone 設置以 config.yaml 為準（#18764）。
  • 源文件被修改後自動重啟（#18409）。
  • 陳舊代碼檢查改用 git HEAD SHA，不再依賴文件 mtime（#19740）。
  • 關停與重啟流程衛生修復：drain timeout、false-fatal、success log 全面梳理（#18761）。
  • env reload 後保留 max_turns（#21240）。
  • gateway 進程掃描排除祖先 PID（#19586）。
  • quick-command 別名分發移至內建之前（#19588）。
  • gateway status 顯示其他 profile 狀態，避免誤解（#19582）。
  • Telegram / Discord slash 命令納入 external_dirs 技能（#18741）。
  • disabled / optional 技能按 frontmatter slug 匹配，不再按目錄名（#18753）。
  • 從 SessionDB 讀取 /status token 總數（#18206）。
  • snapshot 回調在 agent 綁定後生成（#18219）。
  • /new 或 /reset 後重新注入 topic 綁定的技能（#18205）。
  • 原生圖像掛起路徑按會話隔離（#18202）。
  • new / resume / branch 時清理已排隊的 reload skills 提示（#19431）。
  • Telegram 菜單隱藏需要必填參數的命令（#19400）。
  • 將頂層 require_mention 橋接到 Telegram 配置（#19429）。
  • 抑制重複語音轉錄（#19428）。
  • 服務未安裝時給出友好提示（#19707）。
  • 會話信息 header 從 custom_providers 讀取 context_length（#19708）。
  • systemd unit 保留 WSL interop PATH（#19867）。
  • 處理計劃內服務停止（#19936）。
  • 保留與系統 DNS 一致的 DoH 已確認 Telegram IP（#20175）。
  • Discord + Telegram 從 config.yaml 加載 reply_to_mode（#20171）。
  • 容忍格式錯誤的 HERMES_HUMAN_DELAY_* 環境變量（#20217）。
  • thread 確定性驅逐時保留最新條目（#20285）。
  • 僅安裝系統 scope unit 時不再讓 setup wizard 走入死衚衕（#20905）。
  • 等待 systemd 重啟就緒 + 加固 Discord slash 同步（#20949）。
  • 避免重複的 Responses 歷史記錄（#21185）。
  • bootstrap 失敗暴露至 stderr（#21278）。
  • log agent task 失敗不再靜默丟失 usage 數據（#21274）。
  • runtime-status 寫入失敗時啟用 rate-limit log（#21285）。
  • 每次 fallback 重啟前執行 reset-failed，避免 gateway 卡死（#21371）。
  • Telegram 保留 thread_id=1 用於論壇 General 輸入指示（#21390）。
  • 批量關鍵修復：session resume、/new 競態、HA WebSocket scheme（#19182）。

Telegram​

  • DM 用戶管理多會話 topic（#19206）。

Discord​

  • 消息刪除 action（#21197）。
  • free_response_channels 可覆蓋 DISCORD_IGNORE_NO_MENTION（#19629）。

Slack​

  • 修復臨時 slash-command ack、私聊通知投遞、format_message 問題（#18198）。

WhatsApp​

  • 從 env override 加載 WhatsApp home channel（#18190）。

飛書​

  • 可配置的機器人接入與 mention 策略（#18208）。
  • markdown 表格強制 text 模式（#20275）。

Matrix + Email​

  • /sethome 在 Matrix 與 Email 上跨重啟持久化（#18272）。

Teams​

  • 新增 sidebar 與群聊回退的 threading 文檔及實現（#20042）。

微信​

  • 按內容指紋去重微信消息（#19742）。

QQBot​

  • SDK 改動 in-tree 移植：分塊上傳、審批鍵盤、引用附件（#21342）。
  • 通過 inline 鍵盤連接原生工具審批 UX（#21353）。

核心代理與架構​

Provider 與模型支持​

可插拔 Provider​

  • ProviderProfile ABC + plugins/model-providers/：推理 provider 升級為可插拔表面（#20324）。
  • list_picker_providers：按憑證過濾的 provider 選擇器（#20298）。
  • 刪除 /provider，統一為 /model（#20358）。
  • CLI 與插件共享 Hermes dotenv loader（#20281）。
  • Nous OAuth 跨 profile 共享 token store（#19712）。

新模型​

  • deepseek/deepseek-v4-pro 加入 OpenRouter + Nous Portal（#20495）。
  • x-ai/grok-4.3 加入 OpenRouter + Nous Portal（#20497）。
  • openrouter/owl-alpha（free 層）加入 curated 列表（#18071）。
  • tencent/hy3-preview OpenRouter 付費路徑（@Contentment003111，#21077）。
  • Arcee Trinity Large Thinking：溫度 + 壓縮 override（#20473）。
  • x-ai/grok-4.20-beta 重命名為 x-ai/grok-4.20（#19640）。
  • Vercel AI Gateway 在 provider picker 中降到底部（#18112）。

Provider 配置​

  • OpenRouter 響應緩存支持（#19132）。
  • image_gen.model 從 config.yaml 生效（#21273）。
  • delegate provider 解析時尊重運行時默認模型（#17587）。
  • provider picker 中避免 Bedrock 憑證探測（#18998）。
  • cron 執行時丟棄陳舊的 env-var provider override（#19627）。
  • auxiliary curator 的 api_key / base_url 進入運行時解析（#19421）。

代理循環與對話​

  • video_analyze：原生視頻理解工具（#19301）。
  • CLI + TUI 狀態欄顯示 context 壓縮計數（#21218）。
  • get_tool_definitions quiet_mode 緩存隔離 + 去重 LCM 注入（#17889）。
  • warning-first 工具調用循環護欄（#18227）。
  • 從 orphan tool-tail 打破永久空響應循環（#21385）。
  • ContextVars 正確傳遞給併發的 tool worker 線程（#18123）。
  • CLI / TUI / gateway 均暴露自我改進 review 摘要（#18073）。
  • execute_code 併發 hermes_tools RPC 調用串行化（#17894、#17902）。
  • 壓縮 token 估算納入 system prompt + 工具 schema（#18265）。

壓縮​

  • dedup pass 跳過非字符串工具內容，避免 AttributeError（#19398）。
  • 會話重置時復位 _summary_failure_cooldown_until（#19622）。
  • 超時錯誤也觸發 fallback（#19665）。
  • _prune_old_tool_results 邊界方向修復（#19725）。
  • 為內容過濾軟化 summary prompt（#21302）。

Delegate​

  • _build_child_agent 繼承父 fallback_chain（#19601）。
  • 守護 config.yaml 中 delegation: null 的情況（#19662）。
  • 僅設 delegation.base_url 而未設 delegation.api_key 時，繼承父 api_key（#19741）。
  • 交集前展開復合 toolset（#21300）。
  • 修正 ACP 文檔——Claude Code CLI 並無 --acp flag（#21201）。

會話與記憶​

  • Hindsight：探測 update_mode='append' API，實現跨進程去重（#20222）。

Curator​

  • hermes curator archive 與 prune 子命令（#20200）。
  • hermes curator list-archived（#21236）。
  • 手動 hermes curator run 改為同步執行（#21216）。
  • state 中保留 last_report_path（#18169）。
  • 合併後改寫 cron job 的技能引用（#18253）。
  • 首次運行前增加延遲 + --dry-run 預覽（#18389）。
  • 刪除時 absorbed_into 權威化 + 回滾時恢復 cron 技能鏈（#18731）。
  • 避免子串匹配導致的假陽性合併（#19573）。
  • 僅給後臺 review 沉澱打 agent-created 標記（#19621）。
  • 按 frontmatter name 保護 hub 技能（#20194）。

工具系統​

文件工具​

  • write_file + patch 後自動執行 post-write delta lint：進程內 Python / JSON / YAML / TOML 語法校驗（#20191）。

Cron​

  • no_agent 模式：純腳本 cron job（看門狗模式）（#19709）。
  • context_from 串接文檔（#20394）。
  • non-dict origin 視為缺失而非讓 tick 崩潰（#19283）。
  • cron job 加載技能時增加使用計數（#19433）。
  • 恢復 next_run_at 為 null 的 job（#19576）。
  • prerun 腳本無輸出時跳過 AI 調用（#19628）。
  • job 執行時展開 config.yaml 引用（#19872）。
  • 串行化 get_due_jobs 寫入，防止並行狀態損壞（#19874）。
  • 構造 cron AIAgent 前先初始化 MCP server（#21354）。

MCP​

  • 支持 SSE 傳輸（#21227）。
  • SSE 傳輸上轉發 OAuth + 提高 sse_read_timeout（#21323）。
  • stale-pipe 失敗按 session-expired 重試（#21289）。
  • 圖像類工具結果以 MEDIA tag 暴露，不再被丟棄（#21328）。
  • _wait_for_lifecycle_event 週期性 keepalive（#20209）。
  • 終止會話上重連（#19380）。
  • AnyUrl 導入與 mcp 依賴解耦（#19695）。
  • mcp add --command 修復不同的 argparse dest 問題（#21204）。
  • MCP 發現前清除陳舊線程中斷（#21276）。
  • MCP 調用錯誤中報告配置的 timeout（#21281）。
  • str(exc) 為空時錯誤信息補充異常類型（#21292）。
  • MCPServerTask.run 中顯式重拋 CancelledError（#21318）。
  • mcp_serve 中防禦性強轉數值參數（#21329）。
  • utility stub 按 server 通告的能力門控（#21347）。

瀏覽器​

  • 允許顯式 CDP override，無需 local agent-browser（#19670）。
  • root + AppArmor userns 限制時注入 --no-sandbox（#19747）。
  • 收緊 Lightpanda fallback 邊界情況（#20672）。

Web 工具​

  • 按能力選擇後端——搜索 / 抽取拆分（#20061）。
  • SearXNG 原生搜索專用後端（#20823）。

審批 / 工具門控​

  • 會話清理時喚醒被 block 的 gateway 審批（#18171）。
  • YOLO 模式 env 解析加固，防止 quoted-bool 字符串誤解析（#18214）。
  • 敏感寫檢測擴展到 shell RC 文件與憑證文件（#19282）。

插件系統​

  • transform_llm_output 插件 hook（#21235）。
  • 平臺插件 hook 文檔：env_enablement_fn + cron_deliver_env_var（#21331）。
  • 可插拔表面覆蓋度完善：model-provider 指南、完整插件地圖、opt-in 修復（#20749）。
  • 插件作者缺口填補：image-gen provider 指南 + 發佈 skill tap（#20800）。

技能生態​

新 Optional Skill​

  • Shopify：Admin + Storefront GraphQL（#18116）。
  • here.now（#18170）。
  • shop-app：個人購物助手（#20702）。
  • Anthropic financial-services bundle 移植（#21180）。
  • kanban-video-orchestrator（#19281）。
  • searxng-search：optional skill + Web Search + Extract 文檔頁（#20841、#20844）。

Skill UX​

  • Linear 技能新增 Documents 支持 + Python 助手腳本（#20752）。
  • Obsidian 技能現代化，改用 file 工具（#20413）。
  • 自定義工具創建默認走插件（#19755）。
  • skill_commands 緩存：平臺 scope 變化時自動重掃（#18739）。
  • skill_commands 緩存增加重掃路徑（#21181）。
  • extract_skill_conditions 中非 dict metadata 的迴歸測試（#18213）。
  • 說明如何還原 bundled 技能（#20404）。
  • 文檔化 hermes skills reset 子命令（#20395）。
  • himalaya v1.2.0 的 folder.aliases 語法說明（#19882）。
  • 將代理指向 hermes-agent 技能，文檔站同步更新（#20390）。

CLI 與用戶體驗​

CLI​

  • /new 接受可選 session 名參數（#19637）。
  • 100 條新 CLI 啟動 tip（#20168）。
  • display.language 靜態消息翻譯（zh / ja / de / es）（#20231）。
  • 法語（fr）locale（#20329）。
  • 烏克蘭語（uk）locale（#20467）。
  • 土耳其語（tr）locale（#20474）。
  • 窗口大小調整後恢復 classic CLI 輸出（#20444）。
  • TUI 絕對路徑補全修復（#19930）。
  • 修復惰性會話創建的迴歸問題（#20363）。
  • 本地後端 CLI 始終使用啟動目錄（#19334）。
  • 移除已廢棄的 c-S-c 鍵綁定（#19919）。

TUI（Ink）​

  • /model picker 全面重寫，對齊 hermes model 行為 + inline 鑑權（#18117）。
  • 啟動 banner 各部分可摺疊——skills、system prompt、MCP（#20625）。
  • 狀態欄顯示 context 壓縮計數（#21218）。
  • focused selector 減少 overlay 渲染抖動（#20393）。
  • 恢復語音 push-to-talk 一致性（#20897）。
  • kanban 按鈕修復（#18358）。

Dashboard​

  • Plugins 頁面：管理插件、啟用 / 禁用、查看鑑權狀態（#18095）。
  • Profiles 管理頁面（#16419）。
  • 分析表格列支持交互式排序（#18192）。
  • default-large 18px 內置主題（#20820）。
  • 支持 X-Forwarded-Prefix 反向代理部署（#21296）。
  • Docker 中通過 HERMES_DASHBOARD=1 啟動 dashboard 副進程（#19540）。
  • Dashboard 主題 layout shift 修復（#17232）。
  • gateway model picker current context 修復（#20513）。

升級與 Setup​

  • hermes update --yes/-y 跳過交互提示（#18261）。
  • 升級後需手動重啟 profile 的 gateway（#18178）。

Profile​

  • --no-skills flag 創建空 profile（#20986）。

語音、圖像與媒體​

  • xAI Custom Voices：語音克隆（#18776）。
  • Achievements：解鎖徽章時的分享卡渲染（#19657）。
  • gateway 啟動時刷新 systemd unit（不僅限於 start / restart）（#19684）。

API Server 與遠程訪問​

  • X-Hermes-Session-Key header：為長期記憶提供穩定的會話級隔離（#20199）。

ACP 適配器（VS Code / Zed / JetBrains）​

  • /steer 與 /queue slash 命令（#18114）。
  • WSL 會話翻譯 Windows cwd（#18233）。
  • 在空閒會話上將 /steer 作為普通 prompt 執行（#18258）。
  • 將 Zed 的 thoughts 路由至 reasoning，打磨 tool / context 渲染（#19139）。
  • 通過 replace_messages 實現原子會話持久化（#20279）。
  • 會話持久化中保留 assistant reasoning 元數據（#20296）。
  • 更新 ACP Client 擴展的 VS Code 配置文檔（#20433）。

Docker​

  • HERMES_DASHBOARD=1 啟動 dashboard 副進程（#19540）。
  • 官方鏡像拒絕以 root 身份運行 gateway（#21250）。
  • 運行時 node_modules chown 至 hermes 用戶（#21267）。
  • 構建上下文排除 compose / profile 運行時 state（#19626）。
  • CI：不取消重疊構建，守護 :latest 標籤（#20890）。
  • Dockerfile 契約測試對齊簡化後的 TUI 流程（#21174）。
  • 文檔：連接本地推理服務（vLLM、Ollama）（#20407）。
  • 文檔：API_SERVER_* 環境變量說明（#20409）。
  • 文檔：Docker 終端後端為單一持久容器（#20003）。

重要 Bug 修復​

Agent​

  • 修復惰性會話創建的迴歸（#20363）。
  • ContextVars 正確傳遞給併發的 tool worker 線程（#18123）。
  • warning-first 工具調用循環護欄（#18227）。
  • CLI / TUI / gateway 均暴露自我改進 review 摘要（#18073）。

Gateway 流式​

  • StreamingConfig bool 與數值類型強轉加固（#16463）。

Model​

  • provider picker 中避免 Bedrock 憑證探測（#18998）。

Doctor​

  • 本地未安裝 agent-browser 時檢查全局安裝（#19671）。
  • kimi-coding-cn provider 校驗迴歸修復（#19734）。

Update​

  • 在真實 stream 上 patch isatty，修復 xdist-flaky --yes 測試（#21175）。
  • restart-mock 感知 post-update 倖存清掃（#21177）。

Auth​

  • ACP 保留 assistant reasoning 元數據（#20296）。

Redact​

  • 增加 code_file 參數，跳過 ENV / JSON 模式的假陽性（#19715）。

Email​

  • quoted-relative file-drop 路徑與工具郵件路徑上的 Date header 修復（#19646）。

測試​

  • ACP：MCP E2E mock 接受 prompt 持久化 kwargs（#18047）。
  • Toolsets：post-#17805 toolset 斷言中納入 kanban（#18122）。
  • Agent：max-iterations summary 消息脫敏覆蓋（#19580）。
  • run_agent：_coerce_number 的 -inf / nan 迴歸覆蓋（#19703）。

文檔​

重大新增文檔​

  • llms.txt + llms-full.txt：面向 AI agent 友好的文檔攝入格式（#18276）。
  • User Stories 與 Use Cases 拼貼頁（#18282）。
  • Persistent Goals (/goal) 功能頁（#18275）。
  • Windows（WSL2）指南擴展：文件系統、網絡、服務、常見坑（#20748）。
  • 中文（zh-CN）README 翻譯（#20431）。
  • zh-Hans Docusaurus locale + Tool Gateway / image-gen / WSL quickstart 翻譯（#20430）。
  • Tool Gateway 文檔重構：先講它做什麼，配置說明移至末尾（#20827）。
  • Quickstart：Onchain AI Garage Hermes 視頻教程合集（#20192）。
  • Open WebUI bootstrap 腳本（#20427）。
  • 本地 Ollama 配置指南（#20426）。
  • Google Gemini 指南（#20401）。
  • /model 自定義模型別名（#20475）。
  • Together / Groq / Perplexity 通過 custom_providers 的 cookbook（#20400）。
  • 豆包語音集成示例（TTS + STT）（#20418）。
  • WSL-to-Windows Chrome MCP 橋（#20428）。
  • Hermes 技能文檔同步：slash 命令 + durable-systems（#20390）。
  • AGENTS.md：curator / cron / 委派 / toolset + 修復插件樹（#20226）。
  • Bedrock quickstart 入口 + fallback 註釋 + 部署鏈接（#20397）。

文檔打磨​

  • 將膨脹的技能樹摺疊為單一 Skills 節點（#18259）。
  • 澄清 session_search 副模型文檔（#19593）。
  • Open WebUI Quick Setup 缺口補全（#19654）。
  • 自定義工具創建默認走插件（#19755）。
  • 澄清 Telegram 群聊故障排查（#20416）。
  • Codex OAuth 鑑權前置條件說明（#20417）。
  • Discord Server Members Intent + SSRC 映射漂移 + /voice join slash Choice（#20411）。
  • 文檔化 ctx.dispatch_tool()（#20391）。
  • 文檔化 hermes webhook subscribe --deliver-only（#20392）。
  • 文檔化 hermes import 參考（#20396）。
  • 文檔化各 provider 的 TTS max_text_length 上限（#20389）。
  • 澄清支持的 prompt 自定義表面（#20383）。
  • 修正 web_extract summarizer timeout 註釋（#20381）。
  • 修復 fallback provider 配置路徑（#20382）。
  • 修正誤導性 RL install-extras 說明（#21213）。
  • 澄清 API server 工具執行的本地性（#21223）。
  • 改用 .venv 以匹配 AGENTS.md 與 scripts/run_tests.sh（#21334）。
  • 將工具發現與測試 runner 與 AGENTS.md 對齊（#20791）。
  • 統一終端後端數量與命名在文檔和代碼中的表述（#20402）。
  • 刷新過時的平臺數量（#20403）。

貢獻者​

核心​

  • @teknium1：salvage、triage、review、feature 開發與發佈管理。

主要社區貢獻者（按合入 PR 數排序）​

  • @kshitijk4poor — 21 個 PR · SearXNG 原生搜索後端、按能力選擇後端、TUI 啟動 banner 摺疊、Slack 臨時 ack 與格式修復、Lightpanda fallback 加固、searxng-search optional skill、自定義工具默認走插件、kanban failure-column 修復
  • @alt-glitch — 13 個 PR · video_analyze 工具、xAI Custom Voices（語音克隆）、本地後端 CLI 啟動目錄修復、惰性會話創建迴歸修復、gateway 啟動時刷新 systemd unit
  • @OutThisLife — 9 個 PR · TUI 性能優化（overlay 渲染抖動減少）、語音 push-to-talk 一致性恢復
  • @helix4u — 6 個 PR · 窗口大小變化後恢復 classic CLI 輸出、TUI 絕對路徑補全、gateway model picker current-context 修復、Bedrock 憑證探測規避、kanban 文檔修復
  • @ethernet8023 — 3 個 PR · Docker CI：不取消重疊構建、:latest 標籤守護
  • @benbarclay — 3 個 PR · Docker：通過 HERMES_DASHBOARD=1 啟動 dashboard 副進程
  • @austinpickett — 3 個 PR · Dashboard Plugins 頁面、TUI /model picker 重寫（含 inline 鑑權）、kanban 按鈕修復
  • @sprmn24 — 2 個 PR
  • @asheriif — 2 個 PR
  • @xxxigm — 2 個 PR · 貢獻者文檔：.venv 偏好、測試 runner 與 AGENTS.md 對齊
  • @stephenschoettler — ACP MCP E2E mock kwargs
  • @vincez-hms-coder — Dashboard Profiles 管理頁面
  • @cdanis — Contributor
  • @briandevans — Toolsets 測試：kanban 斷言
  • @heyitsaamir — Contributor

其他貢獻​

除上述貢獻者外，還有一長串 salvage / co-author / docs / 單次修復貢獻者，完整名單請參閱官方發佈頁。

自 v0.12.0 以來共有 **295 位社區貢獻者（含 co-author）**參與——僅一週時間。