Hermes Agent:實務參考指南(2026)
# Hermes Agent實務參考指南。這款由Nous Research開發的開源AI代理具備自我改進能力。本指南涵蓋供應商驗證、設定檔、技能系統,以及如何將其作為跨平台訊息閘道執行。
重點摘要:Hermes Agent 是 Nous Research 推出的開源自我改進 AI 代理。它可作為 CLI 與跨平台通訊 gateway 執行,將長期身分與持久記憶儲存在磁碟上,累積隨使用而改進的 skill,並支援任何相容於 OpenAI 的 LLM 供應商,包括 Nous Portal、OpenRouter、Anthropic、GitHub Copilot(自 v0.22.6 發布期間起為
github-copilot外掛)、z.ai、Kimi、MiniMax、DeepSeek、Qwen Cloud、Hugging Face、Google、xAI/SuperGrok,或您自行架設的端點。1219 目前版本為 v0.22.6(標籤為v0.22.6,日期為2026年11月2日),是 v0.22.2 之後第4個小幅彙整版本。v0.22.2 是針對 v0.22.0 的修正補丁,而 v0.22.0 則是彙整並記錄 v0.21.1 至 v0.21.7 整個補丁系列的功能版本;v0.22.3 至 v0.22.6 的重點版本說明將延至 v0.23.0 一併整理。v0.22.6 新增內容、v0.22.3 至 v0.22.5 新增內容、v0.22.2 新增內容、v0.22.1 新增內容及v0.22.0 新增內容說明了各版本的變更,後續版本章節則依由新到舊的順序排列。5860626466 對多數新使用者而言,最困難的是供應商驗證:在v0.22.5標籤版本中,Hermes 的靜態選單清單內建39家供應商,並會根據41個隨附的供應商外掛自動擴充清單。此外,還支援自訂端點、自 v0.22.0 起提供的受管理本機 llama.cpp 執行環境,以及3種不同的驗證途徑(在.env中設定 API 金鑰、透過hermes model使用 OAuth,或在config.yaml中設定自訂端點)。53555961 驗證機制是首先要掌握的部分,其餘所有行為都取決於最終解析出的供應商。
Hermes Agent 是完整的代理執行環境,並非僅為聊天功能加上一層介面。它能讀取您的檔案系統、在沙箱後端執行命令、擷取網頁、啟動子代理、執行 cron 排程工作、透過單一 gateway 程序與 Telegram/Discord/Slack/WhatsApp/Signal/電子郵件互通,並從經驗中建立自己的 skill。1 CLI 是建構於 run_agent.py 對話迴圈之上的終端機介面;gateway 則是長時間執行的程序,會將通訊平台的訊息導入同一個對話迴圈。3
Hermes 的一般使用者與進階使用者之間,差別在於是否掌握5大系統。熟悉這些系統,Hermes 就能讓您事半功倍:
- 供應商解析:驗證流程如何對應至 API 呼叫
- 設定階層:
config.yaml+.env+auth.json+SOUL.md+AGENTS.md - 工具與 toolset 系統:代理能執行哪些操作,以及各平台的權限限制
- skill 系統:代理自行建立並持續演進的程序性記憶
- gateway + cron + profile:讓 Hermes 融入您的日常使用環境,而不只侷限於當下所在的介面
重點整理
- 供應商驗證有3種途徑,而非只有1種。在
.env中設定 API 金鑰、透過hermes model/hermes auth使用 OAuth,或在config.yaml中設定自訂端點。請選擇符合供應商需求的途徑,不要只選自己熟悉的方式。 - 只需1個命令即可切換供應商。
hermes model會以互動方式引導您設定所有支援的供應商,包括 OAuth 登入;/model provider:model則可在工作階段中途切換,並保留歷史紀錄。2 - 使用者可編輯的設定集中在2個檔案。
~/.hermes/config.yaml儲存設定,~/.hermes/.env儲存機密資訊。auth.json、SOUL.md、MEMORY.md與skills/由 Hermes 直接管理。您可以手動編輯SOUL.md,其餘則由代理自行更新。4 - Hermes 是 OpenClaw 的後繼產品。若要遷移,
hermes claw migrate可自動匯入超過30類狀態資料。5 自 v0.22.5 發布期間起,遷移工具改由agent-importers外掛提供,保留hermes claw migrate命令名稱,並可匯入 Claude Code、Codex 與 Cursor 的設定(請參閱CLI 命令)。65 - 輔助工作預設使用您的主要模型。視覺處理、核准分類、壓縮與工作階段標題會以獨立的「輔助」LLM 呼叫執行。在此標籤版本中,
auto會將所有這類呼叫導向主要聊天模型,無須另外設定;但若使用昂貴的推理模型,這些輔助工作會帶來可觀的額外費用。若需控制成本,可將個別auxiliary.<task>設定項目指向價格低廉、速度快的模型。434
以下每個章節皆以 hermes-agent.nousresearch.com/docs 的上游文件及 github.com/NousResearch/hermes-agent 的原始碼目錄樹為依據。每項事實陳述都附有註腳,指向其出處的特定上游頁面。
依需求查閱
| 您的需求 | 請前往 |
|---|---|
| 安裝 Hermes | 安裝 — 單行安裝命令或手動步驟 |
| 登入供應商 | 驗證與供應商 — 您要找的章節 |
| 在工作階段中途切換模型 | 請參閱 hermes auth 命令與自訂與自行架設的端點,了解 /model 語法 |
| 執行本機 LLM | 自訂與自行架設的端點 — Ollama、vLLM、SGLang、llama.cpp、LM Studio |
| 連接通訊平台 | 通訊 gateway — Telegram、Discord、Slack、WhatsApp、Signal、Google Chat、LINE、SimpleX Chat、ntfy、Buzz(文件比較表列有28個平台) |
| 撰寫或安裝 skill | skill 系統 — 漸進式揭露 + skill 中心 |
| 查閱每個 CLI 命令的詳細參考資料 | 繼續閱讀,或直接前往CLI 命令 |
Hermes的運作方式:心智模型
Hermes以單一對話迴圈為核心,任何進入點都能呼叫它。進入點包括CLI(cli.py)、訊息gateway(gateway/run.py)、用於編輯器整合的ACP轉接器、批次執行器,以及API伺服器。3它們最終都會呼叫run_agent.py中的AIAgent.run_conversation(),執行以下步驟:
- 透過
agent/prompt_builder.py,根據SOUL.md、MEMORY.md、USER.md、skill、上下文檔案及工具指引建立系統提示詞(2026年9月的模組拆分將其移至新的agent/套件)3 - 透過
runtime_provider.py決定執行階段的供應商——此步驟會選定驗證方式、基底URL及API模式3 - 使用3種API模式之一呼叫供應商:
chat_completions、codex_responses或anthropic_messages3 - 透過
model_tools.py及中央工具登錄表(tools/registry.py)分派傳回的工具呼叫3 - 持續迴圈,直到模型產生最終回覆,再將工作階段儲存至支援FTS5的SQLite3
理解此迴圈至關重要,因為每項功能——人格、記憶、skill、壓縮、備援——都連接到其中一個階段。閱讀設定鍵時,若想知道它的用途,答案通常是「它用來調整上述迴圈中第1、2、3或4階段的行為」。
與平台無關的核心。單一AIAgent類別同時服務CLI、gateway、ACP、批次執行及API伺服器。平台差異由進入點處理,不在代理本身。3這也是相同斜線指令能在終端機和Telegram中運作的原因——它們都透過hermes_cli/commands.py中共用的COMMAND_REGISTRY進行分派。6
目錄結構就是系統架構。Hermes將所有資料儲存在~/.hermes/下(非預設profile則使用$HERMES_HOME):4
~/.hermes/
├── config.yaml # Settings (model, terminal, TTS, compression, etc.)
├── .env # API keys and secrets
├── auth.json # OAuth provider credentials (Nous Portal, Codex, Anthropic)
├── SOUL.md # Primary agent identity (slot #1 in system prompt)
├── memories/ # Persistent memory (MEMORY.md, USER.md)
├── skills/ # Bundled + agent-created + hub-installed skills
├── cron/ # Scheduled jobs
├── sessions/ # Gateway session state
└── logs/ # agent.log, gateway.log, errors.log (secrets auto-redacted)
上述每個檔案都有明確職責,彼此不重疊。若您想找「Hermes將X存在哪裡」,答案就在其中。
v0.22.6的新功能(v0.23.0之前的第4個彙整版本)
v0.22.6(標籤v0.22.6,提交f0d94882,2026年11月2日,於UTC 17:18發布)是v0.22.2之後第4個精簡修補版本,所附說明與前3個版本相同:「此期間的完整精選說明將隨v0.23.0發布。」它「彙整了自v0.22.5以來合併的約776個PR」:3,448筆非合併提交,涉及4,316個變更檔案(+248,579 / -94,077),並關閉385個議題。與v0.22.5相比,v0.22.6的檔案樹新增1,504個blob、移除237個,並變更2,646個。以下列出版本說明明列的項目,以及標籤所呈現的內容:6667
- Webapp與Desktop。
hermes webapp會在瀏覽器中開啟Hermes Desktop工作區:當config.yaml中的webapp.enabled為true時,由gateway提供服務;此指令會視需要建置套件、啟動gateway,並開啟一次性登入連結(--no-open只輸出連結,--status顯示gateway是否正在提供服務,--build-only在建置完成後即停止)。Desktop新增Web Access面板,可在您的網路或自訂URL上開啟Webapp,並以Nous登入保護;Desktop外掛可在瀏覽器分頁中載入;群組聊天可重新命名與解散,並支援@提及與貼上附件;每個profile都會顯示為側邊欄的一個區段;cron編輯器也新增Stop按鈕。 - 工作階段、skill、cron與壓縮。
/model reset會移除聊天的/model覆寫設定,使其回到所屬profile設定的模型,且不會遺失歷史紀錄(gateway與Desktop的聊天指令)。hermes curator lock <skill>會將skill宣告為代理不得透過任何寫入途徑變更的項目,unlock解除鎖定,hermes curator status列出已鎖定的skill,Desktop的Capabilities面板也有相同的開關。compression.prepare_ahead: true(預設為false)會在壓縮執行前,先以背景作業準備摘要。hermes cron cancel可停止執行中的工作。每項cron工作都可帶有catch_up:true會針對機器關機期間錯過的所有執行一次性補跑一回,false則直接跳到下一個時段;未設定時,週期性工作遵循cron.catch_up_missed(預設為true),單次工作則維持120秒的寬限規則,而略過的時段會在執行帳本中記為一列「missed xN」。/delegation的選擇會以delegation.backend持久保存在profile的config.yaml中,因此下一個工作階段會直接沿用。 - 遷移、保管庫、外掛與平台。
hermes migrate <agent>會在缺少agent-importers外掛時先安裝,再執行hermes import-agent <agent>;匯入工具現在也支援Grok Bot(由機器人依匯入工具印出的提示詞自行產生的匯出檔)與OpenBot桌面版(其openbot.db),且hermes setup偵測到其中任一者時會提供匯入選項。保管庫金鑰可存放在作業系統鑰匙圈中:vault.key_storage: keychain(預設為file),可透過hermes vault key migrate --to keychain(或--to file)搬移,底層使用keychain選用套件提供的keyring套件(macOS Keychain、Windows Credential Manager、KWallet)。目錄項目的requires_hermes現在會在外掛安裝與更新時強制檢查,而不只在載入時。text_to_speech的ElevenLabs版本可針對每次呼叫指定voice_id,並透過find_voices搜尋公開的Voice Library或您帳戶中的語音。pre_llm_call外掛掛鉤可回傳{"action": "block", "message": "..."},在送出任何推論請求前結束該回合,或注入上下文。Telegram的video note會以影片訊息送達,Slack的表情符號回應會作為討論串上下文一併帶入,套件管理器也能續傳中斷的下載(版本說明所述;未在標籤中找到對應實作)。 - GitHub Copilot退出核心(10月25日,屬於此期間)。提交
1da2eb42「refactor!: 將GitHub Copilot移出核心(現為github-copilot labs外掛)」刪除了plugins/model-providers/copilot/與copilot-acp/;2種模式合併為單一社群層級外掛github-copilot,由NousResearch/hermes-labs-plugins提供(標籤中已有目錄項目)。名稱、設定鍵與環境變數均未變更,因此遷移方式就是「安裝外掛」:hermes update會為每個曾透過copilot或copilot-acp路由的profile安裝它(退出核心遷移表),代理與gateway啟動時會針對目前的home每個處理程序重試一次,且每則「未知供應商」訊息都會指出hermes plugins install github-copilot。靜態選擇器清單移除了copilot與copilot-acp列,agent/copilot_acp_client.py僅作為目錄外掛所繼承的已棄用別名保留。版本說明並未提及此事。請參閱GitHub Copilot:2種模式。 - 在標籤
v0.22.6中。外掛目錄從763個項目增加至911個(新增148個,無移除;其中包括github-copilot、codex-theme、kubernetes、hermes-lang-cs、hermes-lang-he、hermes-model-switcher、hermes-profile-switcher,以及ElevenLabs的音樂與音效工具)。plugins/platforms/維持27個目錄;plugins/model-providers/從41個減至39個(copilot、copilot-acp)。新增:plugins/config_backends/remote/(60個檔案)與hermes_cli/config_backend.py,即ConfigBackend介面層,現在profile的config.yaml每次讀寫都經由它;remote後端從設定平面提供各profile的設定(啟動時擷取,失敗即封閉;由ETag輪詢器重新整理;以比較並交換方式寫回),且只能透過HERMES_CONFIG_BACKEND=remote選用,絕不會作為一般外掛載入。維持不變的項目:隨附的記憶供應商ByteRover與RetainDB、語系目錄、22行的plugin_compat.py存根,以及sessions.auto_prune: false。
更新方式:CLI使用hermes update或單行安裝指令;Store應用程式透過Store更新;透過.exe或.dmg安裝的桌面應用程式在此版本中維持不變,會隨下一個整合發行版本更新;Docker和Hermes Cloud拉取nousresearch/hermes-agent:stable(或:latest)。66
v0.22.3至v0.22.5的新功能(v0.23.0之前的彙整版本)
v0.22.2發布後的2天內,接連推出3個說明簡短的修補版本,且三者都附上相同說明:這段期間經整理的版本說明將隨v0.23.0一併發布,「屆時將記錄自v0.22.0以來的所有變更」。v0.22.3(標籤v0.22.3,2026年10月21日,於UTC 12:21發布)「彙整了自v0.22.2以來合併的約620個PR」:2,911筆非合併提交,涉及4,206個變更檔案,並關閉326個議題。v0.22.4(10月21日,於UTC 18:49發布)包含14筆修正提交。v0.22.5(標籤v0.22.5,標示日期為10月22日,於10月23日UTC 05:28發布)彙整了自v0.22.4以來的約81個PR:231筆非合併提交,涉及804個檔案。與v0.22.2相比,v0.22.5的檔案樹新增2,303個blob、移除109個,並變更2,298個,因此這2個彙整版本合計的變更規模,比v0.22.0相對於v0.21.7的變更還大。以下列出各版本明列的項目,以及標籤所呈現的內容:6465
- v0.22.3,「刻意不在此記錄」。將MCP進度通知串流呈現為即時工具進度;更新傳統CLI版面配置(以符號呈現的對話紀錄、輸入區下方的狀態列、雙行標頭);由外掛宣告、由Hermes負責登入及更新驗證資訊的OAuth用戶端;
hermes plugins update提供所有可用的外掛更新,Desktop也為透過git安裝的外掛加入「更新」按鈕;在Desktop中引導執行方向並編輯佇列中的提示詞;Desktop提供引導式子代理模型與供應商選擇器;CLI和TUI中的即時/loop倒數列;可選擇啟用的Telegram私訊主題轉移;post_compaction外掛掛鉤;能力目錄;Microsoft Store版本在新版本發布時自動上架;工作階段自動清理恢復為須主動啟用,磁碟空間不足時顯示一次性提示;本機執行環境中的Nemotron 3.5 Bolt與單槽DFlash草稿生成;以及數十個新增的外掛目錄項目。 - v0.22.4,修正項目。Desktop不再於輸入區上方顯示膠囊狀建議按鈕(「它們出現的原因不明,大多是在催促您設定MCP伺服器」);不安裝任何內容的外掛會略過相依套件安裝同意步驟;WhatsApp登出後可從儀表板重新配對;Desktop的核准模式標籤會跟隨目前profile的模式;桌面版外掛審查的表層靜態檢查不再將原型寫入標示為問題。目錄新增項目:
bubblewrap(Linux上的bwrap終端機後端,hermes config set terminal.backend bubblewrap)、singularity(Singularity/Apptainer)、mcp-serve、agent-importers,以及Hermes Labs的inbox和workflow-record;Telegram Business移至Hermes Labs社群層級。 - v0.22.5,「刻意不在此記錄」。重新設計Nous登入流程(每次登入都採用一般裝置登入流程、免費方案訪客身分會轉交至您的帳戶、結果會顯示登入者身分、連接器提供登入選項,而非開啟訪客工作階段);
hermes update會暫緩提供其拒絕接受的穩定版本;Windows上的hermes update在重新固定Python版本後,不再卡在舊版啟動器;支援依使用量時段計算的方案(方案用量指示、額度限制卡片、切換模型後恢復運作);可插拔的委派後端(依模型對應表或profile路由子代理,可在各工作階段中切換);外掛斜線指令可要求您選取選項;hermes import-agent、OpenClaw遷移、hermes mcp serve及Singularity後端從核心移至外掛(設定流程偵測到其他代理時,會提供匯入工具);Desktop支援在側邊欄拖曳釘選,以及附有層級標章的一鍵外掛安裝;升級至Electron 44;Pillow 13及一批相依套件安全性更新;聊天的工作資料夾不存在時顯示明確訊息;hermes update可在.git損壞後恢復已暫停的gateway;較長的Claude DirectSDK回覆不再被停滯計時器截斷;Desktop群組聊天恢復顯示目前正在工作的機器人;以及實驗性的webhook模式MCP事件用戶端。 - 在標籤
v0.22.5中。外掛目錄從614個項目增加至763個(新增150個,包括mcp-serve、agent-importers、bubblewrap、singularity、inbox、workflow-record、advanced-delegation及deadbolt;移除codex-account-switch)。plugins/platforms/從21個目錄增加至27個(bluebubbles、qqbot、signal、weixin、whatsapp_cloud、yuanbao)。維持不變的項目:41個模型供應商外掛目錄、隨附的記憶供應商ByteRover與RetainDB、17份核心及16份TUI語系目錄,以及22行的plugin_compat.py存根;靜態選擇器清單有39列。sessions.auto_prune的預設值再次改為false(預設值檔案說明:存放state.db的磁碟空間不足時,各介面都會詢問)。mcp_serve.py已從儲存庫根目錄移除,hermes mcp則說明,以MCP伺服器形式執行Hermes的功能由mcp-serve外掛提供;hermes_cli/claw.py與subcommands/import_agent.py已移除,由agent-importers外掛取代;agent/新增delegation_backends.py、delegation_provider.py及delegation_registry.py,並新增developer-guide/delegation-provider-plugin.md文件頁面。
更新方式:CLI使用hermes update或單行安裝指令;Store應用程式透過Store更新;透過.exe或.dmg安裝的桌面應用程式在這幾個版本中維持不變,會隨下一個整合發行版本更新;Docker和Hermes Cloud拉取nousresearch/hermes-agent:stable(或:latest)。64
v0.22.2的新功能(修正後的修補版本)
Hermes Agent v0.22.2(標籤為v0.22.2,於2026年10月15日08:21 UTC發布)是目前的版本。版本說明開頭便交代了發布原因:「v0.22.1是從錯誤的提交建置而成。它包含尚未發布的gateway開發內容,而且Microsoft Store應用程式可能卡在『連線中』。0.22.2才是0.22.1原本應有的版本。」發布提交的訊息為「以已發布的v0.22.1為父提交,從release/0.22.1發布0.22.2」,將預定的發布分支合併至誤發的標籤之上。因此,相較於v0.22.1,檔案樹刪除了1,135個檔案,並修改了另外846個檔案;但相較於v0.22.0,僅新增50個檔案、移除1個檔案,並修改205個檔案。換言之,這是在v0.22.0基礎上的小幅修補,只是與v0.22.1相比呈現出龐大的差異。版本說明列出1項已知問題:曾在0.22.1 gateway下執行的工作階段,無法在0.22.2中刪除。6263
- 重新開機後,gateway又能正常啟動了。 在Linux上,重新開機後,先前使用的低編號PID可能被分配給無關的程序,而gateway可能誤認為已有gateway正在執行,導致受監督的gateway(systemd、launchd、Docker)拒絕啟動。Hermes現在會記錄自身是在哪一次系統開機後啟動;若無法判定,則會查詢主機鎖定,而只有仍在執行的gateway才會持有此鎖定(PR #138594,修正#133744)。
- 筆記型電腦也能完成耗時較長的本機模型回合。 本機請求一律採用串流傳輸,並在狀態列顯示提示讀取進度;停滯計時器會排除電腦休眠的時間;本機伺服器恢復運作後會再次嘗試,不再因斷路器使後續每則訊息都失敗;伺服器仍在讀取長篇對話時,壓縮作業也不再逾時。在採用統一記憶體的Windows電腦上,模型啟動設定與提示快取大小會依可用記憶體調整(PR #138560)。在原始碼中,這些變更對應到
agent/下的6個新模組,包括local_prompt_progress.py、sleep_clock.py與conversation_compression_deadline.py。 - v0.22.1宣告、且v0.22.2保留的內容。 外掛目錄維持614個項目,優先顯示精選模型的選擇器與Nemotron 3.5 Super VL識別碼也都保留。各項數量同樣不變:41個模型供應商外掛目錄、39筆靜態選擇器項目、隨附的記憶供應商ByteRover與RetainDB、17份核心與16份TUI語系目錄,以及22行的
plugin_compat.py存根。 - v0.22.2移除的內容。 v0.22.1變更清單中占據大量篇幅的「工作階段權限」與「標準化准入」重構,已從此標籤中移除:包括
gateway/下的118個檔案、47個hermes_cli/模組(多數為gateway_*)、21個頂層hermes_state_*.py模組、agent/managed_worker.py與runtime_session_*模組、ACP gateway伺服器、132個桌面版檔案,以及466個gateway測試。v0.22.1標籤所指提交中的壓縮skill標記修正,以及文件中的「壓縮前後已載入的skill」章節,也一併移除。版本說明指出,僅存在於main的開發內容將隨v0.23.0發布。
重點摘要下方的清單涵蓋自v0.22.0以來整個0.22版本系列的變更(19項功能、7項改進、58項錯誤修正、8項文件變更、9項測試變更、31項基礎架構變更、35項其他變更),因此會重複列出v0.22.1版本說明中的目錄新增項目與選擇器變更。更新方式:執行hermes update或單行安裝指令,即可將已升級至v0.22.1的安裝環境帶回正式發布版本系列;Store安裝版本透過Store更新;Docker與Hermes Cloud則拉取nousresearch/hermes-agent:stable(或:latest)。6263
v0.22.1的新功能(10月14日修補版本)
Hermes Agent v0.22.1(標籤為v0.22.1,於2026年10月14日23:59 UTC發布;版本標題帶有建置標籤rc.5-v0.22.1)曾是當時的最新版本,維持了8小時,直到10月15日被v0.22.2取代。依後者的版本說明,v0.22.1「是從錯誤的提交建置而成」,並「包含尚未發布的gateway開發內容」,而且Microsoft Store應用程式可能卡在「連線中」。以下保留為該標籤所含內容的紀錄;哪些內容仍保留,請參閱v0.22.2的新功能。62 該版本本身的描述只有一句話:「這是修補版本,包含幾項Windows Store修正、外掛更新等內容。」版本說明其餘部分皆為自動產生的提交標題清單(功能類111項、改進類21項、錯誤修正類315項、測試類121項、基礎架構類41項、文件類28項、其他變更類22項)。從這些標題判斷,多數屬於內部機制調整(「工作階段權限」與「標準化准入」重構),而非使用者可見的變更。GitHub與v0.22.0的比較結果共計2,216筆提交,提交者日期介於9月24日至10月14日之間,因此該標籤也納入了v0.22.0定版後合併的開發內容。在該標籤可驗證的項目如下:6061
- 外掛目錄從601個增至614個項目。 版本說明提及、且該標籤中確實存在的項目包括:韓文與巴西葡萄牙文桌面版語言套件(
hermes-lang-ko、hermes-lang-pt-br)、TeamoRouter模型供應商外掛、author-feed、wait-ledger、lightningai與lightningai-rate-limit、Hermes AAC、openinvest、hermes-agent-mixer,以及移至記憶分類的Kumiho Memory。 - 模型選擇器。 對多數供應商而言,精選模型識別碼現在會排在各供應商清單的前端,優先於models.dev資料來源中的項目(少數優先採用即時資料的供應商仍維持資料來源的排序),避免新推出、適合代理工作的模型因資料更新延遲而難以找到。版本說明也記錄了Nemotron Super 3.5的新預設參數與識別碼更名;該標籤的靜態目錄列出的識別碼為
nvidia/nemotron-3.5-super-vl-120b-a12b。 - 壓縮後保留已載入的skill。 標籤所指的提交及其前後提交修正了skill重新載入標記,讓小型、透過斜線指令呼叫、經備援摘要處理,以及平行載入的skill都能在壓縮後保留。開發者指南也新增了「壓縮前後已載入的skill」章節。這屬於尚未發布的開發內容:該標籤提交的變更與文件章節均未包含在
v0.22.2中。63 - 該標籤中維持不變的項目: 41個供應商外掛目錄、39筆靜態選擇器項目、隨附的記憶供應商ByteRover與RetainDB、17份核心與16份TUI語系目錄,以及22行的
plugin_compat.py存根。至於版本描述提到的Windows Store修正,除了1項Windows桌面版票證初始化修正之外,無法從清單中辨識出其他對應項目,因此此處僅依版本說明記載。
請勿停留在此版本:執行hermes update或單行安裝指令,即可將已升級至v0.22.1的CLI安裝環境更新至v0.22.2;Store安裝版本透過Store更新;Docker與Hermes Cloud則拉取nousresearch/hermes-agent:stable。6062
v0.22.0新功能(門檻版本)
Hermes Agent v0.22.0(標籤v0.22.0,日期為2026年10月13日,於10月14日發布)在10月14日的大部分時間裡都是最新版本,至今仍是v0.22系列的功能版本。整個v0.21.x彙整版本系列一直留待此版本提供完整整理:「彙整並完整記錄v0.21.1–v0.21.7修補版本。」此版本延續眾神殿的主題:「Hermes是門檻之神:門口、通道、界石。v0.21.0集結了眾神;v0.22.0則要跨過那道門。」統計列原文如下:「自v0.21.0以來:約24,200次提交 · 約6,080個已合併PR · 約15,600個檔案變更 · 約2,045,000行新增 · 約1,140,000行刪除 · 約7,180個已關閉議題 · 約2,520位貢獻者」。依版本自身的統計,規模約為v0.21.0開發週期的2.5倍;光是自v0.21.7以來,GitHub版本比較就有756次提交。此版本記錄的許多內容已在v0.21.1至v0.21.7期間推出,下方各節也已依標籤版本詳述。本節記錄此版本的定位、升級注意事項,以及自v0.21.7以來的新內容,並已對照該標籤的原始碼查核。5859
有7項變更讓本指南舊版的操作說明不再適用。更新前請先閱讀:
- Python 3.14成為受管理的執行環境。使用受管理安裝方式時,套件管理員會安裝此版本(
pm/lock.json固定使用cpython-3.14.7);從原始碼簽出安裝時,pyproject.toml仍接受3.11至3.14。KittenTTS無法在3.14上使用。 - Windows桌面版僅提供MSIX,且需要Windows 11 22H2或更新版本;NSIS與MSI安裝程式已移除。預設macOS建置僅支援Apple Silicon。
- 預設每台機器僅使用一個gateway。若沒有衝突,
hermes update會將各profile的gateway整併至預設的多工gateway;請參閱Profiles。 - 聊天不再依閒置時間或每日計時器重設。
session_reset的閒置與每日模式已停用(若設定仍指定這些模式,系統會記錄警告,hermes doctor也會回報計時器已移除);使用/new或/reset即可重新開始。 - 舊工作階段會自動清除。
sessions.auto_prune預設啟用:已結束且90天未活動的工作階段會在啟動時刪除。釘選與仍開啟的工作階段一律保留;設定sessions.auto_prune: false可保留全部內容。此變更已在v0.22.3期間撤回:到了v0.22.5,預設值再次改為false,且當存放state.db的磁碟空間不足時,各介面都會詢問一次(請參閱v0.22.3至v0.22.5新功能)。65 - 記憶服務提供者已移至目錄(Honcho、Supermemory、Hindsight、Mem0、OpenViking、Holographic),Home Assistant、Spotify與Langfuse亦同;既有使用者會在更新或首次啟動時完成遷移。ByteRover與RetainDB仍隨附於套件中。請參閱外部記憶服務提供者。
- 外掛作者請注意:外掛相容性匯入層已移除(仍保留22行的
hermes_cli/plugin_compat.py存根),hermes sync(Skill Sync)與內建的tirith掃描器也已移除(設定遷移49至50會刪除security.tirith_*鍵)。另有3個工具重新命名:todo改為todo_list、cronjob改為cronjob_manage、process改為process_manage,舊名稱仍可使用。
此版本依功能領域整理,以下摘要也採用相同方式。
- 首次啟動即可自行完成設定。在從未執行過Hermes的電腦上開啟桌面應用程式時,設定畫面會改為設定對話:逐張卡片詢問您的姓名、強調色與版面配置、要連接的應用程式及要安裝的外掛,接著提供導覽與最多4項初始任務。此流程使用免費的
nous/welcome試用模型,每個作業系統使用者可使用一次,不需要金鑰;選擇略過設定即可結束,透過「設定 ▸ 重新執行初始設定」可再次開啟。CLI、TUI與gateway不提供帳號或免費模型,HERMES_GUEST_ONBOARDING已停用,舊的setup-profile流程與/initiate-setup也已刪除。代理另新增set_theme,因此在任何桌面聊天中都能說「改成紫羅蘭色、深色模式」。 - 連接器:Hermes直接在您的應用程式中運作。代理透過Nous工具gateway操作Linear、Notion等託管應用程式:指定應用程式,在瀏覽器登入一次,即可在同一回合使用工具。開始時不需要Nous帳號;首次使用會建立免費、僅供連接器使用的身分,之後可透過
hermes auth upgrade(或在任何聊天或訊息私訊中使用/login)升級為完整帳號,並保留已連接的應用程式。桌面版新增的「連接器」頁面會一併列出託管應用程式與您的MCP伺服器(取代原本的MCP分頁),TUI與CLI也會顯示相同的設定卡片。同一應用程式的多個具名帳號(如work與home)可透過/connectors或hermes connectors管理。nous.guest: false可關閉訪客身分,tools.connectors.enabled: false則可關閉連接器。 - 一鍵使用本機模型。Hermes會依您的硬體安裝並維護llama.cpp(CPU、CUDA、Metal、Vulkan或ROCm;建置版本
b11370),根據GPU與RAM評估目錄中的每個模型,並選擇硬體可容納、品質最高的建置版本。在Windows、macOS與Linux上,可從「設定 ▸ 提供者 ▸ 本機模型」開始,或在終端機執行hermes model→本機模型。下載可暫停及繼續,伺服器會隨Hermes啟動與停止,引擎也能一鍵更新。請參閱本機LLM伺服器。 - 穩定版本、簽署套件,以及統一的套件管理員。經過測試、安裝後預設追蹤的SemVer版本,已在v0.21.7一節說明;v0.21.6與v0.21.7是首批通過此發布流程的版本,更新檢查也減為每天一次GitHub API呼叫。桌面應用程式現在採用封裝完整、經簽署的套件,內含專用的Python與Node:Windows(x64與ARM64)透過App Installer或Microsoft Store提供已簽署的MSIX,macOS則提供經簽署與公證的Apple Silicon建置版本。底層由
hermes pm管理所有固定版本、經雜湊驗證的工具與Python環境(doctor、status、repair、gc);相依套件環境以世代為單位管理,使用前會先檢查,因此更新失敗或遭到終止時,不再留下只完成一半的安裝,hermes pm gc則會清理舊世代。選用的SDK會在首次使用時安裝,除非設定security.allow_lazy_installs: false。 - 外掛目錄:600個經過審查的外掛。本開發週期推出的目錄已成長至600個項目(該標籤有601個YAML檔案,v0.21.7時為552個),每個項目都固定至經過審查的提交。文件網站為每個外掛與作者提供專屬頁面,安裝時會顯示已知問題警告;依上架規則,有11個修改內部實作的外掛遭下架(已安裝的副本仍可運作)。記憶服務提供者、Home Assistant、Spotify、Langfuse與TouchDesigner現在都已成為官方目錄外掛。
- Claude 5.5與GPT-6模型浪潮。Claude Fable 5.1、Opus 5.5、Sonnet 5.5與Haiku 5.5,GPT-6 Astra、Sol與Luna,以及GPT-6.1 Sol和Gemini 4 Argon,皆可在有提供支援的Nous Portal、OpenRouter與原生路由上選用;Opus 5.5也可透過原生Anthropic與Bedrock使用。對於能讀取既有推理內容的提供者,現在預設會在恢復、分支與壓縮後重新傳送先前的推理內容。當提供者暫時不穩時,
agent.auto_recovery_cycles(預設5)會限制使用者可見的等待與重試循環次數,避免直接結束回合;agent.turn_liveness.timeout_s(預設600)則會中斷毫無進展的回合。提示快取新增可選擇啟用的prompt_caching.cache_ttl: auto(互動用途為1小時,子代理與cron為5分鐘)。 - 透過密碼管理員登入網站。瀏覽器代理會使用1Password、Bitwarden或Hermes自有加密保管庫中的登入資料登入網站,模型全程不會看到密碼;遮蔽敏感資訊的提示會詢問是否儲存新的登入資料,一次性驗證碼會直接填入,不會進入對話,結帳時填入卡片與地址則需要您的確認。保管庫與瀏覽器登入功能最早出現在下方的v0.21.2一節;此處是本次發布對這些功能的完整說明。
- 機器人畫面。在Linux gateway上執行的機器人可以擁有自己的桌面,並由Hermes Desktop即時串流;遇到登入、2FA提示或CAPTCHA時,您可接管畫面,完成步驟後再交還控制權。使用Docker、SSH或Singularity後端時,機器人畫面、電腦操作與瀏覽器都會在沙箱內執行(
nousresearch/hermes-sandbox:desktop是新的預設映像)。此功能預設關閉,且需要安裝主機套件。 - 所有profile共用一個後端與一個gateway。每台機器以一個訊息gateway及一個桌面後端服務所有profile,取代每個profile各自執行程序的方式;建立profile後,其機器人即可上線,無須重新啟動。各profile仍保有自己的憑證、允許清單、cron工作與工作階段,webhook平台則透過
/p/<profile>/為各profile提供服務。hermes gateway status會說明啟動防護拒絕啟動的原因,hermes gateway migrate --multiplex可手動遷移,hermes -p <name> gateway stop|start可停用或啟用單一profile,gateway.standalone: true則可暫時退出此機制。 - 即時查看並引導子代理。執行中的子代理會持續顯示在CLI(F6)、TUI(Ctrl+T)與Desktop的輸入區上方,列出各子代理的任務、已用時間、即時對話紀錄,以及「引導」與「停止」按鈕;
/stop會傳達至背景子代理,並取回其已完成的部分工作,delegate_task則可將螢幕擷取畫面與設計稿傳給支援視覺的子代理。子代理可設定專屬的備援鏈(delegation.fallback_providers)與閒置逾時(delegation.child_timeout_seconds)。 - 掌握訂閱方案狀況的模型選擇器。可為喜愛的模型加星號,在選擇器中查看即將用盡的訂閱額度(「剩餘17% · 下午3:00重設」)及速率限制解除時間,並在
hermes model、/model(/model X --reasoning high)與Desktop選擇模型時,一併選擇推理強度。 - Hermes在各處都使用您的語言。CLI、gateway、TUI與Desktop中所有使用者可見的字串,皆透過統一的翻譯目錄處理,完整涵蓋16種內建語言(該標籤含17份核心目錄與16份TUI目錄);外掛可隨附語言(
provides_locales),profile也能透過小型YAML檔案覆寫個別字串。 - 全面精簡。依發布說明,原始碼從106萬行減至69.8萬行(−34%),行為完全不變;
gateway/run.py則從34,847行減至5,512行。約19個較少使用的工具(電腦操作、工作階段搜尋、影像生成、cron、Desktop GUI工具)現在只有在代理搜尋時才會載入,使每次呼叫傳送的桌面工具結構描述大致減半(defer: []可停用此機制),固定提示也減少約2.1K個token。 - 貼心小改進。可選擇啟用的vim按鍵操作(
display.vim_mode)、git_branch狀態列欄位、Hermes等待您回應時的提示音與桌面通知(display.bell_on_prompt)、清除草稿而非終止回合的Ctrl+C、可編輯的/queue、讓終端機處理TUI回捲與搜尋的hermes --native(或display.tui_native)、無須工作階段即可查詢額度的hermes usage --json、失敗時以非零狀態碼結束的hermes -z <prompt>、適用於無圖形介面終端機的hermes mcp login <server> --flow device、跟隨主要模型的cron工作(以pinned鎖定特定模型),並支援--paused與--interpreter,以及隱藏開發者面板的Desktop簡易模式。
本期間撤回的項目(未隨版本推出):Collective Wisdom V1是存放於原始碼樹內的組織skill市集,曾合併後又移除(「此版本沒有任何wisdom程式碼」);Desktop卡片式skill與外掛目錄瀏覽器曾3度撤回;持續等待直到獲得回覆的核准與釐清提示(approvals.timeout仍適用);機器人模式中的平行群組聊天回合;具名profile與根目錄auth.json的完整隔離;hermes cron resnap與建立時的模型快照,改由cron跟隨主要模型;Classic預設佈景主題配色;以及tirith目錄外掛。58
更新方式:桌面應用程式會自行更新,透過Store安裝的版本則由Store更新;CLI使用hermes update或單行安裝指令;Docker與Hermes Cloud則拉取nousresearch/hermes-agent:stable(或:latest),這些標籤只會在版本正式發布時更新。58
v0.21.7的新功能(10月11日彙整版)
Hermes Agent v0.21.7(標籤為v0.21.7,日期為2026年10月11日,於10月12日發布)在10月12日至10月14日期間是最新版本,也是v0.21.x系列第5個、最後一個精簡彙整版。v0.21.6僅發布標籤與Docker映像檔,這次則涵蓋所有發布管道:桌面應用程式(macOS Apple silicon與Windows)、Microsoft Store與MSIX組建、安裝程式、Docker及Hermes Cloud。自v0.21.6以來的變更包含「740筆非合併提交」、「4,156個變更檔案」、「204個已合併的PR」與「69個已關閉的議題」(GitHub的比較結果若計入合併提交,共有777筆提交)。經整理的版本說明隨上方的v0.22.0一同公布。以下為此版本記載的變更,已對照該標籤的原始碼確認:5657
- 從原始碼安裝的版本現在會追隨帶有標籤的發布版本。 在官方儲存庫的簽出目錄中執行
hermes update,會切換至最新發布的vX.Y.Z版本所對應的確切提交,不再追隨main上的每筆提交。若已安裝的版本領先最新發布版本,就會維持原狀,直到下一版發布。解析器也不會憑推測將簽出版本往回移:若無法判定版本關係(歷史紀錄過淺、無法連線至GitHub),便保留HEAD。若要繼續追隨每筆提交,請執行hermes update --set-channel main;--channel <name>則可僅覆寫單次執行的設定(stable與canary選用已發布版本,main則選用分支的最新提交)。此選擇會依安裝實例記錄在config.yaml的update.installs下,以安裝路徑衍生的識別碼作為索引鍵(執行hermes update --install-id可顯示該識別碼),因為同一個~/.hermes可能同時供主機上的安裝實例、Docker gateway與桌面應用程式使用。分支儲存庫、鏡像儲存庫及來源為本機路徑的安裝仍會追隨main;Store、MSIX及內附套件的桌面安裝則維持不變。 - 桌面應用程式也提供相同的切換選項。 對於從原始碼安裝的版本,「設定」▸「關於」▸「更新」新增了更新管道欄位(「穩定發布版本」或「每筆提交」),更新對話方塊也會顯示目前使用的管道。
- 恢復工作階段後仍可保留推理內容。 執行
hermes chat --resume後,以及gateway的下一輪對話中,帶有簽章的思考區塊都會重新傳送,供上游驗證;Bedrock Converse推理模型也不再拒絕恢復的工作階段。若上游拒絕某個簽章,系統會記錄其指紋,並在重建請求時將其濾除,避免工作階段因此中斷。 - 更新不再因部分防火牆而失敗。 使用
main的安裝實例不再擷取可能被區域防火牆以403回應的版本發布紀錄。穩定版檢查會在已設定GitHub權杖時使用該權杖(GITHUB_TOKEN或gh auth login);若權杖遭拒,則改以匿名方式重試。遇到GitHub速率限制時,也會明確回報速率限制,不再誤報為「沒有發布版本」。 - Holographic移出核心原始碼樹。 內附的記憶提供者現在僅有ByteRover與RetainDB;Holographic改由外掛目錄安裝(社群層級,
requires_hermes: ">=0.21.5"),並與其他6個提供者一樣納入自動遷移。請參閱外部記憶提供者。 - 外掛目錄從493個項目增加至552個,根據版本說明,新增項目包括memory-shield、command-ledger、Memoria、Model Router、wyoming-voice-bridge、codex-account-switch及redline。提供者外掛仍維持41個目錄,靜態選擇器則維持39列。
- 版本說明另列出以下變更: 外掛可執行內建的桌面動作(
ctx.runAction,例如view.showBrowser),並透過寵物對話泡泡發言(ctx.pet.say);Codex請求由核心發出,因此外掛不會持有權杖;在工作階段中途安裝的skill,無須重建提示詞即可供模型使用;Krea 2 Medium Turbo成為新付費訂閱者的預設影像生成管道,若託管的Krea拒絕請求,則改用FAL作為備援;桌面更新速度更快;固定版本的安裝只會簽出指定版本;壓縮標記會傳送至Relay(agent/relay_compaction.py會將hermes.compaction紀錄以NeMo Relay標記的形式送出)。
更新方式:桌面應用程式會自行更新,Store安裝則透過Store更新;CLI使用hermes update或單行安裝指令;Docker與Hermes Cloud則拉取nousresearch/hermes-agent:stable(或:latest)。56
v0.21.6 新功能(10月8日彙整版)
Hermes Agent v0.21.6(標籤為v0.21.6,2026年10月8日)是10月8日至10月11日期間的最新版本,也是v0.21.x系列的第4個精簡彙整版,並首次透過專案新的穩定版發布流程產出:「單一嘗試參照、經過測試的Docker映像檔,以及發布時的收據標籤」。此版本僅發布標籤、GitHub版本與Docker映像檔;桌面應用程式、Termux套件和Microsoft Store版本則維持現有版本,直到下次整合發布。自v0.21.5以來累積的變更規模為歷來最大:「8,867筆非合併提交」、涉及「8,342個變更檔案」,以及「2,106個已合併PR」和「3,027個已關閉議題」(GitHub比較頁面若計入合併提交,共有9,180筆提交)。精選版本說明再次延後至v0.22.0。發布說明列出了尚未詳述的項目;以下各項均已對照該標籤的原始碼確認:5455
- 說話時即時轉錄。
stt.streaming: true可在CLI、TUI和Desktop上於話語尚未結束時,串流輸出部分文字。此功能預設關閉,支援openai、xai和elevenlabsSTT供應商(stt.streaming_model指定可在話語進行中輸出增量文字的模型,OpenAI使用gpt-live-transcribe),串流失敗時則改用檔案處理流程。 - 語音回合有了專屬模型設定。
auxiliary.voice_chat會將語音回合(CLI語音輸入、Desktop或TUI語音對話、通訊平台語音訊息)導向比工作階段主要模型更快的模型,預設為reasoning_effort: none。此路由會在系統提示建立後綁定,並在記憶同步與背景審查之前解除。若某個回合會超過語音模型的壓縮門檻,則仍使用主要模型。請參閱輔助模型。 - 第三方外掛可在獨立處理程序中執行。
plugins.isolation: host(預設為in_process)會為每個profile建立一個外掛宿主處理程序,以載入一般外掛,並拒絕所有其他會在主處理程序內匯入使用者程式碼的途徑(類別供應商、模型供應商profile、儀表板外掛API);內建外掛仍在主處理程序內執行。外掛若停止回應或當機,只會導致其宿主停止運作,不會拖垮gateway。請參閱外掛系統。 - 另有4個記憶供應商移出核心原始碼目錄。 Honcho、Mem0、OpenViking和Supermemory現在與Hindsight一樣,改由外掛目錄安裝(屬於社群層級,由各自廠商維護);內建供應商則為ByteRover、Holographic和RetainDB。v0.21.5引入的自動遷移機制涵蓋全部8個供應商。請參閱外部記憶供應商。
- 外掛相容層已移除。
hermes_cli/plugin_compat.py僅剩不具功能的占位檔案,COMPAT_MANIFEST.md與相容性墊片均已刪除,plugins.allow_deprecated_imports也不再存在;若外掛仍從模組拆分前的路徑匯入,便會匯入失敗。請參閱外掛系統。 hermes status預設顯示摘要。 預設輸出每個元件各占一行;--full(別名為--all)會列出所有區段,--deep則執行耗時較長的檢查。版本說明另提到--short旗標,但該標籤的解析器並未提供此旗標,因為摘要已是預設輸出。- 可插拔、分層的語言套件。
display.language接受內建語言目錄(該標籤共有17種)、profile的覆寫目錄或外掛語言套件所提供的任何識別碼。hermes config set display.language <id>會先探索外掛,因此可接受剛安裝的語言套件。核心與TUI字串分層提供(locales/<lang>.yaml與locales/<lang>.tui.yaml,該標籤共有16個TUI語言套件)。請參閱在地化。 - 3個新的供應商外掛:
lmstudio、solstice和tencent-tokenhub讓plugins/model-providers/的目錄數從38增至41;靜態選擇清單仍維持39列。Nous與OpenRouter選擇器新增GPT-6.1 Sol(含-pro變體)、Claude Sonnet 5.5和Claude Haiku 5.5,openai-api與Bedrock清單也新增GPT-6.1 Sol。本機模型方面:hermes model會直接列出Ollama、LM Studio和Ollama Cloud模型,而內建本機執行環境新增llama.cpp CUDA建置版本(llamacpp-cuda),依發布說明支援Linux x64與arm64。 - 核准規則新增2種偵測機制。 若curl或wget上傳(
-d、-F、-T)攜帶名稱顯示可能含有機密的變數或憑證檔案,或透過管線將憑證檔案傳入這類指令,便會標記為可能的資料外洩;指令若含有不可見或雙向Unicode控制字元,則會標記為可能的混淆手法,因為您核准時看到的內容可能與實際執行內容不同。 - 儲存區無法寫入時,cron仍可持續運作。 磁碟已滿或唯讀掛載(ENOSPC、EROFS、EACCES)會讓cron儲存區一次性進入降級狀態,不再每60秒觸發時都發出警告。重新探測頻率最多每分鐘一次,
hermes cron status與hermes doctor也會回報此狀態(此版本另新增主要頻道警告)。 - Discord設定流程會檢查機器人權杖並顯示邀請連結,連結包含配接器所需的權限位元;若Message Content Intent仍未開啟,也會明確提示,因為未啟用時Discord會拒絕機器人連線。請參閱通訊gateway。
- 其他項目:
activate.fish,即./activate開發環境指令碼的fish版本;版本說明提及的統一Kanban工作流程定義;以及發布說明列出、但尚未包含在此版本桌面建置中的功能:將最愛與釘選模型置於Desktop選擇器頂端、在訂閱達到使用上限前顯示用量標籤、說明原因與結束時間的供應商速率限制通知、審查面板的差異範圍選擇器,以及隨回合狀態調整的保持喚醒功能。
安全性修正,發布說明均列有致謝:Tenable Research通報的4項儀表板驗證問題(偽造的X-Forwarded-For標頭可重設密碼登入的速率限制,並繞過每個IP的上限;未經驗證的登入請求可將無大小限制的值寫入驗證稽核紀錄;公開的/auth/路由未限制請求主體大小;原生登入可能將登入碼傳送至非迴路位址的重新導向目標,導致工作階段遭接管);自動git呼叫(工作階段工作區快照、子代理worktree、kanban、worktree清理、hermes -w)可能在第一個提示之前,執行不受信任儲存庫自身設定所定義的clean、smudge或process篩選程式,現在若無法使這些篩選程式失效,便會拒絕操作;電子郵件From標頭中以引號包住的顯示名稱,可能被當成允許的寄件者而通過電子郵件允許清單檢查,現在會先展開標頭摺行,再以parseaddr解析(GHSA-rxqh-5572-8m77)。任何部署儀表板、gateway或電子郵件功能的環境,都應將此標籤視為安全性相關升級。5455
更新方式:執行hermes update或單行安裝指令;Docker與Hermes Cloud則拉取nousresearch/hermes-agent:stable(或:latest)。54
v0.21.5 新功能(9月24日彙整版)
Hermes Agent v0.21.5(標籤為v2026.9.24,2026年9月24日)是9月24日至10月8日期間的最新版本,也是v0.21.x系列的第3個精簡彙整版:「此標籤將v0.21.4之後合併的約460個PR彙整為穩定的標記版本,供下游使用者採用」。精選版本說明再次延後至v0.22.0。以下是影響維運人員的變更,均已對照該標籤的原始碼確認:5253
- Hindsight記憶功能移出核心原始碼目錄。 內建Hindsight供應商與
hermes-agent[hindsight]pip選用依賴套件已移除;Hindsight現在改由外掛目錄安裝,由Vectorize維護;版本說明未提及此項變更。若您的設定指定memory.provider: hindsight,hermes update會將目錄中的外掛安裝到每個指定它的profile主目錄。首次啟動代理時,若仍未安裝,也會自動安裝,除非security.allow_lazy_installs為false(此時請執行hermes plugins install hindsight)。設定、.env鍵與記憶資料均保持原樣。請參閱外部記憶供應商。 gateway.multiplex_profiles: false已停用。 gateway會直接將其改寫為true,並顯示一次方框通知。若具名profile必須保留自己的gateway,請在其自身的config.yaml中設定gateway.standalone: true;若要讓某個受服務的profile離線,hermes -p <name> gateway stop現在只會暫停該profile,不會停止宿主。請參閱通訊gateway。- Nous與OpenRouter選擇器中的新模型: GPT-6 Sol與GPT-6 Luna(各有
-pro變體),以及Claude Opus 5.5。 - 此標籤的外掛相容機制維持不變:
plugins.allow_deprecated_imports: true仍可使用。v0.21.6會移除該相容層與設定鍵(請參閱v0.21.6新功能)。
更新方式:執行hermes update或單行安裝指令;Docker與Hermes Cloud映像檔則以nousresearch/hermes-agent:v2026.9.24建置。52
v0.21.4新功能(第二次彙整修補版本)
Hermes Agent v0.21.4(標籤v2026.9.21,2026年9月21日)是v0.21.x系列第二次刻意精簡發布說明的彙整版本。官方如此定位:「修補版本。此標籤將v0.21.3以來合併的約1,800個PR彙整為穩定的標記版本,供下游使用者採用(Docker映像檔、Hermes Cloud、託管部署)。」自v0.21.3以來的統計為:「5,071次非合併提交」,涵蓋「5,169個變更檔案」、「1,812個已合併PR」及「2,116個已關閉議題」。以提交次數計算,這是專案歷來兩個標籤之間變更量第二大的區間,僅次於v0.21.1的5,139次;以合併PR數量計算,則是歷來最多。經過整理的完整說明再次延後,原文表示:「此區間經完整整理的版本說明將隨v0.22.0發布,記錄自v0.21.0起的所有內容」,並承諾「此區間的任何內容都不會遺漏」。說明仍列出了尚未詳述的項目;以下每一項均已對照該標籤的原始碼查核。凡涉及本指南既有章節變更的項目,均附上章節連結。5051
- 每台主機只執行一個gateway,Desktop改為連接既有程序。 規則是每台主機的每位作業系統使用者各執行一個
hermes serve與一個hermes gateway run,各自以多工方式服務所有profile。新的主機層級單一執行個體機制負責強制落實:成功取得執行權的程序會在整個生命週期持有主機鎖定,並留下包含(pid, createTime)的會合紀錄。如此一來,第二次啟動便能確認鎖定持有者仍是同一個存活程序,並連接該程序,而非綁定第二個連接埠。判定紀錄失效必須有證據,不能憑空假設。Desktop應用程式也採用同樣的做法,連接主機上正在執行的後端,而非另行啟動一個。訊息gateway詳述其運作機制。51 - 連接器整合為後端統一管理的操作,搭配單一設定卡片。
manage_connections工具呼叫會驅動後端純資料形式的連線狀態機,Desktop、TUI與CLI皆以相同的設定卡片呈現:每項缺少的憑證各有一個欄位,必須等所有必填欄位都有文字,才能執行卡片上的動作。請參閱Nous免費方案小節。51 --format stream-json:機器可讀的單次執行輸出。hermes chat -q ... --format stream-json會在stdout的每一行輸出一個JSON物件,供CI執行器與協調器使用:先是system/init事件,接著是text增量、tool_use及tool_result事件,最後以一個result封裝物件結束,內含結束代碼、最終文字與token統計。診斷資訊與工作階段ID仍輸出至stderr,每個事件的工具輸出上限為5,000個字元。此旗標會隱含啟用--quiet,且必須搭配-q或--query-file(兩者皆無時以結束代碼2結束),也不能與--tui併用。hermes chat選項表已收錄此旗標。51skills.auto_load將skill固定載入每個工作階段。 在config.yaml的skills.auto_load下列出的名稱,會在每個新工作階段完整載入,涵蓋CLI、TUI、gateway、cron與API;首次建立提示時解析一次。skill系統新增了固定載入skill的小節。51- 未授權私訊新增
decline選項。unauthorized_dm_behavior在pair與ignore之外新增第三個值:decline會先禮貌回絕一次,接著24小時內不再回應該寄件者。請參閱使用者授權與配對。51 mcp.discovery_concurrency限制MCP探索時的並行連線數。 預設值為4,0表示不設上限;所有已設定的伺服器仍會連線,只是不再同時發起。請參閱MCP整合。51session_search新增時間範圍與擴大召回的重試機制。 探索介面接受after/before時間界限(ISO格式,或7d之類的相對時間長度)。多詞查詢若沒有結果,會改以符合任一詞的條件重試,取代FTS5預設要求所有詞皆符合的AND條件。請參閱工作階段搜尋。51hermes sessions set-journal-mode delete|wal:離線日誌模式轉換工具。 當state.db卡在錯誤的SQLite日誌模式時,現在可透過此指令自行處理;過去則必須手動執行PRAGMA journal_mode=DELETE。請先停止gateway、dashboard及所有CLI:只要有其他程序持有資料庫,此工具就會拒絕執行;它不會等待開啟資料庫的程序退出才轉換,並會在轉換後驗證SQLite標頭位元組。Windows沒有持有程序掃描功能,因此必須自行停止所有Hermes程序,再加上--force才會執行。hermes doctor現在也會引導使用者使用此指令。頂層指令中的hermes sessions列已收錄。51- Desktop:字型設定、一鍵更新引擎,以及解除安裝外掛。 設定頁新增字型家族欄位,依profile儲存於
desktop.font_family,可覆寫聊天與介面中佈景主題的無襯線字型。建議清單優先列出有助於無障礙閱讀的字型(OpenDyslexic、Atkinson Hyperlegible、Lexend);留空則由佈景主題決定。受管理的本機模型執行環境在有更新可用時,會顯示「更新引擎」按鈕;若更新失敗,按鈕會保留,方便直接重試。此外,外掛中心現在可在確認對話方塊後解除安裝外掛。51 - 影片目錄:LTX 2.5與Kling O3。 FAL影片外掛新增
ltx-2.5(Lightricks的開源影音模型:原生音訊、最長20秒/4K圖像轉影片、攝影機運動預設、低價級別;fal不接受1440p/2160p下超過10秒的片段)與kling-o3(快手的頂尖模型系列,屬於高價級別:原生多鏡頭敘事、可選音訊、3至15秒)。51 - 外掛目錄成為隨專案提供的目錄與網站。 儲存庫的
plugin-catalog/目錄從v2026.9.14的9個項目,增加至此標籤的228個。每個外掛各有一份經審查的YAML,並固定至確切的提交SHA。文件網站現在也會為每個外掛與作者建立專屬頁面,各外掛頁面會呈現固定提交中的README。版本說明列出的10個社群外掛,在此標籤中都已收錄於目錄。外掛系統詳述相關資訊。51 - 另有大量修正,涵蓋profile/多工隔離、cron、看板、Desktop與
state.db。版本說明僅概括列出這些類別;完整整理的修正紀錄將留待v0.22.0撰寫。50
plugin-compat的還原變更在此區間仍未合併。 COMPAT_MANIFEST.md、compat_manifest.json與相容性轉接層在v2026.9.21中都仍然存在。此區間對hermes_cli/plugin_compat.py的變更,只有程序共用的掃描快取(多工gateway會為每個服務中的profile探索一次外掛;若每次都重新解析各外掛的原始碼,啟動流程每個profile約需多花0.4秒),以及Windows上的POSIX格式命中路徑(#112576)。日期限制與僅接受布林字面值的備援開關都未變更,因此plugins.allow_deprecated_imports: true仍可讓受影響的外掛載入。外掛系統的相容性說明框載有目前狀態。42
更新方式不變:git安裝使用hermes update,全新安裝則使用shell安裝程式;Docker與Hermes Cloud映像檔皆以此標籤建置(nousresearch/hermes-agent:v2026.9.21)。50
v0.21.3新功能(9月14日修補版本)
Hermes Agent v0.21.3(標籤v2026.9.14,2026年9月14日)納入main上另外3天的變更,但版本說明只有2項。之所以發布,是因為Cloud代理程式會自動更新至最新的版本標籤,而遠端gateway登入修正必須送達這些代理程式。(1)遠端dashboard工作階段不再因短時間大量更新請求而遭撤銷:gateway上的兩條更新路徑(cookie驗證關卡與Desktop的原生bearer路由),現在都會將攜帶相同輪替更新權杖的並行請求合併為一次執行。因此,Desktop喚醒時突發的請求不會再重送已輪替的權杖,觸發Portal的重複使用偵測,導致整個工作階段遭撤銷。更新作業也移至事件迴圈外執行,身分識別提供者回應緩慢時,不再凍結/api/status。(2)長時間執行的程序不再重複建立state.db寫入控制代碼:gateway、dashboard/Desktop後端、ACP與CLI的讀取端改以唯讀方式連接,同一程序內的寫入端則共用登錄表中的控制代碼。此區間統計為:「1,036次非合併提交」,涵蓋「2,642個變更檔案」與「338個已合併PR」。其餘內容刻意延後說明:版本說明列出了尚未詳述的項目(每個模型選擇器中的推理強度選項、OpenRouter OAuth PKCE、HEIF/HEIC/AVIF解碼、一批FAL目錄更新、Slack貼上表格與Agent Sessions API、跨虛擬機檔案系統上拒絕使用state.db WAL,以及其他項目),並承諾提供完整整理的紀錄,原文表示:「此區間經完整整理的版本說明將隨v0.22.0發布,記錄自v0.21.0起的所有內容」,以及「此區間的任何內容都不會遺漏」。49
plugin-compat的期限也如期到來。 v0.21.1宣布於2026年9月14日移除的措施,已透過發布程式碼中的日期限制生效,並非透過還原程式碼實現:在v2026.9.14標籤中,hermes_cli/plugin_compat.py包含COMPAT_REMOVAL_DATE = 2026-09-14,而removal_in_effect()自該日起傳回true(或在清單檔案消失時立即傳回true),因此受影響的外部外掛現在會在載入時遭停用,並顯示紅色通知。尚未發生的是:真正刪除舊匯入路徑的還原變更。COMPAT_MANIFEST.md、compat_manifest.json與相容性轉接層在該標籤中都仍然存在,在v2026.9.21以及截至9月22日的main上也一樣。這正是plugins.allow_deprecated_imports: true仍可作為備援開關的原因:只要允許載入器繼續執行,舊路徑仍可解析。有2個容易踩到的陷阱:此鍵必須是YAML布林字面值(程式碼只接受布林值True;"true"或"false"這類加上引號的字串會視為未設定,原始碼註解也註明「僅限布林字面值」);而且還原變更一旦合併,備援開關就會立即失效,因為路徑本身將不復存在。外掛系統的相容性說明框載有目前狀態。4249
v0.21.2的新功能(state.db修補版本)
Hermes Agent v0.21.2(標籤v2026.9.11,2026年9月11日)的首要目的,是修復v0.21.0造成的問題。版本說明直言:「v0.21.0大幅重寫了工作階段儲存區的連線處理方式,卻讓部分安裝環境的state.db變得脆弱:多個寫入端互相取消鎖定、正常的資料庫被誤報為損毀、單筆異常資料就讓sessions list無法運作。此版本解決了這類問題,也整合了v0.21.1發布後4天內併入main的所有其他變更。」不同於v0.21.1刻意精簡的說明,這次版本說明列出了自身的重點;這段期間共有「140位貢獻者」提交「947筆非合併提交」,涉及「1,869個變更檔案」及「312個已合併的PR」。至於整個v0.21.x系列的完整重點整理,仍留待v0.22.0撰寫。48
- state.db可靠性改善:6個PR,解決44個問題。 版本說明將維運建議放在最前面,您也應優先處理:若
state.db在0.21.0或0.21.1損毀,請執行hermes doctor。它現在會分別指出結構損毀與全文檢索索引損毀,不再將所有問題統稱為「FTS寫入損毀」。若重建仍不足以解決問題,還會指引您使用hermes sessions recover --inspect-only(離線、非破壞性、固定使用指定profile;回報標準資料表是否可讀取,且不會建立輸出資料庫)。針對根本原因的修正,移除了儲存區所有額外的寫入端:各profile的gateway原本每5秒就會將託管聊天室狀態寫入根目錄的state.db,現在這項協調工作改由專用的shared-state.db處理,因此各profile的gateway不再以可寫入模式開啟主要工作階段儲存區;儀表板會先以唯讀模式開啟;cron的生命週期防護機制改用可追蹤的連線登錄表,不再直接對使用中的資料庫呼叫open()(這會取消gateway的POSIX鎖定,是導致SQLite損毀的典型做法);而doctor --fix會拒絕執行無法確認安全的checkpoint。除了寫入端之外,FTS索引損毀現在只會讓搜尋功能降級,稍後再重建索引,不會因安全防護而中止整個回合;單筆損毀資料不再讓sessions list、匯出或洞察功能失效(異常資料列會顯示?,並附上指出所屬工作階段的警告);工作階段絕不會繫結或讀取其他profile的資料庫;唯讀開啟也不再取得寫入鎖定,因此在忙碌的gateway後方執行一次性hermes時,已從停滯4至20秒後失敗,縮短為0.01秒。48 - 強化多profile隔離。 自v0.19.0起,本指南便多次引述專案的說法:profile路由可讓每個profile擁有「完全隔離的設定、skill、記憶與機密資料」。到了v0.21.2,這項承諾仍存在漏洞,如今已完成修補:次要profile的機器人會繼承預設profile的允許清單、介接器可能將憑證傳送到預設profile的主機、stdio MCP伺服器會收到預設profile的保管庫機密資料、
MEDIA:傳送可能夾帶其他profile的.env/auth.json/state.db、webhook與Feishu回呼可能偏離路由指定的profile,而次要profile也可能從各處理程序的快取中取得同層profile的Nous持有者權杖(#107609-#107630)。若您在單一多工gateway下執行多個profile,從這個版本起,隔離承諾才真正落實。48 - 不向代理揭露密碼的憑證保管庫。 代理現在可透過1Password、Bitwarden或本機Hermes保管庫,在瀏覽器中登入、付款與填寫地址,全程不會看見機密資料。雙因素驗證碼則來自已儲存的驗證器金鑰(TOTP:base32種子或
otpauth://totpURI;不接受以計數器為基礎的HOTP),或透過使用者介面向您索取。每個後端都會交給代理相同格式的資料:登入中繼資料,加上一個具有命名空間、內容不透明的控制代碼(本機使用vault_,另有op:、bw:),只有在填入時才解析出密碼;外部密碼管理工具會保持鎖定,直到您為該工作階段解鎖,而主密碼「絕不會成為工具引數、絕不會進入argv,也絕不會持久儲存」。這項功能延續了v0.19.0的SecretSource工作,當時已將供應商的API金鑰移出明文.env;如今保管庫也為代理的瀏覽器憑證提供相同保護。48 - 經過精選、以SHA固定版本的外掛目錄。
hermes plugins browse會列出「精選外掛目錄中的所有項目」,hermes plugins search可查詢目錄,而hermes plugins install除了Git URL與owner/repo之外,也能解析目錄中的名稱。hermes plugins pack則以「宣告式、可分享的外掛組合」補齊功能:透過單一hermes-pack.yaml,將一組外掛固定至確切的提交SHA;pack install會逐一執行一般的固定版本安裝,各項能力的授權同意仍逐個外掛處理;pack export會為目前安裝的外掛匯出組合檔;pack show則提供試執行預覽。外掛系統的指令區塊已收錄這些新子指令。48 - Nous免費方案與首次啟動導引。 全新安裝後,只需一道指令登入,即可使用免費推論與連接器;
/login可直接在聊天中執行,連接器工具(Gmail、Linear、Notion等)則可透過tool_search搜尋。桌面版的首次啟動導引由HERMES_GUEST_ONBOARDING=1控制,且只有值恰為1時才會啟用:桌面版自身的測試明確確認,'true'、'0'與空值都不會啟用此功能。是否啟用的決定也會明確寫入所啟動後端的環境,避免繼承的值意外生效。請參閱Nous工具gateway。48 - 桌面版後端大量啟動的問題已解決。 Bot Mode過去會在啟動時及每次機器人名單更新週期,為每個profile啟動或連線至一個後端;將游標移至Bots名單上時,每一列都會啟動一個後端;切換profile也可能重複啟動主要後端。這些問題已在本次更新期間全數修復。48
更新方式維持不變:現有安裝執行hermes update,全新安裝則使用shell安裝程式。48
v0.21.1新功能(彙整修補版本)
Hermes Agent v0.21.1(標籤v2026.9.7,2026年9月7日)的發行說明刻意保持精簡:這是一個「修補版本」,「彙整自v0.21.0以來main分支的現有變更,供依標籤部署及下游使用者採用」。內文列出這段期間的統計資料——「4,364個變更檔案,涵蓋5,139筆非合併提交(+601,014 / -768,419)」及「632個已合併PR」——接著將詳細說明留待後續:「這段期間完整且經過整理的發行說明將隨v0.22.0發布。」這使它成為專案史上相鄰標籤之間變更量最大的一次發布(先前沒有任何相鄰標籤區間超過v2026.7.20..v2026.7.30的2,790筆非合併提交),卻搭配最精簡的發行說明。在v0.22.0補上整理後的紀錄之前,以下6類變更會影響您在此標籤版本下操作Hermes的方式,且每一類都已查核原始碼。41
- 程式碼庫已拆分,外掛相容期於9月14日屆滿。 2026年9月的拆分作業(PR #102117)將儲存庫中的大型模組拆成職責明確的檔案:新的
agent/套件收納對話迴圈的內部實作(214個頂層模組及7個子套件;prompt_builder.py現位於agent/prompt_builder.py,而AIAgent仍留在run_agent.py),CLI的子命令剖析器移至hermes_cli/subcommands/套件(61個模組),靜態CANONICAL_PROVIDERS清單從hermes_cli/models.py移至hermes_cli/models_catalog_static.py(清單本身未變:39筆靜態項目,仍會從39個內附的供應商外掛目錄自動擴充),而delegate_task則拆分至約12個tools/delegate_tool_*模組。內部匯入路徑並非穩定的API,因此儲存庫根目錄新增的COMPAT_MANIFEST.md列出1,148個「moved-lazy」公開名稱,透過舊模組路徑重新匯出;每個名稱在解析時,都會於每個處理程序中發出一次HermesPluginCompatWarning。相容層僅為暫時措施,其停用機制已於2026-09-14如期生效,也就是此標籤發布後6天——這不是透過程式碼還原達成,而是由已隨版本交付的日期條件控制。自該日起,受影響的第三方外掛不會載入:CLI橫幅、hermes doctor及hermes update會顯示紅色通知,指出停用的外掛;桌面版會顯示一次性的強制回應對話框,hermes plugins list也會列出原因。如果您使用外部外掛,請進行檢查:hermes plugins compat <path>會列出每個file:line及舊路徑->新路徑,只要仍有未修正項目,就以結束代碼1退出(加上--json可輸出機器可讀格式;不帶參數執行則會掃描所有已安裝外掛)。若外掛作者尚未跟進,可在config.yaml中設定plugins.allow_deprecated_imports: true作為應急方式,而且目前仍然有效:截至9月22日,真正刪除舊匯入路徑的還原變更仍未合併(已查核至標籤v2026.9.21及main),因此只要允許載入器繼續執行,舊路徑仍可解析。後續細節請參閱上方的v0.21.2新功能;外掛系統章節則提供目前狀態的說明方塊。42 - gateway對話不再因計時器而更換,完全不會。 工作階段生命週期文件現在明確說明其行為約定:「閒置與實際經過時間都不會觸發對話更換。
/new與/reset會建立明確的分界;上下文壓縮則持續管理冗長的歷史紀錄。舊版計時器設定會被忽略。既有的SessionResetPolicy資料型別只是無作用的相容性資料,並非執行時期政策。」對話分界必須由使用者明確建立;如果您透過hermes claw migrate保留了OpenClaw時期的工作階段重設計時器,這些設定現在只是無作用的資料。請參閱訊息gateway。43 - MCP授權新增裝置代碼流程。
hermes mcp login <name>新增--flow {browser,device}:browser是既有的PKCE流程,device則是RFC 8628裝置代碼登入流程,適用於不便使用瀏覽器回呼的機器;此旗標會覆寫伺服器的oauth.flow設定。這段期間也強化了MCP驗證的其餘環節:在整個OAuth工作階段中強制檢查profile擁有權,忽略格式錯誤的OAuth中繼資料快取,避免伺服器卡住,桌面版則透過用戶端本機回呼轉送MCP OAuth流程。另一項相關變更是:-t/--toolsets現在也會篩選哪些已設定的MCP伺服器需要啟動,因此單次執行hermes -z -t <toolsets>時,會略過不需要的伺服器冷啟動。MCP整合的命令區塊現已加入login與reauth [--all];兩者早於這段期間就已存在,只是先前尚未在此記載。44 - 委派機制更如實反映背景工作的狀態。
delegate_task有6項可靠性變更,皆已從此標籤版本的委派工具原始碼查核。(1)背景批次預設會以單一完成通知回報;啟用delegation.independent_completions後,會將呼叫拆成多個完成單位:共用同一個group值的任務會等待彼此完成後一併回報,未分組的任務則各自在完成時回報。這項預設是刻意設計的——原始碼註解指出,逐項任務湧入的完成通知「打亂了未事先為此做好規劃的協調代理」。(2)子代理結束並清理資源時,其背景處理程序會被終止,除非子代理透過process_manage(action="handoff")將它們交接給父代理;未交接的殘留程序會以orphaned_processes列在結果中,而已結束卻從未被讀取的子處理程序,則會以unread_completions呈現,並附上輸出尾段。依原始碼文件字串所述,設計原則是父代理「必須由執行環境得知這件事」,而非相信子代理聲稱的「監看程序正在執行」。(3)delegation.fallback_providers成為正式可用的設定項目:null讓未固定供應商、端點或模型的子代理繼承父代理的備援鏈,[]則停用備援;固定供應商、端點或模型的子代理不會使用備援,除非此設定明確指定。(4)子代理的備援鏈會透過標準正規化程序解析,因此格式錯誤的項目會被捨棄,不會導致啟動失敗。(5)處理單位執行到一半當機,不再遺失已完成的子代理結果:包含多個子代理的單位會將每個已完成子代理的結果持久儲存於該單位自己的資料列,並在復原結果中保留為部分成果。(6)子代理一律不會繼承1小時提示快取級別:受委派的子代理會降至5分鐘級別,因為1小時級別的定價適用於暫時離開的使用者,而非短時間內大量並行執行的子代理。45 - 供應商與模型。 Nous Portal與OpenRouter的目錄新增OpenAI的GPT-6 Astra及Astra Pro,並提供
-fast/-flex速度級別變體(「2倍價格、優先級別」/「0.5倍價格、彈性級別」)。在ChatGPT/Codex OAuth路徑上,Astra受帳戶權限限制(只有即時、依帳戶範圍探索的結果才能將其列為可用),並新增可自行選用的-900k選擇器變體,將標示的272K上下文視窗提高至經即時驗證的約900K;此後綴絕不會隨請求傳送。另外還有:anthropic/claude-fable-5.1、google/gemini-3.7-flash及gemini-3.8-flash、qwen/qwen3.8-max-0902及qwen3.8-flash,以及Meta的Muse Spark 1.3系列(1M上下文,包含貢獻者變體),另加Meta的muse-image影像生成供應商外掛。Tavily成為網頁搜尋/擷取後端(TAVILY_API_KEY;透過hermes tools選擇Tavily時,無金鑰也可使用)。受管理的llama.cpp執行環境讓本機模型成為完整支援的選項(官方二進位檔、單一受監管的llama-server、桌面版一鍵設定),而原始碼樹之外的外部處理程序供應商也有了專屬的解析分支。操作層面上,選擇器的遠端目錄現在每20分鐘重新整理一次(model_catalog.ttl_minutes,預設20;舊版ttl_hours鍵只有在使用者曾明確設定時才會沿用)。46 - 桌面版:為頁面加上註記,掌控工作階段。 應用程式內建瀏覽器新增註解模式:按一下「註記」,再於即時頁面上點選任一元素(或拖曳框選),然後輸入註記;儲存的註解會以編號標記保留,本身絕不會送出對話回合。完成後,按下「新增N則註解」即可將整批內容送入訊息編輯器,每個標記都會附上裁切後的螢幕擷取畫面。各元素註解也會攜帶其CSS選擇器、標記內容,以及影響版面配置的計算樣式,讓代理能在原始碼中找到該元素,不必只憑圖片猜測(標記內容離開頁面之前,密碼、隱藏值及看似金鑰的屬性都會先被遮蔽)。較大的批次會依頁面區域分組,因此20多則註解會整理成少數幾項工作,通常各自涉及不同檔案——這正是能夠安全分派給並行工作代理的關鍵。周邊功能還包括:結構化的工作階段控制項與工作階段自動化控制項、拖曳建立工作階段、匯入其他程式設計代理對話紀錄的工作階段匯入檢視、
display.resume_last_session(預設為true:冷啟動時會重新開啟上次的聊天或頁面)、在browser.use_real_profile關閉時開啟瀏覽器窗格,首次顯示徵求同意啟用該設定的提示、「功能」->「Skills」下內建可一鍵安裝的選用skill目錄,以及新增俄文桌面版UI語系(CLI的17個語系目錄維持不變)。47
更新方式維持不變:既有安裝執行hermes update,全新安裝則使用shell安裝程式。這段期間經過整理的完整紀錄將由v0.22.0補上;以上各類則是此標籤版本帶來的變更。41
v0.21.0的新功能(Pantheon版本)
Hermes Agent v0.21.0(標籤v2026.8.31,2026年8月31日)是目前的功能版本,也是整個v0.20.x整合版本系列一直留待發布的完整彙整紀錄:「此版本整合了v0.20.1-v0.20.6基礎架構修補標籤中的所有內容;這些版本期間的變更皆完整記錄於此。」此版本延續Herald的主題:「v0.20.0讓Hermes成為傳令使者——他開口發聲,並將訊息帶給其他代理。在v0.21.0,眾神齊聚。」原文統計如下:「自v0.20.0以來:約5,800次提交 · 約2,475個已合併PR · 約5,680個檔案變更 · 約869,000行新增 · 約135,000行刪除 · 約2,100個議題已關閉 · 760多位貢獻者」。35
此版本依功能領域整理,本摘要也採用相同方式。若某項功能影響本指南的既有章節,會在相關段落直接附上連結。
- Bot Mode:內建代理社群,讓您的代理彼此互動。 Bot Mode從v0.20.3版本期間隨附的
hermes-bots外掛,升級為桌面應用程式中預設啟用的功能。每個代理profile都有名稱、以確定性方式產生且可隨機重設或鎖定的頭像,以及共用名單中的席位;您能建立類似Discord的群組聊天室,與多個機器人在同一個房間交談,從訊息輸入區以@提及任一機器人,並為聊天室設定名稱和圖片。相關功能還包括標示發話代理的代理間訊息卡片、傳送端送達通知、先繪製畫面再補齊狀態以即時喚醒、Routines面板,以及依應用程式設計系統重新建構的介面。版本說明如此形容:「過去,『多代理』意味著串接底層機制;現在,它看起來就像一個滿是同事的聊天應用程式。」35 hermes peer:讓代理之間互傳私訊。 任一Hermes代理都能透過識別名稱,跨profile與gateway傳訊給其他代理,既可從CLI操作,也可直接在對話中進行——請研究機器人將發現交給程式設計機器人,並在目前的對話中閱讀回覆。「回覆會送達各代理的標準Bot Chat,因此代理之間的對話能持久保存並供檢視,不是送出後就不再追蹤。」hermes peer指令(新增/列出/移除對等代理、dm)已列於頂層指令表格。35- 有記憶的cron工作。 排程工作不再健忘:cron代理會像其他代理一樣載入並更新持久記憶;
continuity=true會將每次執行的輸出帶入下一次,讓監控程式依據先前已回報的內容排除重複項目;每項工作都有持久保存的筆記區;監控模式工作在沒有變更時會完全略過LLM;每項工作都能固定推理強度;cron輸出也可送達機器人的標準Bot Chat,並由機器人實際回應。排程工作(Cron)章節現已記錄各項功能在該標籤版本中的運作機制。3537 - 即時子代理協調。
delegate_task新增控制操作:列出執行中的子代理、在執行途中調整某個子代理的方向,或提早停止並保留部分結果。子代理輸出可依JSON結構描述驗證,結果中會顯示每次委派的費用,預設上限也提高至每個子代理250次迭代,以及10個並行子代理(這是v0.19.0中取代max_async_children的統一上限)。3538 - MCP指揮中心。 MCP伺服器與目錄整合至同一個桌面頁面,支援拖入或「貼上任何內容」匯入;背景健康檢查會在工具呼叫失敗前提醒您重新驗證;代理群費用/用量浮層會顯示結構描述的token估算值與各伺服器30天用量;
hermes://深層連結則可在明確確認後安裝MCP伺服器。請參閱MCP整合。35 - CLI功能大幅增強。 Ctrl+P可開啟支援模糊搜尋的指令面板(也可透過
/palette開啟),/model選擇器會隨輸入即時篩選,/status會顯示推理模式、待核准項目與上下文用量,狀態列則可顯示即時快取命中率、延遲與每秒token數,並可逐欄切換顯示。此外還有全域緊急停止、工作階段釘選/取消釘選、輪替的訊息輸入區提示文字,以及終端機寵物。命名上有一點須留意:版本說明將模擬執行的核准檢查工具稱為hermes approval-check;但在該標籤版本中,實際指令是hermes approvals test——並不存在approval-check子指令。3540 - 代理可操作桌面應用程式的瀏覽器。 應用程式內建瀏覽器不再只是代理能觀看的視窗:Hermes可直接導覽、點擊並讀取內容,也能將頁面另開於系統瀏覽器,並提供完整的連結快顯選單。35
- 6個新供應商與一波模型目錄更新。 新增Meta Model API(Muse Spark)、CommandCode、Tencent TokenPlan、Nebius Token Factory、Ramp Router及Actual Computer。其中3個(Meta AI、CommandCode、Actual Computer)已在較早的整合版本期間加入,並已列於供應商完整對照表;對照表現新增Tencent TokenPlan、Nebius Token Factory、Ramp Router,以及文件中新列出的Alibaba Token Plan SKU。模型目錄新增GLM-5.3-Flash、qwen3.8-max/flash、Gemini 3.7 Flash、MiniMax M3免費版、Nemotron 3.5 Lightning及Muse Spark 1.2。同時帶來2項結構性變更:
config.yaml中的model_overrides讓您不必等待新版發布,就能覆寫任一模型的上下文視窗或定價;供應商整合現在也能以透過pip安裝的套件提供,並經由進入點自動探索;此外,統一的選擇防護登錄機制會在所有選擇器介面中,針對使用您的資料進行訓練的模型提出警示。3536 - 全面強化安全性。 寫入受保護的代理指示檔案(AGENTS.md、skill、記憶儲存區)現在一律需要核准,避免遭提示注入的代理悄悄改寫自身的常設指示;全面的敏感資訊遮蔽修正堵住了終端機錯誤、
.env讀取、checkpoint與ACP日誌中的機密外洩缺口;核准系統新增對Windows破壞性指令的辨識;macOS權限授予可透過穩定的TCC簽署身分(hermes desktop --setup-tcc-identity)在更新後保留;Blender MCP目錄項目與skill則因上游遭入侵而移除。該標籤版本的詳細資訊請參閱安全性強化。3539 - Gateway日趨成熟。 Slack新增原生即時卡片(真正的串流回覆,以及可選擇啟用的計畫/工作卡片),並可停用外送訊息的連結預覽;Telegram新增內嵌選擇器,讓所有指令與skill都能透過@botname搜尋,突破Telegram指令選單的數量上限;中繼通道更加完善(原生外掛初始化、支援草稿串流的即時卡片操作、工作階段區段切分、恢復語音訊息STT);gateway控制通訊端讓代理群用戶端能查詢gateway,也讓更新程式能平順暫停它,無須強制終止整個處理程序樹;當監看程式觸發時,回合回收機制會擷取卡住的工作程序堆疊。35
- 一波skill更新。 8個保留並重新納入的生產力skill(document-to-action-items、meeting-action-items、email-inbox-triage、github-issue-to-pr、weekly-review-planning、competitor-news-monitor、product-price-monitor、social-media-content-calendar)、從HAR產生的API用戶端(「觀察網站一次,之後就能直接呼叫其隱藏的API,不必使用瀏覽器」)、publish-site、session-librarian、blocked-page-recovery、merge-reconciler、plan-interrogation,以及在建立時提供建議的SKILL.md靜態檢查工具。35
此版本期間已撤回(未隨版提供): Model Council模式(/council)與DCP context engine均曾納入,後來又撤回;僅支援WS的gateway伺服器(#94245)合併後也已撤回(#96118),因此桌面啟動流程仍使用FastAPI——不過,附帶序號的事件重播(#94219),也就是透過WebSocket進行無損桌面重新連線的功能,確實已隨版提供。Electron則回復至40.10.2。若社群對v0.20.x各版本期間的報導提及上述已撤回項目,請留意它們並未包含於此版本。35
更新方式不變:既有安裝執行hermes update,全新安裝則使用shell安裝程式。下方Herald版本中的整合版本小節,仍保留各標籤版本期間納入哪些變更的逐項紀錄。35
v0.20.0新功能(The Herald版本)
Hermes Agent v0.20.0(標籤v2026.8.3,2026年8月3日)是在v0.21.0彙整整個系列之前推出的功能版本;v0.20.1(8月13日)與v0.20.2(8月16日)則是在此基礎上提升穩定性的標籤版本,而v0.20.3(標籤v2026.8.16.2,8月17日發布)、v0.20.4(標籤v2026.8.18,8月18日)、v0.20.5(標籤v2026.8.19,8月21日發布)與v0.20.6(標籤v2026.8.27,8月27日)持續推出彙整版本,各自涵蓋的開發期間也都包含新功能——請參閱下方小節。自v0.19.0以來,這段期間由超過650位貢獻者共同完成約3,650筆提交、合併1,400個PR,並關閉1,200個議題。69
有3項變更讓本指南早期版本的操作指引不再適用。請先閱讀以下內容:
- 現在必須使用Node 26。安裝程式將版本固定為
NODE_VERSION="26",並拒絕較舊的執行環境,顯示「Node.js …版本過舊(Hermes要求Node >=26)。」安裝程式、heal與upgrade都會強制執行此要求。請注意,文件網站的安裝頁面仍寫著Node v22;安裝指令碼與版本說明較新,應以這兩者為準。69 - pip與Homebrew已停止支援,而非僅標示為不建議使用。原文如下:「brew + pip/PyPI wheel管道已退役(支援的管道為shell安裝程式/Docker/Nix)。」若仍使用pip或brew安裝,該管道已不再提供新版本。69
- 工具呼叫的預設迭代上限從90提高至500。長時間的自主執行不再因人為限制而中斷,下文所有預算壓力門檻也都以新上限計算。
read_file的預設讀取行數也從500行提高至2,000行。69
此版本的其他更新:
- 對話式語音。支援串流TTS、插話中斷,以及在裝置端辨識喚醒詞。69
- A2A v1.0。新增代理程式間通訊協定外掛,完成議題#514中長期追蹤的需求。69
- 具簽章的傳出webhook。
hermes webhook先前僅支援傳入;v0.20.0新增以HMAC簽章的傳出生命週期webhook,涵蓋工作階段、回合與工具事件。69 - 有根據的引用。新增具備事實查核模式的skill。69
- 面向進階使用者的一系列CLI更新。
!command可立即執行shell命令,無須耗用模型回合;/init會掃描專案並寫入或更新AGENTS.md;/diff可在任何介面顯示已暫存、全部或工作階段中的變更;/context會細分內容視窗的占用情況;/focus提供精簡輸出檢視,並可還原隱藏的行;Ctrl+S可暫存尚未寫完的提示詞。hermes import-agent只需一個命令,就能遷移Claude Code或Codex CLI設定。69 - 機密資料功能擴充。新增可與所有保管庫搭配使用的命令輔助程式機密來源、以單一命令輪替權杖並提供可據以處理的啟動錯誤、可選擇啟用的Bitwarden加密緊急備援快取、以各profile主目錄為範圍的保管庫注入金鑰,以及
config.yaml與MCP設定之間一致的${env:VAR}SecretRef支援。下文的3種驗證途徑維持不變。69 - 更快的暖啟動。
hermes -w的冷啟動時間從約14秒降至1.8秒。69 - 桌面端成為平台。新增具版本管理卡片與沙箱即時預覽的產出物、以Kanban為首個桌面外掛的外掛SDK、快速輸入全域快捷鍵、多個GUI視窗、SSH遠端後端模式,以及RFC 8252原生登入。69
v0.20.3、v0.20.4、v0.20.5與v0.20.6彙整版本(8月17日至27日)
v0.20.0之後,專案以高頻率發布帶有標籤的彙整版本,內容不僅是穩定性修正。這4個版本都以相同方式延後提供整理過的版本說明——各自都表示「此期間完整整理的版本說明將隨v0.21.0一併發布」——而v0.21.0如今已兌現承諾:上方的v0.21.0新功能就是這整段期間經過整理的紀錄(該版本確認這些期間的變更「已在此完整記載」)。下列區塊保留各標籤發布當時的紀錄,讓您仍可查明各項變更究竟在哪個標籤版本落地;整理後的說明則將它們合併呈現。68233035
v0.20.3(自v0.20.2以來約250筆提交、約125個PR):
- 遷移至MCP 2.x SDK,並支援2026-07-28無狀態協定。Hermes改用當前世代的MCP SDK,並支援該協定的無狀態修訂版。68
- Bot Mode以隨附外掛形式推出(
hermes-bots),內含核心隊友協定。68 - 新增CommandCode供應商外掛,擴充供應商目錄。68
- 用於電腦操作的Cua Driver 0.20執行階段契約,以及子程序Python執行階段歸屬管理強化(PYTHONHOME/PYTHONPATH隔離)。68
- 可靠性:cron排程器自我修復(EMFILE復原、過期領用狀態校正、卡住工作的重新啟動)、工作階段交接資料遺失修正、桌面端遠端gateway連線自我修復,以及一系列生態系功能移植(外掛安裝安全掃描、
/worktree、/rollback保留手動編輯內容、UTF-16檔案讀取)。68
v0.20.4(自v0.20.3以來約146筆提交、約74個PR):
- 桌面端的玻璃介面:霧面玻璃與半透明效果,搭配磨砂效果選擇器及macOS預先選取設定。68
- 分頁式「工作階段|機器人」側邊欄,可個別隱藏或顯示機器人,並修正Bot Mode群組聊天問題(長時間執行的成員回合、Markdown呈現、跨機器路由)。68
- 安裝skill時執行NVIDIA SkillEvaluator Tier 1建議性掃描——安裝skill時會進行授權與安全檢查。68
- 強化cron媒體傳送(可設定逾時、手動執行附件、顯示錯過的排程觸發)、修正SessionDB事件迴圈執行緒與資源競爭問題、讓
hermes update如實呈現擱置分支狀態,以及新增看板原生作業系統通知。68
v0.20.5(自v0.20.4以來約746筆提交、約323個PR):
- 免金鑰網頁服務層:全新安裝後無須任何API金鑰,即可使用網頁搜尋;由5家供應商提供免費輪替服務,並採環狀故障切換。23
- 一系列CLI細節改善:支援模糊比對的
/model選擇器、Ctrl+P命令面板,以及資訊更豐富的/status。23 - Bot Mode更趨成熟:群組聊天室討論串、可摺疊的對話摘要、團塊臉孔頭像,以及支援拖放的PDF/檔案附件。23
- 機群與worktree工具:
hermes update執行紀錄、hermes update --plan(版本說明稱之為「機群--plan驗證」;此旗標屬於hermes update,而非fleet命令,其剖析器說明指出它會「顯示更新計畫並結束,不做任何變更」),以及hermes worktree list/prune。2327 - cron工作新增持久記憶與個別工作的推理強度設定,另有根據Composio評估結果加入的執行規範與執行階段停滯防護、多問題釐清、免驗證的opencode-free供應商,以及桌面端效能改善(Bot Mode先繪製畫面再完成hydration、兩個渲染器均採用React Compiler)。23
v0.20.6(標籤v2026.8.27,8月27日——自v0.20.5以來約1,313筆提交、約525個PR):
此版本明確自述為「修補版本。此標籤將v0.20.5以來合併的約525個PR彙整為穩定的標籤版本,供下游使用者採用」,其說明也指出,這段期間約有1,313筆提交,涉及約1,557個檔案(+177,113 / −21,682),共合併約525個PR。30該說明的主要項目如下:
- 經同意後使用實際profile瀏覽——本機瀏覽可使用您的預設Chromium profile,並在Windows上提供經核准後關閉瀏覽器的流程。30
- 桌面端瀏覽器擁有獨立的作業系統視窗,另有受管理的SSH遠端更新引擎與機群profile側欄。30
- 擴充遠端MCP目錄:收錄超過50個經實際連線驗證、由供應商代管的伺服器,包括Cloudflare、Grafana Cloud、Better Stack與Railway。30
- 可選擇使用作業系統鑰匙圈加密已儲存的機密資料——不再每次啟動都出現macOS鑰匙圈提示。30
- 各選擇器新增模型:GLM-5.3-Flash、MiniMax M3免費版,以及MiniMax H3 Max影片模型。30
- 為
web_search/web_extract加入TTL結果快取,並讓tool_search支援多重查詢與詞幹處理。30 - 精簡尾端壓縮現已成為預設值——下方的內容壓縮一節記載此標籤版本的設定。3031
- 終端機後端改為可插拔架構——請參閱終端機後端。3032
- 更新程式與機群管理如實反映狀態:更新程式透過控制socket暫停gateway,取代終止整個程序樹的做法;由映像檔或套件管理的安裝也會拒絕不安全的就地更新。30
- cron新增持久化事件確認與更清楚的程式碼版本不一致錯誤、Slack連結展開控制,以及共用Docker容器身分。30
更新方式維持不變:現有安裝使用hermes update,全新安裝則使用shell安裝程式。682330
v0.19.0的新功能(Quicksilver版本)
Hermes Agent v0.19.0(標籤v2026.7.20,2026年7月20日)以信使之神的神速命名:此版本的核心是提升回應速度,所有平台首輪回應的首個token等待時間均縮短約80%。此外,還加入終端機帳務管理、密碼管理員機密來源、預設啟用的智慧核准、可觀察執行過程的子代理,以及當機後仍能送達的回應。自v0.18.0以來的開發規模創下專案新高:約2,245次提交、約1,065個合併的PR、約3,300個已關閉的議題,以及超過450位社群貢獻者。70
- 各平台首個token等待時間均縮短約80%。 在CLI、gateway、TUI、桌面版及cron中,冷啟動時從提交到派送的時間均從約4.3秒降至約0.9秒。Discord能力偵測已移出關鍵路徑;已知不是Ollama的供應商會略過Ollama探測;代理初始化也移除了會造成阻塞的工作。使用者感受到的延遲也經過改善:推理模型現在預設即時串流顯示思考過程(
display.show_reasoning已開啟),回應框則改為逐個token繪製,不再逐行更新。70 - 桌面版與TUI的多項繪製改善。 桌面應用程式透過約20個PR全面提升速度:串流Markdown分割器採用增量區塊詞法分析,讓CPU用量降至原本的1/14;審查面板的差異檢視採用虛擬化呈現;即使對話記錄龐大,也能迅速切換工作階段;側邊欄與工具列項目不再隨每個token重新繪製。TUI現在也會逐區塊增量繪製串流Markdown。70
- pip與Homebrew安裝方式已棄用。 這兩種方式均被標記為「不受支援的舊版」安裝方式,並預計移除。v0.20.0已完成移除——brew與pip/PyPI wheel管道均已停用,目前支援的管道為shell安裝程式、Docker及Nix。7069
- 機密可從密碼管理員取得。 全新的可插拔
SecretSource介面可在載入時從Bitwarden與1Password(op://參照)擷取機密,支援同時啟用多個保管庫、明確的優先順序、衝突警告,以及每個變數的來源追蹤。API金鑰不再需要存放於明文.env中。未來可透過外掛加入其他保管庫供應商。70 - 智慧核准現已預設啟用。 當Hermes要執行被標記的命令時,會由獨立的LLM審查者評估,不再每次都要求您核准,而且每項判定僅適用於該次的確切命令。使用者自訂的拒絕規則即使在YOLO模式下也會封鎖符合條件的命令;
/deny <reason>會傳達拒絕原因,讓代理修正方向;外掛的pre_tool_call核准動作(重新加入,並支援規則鍵)則會將工具呼叫提升至人工審核關卡。70 - 終端機帳務管理:
/subscription與/topup。 無須離開終端機,即可管理Nous Portal方案:檢視方案與剩餘額度、預覽升級的確切費用或降級生效時間,再套用變更,並可復原。桌面應用程式也新增了對應的帳務設定分頁。70 - 觀看子代理工作,保留每一份已完成的答案。 子代理一啟動,
delegate_task派送便會傳回即時記錄檔,可立即使用tail -f查看。每個子代理各有一份便於閱讀的記錄,涵蓋每次工具呼叫、結果與串流回覆。背景委派的完成結果可在重新啟動後保留;gateway的最終回應則會寫入state.db中的待送達帳本,若gateway在傳送途中當機,下次啟動時便會重新傳送。max_async_children設定選項已棄用,改由統一的委派並行數上限取代。70 - 一個gateway,多個profile。 單一多工gateway可共用一個機器人權杖,將特定伺服器、頻道或討論串路由至不同的profile。每個profile的設定、skill、記憶與機密均完全隔離,並可透過
GATEWAY_MULTIPLEX_PROFILES覆寫設定。路由索引已移至state.db;sessions.json現在是選用的舊版鏡像。70 - 多項供應商與模型更新。 Fireworks AI獲得完整支援(包含成本估算,並位居供應商選單第2位),DeepInfra與Upstage Solar也加入供應商行列。模型目錄新增GPT-5.6(Sol/Terra/Luna + Pro,已完成端到端整合)、grok-4.5(正式推出)、kimi-k3(kimi-k2.x已退役),以及完整整合的Claude Sonnet 5。各供應商可使用
enabled: false旗標,搭配excluded_providers設定,將未使用的供應商從/model選單與解析流程中移除。70 - 推理投入程度可靈活調整。 所有介面均新增
max與ultra投入程度等級,支援在設定中逐模型覆寫、在MoA預設組態中逐角色設定(顧問深入思考,彙整模型維持快速回應),以及為輔助模型逐任務設定投入程度。CLI也新增僅適用於目前工作階段的/reasoning。70 - CLI與MCP介面。
hermes sessions export可匯出Markdown、Quarto、HTML、僅提示詞及Hugging Face追蹤記錄格式,並提供可選用的--redact清除敏感資訊功能;/model --once可僅覆寫一輪對話的模型;斜線skill呼叫可疊加使用(/skill-a /skill-b do XYZ);--safe-mode協助疑難排解;hermes config get/unset補齊設定管理功能;hermes serve成為真正的無介面後端;MCP工具則採用mcp__server__tool命名慣例。70
若從v0.18.x升級,請優先留意兩項變更:pip或Homebrew安裝現在會顯示「不受支援的舊版」警告(請改用單行安裝程式),而max_async_children已棄用,改由統一的委派並行數上限取代。其餘均為新增功能。升級的主要理由是首輪延遲縮短約80%、智慧核准,以及能讓已完成答案在當機後仍可送達的帳本。
v0.18.0的新功能(Judgment版本)
Hermes Agent v0.18.0(標籤v2026.7.1,2026年7月1日)以判斷力命名:代理會驗證自己的工作,不再只是宣稱成功;多模型集成推理也能供您實際檢視。此版本還清空了所有P0/P1待辦項目,在12天內解決約692項最高優先順序的問題。22
- Mixture-of-Agents成為完整支援的模型。 現在所有介面都能像選擇其他模型一樣選用MoA,並可看見集成推理過程:每個參考模型的完整輸出會以各自標示的區塊呈現,答案也會即時串流顯示。您能觀看模型群的思考過程,不再只收到不知如何產生的合併答案。22
/goal的完成契約。 代理會在回報目標完成前執行專案檢查,驗證自己的工作,而非只是宣稱成功,將判斷力用於自我檢驗。22/learn——透過描述將任何流程化為skill。 只要描述工作流程,就能轉換成可重複使用的skill;產生的skill會自動遵循儲存庫的CONTRIBUTING.md規範。22/journey時間軸。 以視覺方式呈現記憶與skill隨時間演進的歷程,並支援編輯;桌面版另提供記憶關聯圖。22- 背景子代理並行派工。 可委派多項任務同時執行,不會阻塞對話。v0.17.0原本僅能使用單一背景子代理,現在已擴展為多個子代理協作。22
- 桌面版Projects。 完整支援程式開發Projects,採用專案/儲存庫/工作分支的組織模型。22
- 可縮減至零的gateway。 gateway可在閒置時進入休眠,並協調處理完既有工作,以實現無縫部署。對於將Hermes作為常駐服務執行的使用者,這項改善尤其實用。22
- 支援Google Vertex AI。 供應商目錄新增透過GCP服務帳戶存取Gemini的方式,並支援自動更新OAuth2權杖。22
/prompt編輯器命令。 開啟$EDITOR撰寫多行提示詞,無須再受限於輸入列。22
若從v0.17.x升級,此版本沒有會破壞CLI相容性的變更。升級的主要理由是完成契約(目標完成時會自行驗證)、完整支援且可檢視集成過程的MoA,以及可將工作流程擷取為skill的/learn。
v0.17.0的新功能(The Reach Release)
Hermes Agent v0.17.0(標籤v2026.6.19,2026年6月19日)以代理程式如今的觸及範圍命名:新增訊息通道、模型供應商,以及更深入的桌面與儀表板控制功能。此版本在v0.16.x的基礎上擴充功能;CLI介面維持不變。21
- 新增訊息通道。 iMessage現在可透過Photon Spectrum運作,無須Mac中繼(裝置代碼OAuth,
hermes photon login);WhatsApp Business Cloud API是Meta官方介接器,不再需要橋接程序;SimpleX新增群組、原生附件、文字批次傳送與自動接受功能;Raft則以內建平台外掛的形式加入,採用以契約保障隱私的喚醒通道設計。21 - 新增模型與供應商。 目錄新增
z-ai/glm-5.2(1M上下文)、anthropic/claude-fable-5、laguna-m.1、nemotron-3-ultra與grok-composer-2.5-fast(透過xAI OAuth存取的Cursor模型,200k上下文)。xAI預設模型改為grok-build-0.1,Anthropic自適應模型現在遵循新版思考協定(絕不傳送reasoning欄位)。21 - 桌面與儀表板。 桌面應用程式新增背景子代理程式,透過即時「監看視窗」串流顯示委派工作的活動(
delegate_task(background=true)),並加入Composer模型選擇器、可重新綁定的鍵盤快捷鍵、原生作業系統通知、各討論串獨立的輸入草稿、VS Code Marketplace佈景主題,以及日文與繁體中文介面。儀表板新增完整的profile建構工具(無須編輯config.yaml即可設定模型、skill與MCP)、全域profile切換器、重新設計且具備安全掃描功能的Skills Hub、Automation Blueprints(可用於表單、斜線指令、對話與文件的參數化範本),以及受OAuth驗證關卡保護、未通過驗證時會回傳401的安全登入機制。21 - Skill與工具。
image_generate現在可透過所有支援的影像供應商編輯與轉換來源影像,不再只限於從零生成;memory工具新增operations陣列,可在單次呼叫中以不可分割的批次操作完成新增、取代與移除;新的simplify-codeskill會依Chesterton’s Fence風險分級把關,並由3個代理程式平行執行審查與清理;布林值write_approval則取代了三態的write_mode。21 - 架構。 背景子代理程式會立即回傳控制代碼,並將結果以新一輪對話的形式送回;MCP資訊徵詢處理常式支援在工具呼叫途中請求確認,稍後才連線的MCP工具則會在對話輪次之間提供使用(不影響快取);cron改為可插拔的CronScheduler,搭配Chronos受管cron供應商;新增的Managed範圍(
/etc/hermes)讓管理員能鎖定使用者無法修改的設定,並提供Gateway-Gateway中繼以支援多gateway拓撲。21 - 新增指令。
/version、/billing(互動式終端機帳務功能)、hermes photon login(iMessage驗證)與hermes curator run --consolidate;整併功能現在須主動啟用,因此例行背景整理不會消耗任何token。21 - 安全性。 v0.17.0修補了透過shell跳脫繞過拒絕清單的漏洞;在缺少核准模組,以及採用自有政策的gateway介接器出現相關問題時,預設拒絕執行;清理cron工作指令碼子程序的執行環境;遮蔽請求偵錯傾印中的機密資訊;檢查MCP stdio設定中的資料外洩模式;並升級urllib3與PyJWT以修補CVE漏洞。21
若您從v0.16.x升級,本版沒有任何會破壞CLI相容性的變更;它是在同一個代理程式周邊新增通道、模型與操作介面。無須中繼的iMessage、官方WhatsApp介接器,以及供管理員使用的Managed範圍,是本次升級的主要亮點。
v0.16.0的新功能(The Surface Release)
Hermes Agent v0.16.0(標籤v2026.6.5,2026年6月5日)以新增的操作介面命名,為這個以CLI為優先的代理程式帶來更多使用方式。最大亮點是Hermes不再僅限於終端機。20
- 原生桌面應用程式。 Hermes Desktop是全新的Electron應用程式,支援macOS、Linux與Windows,提供一鍵安裝與應用程式內自動更新。它具備串流聊天視窗、檔案拖放、剪貼簿圖片貼上、
Cmd+K指令面板、支援封存與搜尋的工作階段清單,以及狀態列模型選擇器。它可透過安全的WebSocket連線至遠端Hermes gateway,並以OAuth或使用者名稱/密碼進行驗證;每個profile可設定各自的遠端主機,也能同時執行多個profile的工作階段,並透過跨profile的@session參照互相連結。桌面介面也透過具型別定義的i18n層提供完整的簡體中文翻譯(display.language;預設仍為英文)。20 - 瀏覽器管理面板。 本機網頁儀表板從狀態檢視升級為完整的管理面板:包含具備啟用/停用切換功能的MCP目錄、憑證管理、webhook與hook建立、記憶設定、gateway控制,以及提供更新前檢查與一鍵Debug Share的系統頁面。新增的通道頁面可直接在瀏覽器中設定所有gateway訊息平台(Telegram、Discord、Slack等)。驗證機制現在支援插拔式擴充:使用者名稱/密碼登入、通用的自行託管OIDC供應商、用於註冊自行託管OAuth用戶端的
hermes dashboard register,以及透過更新權杖進行的工作階段輪替。20 - 新增CLI與斜線指令。
/undo [N]可回退最近N輪使用者對話,並提供預先填入與軟刪除功能,適用於CLI、TUI及各訊息平台。現在可設定預設介面(cli或tui),並以--cli覆寫;TUI新增統一的/model指令與工作階段浮層。hermes portal是Nous Portal初始設定流程的易讀別名,首次執行時新增快速設定與完整設定兩條路徑,另加入2個診斷指令:hermes prompt-size與hermes sessions optimize。20 - 新增模型與供應商。 選擇器新增
deepseek-v4-flash、MiniMax-M3(1M上下文,原生MiniMax供應商)、qwen3.7-plus(Nous + OpenRouter)與gemini-3.5-flash(Gemini OAuth + API金鑰)。桌面啟動器加入完整整合的xAI Grok OAuth供應商;所有介面的模型選擇器皆支援模糊搜尋;具有多個端點的供應商整合於同一列;目錄更新頻率則從每日改為每小時。20(v0.21.1後來再次調整頻率:選擇器的遠端目錄每20分鐘更新一次,由model_catalog.ttl_minutes設定。46) - 精簡skill與漸進式揭露。 預設skill集合移除了重複與已失效的skill(Spotify改為原生外掛、Linear改用
hermes mcp install linear,並移除數個過時項目),將更多項目改為選用,並新增environments:前置資料關聯性條件(kanban/docker/s6),讓特定情境專用的skill在使用者提出需求前不會出現在索引中。NVIDIA/skills現在與OpenAI、Anthropic及HuggingFace並列為Skills Hub預設信任的來源。MCP與外掛工具新增漸進式(限定範圍)工具揭露機制,也修正了MCP在未取得權杖時卻誤報OAuth成功的錯誤。20 - 安全性。 v0.16.0針對CVE-2026-48710(BadHost)鎖定已修補的Starlette版本(≥1.0.1);將非同步執行路徑中的SSRF URL檢查移出事件迴圈;從子程序環境中移除Bedrock推論承載權杖;將
bws_cache.json納入檔案安全讀取防護;將docker restart/stop/kill加入危險模式清單;並清理已審核skill內容中的不可見Unicode字元。此版本解決了2個P0與62個P1問題,其中16個標記為安全性問題。20
若您從v0.15.x升級,這些變更都不會破壞CLI本身的相容性;它們是在同一個代理程式周邊新增操作介面與供應商。若希望讓不使用終端機的人也能使用Hermes,或透過瀏覽器管理遠端gateway,桌面應用程式與管理面板就是值得升級的原因。
v0.14.0的新功能(The Foundation Release)
v0.14.0的重點在於減少設定阻力,並擴大Hermes可執行的環境,而非某一項主打功能。19主要運作變更如下:
- 安裝與啟動更輕量。 可透過
pip install hermes-agent從PyPI安裝,較大型的介接器延後至首次使用時才安裝,啟動流程也延後執行足夠多的工作,讓冷啟動時間縮短約19秒。(v0.19.0後來已將pip安裝方式列為棄用,請參閱安裝。) - 訂閱服務可轉為本機API端點。
hermes proxy可將Claude Pro、ChatGPT Pro與SuperGrok等透過OAuth驗證的供應商,轉為相容於OpenAI的本機端點,供Codex、Aider、Cline與Continue等工具使用。 - Gateway涵蓋範圍擴大。 LINE與SimpleX Chat加入gateway(文件中的平台比較表在標籤
v2026.8.31列出28個平台;訊息Gateway章節說明此數字的計算範圍),Microsoft Teams已完成端到端串接,Discord預設啟用歷史訊息回填,Telegram/Discord的clarify提示現在則使用原生按鈕。 - 寫入時的驗證更完善。 編輯完成後,Hermes可在下一輪對話前顯示該輪的檔案變更摘要與語言伺服器語意診斷,讓代理程式的工作更貼近以證據為依據的做法。
- 桌面與媒體工具擴充。
computer_use可透過cua-driver支援Anthropic以外的供應商,video_generate整合為統一介面並採用可插拔後端,vision_analyze則將原始像素傳送給確實具備視覺能力的模型。
安裝
單行安裝程式是官方支援的安裝方式。它會處理Python、uv、Node.js、ripgrep、ffmpeg、儲存庫複製、虛擬環境,以及全域hermes指令的設定。7
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
自v0.19.0起,已棄用pip與Homebrew安裝方式。 v0.14.0推出的PyPI套件(
pip install hermes-agent)與Homebrew套件配方,現已標示為「不受支援的舊版」安裝方式。Hermes偵測到這類安裝時,所有介面都會顯示警告(但不會阻止使用),並已規劃停止透過PyPI/Homebrew發布。若您先前透過pip或brew安裝,請改用上方的安裝程式。70
支援Linux、macOS、WSL2與Android/Termux(安裝程式會自動偵測Termux,並切換至經過測試的Android套件組合)。7 Windows原生支援現已列為Tier 1,不再是v0.14.0推出時的早期測試版;請使用iex (irm https://hermes-agent.nousresearch.com/install.ps1)安裝。文件明確指出一項限制:macOS僅支援Apple Silicon,不支援Intel Mac。69 回顧版本沿革,v0.14.0透過PowerShell安裝程式加入了早期測試階段的Windows原生支援,但在Windows安裝方式成熟之前,正式環境仍建議使用較穩妥的WSL2。19
安裝完成後:
source ~/.bashrc # or ~/.zshrc
hermes # Start chatting
唯一的先決條件是git。安裝程式會透過uv自動安裝Python 3.11(無須sudo),並安裝Node.js 26(用於瀏覽器自動化與WhatsApp橋接)、ripgrep及ffmpeg。自v0.20.0起,Node 26是強制要求的最低版本;安裝程式會拒絕使用任何較舊版本,改為安裝由Hermes管理的Node。697
驗證安裝
hermes --version # Check version (global flag; there is no `version` subcommand)
hermes doctor # Diagnose config/dependency issues
hermes status # Show current configuration + auth state
hermes dump # Copy-pasteable setup summary for debugging
hermes doctor會明確指出缺少哪些項目,以及如何修正。7 在GitHub議題或Discord討論串中求助時,可貼上hermes dump診斷指令的輸出;它會以純文字摘要呈現完整設定,並遮蔽機密資訊。8
手動安裝
若您需要完整掌控安裝方式,例如自訂Python版本、指定選用套件或整合Nix/NixOS,上游安裝指南提供了逐步操作說明。7 以下是可搭配uv pip install -e ".[<extras>]"組合使用的主要選用套件:
| 選用套件 | 新增功能 |
|---|---|
all |
下列所有功能 |
messaging |
Telegram與Discord gateway |
cron |
cron運算式解析 |
cli |
設定精靈的終端機選單介面 |
modal |
Modal雲端執行後端 |
voice |
CLI麥克風輸入與音訊播放 |
tts-premium |
ElevenLabs高階語音;text_to_speech的ElevenLabs版本可針對每次呼叫指定voice_id,並透過find_voices搜尋公開的Voice Library或您帳戶中的語音(v0.22.6發布期間)67 |
honcho |
AI原生記憶(Honcho整合) |
mcp |
Model Context Protocol支援 |
homeassistant |
Home Assistant整合 |
acp |
ACP編輯器整合支援 |
slack |
Slack訊息功能 |
pty |
PTY終端機支援(互動式CLI工具) |
dev |
pytest與測試工具 |
termux |
經過測試的Android套件組合(包含cron、cli、pty、mcp、honcho、acp) |
Termux的安裝指令有所不同,使用的是pip搭配版本限制檔,而非uv pip:
python -m pip install -e ".[termux]" -c constraints-termux.txt
這是因為在Android上安裝.[all]時,會透過voice選用套件引入faster-whisper,而它所依賴的ctranslate2並未發布適用於Android的wheel套件。7
驗證與供應商
在標籤v2026.9.7中,hermes_cli/models_catalog_static.py第311行包含39個靜態CANONICAL_PROVIDERS項目(2026年9月的模組拆分將此清單從hermes_cli/models.py移出;項目本身未變,包含v0.21.0的tencent-tokenplan),並從plugins/model-providers/自動擴充清單(隨附39個目錄;其中9個——actual、alibaba-coding-plan、commandcode、deepinfra、meta-ai、nebius-token-factory、opencode-free、router、upstage——沒有靜態項目,但因為採用預設的api_key驗證類型,因此會透過自動擴充納入)。文件的供應商頁面以表格列出45個雲端與訂閱制供應商,另有一列自訂端點,並分別說明本機與自行架設的伺服器(Ollama、vLLM、SGLang、llama.cpp、LM Studio、LiteLLM、ClawRouter,以及任何相容於OpenAI的端點)。26在標籤v2026.9.24中,靜態清單仍有39個項目,但plugins/model-providers/只有38個目錄:無需金鑰的opencode-free供應商已於9月18日移除,因為OpenCode的免費方案開始拒絕來自其自有用戶端以外的匿名流量。53在標籤v0.21.6中,靜態清單仍有39列,目錄數則增至41個:原本已有靜態列的lmstudio和tencent-tokenhub新增了外掛目錄,而沒有靜態列的solstice則透過自動擴充加入。55在此基礎上,另有自訂端點與3種不同的驗證方式。以下依方式整理完整的驗證選項,方便您找到符合現有條件的做法。
3種驗證方式
Hermes的每個供應商都採用以下3種驗證模式之一:
方式1——在.env中設定API金鑰。將金鑰放入~/.hermes/.env,Hermes便會在啟動時讀取。OpenRouter、AI Gateway、z.ai/GLM、Kimi/Moonshot、MiniMax(及MiniMax China)、Alibaba Cloud/DashScope、Kilo Code、OpenCode Zen、OpenCode Go、DeepSeek、Hugging Face、Google/Gemini,以及多數第三方供應商都採用此方式。2自v0.19.0起,金鑰不再必須存放於純文字檔案:可插拔的SecretSource介面能在載入時從Bitwarden或1Password(op://參照)取得機密資料,並支援同時啟用多個保管庫、明確且固定的優先順序、衝突警告,以及各變數的來源追蹤;.env仍保留作為備援。(這與v0.15.0的Bitwarden Secrets Manager啟動權杖不同,後者透過單一權杖統一管理供應商金鑰;SecretSource則取代純文字檔案本身,未來的保管庫供應商也能以外掛形式加入。)70
方式2——透過hermes model或hermes auth進行OAuth驗證。啟動裝置代碼流程、開啟瀏覽器,並將憑證儲存至~/.hermes/auth.json(也能從Claude Code或Codex CLI等工具匯入現有憑證)。Nous Portal、OpenAI Codex(ChatGPT帳號)、GitHub Copilot,以及Anthropic(Claude Pro/Max)都採用此方式。2自v0.22.5版本期間起,所有Nous登入都採用一般裝置登入流程:免費方案的訪客身分會轉交至您的帳號,結果會顯示登入者身分,連接器也會提供登入選項,而非開啟訪客工作階段。64
方式3——在config.yaml中設定自訂端點。適用於任何相容於OpenAI的API,例如Ollama、vLLM、SGLang、llama.cpp、LM Studio、LiteLLM代理伺服器、Together AI、Groq、Azure OpenAI,或您自行架設的伺服器。透過hermes model → Custom endpoint設定一次後,即會儲存至config.yaml。2
完整供應商對照表
此對照表涵蓋文件頁面表格所列的供應商,並提供各供應商的確切設定流程;該標籤版本的選擇器列出的供應商比文件更多(請參閱上方數量),而任何相容於OpenAI的服務都能透過自訂端點列所示的方式使用。226
| 供應商 | 驗證方式 | 設定 |
|---|---|---|
| Nous Portal | OAuth | hermes model(OAuth登入,採訂閱制) |
| OpenAI Codex | OAuth | hermes model(ChatGPT裝置代碼,使用Codex模型) |
GitHub Copilot(自v0.22.6發布期間起為github-copilot外掛) |
OAuth或權杖 | hermes model(OAuth裝置代碼),或COPILOT_GITHUB_TOKEN / GH_TOKEN / gh auth token |
| GitHub Copilot ACP(同一外掛) | 本機子程序 | hermes model(PATH中須有copilot CLI,並執行copilot login) |
| Anthropic | OAuth或API金鑰 | hermes model(優先使用Claude Code憑證),或ANTHROPIC_API_KEY,或ANTHROPIC_TOKEN setup-token |
| OpenRouter | API金鑰 | 在~/.hermes/.env中設定OPENROUTER_API_KEY |
| AI Gateway(Vercel) | API金鑰 | 在~/.hermes/.env中設定AI_GATEWAY_API_KEY(供應商:ai-gateway) |
| z.ai / GLM(ZhipuAI) | API金鑰 | 在~/.hermes/.env中設定GLM_API_KEY(供應商:zai) |
| Kimi / Moonshot | API金鑰 | 在~/.hermes/.env中設定KIMI_API_KEY(供應商:kimi-coding)。v0.19.0將kimi-k3加入模型目錄(kimi-k2.x已停用)。70 |
| MiniMax(全球版) | API金鑰 | 在~/.hermes/.env中設定MINIMAX_API_KEY(供應商:minimax) |
| MiniMax China | API金鑰 | 在~/.hermes/.env中設定MINIMAX_CN_API_KEY(供應商:minimax-cn) |
| Alibaba Cloud(Qwen) | API金鑰 | 在~/.hermes/.env中設定DASHSCOPE_API_KEY(供應商:alibaba,別名:dashscope、qwen) |
| Kilo Code | API金鑰 | 在~/.hermes/.env中設定KILOCODE_API_KEY(供應商:kilocode) |
| OpenCode Zen | API金鑰 | 在~/.hermes/.env中設定OPENCODE_ZEN_API_KEY(供應商:opencode-zen) |
| OpenCode Go | API金鑰 | 在~/.hermes/.env中設定OPENCODE_GO_API_KEY(供應商:opencode-go) |
| DeepSeek | API金鑰 | 在~/.hermes/.env中設定DEEPSEEK_API_KEY(供應商:deepseek) |
| Hugging Face | API金鑰 | 在~/.hermes/.env中設定HF_TOKEN(供應商:huggingface,別名:hf) |
| Google / Gemini | API金鑰 | 在~/.hermes/.env中設定GOOGLE_API_KEY或GEMINI_API_KEY(供應商:gemini) |
| Fireworks AI | API金鑰 | 完整內建支援的供應商,模型選擇器提供費用估算與快取價格欄位;已提升至供應商選擇器的第2順位。於v0.19.0新增。70 |
| DeepInfra | API金鑰 | 完整內建支援的供應商,整合機制已強化。於v0.19.0新增。70 |
| Upstage Solar | API金鑰 | 完整內建支援的供應商。於v0.19.0新增。70 |
| xAI(Grok) | 原生供應商 / SuperGrok OAuth | 完整內建支援的供應商,提供直接API存取與模型目錄(v0.9.0+)。v0.14.0新增SuperGrok OAuth,並將具備使用資格帳號的grok-4.3上下文視窗提升至1M。21619v0.17.0新增grok-composer-2.5-fast(透過xAI OAuth使用的Cursor模型,具備200k上下文),並將xAI預設模型改為grok-build-0.1。21v0.19.0將目錄中的grok-4.5標示為正式推出(GA)。70 |
| xAI Custom Voices | API金鑰 | 支援語音複製的TTS供應商。於v0.13.0新增;在config.yaml的tts:下設定,並在.env中提供xAI金鑰。18 |
| Xiaomi MiMo | 原生供應商 | 完整內建支援的供應商,提供設定精靈與模型目錄。Nous Portal提供免費MiMo v2 Pro供輔助任務使用(v0.9.0+)。1615 |
| Google AI Studio | API金鑰 | 在~/.hermes/.env中設定GOOGLE_API_KEY或GEMINI_API_KEY。可直接存取Gemini,並透過models.dev登錄資料自動偵測上下文長度(v0.8.0+)。15 |
| Qwen OAuth(Portal) | OAuth | hermes model → “Qwen OAuth (Portal)”(供應商:qwen-oauth;透過瀏覽器進行PKCE登入,沿用本機Qwen CLI的登入狀態)。支援入口網站請求的OAuth供應商(v0.8.0+)。上方使用API金鑰的DashScope方式,已於v0.14.0從Alibaba Cloud更名為Qwen Cloud;現有設定鍵仍可使用。151926 |
| OpenCode Free(已移除) | 無需金鑰 | 已於2026年9月18日移除,標籤v2026.9.21和v2026.9.24均不包含此供應商。若設定仍指定opencode-free、free或opencode_free,便會收到指出此供應商已移除的錯誤;請透過hermes model切換至opencode-zen(按用量計費,OPENCODE_ZEN_API_KEY)或opencode-go(訂閱制,OPENCODE_GO_API_KEY)。此供應商於v0.20.5版本期間以「無需驗證的opencode-free供應商」之名加入。2353 |
| OpenAI API(直接存取) | API金鑰 | 在~/.hermes/.env中設定OPENAI_API_KEY(供應商:openai-api,可選填OPENAI_BASE_URL)26 |
| Google Vertex AI | OAuth2 / ADC | hermes model → “Google Vertex AI”(供應商:vertex;透過服務帳戶JSON或應用程式預設憑證進行OAuth2驗證,費用計入您的GCP專案)26 |
| Azure AI Foundry | 端點+金鑰 | hermes model → “Azure AI Foundry”(供應商:azure-foundry;使用您的Azure OpenAI / Foundry端點與金鑰;選擇器將其描述為「OpenAI樣式或Anthropic樣式的端點」)26 |
| AWS Bedrock | AWS憑證 | hermes model → “AWS Bedrock”(供應商:bedrock;透過boto3使用標準AWS憑證鏈、IAM或API金鑰;支援Claude、Nova、Llama、DeepSeek)26 |
| NVIDIA NIM / Build | API金鑰 | 在~/.hermes/.env中設定NVIDIA_API_KEY(供應商:nvidia;使用build.nvidia.com上由NIM託管的Nemotron與其他模型,或覆寫基底URL以使用本機NIM端點)26 |
| Ollama Cloud | OAuth或API金鑰 | hermes model → “Ollama Cloud”(供應商:ollama-cloud;貼上OLLAMA_API_KEY,並從偵測到的雲端託管模型中選取)26 |
| StepFun Step Plan | API金鑰 | 在~/.hermes/.env中設定STEPFUN_API_KEY(供應商:stepfun;透過Step Plan API提供代理與程式設計模型)26 |
| MiniMax(OAuth) | OAuth | hermes model →「MiniMax(OAuth)」(供應商:minimax-oauth;透過瀏覽器以PKCE登入Coding Plan,支援全球或中國區域)26 |
| Meta AI | API金鑰 | 在~/.hermes/.env中設定MODEL_API_KEY(供應商:meta-ai;Meta Model API、Muse Spark系列)26 |
| NovitaAI | API金鑰 | 在~/.hermes/.env中設定NOVITA_API_KEY(供應商:novita;200多個模型、Model API、Agent Sandbox、GPU Cloud)26 |
| Arcee AI | API金鑰 | 在~/.hermes/.env中設定ARCEEAI_API_KEY(供應商:arcee;別名:arcee-ai、arceeai;Trinity模型)26 |
| GMI Cloud | API金鑰 | 在~/.hermes/.env中設定GMI_API_KEY(供應商:gmi;別名:gmi-cloud、gmicloud)。請使用GMI的/v1/models端點回傳的確切模型ID26 |
| Actual Computer | API金鑰或本機常駐程式 | 使用託管轉送服務時,在~/.hermes/.env中設定ACTUAL_API_KEY;若使用本機常駐程式,則設定ACTUAL_BASE_URL=http://127.0.0.1:8080,透過迴路介面連線時不需金鑰(供應商:actual;別名:actual-computer、actualcomputer、aci)26 |
| Tencent TokenHub | API金鑰 | 在~/.hermes/.env中設定TOKENHUB_API_KEY(供應商:tencent-tokenhub;別名:tencent、tokenhub、tencentmaas;Hy3 Preview)26 |
| CommandCode | API金鑰 | 在~/.hermes/.env中設定COMMANDCODE_API_KEY(供應商:commandcode,別名為commandcode-chat;Claude模型則透過commandcode-anthropic使用,別名為commandcode-claude)。支援GOAT/Pro/Max/Provider方案,但不支援價格為$1的Go方案,因為該方案不提供API存取權。此外掛程式於v0.20.3期間加入。6826 |
| Alibaba Cloud(Coding Plan) | API金鑰 | DASHSCOPE_API_KEY(供應商:alibaba-coding-plan,別名為alibaba_coding);屬於獨立計費的SKU,使用的端點與alibaba DashScope供應商不同26 |
| Tencent TokenPlan | API金鑰 | 在~/.hermes/.env中設定TOKENPLAN_API_KEY(供應商:tencent-tokenplan,別名:tokenplan、tencent-lkeap;透過位於api.lkeap.cloud.tencent.com的Anthropic Messages端點提供Hy4預覽版)。於v0.21.0新增;選擇器將TokenHub和TokenPlan合併顯示於同一個「Tencent Hy」列,此合併僅影響顯示3536 |
| Nebius Token Factory | API金鑰 | 在~/.hermes/.env中設定NEBIUS_API_KEY(供應商:nebius-token-factory;別名:nebius、nebius-tf、tokenfactory)。於v0.21.0新增3536 |
| Ramp Router | API金鑰 | 在~/.hermes/.env中設定RAMP_ROUTER_API_KEY(供應商:router;別名:ramp-router、ramp、router.com)。Ramp位於api.router.com的LLM gateway原生支援OpenAI Responses,並提供依帳戶而定的即時模型目錄——有效的模型ID以您的金鑰呼叫/v1/models所回傳的結果為準,因此選擇器會動態擷取,而非寫死在程式碼中。於v0.21.0新增3536 |
| Alibaba Cloud(Token Plan) | API金鑰 | 在~/.hermes/.env中設定ALIBABA_TOKEN_PLAN_API_KEY(供應商:alibaba-token-plan;中國大陸端點:alibaba-token-plan-cn)——這是Model Studio的固定token額度方案,也是繼alibaba和alibaba-coding-plan之外的第3個Alibaba SKU36 |
| 自訂端點 | config.yaml | hermes model →「自訂端點」(儲存於config.yaml)。文件列出的OpenAI相容服務包括Together AI、Groq、Cerebras(https://api.cerebras.ai/v1)、Mistral、Azure OpenAI、LocalAI和Jan26 |
自v0.19.0起,也能排除不使用的供應商:透過個別供應商的enabled: false旗標及excluded_providers設定鍵,即可將其從/model選擇器和內建供應商解析流程中移除。70 |
Anthropic:3種驗證方式
Anthropic值得獨立說明,因為Hermes支援3種不同的Claude存取方式,選對方式相當重要。以下摘自上游文件:2
# Method 1: API key (pay-per-token)
export ANTHROPIC_API_KEY=***
hermes chat --provider anthropic --model claude-sonnet-4-6
# Method 2: OAuth through hermes model (preferred)
# Uses Claude Code's credential store when available
hermes model
# Method 3: Manual setup-token (fallback/legacy)
export ANTHROPIC_TOKEN=***
hermes chat --provider anthropic
# Auto-detect Claude Code credentials
hermes chat --provider anthropic # reads Claude Code files automatically
透過hermes model選擇Anthropic OAuth時,Hermes會優先使用Claude Code本身的憑證儲存區,而非將權杖複製到~/.hermes/.env。如此可讓支援更新的Claude憑證持續保持可更新狀態。2若已在同一台電腦上使用Claude Code,這是最簡潔的方式。
若要在config.yaml中將Anthropic設為固定供應商:
model:
provider: "anthropic"
default: "claude-sonnet-4-6"
--provider claude和--provider claude-code也可作為--provider anthropic的簡寫。2
GitHub Copilot:2種模式
Copilot支援2種模式:直接使用Copilot API(建議),以及Copilot ACP(會將本機Copilot CLI啟動為子程序)。2自v0.22.6發布期間起,2種模式皆以github-copilot外掛(社群層級,NousResearch/hermes-labs-plugins)的形式提供,而非內建於核心:hermes plugins install github-copilot可加入這2種模式,hermes update會為每個已透過copilot或copilot-acp路由的profile安裝此外掛,下方的指令、設定鍵與環境變數均未變更。67
# Direct Copilot API
hermes chat --provider copilot --model gpt-5.4
# Copilot ACP (requires the Copilot CLI in PATH + an existing copilot login)
hermes chat --provider copilot-acp --model copilot-acp
根據上游文件,驗證資訊的檢查順序如下:2
1. COPILOT_GITHUB_TOKEN環境變數
2. GH_TOKEN環境變數
3. GITHUB_TOKEN環境變數
4. gh auth token CLI備援方式
5. 透過hermes model進行OAuth裝置代碼登入
權杖類型至關重要。Copilot API不支援傳統個人存取權杖(ghp_*)。支援的類型包括OAuth權杖(gho_*)、細粒度PAT(github_pat_*,需具備Copilot Requests權限),以及GitHub App權杖(ghu_*)。若gh auth token回傳的是ghp_*權杖,請改用hermes model透過OAuth進行驗證。2
中國AI供應商(原生支援)
Hermes內建支援z.ai/GLM、Kimi/Moonshot、MiniMax(全球及中國端點)與Alibaba Cloud,並為各家提供專屬的供應商ID。2
# z.ai / ZhipuAI GLM
hermes chat --provider zai --model glm-5 # Requires: GLM_API_KEY
# Kimi / Moonshot AI
hermes chat --provider kimi-coding --model kimi-for-coding # Requires: KIMI_API_KEY
# MiniMax (global)
hermes chat --provider minimax --model MiniMax-M2.7 # Requires: MINIMAX_API_KEY
# MiniMax (China)
hermes chat --provider minimax-cn --model MiniMax-M2.7 # Requires: MINIMAX_CN_API_KEY
# Alibaba Cloud / DashScope (Qwen)
hermes chat --provider alibaba --model qwen3.5-plus # Requires: DASHSCOPE_API_KEY
可透過GLM_BASE_URL、KIMI_BASE_URL、MINIMAX_BASE_URL、MINIMAX_CN_BASE_URL或DASHSCOPE_BASE_URL環境變數覆寫基底URL。2
Z.AI會自動偵測端點。使用z.ai/GLM供應商時,Hermes會探測多個端點(全球、中國及程式設計版本),找出接受您API金鑰的端點。可用的端點會自動快取,因此大多數使用者不需設定GLM_BASE_URL。2
xAI(Grok)會自動啟用提示快取。當基底URL包含x.ai時,Hermes會在每次請求中傳送x-grok-conv-id標頭,將同一對話工作階段的請求路由至相同伺服器,以重複使用已快取的系統提示與歷史紀錄。2此功能會自動運作,無需設定。
hermes auth命令
hermes auth是用來管理憑證集區與OAuth憑證的命令。6
hermes auth # Interactive wizard
hermes auth list # Show all credential pools
hermes auth list openrouter # Show one provider's pool
hermes auth add openrouter --api-key sk-or-v1-xxx
hermes auth add anthropic --type oauth
hermes auth remove openrouter 2 # Remove by index
hermes auth reset openrouter # Clear cooldowns
憑證集區可讓您輪替使用同一供應商的多組API金鑰或OAuth權杖,無需修改程式碼,就能將請求分散至多組金鑰,分攤速率限制。6舊版hermes login/hermes logout命令已移除,請改用hermes auth。6
自訂與自行託管的端點
Hermes可搭配任何相容於OpenAI的API端點使用。只要伺服器實作了/v1/chat/completions,就能將Hermes指向該伺服器。2
互動式設定(建議):
hermes model
# Select "Custom endpoint (self-hosted / VLLM / etc.)"
# Enter: API base URL, API key, Model name
手動設定config.yaml:
model:
default: your-model-name
provider: custom
base_url: http://localhost:8000/v1
api_key: your-key-or-leave-empty-for-local
這兩種方式都會將設定儲存至config.yaml,此檔案是主模型、供應商與基底URL的唯一設定依據。2舊版環境變數OPENAI_BASE_URL與LLM_MODEL已不再用於讀取主模型設定——請使用hermes model或直接編輯config.yaml。2(OPENAI_BASE_URL+OPENAI_API_KEY仍可作為輔助provider: "main"路由路徑的備援,因此若您在該路徑中使用這些變數,請勿貿然刪除。)4
在工作階段中切換自訂端點:
/model custom:qwen-2.5 # Custom endpoint with explicit model
/model custom # Auto-detect the model from the endpoint
/model custom:local:qwen-2.5 # Named custom provider "local"
/model custom:work:llama3 # Named custom provider "work"
/model openrouter:claude-sonnet-4 # Back to a cloud provider
/model custom(單獨使用,不加模型名稱)會查詢端點的/v1/models API;若恰好只載入1個模型,就會自動選取該模型——適合執行單一模型的本機伺服器。2
本機LLM伺服器(設定範本)
上游文件提供Ollama、vLLM、SGLang、llama.cpp與LM Studio的完整設定指南。以下列出實際操作時會用到的關鍵指令。每個範本都能建立可供Hermes連線使用的端點。2
自v0.22.0起,Hermes可自行執行模型。 hermes model → 本機模型(桌面應用程式中的「設定 ▸ 供應商 ▸ 本機模型」)會依硬體安裝並維護適用的llama.cpp建置版本(CPU、CUDA、Metal、Vulkan或ROCm;v0.22.0鎖定檔中指定為b11370),依據GPU與RAM容量評估目錄中的每個模型,並下載容量可容納且品質最高的建置版本,支援暫停與續傳。目錄包含Qwen3.8 27B、Qwen3.8 Flash Next、Qwen3.6 35B-A3B與DeepSeek V4 Flash,也支援Hugging Face上的任何GGUF;伺服器會隨Hermes啟動與停止,且只會推薦可完整載入GPU記憶體的模型。若要自行執行伺服器,仍可使用下方範本。5859v0.22.2提升了筆記型電腦上耗時較長的本機回合穩定性:狀態列會顯示提示讀取進度;停滯計時器會排除睡眠時間;伺服器恢復後會重試,而非觸發斷路器;壓縮作業的截止時間會配合仍在讀取長篇對話的伺服器延後;在採用統一記憶體的Windows電腦上,則會依記憶體容量調整啟動設定。62
Ollama——最簡單的本機方案,無須設定:
ollama pull qwen2.5-coder:32b
OLLAMA_CONTEXT_LENGTH=32768 ollama serve # Raise from 4k default
hermes model # Custom endpoint → http://localhost:11434/v1 → qwen2.5-coder:32b
Ollama的重要注意事項:Ollama的預設上下文長度非常低(VRAM低於24GB時為4,096個token)。必須透過OLLAMA_CONTEXT_LENGTH或Modelfile提高長度——相容於OpenAI的API不接受用戶端傳入的上下文長度,因此Hermes無法代為設定。2用於代理程式時,請至少設為16k–32k。
vLLM——高效能GPU推論服務:
pip install vllm
vllm serve meta-llama/Llama-3.1-70B-Instruct \
--port 8000 \
--max-model-len 65536 \
--tensor-parallel-size 2 \
--enable-auto-tool-choice \
--tool-call-parser hermes
工具呼叫需要--enable-auto-tool-choice與--tool-call-parser <name>。支援的剖析器包括:hermes(Qwen 2.5、Hermes 2/3)、llama3_json、mistral、deepseek_v3、deepseek_v31、xlam、pythonic。若未加入這些旗標,工具呼叫會以純文字傳回。2
SGLang——透過RadixAttention重複利用KV快取,提供快速推論服務:
pip install "sglang[all]"
python -m sglang.launch_server \
--model meta-llama/Llama-3.1-70B-Instruct \
--port 30000 \
--context-length 65536 \
--tp 2 \
--tool-call-parser qwen
SGLang注意事項:預設max_tokens為128。若回應遭到截斷,請在伺服器上設定--default-max-tokens,或在config.yaml中設定model.max_tokens。2
llama.cpp / llama-server——CPU與Apple Silicon Metal:
./build/bin/llama-server \
--jinja -fa \
-c 32768 \
-ngl 99 \
-m models/qwen2.5-coder-32b-instruct-Q4_K_M.gguf \
--port 8080 --host 0.0.0.0
工具呼叫必須使用--jinja。若未使用此旗標,llama-server會完全忽略tools參數,模型則會嘗試在回應文字中寫入JSON來呼叫工具——Hermes無法將其解析為實際的工具呼叫。2
LM Studio——具備GUI的桌面應用程式:
從LM Studio應用程式啟動伺服器(Developer分頁 → Start Server),或透過CLI執行:lms server start(在連接埠1234啟動)與lms load qwen2.5-coder --context-length 32768。2接著將hermes model指向http://localhost:1234/v1。
LM Studio的重要注意事項:LM Studio會從模型中繼資料讀取上下文長度,但許多GGUF模型回報的預設值為2048或4096。請務必在LM Studio模型設定中明確指定上下文長度——點選模型選擇器旁的齒輪圖示,將「Context Length」設為至少16384(建議32768),然後重新載入模型。2
具名自訂供應商
若您使用多個自訂端點(例如本機開發伺服器與遠端GPU伺服器),請在config.yaml中將它們定義為具名自訂供應商:2
custom_providers:
- name: local
base_url: http://localhost:8080/v1
# api_key omitted — Hermes uses "no-key-required" for keyless local servers
- name: work
base_url: https://gpu-server.internal.corp/v1
api_key: corp-api-key
api_mode: chat_completions # optional, auto-detected from URL
- name: anthropic-proxy
base_url: https://proxy.example.com/anthropic
api_key: proxy-key
api_mode: anthropic_messages # for Anthropic-compatible proxies
接著即可在工作階段中使用三段式語法切換:
/model custom:local:qwen-2.5
/model custom:work:llama3-70b
/model custom:anthropic-proxy:claude-sonnet-4
也能從互動式hermes model選單選取具名自訂供應商。2
可插拔的供應商架構(v0.13.0+)
v0.13.0提供ProviderProfile抽象基底類別(ABC)與plugins/model-providers/目錄,讓第三方推論供應商無須修改核心程式碼即可整合。18若供應商支援相容於OpenAI、Anthropic或Codex的API模式,即可實作ProviderProfile子類別,宣告驗證路徑、基底URL、模型目錄與快取標頭;Hermes會透過內建供應商使用的同一條runtime_provider.py路徑解析。這項架構變更促成了v0.13.0的供應商擴充:新增供應商時,只需提供外掛,無須編輯核心程式碼。
相容於OpenAI的本機代理伺服器(v0.14.0+)
hermes proxy提供相容於OpenAI的本機端點,後端使用Hermes已登入的OAuth供應商——Claude Pro、ChatGPT Pro、SuperGrok或其他已設定的相容供應商。19這表示需要OpenAI風格API的工具,包括Codex CLI、Aider、Cline、Continue或自訂指令碼,都能重複使用Hermes透過訂閱取得的驗證資訊,無須另備API金鑰。請將此代理伺服器視為本機開發基礎設施:審慎設定繫結位址,避免廣泛開放存取,並留意各供應商的使用條款。
上下文長度偵測
上游文件指出,以下2項設定經常被混淆:2
context_length——上下文視窗總長度(輸入與輸出合計的token額度,例如Claude Opus 4.7為1,000,000,Sonnet 4.6為200,000)。Hermes據此判斷何時壓縮歷史紀錄。model.max_tokens——輸出上限(模型單次回應可產生的最大token數)。與歷史紀錄長度無關。
若自動偵測的視窗大小有誤,請設定context_length:
model:
default: "qwen3.5:9b"
base_url: "http://localhost:8080/v1"
context_length: 131072 # tokens
Hermes依循多來源解析鏈偵測上下文視窗:設定覆寫 → 自訂供應商的個別模型設定 → 持久化快取 → 端點的/models → Anthropic /v1/models → OpenRouter API → Nous Portal → models.dev(由社群維護、收錄超過3800個模型的登錄目錄)→ 備援預設值(128K)。2系統會考量供應商差異,因此同一模型可能因提供服務的供應商不同而有不同的上下文限制(例如,claude-opus-4.6在Anthropic直連服務上為1M,在GitHub Copilot上則為128K)。2
智慧模型路由:供應商輪替與備援
Hermes不會將您綁定在單一供應商的單一模型上。智慧模型路由是一組 決定由哪個供應商與模型實際處理特定請求的機制:憑證 集區將負載分散至多組金鑰,主供應商失敗時由已設定的備援接手, 下方的輔助槽位則將支線任務路由至成本較低的模型,與主模型 各自獨立運作。26請一併設定這3項機制——它們決定了代理程式 遇到速率限制時,是停滯不前,還是繼續運作。
憑證集區。若持有同一供應商的多組API金鑰,請透過hermes auth設定輪替策略,讓請求分散使用多組金鑰的速率配額。6
備援模型。設定備用的provider:model,讓Hermes在主要模型失敗時(速率限制、伺服器錯誤、驗證失敗)自動切換:2
fallback_model:
provider: openrouter # required
model: anthropic/claude-sonnet-4 # required
# base_url: http://localhost:8000/v1 # optional, for custom endpoints
# api_key_env: MY_CUSTOM_KEY # optional, env var name
備援機制會在工作階段中途切換模型與供應商,同時保留對話內容。每個工作階段最多觸發1次。2支援備援的供應商:openrouter、nous、openai-codex、copilot、copilot-acp、anthropic、huggingface、zai、kimi-coding、minimax、minimax-cn、deepseek、ai-gateway、opencode-zen、opencode-go、kilocode、alibaba、custom。2
輔助模型
Hermes使用「輔助」模型處理周邊任務:影像分析(視覺)、危險指令核准分類、上下文壓縮、工作階段標題產生、TTS音訊標籤插入、skill比對、MCP工具分派、Kanban規格定義/拆解系列任務,以及自v0.21.6起加入的語音回合(auxiliary.voice_chat,預設以較快的模型搭配reasoning_effort: none處理語音回合;若請求超出語音模型的壓縮門檻,則保留主要模型)。43455預設情況下(auxiliary.*.provider: "auto"),所有輔助任務都使用您的主要聊天模型執行——也就是您在hermes model中選擇的供應商/模型。文件明確說明,這項行為已取代舊有的低價供應商自動偵測機制:「早期版本會將聚合平台使用者(OpenRouter、Nous Portal)的輔助任務分派至供應商端的低價預設模型。這種行為令人意外……現在,所有使用者的auto都會使用主要模型,而config.yaml中的個別任務覆寫設定仍有優先權。」34無須設定即可開始使用;取捨在於成本——若使用昂貴的推理模型,輔助任務會增加可觀的費用,因此若在意成本,建議將個別任務指定給便宜、快速的模型。
先前的2項輔助任務已完全不再使用LLM:網頁擷取(「web_extract與瀏覽器快照會依確定性規則截斷長篇內容,並儲存全文,供read_file分頁讀取——完全不涉及LLM」)和工作階段搜尋(採用單一格式的工具會直接傳回資料庫內容)。舊有的auxiliary.web_extract.*與auxiliary.session_search.*區塊已從預設設定中移除——現有config.yaml中的殘留值屬於「無害的殘留設定,會予以忽略」——而該版本標籤的預設設定中也沒有flush_memories設定項目。34
您可以設定各項輔助任務使用的模型與供應商。所有輔助任務設定項目都使用相同的參數:provider、model、base_url(另有api_key、timeout、extra_body,以及各任務專屬的reasoning_effort)。434
auxiliary:
vision: # vision_analyze + browser screenshots
provider: "auto" # "auto" (= main model), "openrouter", "nous", "main", etc.
model: "" # e.g. "openai/gpt-4o", "google/gemini-2.5-flash"
base_url: "" # Custom OpenAI-compatible endpoint
api_key: "" # Falls back to OPENAI_API_KEY
timeout: 120
download_timeout: 30
approval: # dangerous-command approval classifier
provider: "auto"
model: ""
timeout: 30
compression: # summarizer -- legacy compression.summary_* keys migrate here (config v17)
provider: "auto"
model: ""
base_url: ""
timeout: 120
title_generation: # auto-generated session titles after the first exchange
enabled: true # set false to disable auto-titles
provider: "auto"
model: ""
language: "" # empty follows the conversation; e.g. "English" pins titles to one language
tts_audio_tags: { provider: "auto", model: "" } # Gemini 3.1 TTS hidden audio-tag insertion
skills_hub: { provider: "auto", model: "" } # skill matching and search
mcp: { provider: "auto", model: "" } # MCP tool dispatch
triage_specifier: { provider: "auto", model: "" } # hermes kanban specify: rough one-liner into a concrete spec, promoted to todo
kanban_decomposer: { provider: "auto", model: "" } # hermes kanban decompose: triage task into a graph of child tasks routed to specialist profiles
profile_describer: { provider: "auto", model: "" } # hermes profile describe --auto: 1-2 sentence profile descriptions
其他專門用途的設定項目也採用相同結構——goal_judge(判斷是否滿足/goal約定條件)、curator(審查skill使用情況的分支)、background_review(回合結束後自我改進的分支)、review(/review的審查子代理)、moa_reference與moa_aggregator(Mixture-of-Agents)、memory_query_rewrite,以及monitor——而且完全不必手動編輯YAML:執行hermes model並選擇「設定輔助模型」,即可透過互動式選單逐項設定任務。34
"main"供應商選項表示「使用主要代理目前使用的供應商」——僅限用於auxiliary:、compression:及主要模型的備援項目(fallback_providers:,或舊版的fallback_model:)。它不適用於最上層的model.provider設定。若主要模型使用自訂的OpenAI相容端點,請在model:區段中設定provider: custom。4
這為何重要:由於auto已使用主要模型,過去「若未設定OpenRouter,輔助任務就會在未提示的情況下退化」的陷阱已不復存在——如今需要權衡的是成本。若主要模型是昂貴的推理模型,請將頻繁呼叫模型的周邊任務分派給便宜、快速的模型:
auxiliary:
vision:
provider: "openrouter"
model: "google/gemini-2.5-flash"
compression:
provider: "openrouter"
model: "google/gemini-2.5-flash"
設定系統
Hermes採用分層設定系統。瞭解各層的優先順序至關重要,因為較高層會覆寫較低層的設定。其中一層是全域供應商登錄表,無法在config.yaml中查看。
設定檔配置
根據上游文件,Hermes的設定由下列檔案組成:4
~/.hermes/
├── config.yaml # All settings (model, terminal, TTS, compression, memory, toolsets, ...)
├── .env # Secrets (API keys, bot tokens, passwords)
├── auth.json # OAuth provider credentials (Nous Portal, Codex, Anthropic)
├── SOUL.md # Primary agent identity (slot #1 in system prompt)
├── memories/ # Persistent memory (MEMORY.md, USER.md)
├── skills/ # Bundled + agent-created + hub-installed skills
├── cron/ # Scheduled jobs
├── sessions/ # Gateway session state
└── logs/ # agent.log, gateway.log, errors.log (secrets auto-redacted)
config.yaml與.env——兩者皆有設定時,非機密設定以config.yaml為準。4規則如下:
- 機密資訊(API金鑰、機器人權杖、密碼)→ .env
- 其餘設定(模型、終端機後端、壓縮設定、記憶上限、toolset)→ config.yaml
在config.yaml中,可透過shell風格的插值語法參照機密資訊:4
auxiliary:
vision:
api_key: ${GOOGLE_API_KEY}
base_url: ${CUSTOM_VISION_URL}
delegation:
api_key: ${DELEGATION_KEY}
管理設定
hermes config # View current configuration
hermes config show # Same as above
hermes config edit # Open config.yaml in your editor
hermes config set KEY VAL # Set a specific value
hermes config get KEY # Print a single value (v0.19.0+)
hermes config unset KEY # Remove a key so the default applies again (v0.19.0+)
hermes config path # Print the config file path
hermes config env-path # Print the .env file path
hermes config check # Check for missing options (after updates)
hermes config migrate # Interactively add missing options
範例:4
hermes config set model anthropic/claude-opus-4
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-... # Saves to .env
每次執行hermes update後,都應執行hermes config check與hermes config migrate,以找出設定檔中尚未包含的新增設定選項。6
設定優先順序
Hermes會從多個來源載入設定。多個來源設定同一個值時,以優先順序較高的來源為準:4
- CLI引數——
hermes chat --model anthropic/claude-sonnet-4(僅覆寫本次呼叫的設定) - 環境變數——於程序啟動時套用
config.yaml——主要設定檔.env——僅存放機密資訊- 內建預設值——其他來源皆未設定時套用
CLI旗標在該次呼叫中一律優先。長期設定則以config.yaml為準。
在地化(v0.13.0+)
v0.13.0為CLI與gateway訊息新增了7種語系:簡體中文、日文、德文、西班牙文、法文、烏克蘭文及土耳其文。18v0.14.0將在地化範圍擴及所有gateway命令與網頁儀表板,並新增8種語系,使總數達到16種。19在v2026.8.31標籤版本中,locales/目錄樹包含17份訊息目錄——英文加上16種翻譯(af、ar、de、es、fr、ga、hu、it、ja、ko、pt、ru、tr、uk、zh-hant、zh)。33文件目前僅提供zh-Hans在地化版本。語系由LC_ALL/LANG環境變數,或config.yaml中明確指定的locale:設定鍵決定。英文仍為預設語言,尚未翻譯的字串也以英文為準。v0.21.6讓語言支援可透過外掛擴充:display.language接受隨附的17份訊息目錄、profile的覆疊目錄,或已安裝的外掛語言套件所提供的任何識別碼。hermes config set display.language <id>會先執行外掛探索,因此能辨識剛安裝的語言套件;核心與TUI字串分屬不同層(locales/<lang>.yaml與locales/<lang>.tui.yaml,該標籤版本包含16個TUI語言套件)。55
profile——多個彼此隔離的Hermes執行個體
profile讓您擁有多個彼此隔離的Hermes執行個體,各自具備獨立的設定、工作階段、skill、記憶與gateway PID。如此即可同時執行「工作用Hermes」與「個人用Hermes」,彼此無法存取對方的狀態。6
自v0.22.0起,每台機器上的所有profile共用一個訊息gateway與一個桌面後端。若無衝突,hermes update會將現有各profile的gateway整併為此預設配置;hermes gateway status會說明拒絕整併的原因;hermes gateway migrate --multiplex則可手動執行遷移。gateway.standalone: true可暫時停用此行為,但原始碼將其標示為相容性介接層,而非受支援的拓撲。5859v0.22.2修正了受程序管理工具(systemd、launchd、Docker)監管的gateway在重新開機後拒絕啟動的問題:被重新使用的PID可能遭誤判為仍在執行的gateway。Hermes現在會記錄啟動時所屬的系統開機識別資訊,無法判定時則以主機鎖定機制為準。62
hermes profile list
hermes profile create work --clone # Clone from current profile
hermes profile use work # Set sticky default
hermes profile alias work --name h-work # Create wrapper script
hermes profile export work -o work-backup.tar.gz
hermes profile import work-backup.tar.gz --name restored
hermes -p work chat -q "Hello from work profile" # One-off without switching
每個profile都有專屬的HERMES_HOME(預設為~/.hermes-<name>/),因此多個profile可同時執行gateway,互不干擾。63
自v0.21.2起,隔離邊界的落實更加嚴格:一系列修正堵住了多工gateway配置中實際存在的跨profile洩漏漏洞。這些漏洞可能讓次要profile沿用預設profile的允許清單、將憑證傳送至預設profile的主機、將預設profile保管庫中的機密資訊交給stdio MCP伺服器,或將另一個profile的.env/auth.json/state.db附加至MEDIA:傳送內容(#107609-#107630)。若您透過多工方式執行多個profile,v0.21.2才是真正落實隔離承諾的標籤版本——請參閱v0.21.2的新功能。48
CLI指令
本節提供實務使用者查閱頂層CLI指令。以程式碼為依據的權威參考資料,請參閱上游的CLI指令參考。6
全域選項
hermes [global-options] <command> [subcommand/options]
| 選項 | 說明 |
|---|---|
--version, -V |
顯示版本後結束 |
--profile <name>, -p <name> |
選擇要使用的Hermes profile |
--resume <session>, -r <session> |
依ID或標題繼續工作階段 |
--continue [name], -c [name] |
繼續最近的工作階段(或比對標題) |
--worktree, -w |
在獨立的git worktree中啟動 |
--in <dir> |
啟動或繼續前先切換至DIR。搭配--resume latest或-c時,會選取DIR工作區最近的工作階段,並讓工作階段留在DIR(略過還原已記錄工作目錄的步驟)27 |
--ignore-user-config |
忽略~/.hermes/config.yaml,改用內建預設值(仍會載入.env中的憑證)27 |
--ignore-rules |
略過自動注入AGENTS.md、SOUL.md、.cursorrules、記憶及預先載入的skill27 |
--tui |
啟動現代TUI,取代傳統REPL27 |
--cli |
強制使用傳統prompt_toolkit REPL(覆寫display.interface=tui)27 |
--dev |
搭配--tui:透過tsx執行TypeScript原始碼(略過dist建置)27 |
--yolo |
略過危險指令的核准提示 |
--safe-mode |
疑難排解旗標——以最精簡的安全模式啟動Hermes,協助釐清啟動問題(v0.19.0+)70 |
--pass-session-id |
在代理的系統提示中加入工作階段ID |
頂層指令
| 指令 | 用途 |
|---|---|
hermes chat |
互動式或單次聊天 |
hermes model |
以互動方式選擇預設供應商與模型 |
hermes gateway |
執行或管理訊息gateway |
hermes setup |
互動式設定精靈 |
hermes auth |
管理憑證——新增、列出、移除、重設及設定策略 |
hermes status |
顯示代理、驗證及平台狀態;自v0.21.6起預設顯示單一畫面的摘要,使用--full(或--all)顯示所有區段,使用--deep執行耗時較長的檢查 |
hermes cron |
檢視cron排程器並觸發排程檢查;hermes cron cancel可停止執行中的工作(v0.22.6發布期間)67 |
hermes webhook |
管理動態webhook訂閱 |
hermes doctor |
診斷設定與相依套件問題 |
hermes dump |
產生可複製貼上的設定摘要,供技術支援與偵錯使用 |
hermes logs |
檢視、持續追蹤及篩選代理/gateway/錯誤日誌 |
hermes config |
顯示、編輯、遷移及查詢設定 |
hermes pairing |
核准或撤銷訊息配對碼 |
hermes skills |
瀏覽、安裝、發布及稽核skill |
hermes honcho |
管理Honcho跨工作階段記憶。此指令是否可用取決於外掛:文件指出「外掛專屬子指令(例如hermes honcho)會在其供應商啟用時自動註冊」,因此除非Honcho是目前啟用的記憶供應商,否則hermes --help不會列出此指令6 |
hermes memory |
設定外部記憶供應商 |
hermes acp |
將Hermes作為ACP伺服器執行(編輯器整合) |
hermes mcp |
管理MCP伺服器設定;將Hermes作為MCP伺服器執行;自v0.22.5發布期間起,將Hermes本身作為MCP伺服器執行的功能改由mcp-serve外掛提供(先執行hermes plugins install mcp-serve,再執行hermes mcp-serve;MCP用戶端須將引數改為["mcp-serve"])65 |
hermes plugins |
管理外掛;hermes plugins update提供所有可用的外掛更新(v0.22.3發布期間)64 |
hermes tools |
設定各平台啟用的工具 |
hermes sessions |
瀏覽、匯出、清理及刪除工作階段。v0.19.0擴充hermes sessions export,支援Markdown、Quarto、HTML、僅含提示及Hugging Face追蹤記錄格式,並提供可選用的--redact機密資訊清除處理,以及依存留時間/工作區/平台篩選的功能70;hermes sessions recover會從損壞的state.db重建正式工作階段資料,寫入另一個全新資料庫,全程離線且不破壞原始資料。使用--inspect-only可回報正式資料表的可讀性,而不建立資料庫(v0.21.2指引的復原方式)48;hermes sessions set-journal-mode delete\|wal(v0.21.4發布期間)可離線將資料儲存區在WAL與復原日誌模式之間轉換——只要有其他程序持有資料庫或附屬檔案,就會拒絕執行;轉換時不會等待開啟檔案的程序釋放資源,完成後會驗證SQLite標頭的第18/19位元組,並接受--db以指定非預設資料儲存區。請先停止gateway、儀表板及所有CLI;Windows沒有資源持有者掃描機制,因此指令會拒絕執行,直到您自行停止所有Hermes程序後傳入--force。此指令刻意採用離線分派,確保不會開啟正在轉換的資料儲存區,且hermes doctor現在也會引導使用此指令51 |
hermes insights |
顯示token/費用/活動分析 |
hermes usage |
不啟動工作階段,直接顯示已設定帳戶的速率限制時間區間(/usage區塊);指令碼可使用--json(v0.22.0)59 |
hermes claw |
OpenClaw遷移輔助工具;在v0.22.5發布期間從核心移至agent-importers外掛,保留hermes claw migrate指令名稱,並新增hermes claw cleanup65 |
hermes profile |
管理profile(多個獨立執行個體) |
hermes completion |
輸出shell自動補齊指令碼(bash/zsh) |
hermes whatsapp |
設定並配對WhatsApp橋接器 |
hermes --version (-V) |
輸出版本資訊。這是全域旗標,並非子指令:在標籤v2026.8.31中,_BUILTIN_SUBCOMMANDS集合沒有version項目,啟動快速路徑也只比對--version/-V27 |
hermes update |
更新從原始碼安裝的版本並重新安裝相依套件;自v0.21.7起,官方儲存庫的簽出副本會追蹤最新發布版本(使用--set-channel main追蹤每次提交,--channel <name>僅套用於當次執行,--install-id輸出此安裝的ID) |
hermes pm |
所有受管理安裝共用的統一套件管理器(v0.22.0):doctor依鎖定檔檢查安裝狀態,status輸出最新同步回執,repair重建相依套件環境,gc移除無任何參照的儲存項目59;自v0.22.6發布期間起支援續傳下載(版本說明所述)66 |
hermes uninstall |
從系統移除Hermes(--full也會刪除設定/資料) |
hermes backup |
完整備份設定、工作階段、skill及記憶(v0.9.0+)16 |
hermes import |
從備份封存檔還原——用於跨機器遷移或回復(v0.9.0+)16 |
hermes dashboard |
啟動本機網頁儀表板,透過瀏覽器管理代理(v0.9.0+)16 |
hermes webapp |
在瀏覽器中開啟Hermes Desktop工作區:當webapp.enabled為true時由gateway提供服務,視需要建置,並透過一次性登入連結開啟;--no-open、--status、--build-only(v0.22.6發布期間)67 |
hermes vault |
本機憑證保管庫;hermes vault key顯示保管庫金鑰的存放位置,hermes vault key migrate --to keychain(或--to file)則在vault.key與作業系統鑰匙圈之間搬移金鑰(vault.key_storage,v0.22.6發布期間)67 |
hermes serve |
以無介面模式執行後端API伺服器——自v0.19.0起,不再建置或掛載網頁介面70 |
hermes debug share |
將完整偵錯報告上傳至文字貼上分享服務,方便在疑難排解時分享(v0.9.0+)16 |
hermes approvals |
核准提示工具:suggest從核准歷程中整理出command_allowlist建議;test模擬判定指令是否獲准,而不執行指令(「絕不執行指令」,支援--backend與--json)。v0.21.0版本說明將此模擬執行功能稱為hermes approval-check,但標籤v2026.8.31中並不存在approval-check子指令——實際指令為hermes approvals test2740 |
hermes bundles |
建立、列出及管理skill套組(以單一/<name>斜線指令作為多個skill的別名)27 |
hermes checkpoints |
檢視/清理/清空~/.hermes/checkpoints/,即/rollback背後的影子儲存區;不帶引數執行可查看狀態總覽27 |
hermes computer-use |
管理Computer Use(cua-driver)後端(macOS/Windows/Linux)27 |
hermes console |
開啟安全的Hermes指令主控台27 |
hermes curator |
背景skill維護(curator):狀態、執行、暫停、固定27;自v0.22.6發布期間起新增lock與unlock(已鎖定的skill,代理無法變更)67 |
hermes egress |
管理遠端終端機沙箱使用的iron-proxy對外連線憑證注入防火牆(預設停用)27 |
hermes fallback |
管理備援供應商,在主要模型失敗時依序嘗試27 |
hermes hooks |
檢視及管理shell指令碼掛鉤:list、test <event>、revoke及doctor(執行權限位元、允許清單、mtime偏移、JSON有效性、模擬執行耗時)27 |
hermes import-agent |
將Claude Code(~/.claude)或Codex CLI(~/.codex)設定匯入Hermes27;自v0.22.5發布期間起由agent-importers外掛提供,現在也支援Cursor(~/.cursor)與OpenClaw,一律先預覽並在套用前詢問,使用--sync可重新匯入已變更的來源;hermes setup偵測到其他代理時會提供安裝此外掛的選項65 |
hermes desktop(別名gui) |
建置並啟動原生Electron桌面應用程式27 |
hermes kanban |
多profile協作看板(任務、連結、留言),提供多個看板、群體協作圖(swarm:平行工作代理→驗證代理→彙整代理)及分派器27 |
hermes login / hermes logout |
已棄用。請使用hermes auth管理憑證、hermes model選擇供應商,或使用hermes setup完成完整設定27 |
hermes lsp |
語言伺服器協定管理:status、list、install <server>、install-all及restart(關閉執行中的LSP用戶端;下次編輯時會重新啟動)27 |
hermes migrate |
遷移已退役模型或已棄用設定的組態27;自v0.22.6發布期間起,hermes migrate <agent>會在缺少agent-importers外掛時先安裝,再執行hermes import-agent <agent>(Claude Code、Codex、Cursor、OpenClaw、Grok Bot、OpenBot),hermes migrate xai則會改寫xai參照67 |
hermes moa |
設定Mixture of Agents供應商/模型欄位(可從模型選擇器選取具名預設組合)27 |
hermes journey(別名learning、memory-graph) |
依時間顯示已學習skill與記憶的時間軸27 |
hermes monitoring |
檢視gateway監控(健康狀態與診斷匯出);status顯示設定、匯出狀態及敏感資訊遮蔽情況27 |
hermes pause / hermes resume |
緊急停止:pause暫停cron/kanban分派及新的gateway對話回合;resume解除暫停27 |
hermes peer |
跨機器的機器人私訊:以add、list、remove新增、列出及移除對等Hermes gateway,並透過dm私訊其中的代理,輸出其回覆27 |
hermes pets |
瀏覽、安裝及選取petdex動畫寵物27 |
hermes portal |
設定Nous Portal(登入、模型選擇、Tool Gateway):login(預設)、info、open、tools;請參閱Nous Tool Gateway2728 |
hermes connectors |
透過Nous工具gateway管理託管應用程式連接器及其帳戶(v0.22.0),包括同一應用程式的多個具名帳戶;聊天中的對應指令為/connectors59 |
hermes project |
管理專案(具名、涵蓋多個資料夾的工作區):建立、列出、顯示、新增/移除資料夾、重新命名、設定主要資料夾、使用、封存、還原及繫結kanban看板27 |
hermes proxy |
連接OAuth供應商的本機OpenAI相容代理服務:start、status、providers27 |
hermes prompt-size |
顯示系統提示與工具結構描述的位元組用量明細;離線執行27 |
hermes send |
向已設定的平台傳送訊息,不啟動代理迴圈,也不使用LLM(適用於指令碼、cron工作、CI)27 |
hermes skin |
列出、切換及調整外觀主題(list、use、set)27 |
hermes slack |
Slack整合輔助工具:manifest輸出或寫入Slack應用程式資訊清單,將每個gateway指令註冊為原生斜線指令27 |
hermes sync |
跨裝置及團隊的skill同步:status、pull、push、now、enable、disable、device、propose27 |
hermes whatsapp-cloud |
設定WhatsApp Business Cloud API整合(與hermes whatsapp的Baileys個人帳戶橋接器不同)27 |
hermes worktree |
稽核並清理累積的git worktree與已合併分支。list(別名ls、audit;預設指令)依存留時間、大小、判定結果及原因分類每個工作樹;prune移除可安全刪除的工作樹,並刪除已完全合併的本機分支。兩者皆接受--repo <root>;prune另提供--dry-run(顯示計畫但不做任何變更)、--trees-only及--branches-only。此指令絕不刪除已追蹤但尚未提交的變更、未推送的獨有提交,或使用中的工作樹;僅含未追蹤檔案的暫存內容會先封存至~/.hermes/archive/worktree-prune/,再予以移除27 |
hermes secrets |
管理外部機密來源(Bitwarden、1Password),以便在程序啟動時取得API金鑰27 |
hermes security |
對venv、外掛及MCP伺服器執行供應鏈稽核(OSV.dev)(audit)27 |
hermes verify |
偵測專案的執行方式並進行冒煙測試27 |
hermes chat——主要進入點
不帶引數執行hermes會進入互動式聊天。hermes chat則是可明確指定選項的形式:6
hermes chat -q "Summarize the latest PRs" --oneshot # Answer and exit (without --oneshot, a TTY seeds an interactive session)
hermes chat --provider openrouter --model anthropic/claude-sonnet-4.6
hermes chat --toolsets web,terminal,skills # Enable specific toolsets
hermes chat --quiet -q "Return only JSON" # Programmatic mode
hermes chat --worktree -q "Review repo and open a PR"
主要選項:
| 選項 | 說明 |
|---|---|
-q, --query "..." |
要執行的查詢。v0.21.0有所變更:在真正的TTY上,現在會以此查詢開啟互動式工作階段(將原文提交為第一個回合);搭配--oneshot或-Q,或在非TTY環境中,則會在回答後結束——即原本的單次執行行為40 |
--query-file PATH |
從檔案讀取單一查詢,而非從命令列讀取(-表示讀取stdin)。內容不經shell解析,因此引號、$(...)及反引號都會原樣傳入;不可與-q同時使用51 |
--oneshot |
搭配-q/--query-file:回答查詢後結束(原有的單一查詢行為)。使用非TTY標準輸入輸出或-Q/--quiet時會自動啟用40 |
-m, --model <model> |
覆寫本次執行使用的模型 |
-t, --toolsets <csv> |
啟用以逗號分隔的一組toolset |
--provider <provider> |
強制指定供應商(請參閱完整清單) |
-s, --skills <name> |
為此工作階段預先載入一個或多個skill |
-v, --verbose |
詳細輸出 |
-Q, --quiet |
程式化模式(不顯示橫幅、載入動畫或預覽) |
--format <fmt> |
單一查詢模式(-q或--query-file)的輸出格式:text(預設)以純文字輸出最終回覆;stream-json輸出以換行分隔的JSON事件(JSONL)——依序為system/init事件、text增量、tool_use/tool_result事件,最後是一個包含結束代碼、最終文字及token統計資料的result結尾封裝。stream-json會自動啟用--quiet,必須搭配-q或--query-file(缺少時以代碼2結束),且不可與--tui同時使用;診斷資訊與工作階段ID仍輸出至stderr,每個事件的工具輸出上限為5,000個字元(v0.21.4發布期間)51 |
--resume <session> |
直接從chat繼續工作階段 |
--worktree |
建立獨立的git worktree |
--checkpoints |
在破壞性變更前建立檔案系統checkpoint |
--yolo |
略過核准提示 |
--source <tag> |
工作階段來源標籤(預設:cli;整合用途請使用tool) |
--max-turns <N> |
每個對話回合的工具呼叫迭代次數上限(自v0.20.0起預設為500,或採用設定中的agent.max_turns)40 |
hermes setup——完整精靈
執行完整設定精靈,或直接進入特定區段:6
hermes setup # Full wizard
hermes setup model # Provider and model only
hermes setup terminal # Terminal backend only
hermes setup gateway # Messaging platforms only
hermes setup tools # Tool enable/disable per platform
hermes setup agent # Agent behavior only
hermes setup --non-interactive
hermes setup --reset # Reset config to defaults before setup
hermes logs——結構化日誌查詢
hermes logs比對日誌檔案執行tail -f更強大,因為它支援同時依層級、工作階段ID及時間範圍篩選。6
hermes logs # Last 50 lines of agent.log
hermes logs -f # Follow in real time
hermes logs gateway -n 100 # Last 100 lines of gateway.log
hermes logs --level WARNING --since 1h # Warnings from the last hour
hermes logs --session abc123 # Filter by session ID substring
hermes logs errors --since 30m -f # Follow errors.log from 30m ago
hermes logs list # List all log files with sizes
日誌檔案位於~/.hermes/logs/:6
- agent.log——所有代理活動(API呼叫、工具分派、工作階段生命週期、INFO以上層級)
- errors.log——僅包含警告與錯誤(agent.log經篩選後的子集)
- gateway.log——訊息gateway活動(平台連線、分派、webhook)
日誌會透過Python的RotatingFileHandler自動輪替——可查看agent.log.1、agent.log.2等檔案。6
hermes doctor——診斷
發生問題時,應先執行hermes doctor [--fix]。此指令會檢查設定是否有效、相依套件是否存在、API金鑰是否可用及服務狀態,並可透過--fix嘗試自動修復。6
若需與他人分享診斷資訊,請使用hermes dump——它會產生精簡的純文字摘要,並遮蔽API金鑰,可直接貼到GitHub議題或Discord討論串中。6
斜線指令
斜線指令可在進行中的對話工作階段(CLI或訊息平台)內執行。這些指令由hermes_cli/commands.py中共用的COMMAND_REGISTRY分派,因此大多數指令在各種介面上的運作方式都相同。9
工作階段控制
| 指令 | 說明 |
|---|---|
/new(別名/reset) |
開始新的工作階段 |
/clear |
清除畫面並開始新的工作階段 |
/history |
顯示對話紀錄 |
/save |
儲存目前的對話 |
/retry |
重試上一則訊息 |
/undo |
移除上一輪使用者與助理的對話 |
/title <name> |
設定目前工作階段的標題 |
/compress |
手動壓縮對話上下文 |
/rollback [number] |
列出或還原檔案系統checkpoint |
/stop |
終止所有執行中的背景程序 |
/status |
顯示工作階段、模型、token與上下文資訊——自v0.20.5版本更新期間起,也會顯示推理模式、待核准項目與上下文使用量4035 |
/queue <prompt> |
將提示詞排入佇列,供下一輪使用。注意:/queue與/quit都註冊了/q;後註冊的指令優先,實際上/q會解析為/quit,因此請務必完整輸入/queue。9 |
/resume [name] |
繼續先前已命名的工作階段 |
/statusbar(別名/sb) |
切換上下文/模型狀態列的顯示 |
/background <prompt>(別名/bg) |
在獨立的背景工作階段中執行提示詞 |
/btw <question> |
提出臨時的額外問題(不使用工具、不儲存) |
/plan [request] |
載入內附的plan skill,撰寫計畫而非直接執行 |
/branch [name](別名/fork) |
為目前的工作階段建立分支 |
/goal <target> |
讓代理鎖定目標,在多輪互動中持續專注於任務。將Ralph迴圈模式納為原生基本功能,可設定回合數上限。v0.13.0新增。18 |
/subgoal <criterion> |
為進行中的/goal新增成功條件,無須重新啟動迴圈。v0.14.0新增。19 |
/handoff <target> |
將進行中的工作階段,包括訊息、工具呼叫與上下文,移交給另一個模型、角色或profile。v0.14.0新增。19 |
/worktree [new [name]\|list\|prune [--dry-run]] |
無須離開工作階段,即可檢視、建立或回收獨立的git工作樹。new會在儲存庫的.worktrees/下建立工作樹,並將工作階段移至其中;list會列出工作樹;prune與hermes worktree prune採用相同的人工監督回收流程,且根據文件說明,「絕不會動到工作階段目前執行所在的工作樹」27 |
設定與模型
| 指令 | 說明 |
|---|---|
/config |
顯示目前的設定 |
/model [model-name] |
顯示或變更目前的模型;/model reset會移除聊天的覆寫設定並回到profile設定的模型(gateway與Desktop聊天,v0.22.6發布期間)67 |
/provider |
顯示可用的供應商與目前使用的供應商 |
/personality [name] |
設定附加的個性設定 |
/verbose |
循環切換工具進度的顯示方式 |
/reasoning |
管理推理強度與顯示方式。v0.19.0新增max與ultra強度等級,並將/reasoning的作用範圍限於目前工作階段,同時支援在設定中針對個別模型與各個MoA槽位覆寫推理強度70 |
/skin |
顯示或變更介面外觀/佈景主題 |
/voice [on\|off\|tts\|status] |
切換CLI語音模式 |
/yolo |
切換YOLO模式(略過核准提示)。自v0.19.0起,即使處於YOLO模式,使用者自訂的拒絕規則仍會封鎖符合條件的指令70 |
/fast |
切換快速模式——為OpenAI與Anthropic模型提供優先處理(v0.9.0以上)16 |
/debug |
在所有平台上執行快速診斷(v0.9.0以上)16 |
/subscription |
從終端機管理Nous Portal方案——檢視方案與剩餘額度、預覽升級/降級費用,以及套用變更並支援復原(v0.19.0以上)70 |
/topup |
無須離開終端機,即可為Nous Portal餘額加值(v0.19.0以上)70 |
/model是在工作階段進行中切換供應商的主要指令:9
/model # Show current model and options
/model claude-sonnet-4 # Switch model (auto-detect provider)
/model zai:glm-5 # Switch provider:model
/model custom:qwen-2.5 # Use model on custom endpoint
/model custom # Auto-detect model from custom endpoint
/model custom:local:qwen-2.5 # Named custom provider
/model openrouter:anthropic/claude-sonnet-4 # Back to cloud
v0.19.0新增/model --once,可僅在單一回合中覆寫模型,回覆後便會自動切回先前的模型。70自v0.20.5版本更新期間起,/model選擇器也支援模糊比對,會隨著輸入即時篩選。2335
工具、skill與資訊
| 指令 | 說明 |
|---|---|
/tools [list\|disable\|enable] [name...] |
管理目前工作階段的工具 |
/toolsets |
列出可用的toolset |
/browser [connect\|disconnect\|status] |
管理本機Chrome CDP連線 |
/skills |
搜尋、安裝、檢視或管理skill |
/cron |
管理排程任務 |
/reload-mcp |
從config.yaml重新載入MCP伺服器 |
/connectors |
開啟連接器面板:將託管應用程式與您的MCP伺服器整合至同一份清單,並可逐一登入各應用程式(v0.22.0)59 |
/plugins |
列出已安裝的外掛程式 |
/help |
顯示所有指令 |
/usage |
顯示token使用量、費用與耗時 |
/insights |
顯示使用情形分析(最近30天) |
/platforms |
顯示訊息平台狀態 |
/profile |
顯示目前啟用的profile名稱與主目錄 |
/palette |
開啟支援模糊搜尋的指令面板(也可按Ctrl+P)——可模糊搜尋所有指令與skill。於v0.20.5版本更新期間推出4035 |
動態skill斜線指令
每個已安裝的skill都會自動成為可呼叫的斜線指令:9
/gif-search funny cats
/axolotl help me fine-tune Llama 3 on my dataset
/github-pr-workflow create a PR for the auth refactor
/excalidraw # Just the skill name loads it and lets the agent ask what you need
自v0.19.0起,以斜線指令呼叫skill時可疊加使用:/skill-a /skill-b do XYZ會在單一回合中依序載入兩個skill,並為串接的名稱提供自動完成與灰字提示。70
也能在config.yaml中定義快捷指令,將簡短名稱對應至較長的提示詞:9
quick_commands:
review: "Review my latest git diff and suggest improvements"
deploy: "Run the deployment script at scripts/deploy.sh and verify the output"
morning: "Check my calendar, unread emails, and summarize today's priorities"
接著在CLI中輸入/review、/deploy或/morning即可。
前綴比對
指令支援前綴比對:輸入/h會解析為/help,/mod會解析為/model。若前綴可對應多個指令,則以登錄順序中最先註冊的指令為準。完整指令名稱與已註冊的別名,一律優先於前綴比對。9
訊息平台專用指令
部分指令僅適用於訊息平台(Telegram、Discord、Slack、WhatsApp、Signal、電子郵件、Home Assistant):9
/status——顯示工作階段資訊(已不再限於訊息平台;請參閱工作階段控制)/sethome(別名/set-home)——將目前的對話設為平台的主要對話/approve [session|always]——核准待處理的危險指令/deny [reason]——拒絕待處理的危險指令。自v0.19.0起,/deny <reason>會將拒絕理由傳達給代理,讓其調整做法,避免盲目重試70/update——將Hermes Agent更新至最新版本/commands [page]——瀏覽所有指令與skill(分頁顯示)
另有部分指令僅適用於CLI:/skin、/tools、/toolsets、/browser、/config、/cron、/skills、/platforms、/paste、/statusbar、/plugins。9
工具與toolset
Hermes內建豐富的工具登錄機制,涵蓋網頁搜尋、瀏覽器自動化、終端機執行、檔案編輯、記憶、委派、RL訓練、訊息傳送、Home Assistant整合等功能。10工具依用途組成不同的toolset,可針對各平台啟用或停用。
主要分類
| 分類 | 範例 | 說明 |
|---|---|---|
| 網頁 | web_search, web_extract |
搜尋網頁並擷取頁面內容 |
| 終端機與檔案 | terminal, process, read_file, patch |
執行指令與操作檔案 |
| 瀏覽器 | browser_navigate, browser_snapshot, browser_vision |
結合文字與視覺的互動式瀏覽器自動化 |
| 媒體 | vision_analyze, video_analyze, video_generate, image_generate, text_to_speech |
多模態分析與生成。video_analyze優先採用Gemini,並可擴充支援相容的多模態供應商(v0.13.0+)。v0.14.0新增統一的video_generate,支援可抽換的供應商後端;當使用中的模型具備視覺能力時,會透過vision_analyze傳送原始像素資料。1819 |
| 代理協調 | todo, clarify, execute_code, delegate_task |
規劃、釐清需求、執行程式碼、委派子代理 |
| 電腦操作 | computer_use |
透過cua-driver後端控制桌面;v0.14.0讓此功能也能搭配Anthropic以外、具備視覺能力的供應商使用。19 |
| 記憶與回溯 | memory, session_search |
持久化記憶與工作階段搜尋 |
| 自動化與傳送 | cronjob, send_message |
排程任務、對外傳送訊息 |
| 整合 | ha_*, MCP工具, rl_* |
Home Assistant、MCP、RL訓練 |
常見的toolset名稱包括web、terminal、file、browser、vision、image_gen、moa、skills、tts、todo、memory、session_search、cronjob、code_execution、delegation、clarify、homeassistant與rl。10
管理工具
hermes chat --toolsets "web,terminal" # Use specific toolsets
hermes tools # Interactive per-platform tool config
hermes tools --summary # Print enabled-tools summary
也能在工作階段中透過/tools disable <name>與/tools enable <name>切換工具的啟用狀態。這會重設工作階段,讓新的工具組合生效。9
終端機後端
終端機工具內建7種執行後端;自v0.20.6起,也能像供應商選擇器一樣,透過外掛擴充後端(詳見下文):1024
| 後端 | 使用情境 |
|---|---|
local |
在本機執行(預設)—開發、可信任的任務 |
docker |
隔離容器—安全性、可重現性 |
ssh |
遠端伺服器—沙箱、讓代理無法接觸自身的程式碼 |
singularity |
HPC容器—叢集運算、無需root權限 |
modal |
無伺服器雲端執行 |
daytona |
雲端沙箱工作區—持久化遠端開發環境 |
vercel_sandbox |
Vercel Sandbox雲端microVM—在雲端執行,透過快照持久化檔案系統。安裝hermes-agent[vercel]、設定terminal.vercel_runtime(node24、node22或python3.13),並使用VERCEL_TOKEN、VERCEL_PROJECT_ID與VERCEL_TEAM_ID進行驗證;遠端工作區根目錄預設為/vercel/sandbox24 |
使用hermes config set terminal.backend <name>切換後端,或在config.yaml中設定:
terminal:
backend: docker # or: local, ssh, singularity, modal, daytona, vercel_sandbox
cwd: "." # Working directory
timeout: 180 # Command timeout in seconds
外掛後端(v0.20.6+)。第三方沙箱廠商不再需要將實作納入核心儲存庫:外掛在載入時,透過PluginContext.register_terminal_environment_provider註冊TerminalEnvironmentProvider,註冊後的名稱便能像內建後端一樣,透過terminal.backend選用。內建名稱屬於保留名稱,登錄機制會拒絕名稱與儲存庫內既有後端衝突的供應商。註冊後的後端也會自動整合至所有核心功能(hermes setup後端選擇器、儀表板探測狀態、hermes doctor檢查、容器路徑/cwd處理、機密資料移除),因為核心會在每個判定後端類型的位置查詢登錄機制,而非使用寫死的名稱清單。32
SSH後端(基於安全考量建議使用,代理無法修改自身的程式碼):10
terminal:
backend: ssh
# In ~/.hermes/.env
TERMINAL_SSH_HOST=my-server.example.com
TERMINAL_SSH_USER=myuser
TERMINAL_SSH_KEY=~/.ssh/id_rsa
Docker後端:
terminal:
backend: docker
docker_image: python:3.11-slim
容器資源(適用於docker、singularity、modal、daytona):10
terminal:
container_cpu: 1
container_memory: 5120 # MB (default 5GB)
container_disk: 51200 # MB (default 50GB)
container_persistent: true # Persist filesystem across sessions
設定container_persistent: true後,已安裝的套件、檔案與設定都會跨工作階段保留。10
所有容器後端皆採用安全強化措施:唯讀根檔案系統(Docker)、移除DAC_OVERRIDE、CHOWN與FOWNER以外的所有Linux capabilities、禁止權限提升、PID限制(256個行程)、完整的命名空間隔離,以及透過磁碟區持久化工作區。10
背景行程
終端機工具支援背景執行,並提供明確的行程管理操作:10
terminal(command="pytest -v tests/", background=true)
# Returns: {"session_id": "proc_abc123", "pid": 12345}
process(action="list") # Show all running processes
process(action="poll", session_id="proc_abc123") # Check status
process(action="wait", session_id="proc_abc123") # Block until done
process(action="log", session_id="proc_abc123") # Full output
process(action="kill", session_id="proc_abc123") # Terminate
process(action="write", session_id="proc_abc123", data="y") # Send input
PTY模式(pty=true)可支援Codex與Claude Code等互動式CLI工具。10
Sudo
若指令需要sudo,Hermes會提示您輸入密碼(在該工作階段內快取)。也可在~/.hermes/.env中設定SUDO_PASSWORD。10
多代理看板(v0.13.0+)
v0.13.0將多代理協作提升為核心基礎功能:透過持久化看板,跨代理追蹤任務、狀態與工作代理身分,並在重新啟動後保留這些資訊。18有了看板,Hermes工作代理群才能確實完成工作,避免因交接中斷而停滯。
| 機制 | 功能 |
|---|---|
| 心跳 | 每個工作代理在持有任務期間都會定期發送心跳。若未收到心跳,系統會將該工作代理標記為疑似異常,並釋出任務供其他代理重新認領。 |
| 重新認領 | 其他工作代理可接手遭遺棄的任務,並取得完整任務狀態與先前的部分產出。 |
| 殭屍代理偵測 | 工作代理若未將任務標記為完成便結束執行,系統會自動禁止其認領新工作,避免代理群累積失效身分。 |
| 幻覺檢核 | 若產出未通過檢核,任務會附上原因退回看板,而不會被標記為完成。 |
個別任務的max_retries |
對於已知容易失敗的任務,可覆寫預設重試次數上限。 |
| 多專案看板 | 同一個Hermes主目錄可容納多個獨立看板。 |
看板能自然搭配/goal(鎖定目標的Ralph迴圈)管理目標,並透過既有的delegate_task工具建立代理。由此形成的代理群模式,讓每個代理都能依據同一份權威資訊,掌握接下來要做什麼、由誰執行,以及哪些工作受阻。
什麼是Hermes代理群?
代理群是多個Hermes工作代理,針對同一個共用看板平行執行。 它不是需要另外啟用的子系統,而是看板所促成的運作方式。看板 提供了平行代理無法自行建立的依據:對於 接下來該接手什麼工作,是否已有人處理?,給出唯一且具權威性的答案。
v0.15.0將此模式提升為正式支援的拓撲,新增用於 平行工作代理協調的代理群拓撲、將高階目標自動拆解為子任務、 個別任務的模型覆寫、排程任務,以及worktree管理,避免平行 工作代理在同一份簽出目錄中互相衝突。73
| 簡單多代理架構中的問題 | 看板的處理方式 |
|---|---|
| 兩個工作代理搶到同一項任務 | 透過認領確立任務歸屬,並記錄工作代理身分 |
| 工作代理在任務途中停止,工作成果隨之消失 | 心跳逾時後,任務可連同先前的部分產出一起重新認領 |
| 當機的工作代理永遠「持有」任務 | 殭屍代理偵測會禁止其認領新工作 |
| 每個子任務都使用同一個昂貴模型 | 個別任務可覆寫模型,讓機械性子任務使用低成本模型 |
| 平行工作代理編輯相同檔案 | 透過worktree管理隔離各工作代理的簽出目錄 |
實際運作方式是:給代理群一個目標,由自動拆解功能將其拆成看板任務,
再由工作代理認領、執行並回傳結果。重試次數上限按任務設定(max_retries),
因此單一容易失敗的子任務不會耗盡整次執行的容錯額度。由於看板
具備持久性,代理群能在重新啟動後繼續運作,工作代理會重新連接,並依據原有狀態接續執行。
代理群的成效取決於任務拆解的品質。看板負責協調工作代理,無法 讓拆解不當的目標變得合理。若任務共用隱含狀態,仍會互相衝突, 即使使用worktree也一樣。
skill 系統
skill 是代理可在需要時載入的隨需知識文件。它們採用漸進式揭露模式,以減少 token 用量,並相容於 agentskills.io 開放標準。11
所有 skill 都存放在 ~/.hermes/skills/——這是主要目錄,也是唯一權威來源。全新安裝時,內附的 skill 會從儲存庫複製到此處。從中心安裝及由代理建立的 skill 也會存放在這裡。11
漸進式揭露
Level 0: skills_list() → [{name, description, category}, ...] (~3k tokens)
Level 1: skill_view(name) → Full content + metadata (varies)
Level 2: skill_view(name, path) → Specific reference file (varies)
代理只會在確實需要時,才載入完整的 skill 內容。11
SKILL.md 格式
---
name: my-skill
description: Brief description of what this skill does
version: 1.0.0
platforms: [macos, linux] # Optional — restrict to OS platforms
metadata:
hermes:
tags: [python, automation]
category: devops
fallback_for_toolsets: [web] # Conditional activation
requires_toolsets: [terminal] # Conditional activation
config: # Config.yaml settings
- key: my.setting
description: "What this controls"
default: "value"
prompt: "Prompt for setup"
---
# Skill Title
## When to Use
Trigger conditions for this skill.
## Procedure
1. Step one
2. Step two
## Pitfalls
- Known failure modes and fixes
## Verification
How to confirm it worked.
條件式啟用
skill 可依據可用的工具決定是否顯示。這對備援 skill 特別有用——這些免費或本機替代方案,只應在付費工具無法使用時出現:11
| 欄位 | 行為 |
|---|---|
fallback_for_toolsets |
列出的 toolset 可用時,隱藏 skill |
fallback_for_tools |
同上,但檢查個別工具 |
requires_toolsets |
列出的 toolset 無法使用時,隱藏 skill |
requires_tools |
同上,但檢查個別工具 |
範例:內建的 duckduckgo-search skill 使用 fallback_for_toolsets: [web]。設定 FIRECRAWL_API_KEY 後,web toolset 即可使用,代理會使用 web_search——DuckDuckGo skill 則維持隱藏。若未設定 API 金鑰,DuckDuckGo skill 就會自動顯示,作為備援方案。11
由代理管理的 skill
代理可透過 skill_manage 工具建立、更新及刪除自己的 skill。這是代理的程序性記憶——掌握較複雜的工作流程後,便會將做法儲存為 skill,以供日後重複使用。11
代理建立 skill 的時機:11 - 成功完成複雜任務後(呼叫工具 5 次以上) - 遇到錯誤或陷入死胡同後,找到可行的做法時 - 使用者糾正其做法時 - 發現較複雜的工作流程時
動作:11
| 動作 | 用途 |
|---|---|
create |
從零建立新 skill |
patch |
針對特定部分修正(建議優先使用——最節省 token) |
edit |
大幅重寫結構 |
delete |
完全移除 skill |
write_file |
新增或更新輔助檔案 |
remove_file |
移除輔助檔案 |
已鎖定的 skill(v0.22.6 發布期間)。hermes curator lock <skill> 是與 pinned 並列儲存的使用者宣告:已鎖定的 skill,代理無法透過任何寫入途徑(skill_manage、終端機、curator)變更;hermes curator unlock <skill> 可解除鎖定,hermes curator status 列出已鎖定的項目,Desktop 的 Capabilities 面板也有相同的開關。67
skill 中心
hermes skills browse # Browse all hub skills
hermes skills browse --source official # Browse official optional skills
hermes skills search kubernetes # Search all sources
hermes skills search react --source skills-sh # Search skills.sh directory
hermes skills inspect openai/skills/k8s # Preview before installing
hermes skills install openai/skills/k8s # Install with security scan
hermes skills install skills-sh/anthropics/skills/pdf --force
hermes skills check # Check for upstream updates
hermes skills update # Reinstall changed hub skills
hermes skills audit # Re-scan installed hub skills
hermes skills uninstall k8s
hermes skills publish skills/my-skill --to github --repo owner/repo
hermes skills tap add myorg/skills-repo # Add custom GitHub source
整合的中心來源:11
| 來源 | 範例 | 備註 |
|---|---|---|
official |
official/security/1password |
Hermes 隨附的選用 skill(內建信任) |
skills-sh |
skills-sh/vercel-labs/agent-skills/vercel-react-best-practices |
Vercel 的公開 skill 目錄 |
well-known |
well-known:https://mintlify.com/docs/.well-known/skills/mintlify |
透過 URL,從發布 /.well-known/skills/index.json 的網站探索 skill |
github |
openai/skills/k8s |
直接透過 GitHub 儲存庫/路徑安裝 |
clawhub |
— | 第三方 skill 市集 |
lobehub |
— | LobeHub 代理目錄轉換 |
browse-sh |
— | Browserbase skill 來源 |
預設 GitHub taps(無須設定即可瀏覽):openai/skills、anthropics/skills、huggingface/skills、NVIDIA/skills、garrytan/gstack。claude-marketplace 來源已於 v0.20.0 移除,來源清單改以 browse-sh 取代。1169
安全掃描
所有從中心安裝的 skill 都會經過安全掃描器檢查,偵測資料外洩、提示注入、破壞性命令、供應鏈風險跡象及其他威脅。11
信任等級:11
| 等級 | 來源 | 政策 |
|---|---|---|
builtin |
Hermes 隨附 | 一律信任 |
official |
儲存庫中的 optional-skills/ |
內建信任,不顯示第三方警告 |
trusted |
受信任的登錄庫(openai/skills、anthropics/skills) |
較寬鬆的政策 |
community |
其他所有來源 | 非危險的檢查結果可透過 --force 略過;判定為 dangerous 時仍會封鎖 |
--force 可略過社群 skill 因非危險問題而觸發的政策封鎖,但無法略過 dangerous 掃描判定。11
外部 skill 目錄
您可為 Hermes 指定額外的 skill 目錄,與本機目錄一併掃描:11
skills:
external_dirs:
- ~/.agents/skills
- /home/shared/team-skills
- ${SKILLS_REPO}/skills
路徑支援 ~ 展開及 ${VAR} 環境變數替換。外部目錄為唯讀——代理建立或編輯 skill 時,一律寫入 ~/.hermes/skills/。若兩處有同名 skill,則以本機版本為優先。11
固定載入的 skill:skills.auto_load(v0.21.4 期間)
在 config.yaml 的 skills.auto_load 下列出的 skill,會在每個新工作階段中固定完整載入——CLI、TUI、gateway、cron 及 API 皆適用:51
skills:
auto_load:
- team-conventions
- deploy-checklist
此清單只會在首次建構代理提示時解析一次。若名稱不存在或已停用,系統會發出警告並略過,不會導致工作階段失敗。HERMES_IGNORE_RULES(--ignore-rules 背後的機制)會停用此清單,處理方式與其他自動注入的上下文相同。這相當於常設指令,與僅為單一工作階段預先載入 skill 的 -s/--skills 相輔相成。51
持久記憶
Hermes具備容量有限、經過整理的記憶,可跨工作階段保留。代理的記憶由2個檔案組成,皆儲存於~/.hermes/memories/:12
| 檔案 | 用途 | 字元上限 |
|---|---|---|
MEMORY.md |
代理的個人筆記——環境資訊、慣例、學到的事項 | 2,200個字元(約800個token) |
USER.md |
使用者資料——偏好、溝通風格、期望 | 1,375個字元(約500個token) |
這2個檔案會在工作階段開始時,以固定快照的形式注入系統提示詞。代理透過memory工具自行管理記憶,可使用add、replace或remove。12
固定快照模式:注入系統提示詞的內容只會在工作階段開始時擷取一次,期間不會變動。這是刻意的設計,目的是保留LLM的前綴快取,以維持效能。工作階段中的變更會立即儲存至磁碟,但直到下一個工作階段才會出現在系統提示詞中。12
應儲存的內容
儲存以下內容(代理會主動執行):12
- 使用者偏好:「比起JavaScript,我更偏好TypeScript」→ user
- 環境資訊:「這台伺服器執行Debian 12與PostgreSQL 16」→ memory
- 更正事項:「執行Docker指令時不要使用sudo,使用者已加入docker群組」→ memory
- 慣例:「專案使用定位字元縮排、每行寬度為120個字元,並採用Google風格的文件字串」→ memory
- 已完成的工作:「於2026年1月15日將資料庫從MySQL遷移至PostgreSQL」→ memory
略過以下內容:12 - 瑣碎或顯而易見的資訊 - 容易重新查得的事實 - 原始資料傾印(體積過大,不適合存入記憶) - 僅與當次工作階段相關的暫時資訊 - 上下文檔案中已有的資訊
工作階段搜尋
除了MEMORY.md與USER.md之外,代理還能使用session_search工具搜尋過往對話。所有CLI與通訊平台的工作階段都儲存在SQLite(~/.hermes/state.db)中,並支援FTS5全文搜尋。自v0.15.0重新設計後,此工具完全不再使用LLM,而是直接傳回已儲存的對話內容(原始資料稱之為「單一形式的工具直接傳回資料庫內容」)。這讓速度提升至原本的4,500倍,也消除了其API費用。127334
| 功能 | 持久記憶 | 工作階段搜尋 |
|---|---|---|
| 容量 | 總計約1,300個token | 無上限(所有工作階段) |
| 速度 | 即時(已在系統提示詞中) | 一次FTS查詢——自v0.15.0起無須呼叫LLM |
| 使用情境 | 隨時提供關鍵資訊 | 尋找特定的過往對話 |
| 管理方式 | 由代理手動整理 | 自動儲存所有工作階段 |
| Token成本 | 每個工作階段固定(約1,300個token) | 按需計算 |
v0.21.4前後新增了2項功能,皆已在標籤v2026.9.21驗證。第一項是時間界限:探索查詢形式接受after(工作階段開始時間的下限,含該時間)與before(上限,不含該時間)。兩者皆可使用ISO日期/日期時間,或相對時長(7d、24h、2w);僅提供日期時,代表當天UTC午夜。這些參數僅適用於明確指定時間範圍的查詢;sort仍只影響排序偏好,不構成範圍限制。第二項是零結果時放寬比對並重試:FTS5預設以AND連接搜尋詞,因此以不同措辭表達的多詞查詢,只要有一個詞未出現在已儲存的句子中,就可能找不到該句。當精確查詢與子字串備援搜尋皆無結果時,搜尋會重試索引,比對任一搜尋詞,並將涵蓋較多搜尋詞的資料列排在前面。已有命中結果時,仍維持精確比對語意(僅在零結果時才會重試);明確使用OR/NOT、僅含單一搜尋詞,以及經由CJK路徑處理的查詢則維持原樣。51
外部記憶提供者
若需要超越MEMORY.md與USER.md的深度持久記憶,Hermes在v0.22.0隨附2個外部記憶提供者外掛:RetainDB與ByteRover。另有6個可從外掛目錄安裝:於v0.21.7移出核心原始碼樹的Holographic、於v0.21.6移出的Honcho、OpenViking、Mem0與Supermemory,以及於v0.21.5移出的Hindsight;這6個外掛皆列為社群層級項目,由各自的供應商維護。12555759
Hindsight截至v0.21.4仍隨核心原始碼樹提供,並於v0.21.5移至外掛目錄,由Vectorize維護;Honcho、Mem0、OpenViking與Supermemory隨後於v0.21.6移出,Holographic則於v0.21.7移出。既有設定會自動遷移:若memory.provider指定其中一個提供者,hermes update便會將目錄中的外掛安裝至所有指定該提供者的profile主目錄;若仍未安裝,代理首次啟動時會補裝。若設定security.allow_lazy_installs: false,代理啟動時只會記錄一則訊息,因此請自行執行hermes plugins install <name>。外掛會安裝至~/.hermes/plugins/<name>/,並加入plugins.enabled;memory.provider、memory.hindsight.*、HINDSIGHT_API_KEY與您的記憶資料皆維持原樣。可使用hermes memory status與hermes plugins list確認。hermes-agent[hindsight]這個pip選用相依套件組已移除。53
外部提供者與內建記憶並行運作(絕不取代內建記憶),並增添知識圖譜、語意搜尋、自動擷取事實及跨工作階段使用者建模等功能:612
hermes memory setup # Pick a provider and configure it
hermes memory status # Check what's active
hermes memory off # Disable external provider (built-in only)
一次只能啟用一個外部提供者。內建記憶則始終啟用。6
工作階段自動恢復(v0.13.0+)
v0.13.0讓代理在執行途中遭到中斷後仍可恢復。gateway會在重新啟動後自動恢復中斷的工作階段;透過/update重新啟動時,升級過程會保留工作階段狀態;開發期間重新載入原始碼檔案,也會維持目前的工作階段,不再強制建立新的工作階段。18實際效果是:長時間執行的gateway工作與cron驅動的作業,不再因程序重新啟動而重設上下文視窗。
checkpoint v2(v0.13.0+)
v0.13.0將狀態持久化機制重寫為單一儲存庫設計,具備確實生效的清理機制、磁碟用量防護,且不再留下孤立的影子儲存庫。18舊版checkpoint系統會隨著profile長時間運作,持續在磁碟上累積狀態;v2儲存庫為本機checkpoint儲存量設定硬性上限,並移除造成資料量增長的重複狀態記錄。使用者無須變更設定;下一次寫入checkpoint時,就會採用v2流程。
個性與SOUL.md
SOUL.md是Hermes執行個體的主要身分設定。它位於系統提示詞的第1個位置,取代程式碼中寫死的預設身分。13
Hermes會自動在~/.hermes/SOUL.md建立預設的SOUL.md(自訂profile則位於$HERMES_HOME/SOUL.md)。既有的使用者檔案絕不會遭到覆寫。Hermes只會從HERMES_HOME載入SOUL.md,不會搜尋目前的工作目錄。這讓個性設定在不同專案間保持一致、可預期。13
SOUL.md適合放什麼內容
請用它記錄長期適用的表達方式與個性指引:13 - 語氣 - 溝通風格 - 表達的直接程度 - 預設互動方式 - 應避免的風格 - Hermes應如何處理不確定性、意見分歧與模糊之處
較不適合放入的內容:13 - 一次性的專案指示 - 檔案路徑 - 儲存庫慣例 - 暫時性的工作流程細節
這些內容應放在AGENTS.md,而非SOUL.md。
SOUL.md與AGENTS.md的差異
這是Hermes身分管理中最重要的區別:13
SOUL.md——身分、語氣、風格、預設溝通方式,以及個性層面的行為。
AGENTS.md——專案架構、程式碼慣例、工具偏好、儲存庫專屬工作流程、指令、連接埠、路徑與部署注意事項。
實用的判斷原則:無論在哪裡都應沿用的內容,放進SOUL.md;屬於特定專案的內容,則放進AGENTS.md。13
內建個性
Hermes提供多種內建個性,可透過/personality切換:1333
| 名稱 | 說明 |
|---|---|
helpful |
親切的通用助理 |
concise |
簡潔扼要、直切重點的回覆 |
technical |
詳盡、精確的技術專家 |
creative |
創新且不受框架限制的思考 |
teacher |
耐心教學,搭配清楚的範例 |
kawaii |
可愛的表達方式、閃亮符號與熱情 |
catgirl |
帶有貓咪式表達的貓娘 |
pirate |
Hermes船長,精通科技的海盜 |
shakespeare |
吟遊詩人般的文筆,充滿戲劇張力 |
surfer |
輕鬆隨興的哥兒們風格 |
noir |
硬派偵探式敘事 |
uwu |
使用uwu萌語,將可愛發揮到極致 |
philosopher |
對每個問題都深思熟慮 |
hype |
活力全開 |
在config.yaml中設定自訂個性:13
agent:
personalities:
codereviewer: >
You are a meticulous code reviewer. Identify bugs, security issues,
performance concerns, and unclear design choices. Be precise and constructive.
接著使用/personality codereviewer切換。
SOUL.md與/personality的差異
SOUL.md定義基本表達風格,/personality則是在工作階段層級疊加的設定。13建議讓預設的SOUL.md保持務實,再於教學對話中使用/personality teacher,或在腦力激盪時使用/personality creative。
Nous Tool Gateway(v0.10.0+)
自Hermes Agent v0.10.0(2026年4月16日)起,付費的Nous Portal訂閱者可透過現有的Portal憑證,使用一組精選的代管工具,無須管理額外的API金鑰。75 Hermes CLI本身仍採MIT授權,並且完全開放原始碼。這次的變更在於,Portal驗證現在能解鎖的不只有模型推論。
最快的入門方式是執行hermes setup --portal,README將其介紹為「全新安裝後,只需一道指令」:它會透過OAuth讓您登入、將Nous設為供應商,並啟用Tool Gateway。之後便可透過hermes portal管理相關設定。hermes portal login(未指定子指令時的預設行為)會執行相同的一次性初始設定;hermes portal info會顯示「Portal驗證與Tool Gateway路由摘要」;hermes portal open會在預設瀏覽器中開啟訂閱頁面;hermes portal tools會列出gateway工具,以及哪些工具透過Nous路由。hermes portal status仍保留為info的隱藏別名,以維持回溯相容性;該版本標籤下的CLI參考文件也仍將此子指令寫作status,因此兩者皆可使用。28
gateway包含哪些工具
| 工具 | 供應商 | 用途 |
|---|---|---|
| 網頁搜尋 | Firecrawl | 為需要最新資訊的代理檢索資料 |
| 圖片生成 | FAL / FLUX 2 Pro | 無須設定FAL金鑰,即可在互動過程中直接生成圖片 |
| 文字轉語音 | OpenAI TTS | 在訊息gateway上輸出語音 |
| 瀏覽器自動化 | Browser Use | 無頭瀏覽與資料擷取 |
運作方式
gateway透過新增的use_gateway設定欄位,讓您逐一選擇要啟用的工具。若hermes auth中已有Portal憑證,且已為某項工具啟用gateway,該工具的呼叫就會透過Portal路由。否則,系統會使用您的直連API金鑰(若已設定)。
# config.yaml — per-tool gateway opt-in
tools:
web_search:
provider: firecrawl
use_gateway: true # route via Nous Portal subscription
image_generation:
provider: fal
use_gateway: true
執行時的優先順序:當gateway可用,且工具已設定use_gateway: true時,即使您也設定了直連API金鑰,Hermes仍會優先使用gateway。這會影響計費:gateway呼叫會消耗Portal訂閱的額度,而非直連API金鑰的餘額。
啟用gateway
hermes model # select Nous Portal (OAuth flow)
hermes tools # per-platform tool picker integrates gateway tools
hermes status # confirms gateway/subscription detection
系統會根據hermes auth中現有的Portal OAuth憑證,自動偵測訂閱狀態,無須另行登入。自v0.19.0起,也能直接在工作階段內管理訂閱:/subscription會顯示方案與剩餘額度,讓您預覽升級的確切費用或降級的生效時間,並套用變更,同時提供預定變更的橫幅提示與復原功能;/topup則可儲值。桌面應用程式也有對應的帳務設定分頁。70
定價與使用資格
價格與方案名稱公布於Nous Portal定價頁面(https://portal.nousresearch.com/pricing)。本指南不逐一列出各方案,因為這些方案由Portal產品負責,而非Hermes CLI,且其調整不受Hermes版本發布影響。請前往https://portal.nousresearch.com/註冊,並查看定價頁面以瞭解目前的方案。
Nous免費方案與首次啟動引導(v0.21.2+)
自v0.21.2起,全新安裝後無須付費方案或API金鑰,即可使用能正常運作的代理:免費推論與連接器皆已內建,只需一道指令即可登入,也可在對話中透過/login啟動登入流程。連接器工具(Gmail、Linear、Notion等)與其他工具一樣,都能透過tool_search搜尋。桌面版新增首次啟動引導,須以HERMES_GUEST_ONBOARDING=1啟用;只有確切的值1才會生效。桌面版本身的測試明確驗證,'true'、'0'與空值皆不會啟用此功能;是否啟用的決定也會明確寫入所啟動的後端環境,避免繼承的值意外影響結果。48
自v0.21.4發布期間起,這些連接器的連線設定已整合為由後端統一管理的操作,不再由各前端分別處理:manage_connections工具呼叫會驅動後端的純資料連線狀態機(操作期限固定為300秒,刻意不提供設定鍵),而桌面版、TUI與CLI都會將其呈現為相同的設定卡片。卡片會為每項缺少的憑證繪製欄位(名稱、提示、是否必填),並在所有必填欄位皆有文字後,才允許執行操作;後端也會在每個前端強制遵循相同的機密資料專用分流規則。51
淘汰公告
HERMES_ENABLE_NOUS_MANAGED_TOOLS環境變數已於v0.10.0移除。代管工具現在改由各工具的use_gateway設定欄位啟用,並依Portal訂閱狀態決定是否開放使用。75
定位說明:此版本不代表什麼
Hermes Agent CLI無須訂閱即可使用。專案仍採MIT授權,所有核心功能(CLI、skill、記憶、訊息gateway、cron、MCP、本機儀表板,以及所有供應商的BYOK)皆可完整運作,無須向任何人付費。v0.10.0為已付費使用Nous Portal的使用者新增一條便利途徑,並未刪減任何免費使用的功能。
訊息 gateway
Hermes可作為長時間執行的gateway程序,透過單一gateway程序連接28個訊息平台:Telegram、Discord、Slack、WhatsApp、Signal、SMS、Email、Home Assistant、Mattermost、Matrix、DingTalk、Feishu/Lark、WeCom、Weixin(WeChat)、BlueBubbles(iMessage)、QQBot、Microsoft Teams、Tencent Yuanbao、Google Chat、LINE、SimpleX Chat、Photon(iMessage)、WhatsApp Cloud API、WeCom Callback、Raft、IRC、ntfy、Buzz,以及通用Webhook配接器。374171819 28這個數字來自v2026.8.31標籤版本文件中的「平台比較」表;底層的gateway/config.py定義了24個內建Platform列舉成員(包括local、api_server、webhook、msgraph_webhook和relay等非聊天項目),其他名稱則按需解析至plugins/platforms/下隨附的22個配接器目錄之一,因此單純計算列舉成員或目錄數量,並不會與文件中的數字一致。25 v0.9.0透過BlueBubbles加入iMessage支援(自動註冊webhook、設定精靈、當機復原能力),並透過iLink Bot API加入原生WeChat支援,同時為企業應用程式提供WeCom回呼模式。16 v0.11.0加入QQBot。74 v0.12.0加入Microsoft Teams和Tencent Yuanbao。17 v0.13.0加入Google Chat,成為第20個平台,沿用相同的可插拔配接器架構;IRC和Microsoft Teams也遷移至新的配接器模式,採用通用的env_enablement_fn / cron_deliver_env_var外掛掛鉤。18 v0.14.0加入LINE和SimpleX Chat,並補齊Microsoft Teams從頭到尾的整套功能,包括Graph驗證、webhook監聽器、管線執行環境及對外傳送。19 v0.17.0(2026年6月19日)透過Photon Spectrum加入無需中繼的iMessage支援(使用hermes photon login進行裝置代碼OAuth,無需Mac/BlueBubbles中繼),同時加入官方WhatsApp Business Cloud API配接器(取代原本必須使用橋接程序的要求)、SimpleX群組與原生附件,以及隨附的平台外掛Raft。21 文件表格中另列出2個平台,發布說明卻未特別介紹:ntfy是輕量的HTTP發布/訂閱推播管道(在ntfy行動應用程式中訂閱主題,向該主題傳送訊息即可與代理對話,並在手機上收到回覆;可搭配公開的ntfy.sh伺服器或自行架設的執行個體,無需SDK或常駐程序);Buzz則將Hermes連接至Buzz社群。Buzz是Block以Nostr協定打造的開放原始碼人機協作平台,傳出訊息時會呼叫外部buzz CLI,接收訊息則使用原生Nostr WebSocket訂閱。兩者皆透過hermes gateway setup設定連線。25
設定
hermes gateway setup # Interactive platform configuration
hermes gateway install # Install as user service (systemd/launchd)
hermes gateway start # Start the installed service
hermes gateway stop
hermes gateway restart
hermes gateway status
hermes gateway run # Run in foreground (debugging)
互動式設定會引導您逐一連接各平台:設定API權杖、機器人ID、頻道對應及允許清單。6 自v0.21.6起,Discord設定步驟會檢查機器人權杖,並輸出含有配接器所需權限位元的邀請連結;若Message Content Intent仍未啟用,也會明確提示,因為這會使Discord拒絕機器人的連線。5455
訊息如何流動
以下摘自上游架構文件:3
Platform event → Adapter.on_message() → MessageEvent
→ GatewayRunner._handle_message()
→ authorize user
→ resolve session key
→ create AIAgent with session history
→ AIAgent.run_conversation()
→ deliver response back through adapter
所有訊息平台都使用與CLI相同的AIAgent對話迴圈。因此,斜線指令在兩者中的運作方式完全一致,而在Telegram中排程的cron工作也能將輸出傳送至Discord;平台差異僅存在於系統邊緣。3
v0.19.0加入依profile進行訊息路由及持久化傳送的功能。透過GATEWAY_MULTIPLEX_PROFILES覆寫設定,共用單一機器人權杖的多工gateway可將指定的伺服器、頻道或討論串路由至不同profile,各自擁有完全隔離的設定、skill、記憶與機密資料。一系列強化措施也確保單一profile設定錯誤不再導致整個gateway停擺。底層的路由索引已移至state.db(sessions.json現為可選的舊版鏡像),而最終回覆會在平台傳送前後記錄於持久化的待傳送帳本中。已完成的回答若遇上gateway當機,會在下次啟動時重新傳送,不再無聲無息地遺失。70 v0.21.2進一步強化路由profile之間的隔離,修補了這種多工設定中的一系列跨profile洩漏問題:繼承的允許清單、傳送至預設profile主機的憑證、流入stdio MCP伺服器的預設profile保管庫機密資料、跨profile的MEDIA:附件,以及同層profile的Nous持有人權杖殘留在個別程序的記憶快取中(#107609-#107630)。48
v0.21.1將對話邊界改為僅能明確建立。v2026.9.7標籤版本的工作階段生命週期文件,以4句話說明此規則:「閒置與實際經過的時間絕不會觸發對話輪替。/new與/reset會建立明確邊界;長篇歷史紀錄仍由上下文壓縮管理。舊版計時器設定會被忽略。現有的SessionResetPolicy資料型別只是為了相容而保留、不具作用的資料,並非執行階段原則。」明確暫停仍會在下一次收到訊息時建立邊界;復原時會遵守已確立的邊界,不會重新開啟;僅為釋放資源而進行的逐出則仍允許恢復對話。若gateway上的工作階段看似「永不過期」,這正是目前的設計;請自行使用/new輪替。43
自v0.21.4版本期間起,第二次執行hermes gateway run會連接既有程序或拒絕執行,不再重複綁定。規則是每部主機上的每位作業系統使用者,各執行一個hermes serve及一個hermes gateway run,兩者各自以多工方式處理所有profile。若啟動gateway的profile已由目前執行中的多工程序服務,指令只會連接既有程序,並以結束代碼0退出;若尚未服務該profile,Hermes會要求它重新掃描profiles/,待開始服務後再連接;若無法讓它服務該profile,指令就會拒絕執行,不會默默啟動第二個gateway。--replace現在會以該主機程序為目標,無論它是由哪個profile啟動;若擁有者程序卡住,--force則會完全略過詢問。獨立gateway仍可並存:若目前執行的是另一個profile的獨立(非多工)gateway,您的profile仍會像以往一樣在旁啟動自己的gateway,直到強制遷移為止(#109417)。若兩個gateway同時啟動,未取得主機鎖定的程序會以結束代碼75退出;Hermes產生的所有程序監督器都會重試。屆時,成功取得鎖定者的紀錄已經存在,因此重試會依上述規則連接或拒絕執行。鎖定與會合紀錄存放於$HERMES_GATEWAY_LOCK_DIR,若未設定則使用$XDG_STATE_HOME/hermes/gateway-locks(預設為~/.local/state/hermes/gateway-locks),並以作業系統使用者為範圍。若紀錄中的PID已不再執行,或已被另一個程序重新使用,該紀錄便會視為過期並忽略,因此當機的gateway不會阻擋下次啟動。桌面應用程式也遵循相同規則,會連接執行中的主機後端,而非另啟第二個。51
自v0.21.5起,多工已不再是選用功能。gateway.multiplex_profiles只有一個有效值:true。未設定此鍵時會視為啟用,並寫入預設profile的config.yaml;明確設定的false則會直接改寫為true,並在該次gateway啟動時顯示一次方框提示,之後也會再次列於下一次hermes update的摘要中。原本的停用選項改由2個控制方式取代。若要讓單一profile離線,而不停止其他人的機器人,請執行hermes -p <name> gateway stop:主機會將其暫停(建立profiles/<name>/gateway.parked標記),執行hermes -p <name> gateway start則會解除暫停;儀表板與桌面應用程式的停止/啟動按鈕也會執行相同操作。仍需要獨立gateway的具名profile,可在自己的config.yaml中設定gateway.standalone: true;主機便不會服務該profile,其stop/start也只會操作自己的程序。文件將此鍵稱為「暫時性的相容層」,並非受支援的拓撲;若設於預設profile,會被忽略並發出警告。若要分散至不同作業系統使用者,或使用位於預設主目錄profiles/之外的HERMES_HOME,仍須加上--force。53
使用者授權與配對
hermes pairing list # Show pending and approved users
hermes pairing approve <platform> <code>
hermes pairing revoke <platform> <user-id>
hermes pairing clear-pending
配對碼可防止陌生人任意與您的gateway對話。使用者從其訊息平台傳送配對碼後,您以hermes pairing approve核准,即可授權對方使用。6
unauthorized_dm_behavior決定陌生人在配對前傳送私訊時會收到什麼回應:pair會以私訊傳回配對碼,ignore會無聲捨棄訊息,而v0.21.4版本期間新增的decline則會先禮貌拒絕一次,接著24小時內不再回應該傳送者(#88028)。拒絕訊息會依平台與傳送者去除重複,即使使用不同別名也不會重複傳送;訊息文字取自unauthorized_dm_decline_message(全域設定鍵;留空則使用內建回覆:「您好!我是私人助理,只能與我的擁有者聊天,因此無法直接協助您。很抱歉!」)。可在全域設定此行為,或在設定精靈寫入設定的各平台區段中分別設定:
# ~/.hermes/config.yaml
unauthorized_dm_behavior: decline # global; gateway.unauthorized_dm_behavior also works
unauthorized_dm_decline_message: "" # empty = built-in reply
platforms:
telegram:
unauthorized_dm_behavior: pair # per-platform value always wins
若未設定,有效預設值取決於允許清單。完全未設定允許清單時,預設為pair;一旦設定任何允許清單(GATEWAY_ALLOWED_USERS,或平台的允許使用者、群組允許使用者、群組允許聊天室變數),預設便改為ignore,因為允許清單代表此gateway刻意限制存取,而向未知聯絡人傳送配對碼既會造成干擾,也可能洩漏資訊(#9337)。全域ignore或decline可覆寫此規則,但全域pair無法,因為其解讀結果與預設值相同;若要在使用允許清單的同時保留配對功能,請針對個別平台設定pair。(若平台配接器本身設有dm_policy,會先於允許清單規則採用。)Email採用收件匣模式,預設為ignore,除非透過Email專屬的平台設定鍵明確啟用;全域值不會套用至Email。在未設允許清單的情況下設定平台時,hermes gateway setup會將拒絕列為選項之一。51
排程任務(cron)
Hermes 內建完整的 cron 系統,其中工作是代理任務,而非 shell 命令。每項排程工作都會透過全新的 AIAgent 執行,使用已設定的提示詞與選擇性附加的 skill,並將結果傳送至任意平台:36
hermes cron list
hermes cron create --prompt "Check HN for AI news and summarize" --schedule "0 9 * * *" --deliver telegram
hermes cron edit <id>
hermes cron pause <id>
hermes cron resume <id>
hermes cron run <id> # Trigger now on the next tick
hermes cron cancel <id> # Stop an in-flight run (v0.22.6 window)
hermes cron remove <id>
hermes cron status # Check if scheduler is running
hermes cron tick # Run due jobs once and exit
也可以直接在通訊平台的對話中建立:
Every morning at 9am, check Hacker News for AI news and send me a summary on Telegram.
代理會透過工具設定 cron 工作。工作會持續儲存在 JSON 中,重新啟動後仍會保留。3
錯過的執行(v0.22.6 發布期間)。當機器關機或 gateway 停止時,由工作自身的 catch_up 決定:true 會針對錯過的所有執行一次性補跑一回,false 則直接跳到下一個時段。未設定此鍵的工作,若為週期性工作則遵循 cron.catch_up_missed(預設為 true),單次工作則維持 120 秒的寬限規則,除非主動選擇啟用。無論哪種情況,略過或合併的時段都會在執行帳本中記為一列「missed xN」,因此執行歷史會顯示這段空缺,而非一片空白。67
v0.21.0 為排程工作加入記憶與判斷能力。以下 4 項機制皆已在標籤 v2026.8.31 驗證:3537
- 連續性。
continuity=true會在每次執行時注入該工作自身最近一次的輸出,讓偵查或監控代理「醒來時就能看到上次回報的內容,排除重複資訊,並接續先前的進度」。注入的指示是「避免重複已回報的內容」,首次執行則不受影響。在內部實作中,此旗標會儲存為context_from中保留的self項目。可透過hermes cron create ... --continuity與hermes cron edit <job_id> --continuity/--no-continuity切換。37 - 持久化記事本。每項工作都有一個小型鍵值暫存區,用於儲存游標、處理進度標記與監看清單(每個值上限 16 KB,每項工作上限 64 KB。由於每次執行都會將內容注入提示詞,因此刻意設有上限)。執行中的代理會透過終端機工具呼叫
hermes cron notepad <job_id> set <key> <value>寫入內容。37 - 監控模式。工作可以附加成本較低的
monitor_script/monitor_url來源,在每次排程觸發時先執行。若輸出未變(逐位元組精確比較),就會完全略過代理執行,不呼叫 LLM、不傳送結果,只留下靜默的no_change執行紀錄。若有變更,則會注入差異區塊並正常執行代理。監控指令碼應產生穩定的輸出,否則每次觸發都會被判定為有變更。37 - 個別工作的推理強度與 Bot Chat 傳送。
--reasoning-effort可固定工作的思考層級(從none到ultra),在該工作執行時覆寫全域與個別模型的設定;deliver=bot-chat則會將輸出以真正的傳入訊息送至 profile 的標準 Bot Chat 工作階段,讓機器人「處理任何需要採取行動的事項,並在自己的對話中回覆」,而不只是讓使用者在頻道中閱讀結果。37
MCP 整合
Hermes 支援以用戶端與伺服器兩種角色使用 Model Context Protocol:6
作為用戶端 — 將 Hermes 連接至外部 MCP 伺服器,擴充可用工具:
hermes mcp add <name> --url https://example.com/mcp
hermes mcp add <name> --command npx --args "-y,@modelcontextprotocol/server-github"
hermes mcp list
hermes mcp test <name>
hermes mcp remove <name>
hermes mcp configure <name> # Toggle individual tool selection
hermes mcp login <name> # Force re-auth for an OAuth server (--flow browser|device)
hermes mcp reauth [--all] # Re-authenticate one OAuth server, or every one
也可以在 config.yaml 中手動設定:14
mcp_servers:
github:
command: npx
args: ["-y", "@modelcontextprotocol/server-github"]
env:
GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"
自 v0.19.0 起,MCP 工具會以 mcp__server__tool 命名慣例提供給模型。每個工具名稱都帶有伺服器名稱,因此即使兩台伺服器提供同名工具,也不再發生衝突。MCP 伺服器的日誌通知也會記錄於 agent.log。70
v0.21.1 為 MCP OAuth 新增裝置碼流程:hermes mcp login <name> 支援 --flow {browser,device}。browser 是既有的 PKCE 流程,device 則是適用於無圖形介面或遠端機器的 RFC 8628 裝置碼登入流程。此旗標會覆寫伺服器的 oauth.flow 設定。同一版本期間的更新也會在整個 OAuth 工作階段中強制檢查 profile 歸屬、忽略格式錯誤的 OAuth 中繼資料快取,避免伺服器卡住,並透過用戶端本機回呼轉送桌面端的 MCP OAuth 流程;-t/--toolsets 現在也會篩選要啟動哪些已設定的 MCP 伺服器,因此限定範圍的呼叫會略過不需要的伺服器冷啟動。44
v0.21.0 將桌面端的 MCP 介面變成指揮中心:伺服器與目錄整合至同一頁面,支援拖入內容或「貼上任何內容」匯入;背景健康檢查會在工具呼叫失敗前提示驗證即將到期;伺服器群組的成本/用量浮層會顯示各伺服器的結構描述 token 估計值與 30 天用量;hermes:// 深層連結則可在明確確認後安裝 MCP 伺服器。35
v0.21.4 版本期間的更新新增 mcp.discovery_concurrency(預設為 4;0 = 無上限,#117373),限制探索階段同時連線的已設定 MCP 伺服器數量。所有伺服器仍會連線,此上限只是避免它們同時連線。若值不是整數或為負數,系統會記錄警告並回復預設值。51
作為伺服器 — 將 Hermes 對話提供給其他代理:
hermes mcp serve
hermes mcp serve -v # Verbose
上下文壓縮
Hermes 會自動壓縮長對話,使其維持在模型的上下文視窗範圍內。壓縮摘要器會使用獨立的 LLM 呼叫,您可指定任意供應商或端點。4 自 v0.20.6 起,尾端保留策略預設為 lean(compression.tail_mode: lean)。在該版本標籤中,摘要器的模型/供應商/端點設定已移至 auxiliary.compression.*,取代舊有的 compression.summary_*。舊設定鍵會在首次載入時自動遷移(設定版本 17)。3031
compression:
enabled: true
threshold: 0.50 # Compress at this % of context limit
threshold_tokens: null # Optional absolute token cap -- trigger fires at the lower of ratio vs cap
target_ratio: 0.20 # Fraction of threshold to preserve as recent tail (legacy tail mode)
tail_mode: lean # Tail retention: "lean" (default) or "legacy"
protect_last_n: 20 # Min recent messages to keep uncompressed
protect_first_n: 3 # Non-system head messages pinned across compactions
prepare_ahead: false # Opt in to preparing the summary in a background pass before compression runs (v0.22.6 window)
auxiliary:
compression:
model: "" # Empty = main chat model; e.g. "google/gemini-3-flash-preview"
provider: "auto" # "auto", "openrouter", "nous", "codex", "main", etc.
base_url: null # Custom OpenAI-compatible endpoint (overrides provider)
tail_mode 決定的行為。legacy 會依 target_ratio 保留相應大小的原文尾段。在大型上下文視窗或提高門檻的設定下,每次壓縮仍會留下 100–240K 個 token。lean 則保留上下文視窗 2.5% 的原文尾段,並將其限制在 10K 至 25K 之間,改由摘要維繫連續性:包含已壓縮區段的詳細工作階段紀錄,並保留識別碼(每次嘗試呼叫輔助摘要器一次);以機械方式擷取的定位索引(PR 編號、SHA、路徑、錯誤字串,透過正規表示式擷取,絕不改寫);逐字引用的每則真實使用者訊息;以及 session_search 還原指標,讓代理能重新存取摘要中省略的任何內容。文件對 500K token 真實工作階段的實測結果顯示,保留量由約 162K 降至約 49K token。lean 尾段中的舊工具結果會縮減為附有還原指標的單行簡記,而無法辨識的 tail_mode 值會回退至 lean。31
auxiliary.compression.provider |
auxiliary.compression.base_url |
結果 |
|---|---|---|
auto(預設) |
未設定 | 自動偵測最佳可用供應商 |
nous / openrouter / 等 |
未設定 | 強制使用該供應商及其驗證資訊 |
| 任意值 | 已設定 | 直接使用自訂端點(忽略供應商設定) |
摘要模型支援的上下文長度至少必須與主模型相同,因為它會在單次呼叫中接收對話的完整中段。若其視窗較小,呼叫就會失敗,中段的對話回合也會在未產生摘要的情況下遭到捨棄。431
額度壓力警告
代理處理需要大量工具呼叫的複雜任務時,可能在未察覺的情況下耗盡迭代額度(自 v0.20.0 起,預設由 90 回合提高至 500 回合)。額度壓力機制會自動提醒模型:4
| 門檻 | 等級 | 模型看到的內容 |
|---|---|---|
| 70% | 注意 | [BUDGET: 350/500. 150 iterations left. Start consolidating.] |
| 90% | 警告 | [BUDGET WARNING: 450/500. Only 50 left. Respond NOW.] |
串流逾時
LLM 串流連線有兩層逾時機制,會針對本機供應商(localhost、區域網路 IP)自動調整:4
| 逾時類型 | 預設值 | 本機供應商 | 環境變數 |
|---|---|---|---|
| 通訊端讀取逾時 | 120 秒 | 自動提高至 1800 秒 | HERMES_STREAM_READ_TIMEOUT |
| 串流停滯偵測 | 180 秒 | 自動停用 | HERMES_STREAM_STALE_TIMEOUT |
| API 呼叫(非串流) | 1800 秒 | 不變 | HERMES_API_TIMEOUT |
本機端點的通訊端讀取逾時會提高至 30 分鐘,因為本機 LLM 在處理大型上下文時,可能需要數分鐘完成預填,才會產生第一個 token。4
本機網頁儀表板(v0.9.0+)
透過瀏覽器使用的儀表板,讓您在本機管理 Hermes Agent。無須操作設定檔或終端機,就能調整設定、監控工作階段、瀏覽 skill,以及管理 gateway。16 使用 hermes dashboard 啟動。對偏好 GUI 的新使用者而言,這是最容易上手的方式。
背景程序監控(v0.9.0+)
watch_patterns讓您設定要在背景程序輸出中監控的模式,並在符合時即時收到通知。16無論是監控錯誤、等待特定事件(「正在監聽連接埠」),或追蹤建置記錄,都不需要輪詢。搭配v0.8.0推出的notify_on_complete(在背景工作完成時發出通知),Hermes現在具備完整的背景程序可觀測性層。15
可插拔的context engine(v0.9.0+)
現在可透過hermes plugins插入自訂的上下文管理機制。替換成自訂context engine,即可控制代理在每一輪看到的內容,包括篩選、摘要,或注入特定領域的上下文。16這將上下文策略與代理的核心迴圈解耦,讓您依專案或領域自訂上下文。
備份與還原(v0.9.0+)
hermes backup會建立完整的封存檔,涵蓋設定、工作階段、skill與記憶。hermes import則可從備份封存檔還原。16可用於在不同機器之間遷移、在重大變更前建立快照,或與團隊成員分享已確認可正常運作的設定。
Termux/Android支援(v0.9.0+)
Hermes可透過Termux在Android上原生執行。安裝路徑已配合調整,TUI也針對行動裝置螢幕最佳化;語音後端支援與/image指令均可在裝置上使用。16
安全性強化(v0.13.0+)
v0.13.0修復了8項P0安全性問題,並調整了一項預設設定,讓使用者獲得更好的保護。18v0.14.0接著修復另外12項P0與50項P1問題,涵蓋sudo暴力破解防護與sudo-stdin強化、危險指令防護繞過修正、工具錯誤重新注入模型前的清理、儀表板外掛API驗證、skills-hub的SSRF防護,以及安裝期間的供應鏈安全公告掃描。19
| 修正項目 | 變更內容 |
|---|---|
| 預設啟用機密資訊遮蔽 | 先前需要自行啟用。現在除非明確停用,否則記錄與hermes debug share上傳內容都會遮蔽機密資訊。v0.12.0曾因酬載損毀回報而預設停用遮蔽;v0.13.0重新啟用,作為更安全的基準設定。 |
| Discord跨伺服器私訊防護繞過(CVSS 8.1) | Discord角色允許清單現在限定於各自的伺服器,堵住了使用者憑某個伺服器中的角色,就能取得所有伺服器私訊授權的漏洞。 |
| WhatsApp預設限制 | WhatsApp介接器預設拒絕陌生人,且一律不回覆傳給自己的聊天訊息。 |
| MCP OAuth TOCTOU時間窗口 | 修復了MCP OAuth流程中儲存憑證時的競爭條件。 |
CLI auth.json TOCTOU |
修復了CLI驗證儲存區的憑證寫入器中類似的TOCTOU時間窗口。 |
| 瀏覽器SSRF基本防護 | 混合路由強制套用雲端中繼資料SSRF基本防護,阻擋嘗試存取169.254.169.254及同類位址的請求。 |
| cron提示注入掃描 | 在cron工作執行前,掃描組合完成的提示(包括已載入的skill內容),檢查是否存在提示注入。 |
hermes debug share遮蔽 |
偵錯分享功能會在上傳時遮蔽記錄內容,而非僅在寫入時遮蔽。 |
若您負責維護Hermes部署,請將v0.13.0與v0.14.0視為安全性相關升級,而不只是新增功能的版本。v0.13.0修復了Discord跨伺服器防護繞過問題與2個TOCTOU時間窗口;v0.14.0則進一步強化sudo處理、工具錯誤重新注入、外掛API、skills-hub SSRF防護,以及相依套件安全公告檢查。
v0.21.0帶來第4波強化。現在,寫入受保護的代理指示檔案——AGENTS.md、CLAUDE.md、SOUL.md、.cursorrules、skill與記憶儲存區——一律需要核准,避免遭到提示注入的代理悄悄改寫自身的常設指示。這項核准機制預設啟用(security.protected_instruction_files: true,並可透過protected_instruction_extra_patterns中的fnmatch檔案名稱比對清單擴充保護範圍)。來源明確指出它所阻擋的攻擊途徑:「編輯AGENTS.md/CLAUDE.md/SOUL.md的注入指示」,並說明指示檔案會從目前工作目錄的目錄樹載入,因此「只要代理日後可能從某個位置執行,該處的AGENTS.md就是實際的攻擊目標」。3539同一版本也修補了終端機錯誤、.env檔案讀取、checkpoint與ACP記錄中的機密資訊洩漏漏洞;讓核准系統能辨識Windows破壞性指令與路徑;透過穩定的TCC簽署身分,讓macOS權限授予在更新後仍然有效(一次性設定:hermes desktop --setup-tcc-identity,僅限macOS,需要openssl/security/codesign);在上游遭入侵後移除Blender MCP目錄項目與skill;並為外掛安裝加入Tier-1安全性掃描。3539
v0.21.6帶來第5波強化。此版本修復了Tenable Research回報的4項儀表板驗證問題(偽造X-Forwarded-For以繞過登入速率限制、未經驗證的請求可無限制地寫入驗證稽核記錄、公開的/auth/路由未限制請求本文大小,以及將登入代碼傳送至非回送位址的重新導向目標,導致工作階段可遭接管);自動git呼叫也不再於首次提示前執行不受信任儲存庫自身的clean、smudge或process篩選程式;電子郵件的From標頭則改用parseaddr解析,避免以引號包住的顯示名稱通過允許清單檢查。詳情請參閱v0.21.6新功能。5455
實務工作者的架構指南
本節適合希望了解內部運作機制,以便偵錯、擴充或分析效能的讀者。內容綜整自上游架構文件。3
進入點 → AIAgent
Hermes 的每個進入點最終都會呼叫 AIAgent.run_conversation():
┌──────────────────────────────────────────────────────────────────┐
│ Entry Points │
│ │
│ CLI (cli.py) Gateway (gateway/run.py) ACP (acp_adapter/) │
│ Batch Runner API Server Python Library │
└──────────┬──────────────┬───────────────────────┬────────────────┘
│ │ │
▼ ▼ ▼
┌──────────────────────────────────────────────────────────────────┐
│ AIAgent (run_agent.py) │
│ │
│ ┌─────────────┐ ┌──────────────┐ ┌──────────────┐ │
│ │ Prompt │ │ Provider │ │ Tool │ │
│ │ Builder │ │ Resolution │ │ Dispatch │ │
│ └──────┬──────┘ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │ │
│ ┌──────┴───────┐ ┌──────┴───────┐ ┌──────┴───────┐ │
│ │ Compression │ │ 3 API Modes │ │ Tool Registry│ │
│ │ & Caching │ │ chat_compl │ │ 47 tools │ │
│ │ │ │ codex_resp │ │ 20 toolsets │ │
│ │ │ │ anthropic │ │ │ │
│ └──────────────┘ └──────────────┘ └──────────────┘ │
└──────────────────────────────────────────────────────────────────┘
此圖改編自上游架構文件。3
「47 個工具/20 個 toolset」與啟動橫幅中的「28 個工具」。「47 個工具」是上游儲存庫工具登錄表的總數,涵蓋 Hermes 隨附原始碼的所有工具,橫跨所有 toolset。實際執行的 CLI 會在啟動橫幅中顯示較少的數量(我用來驗證本指南的安裝環境回報 28 tools / 89 skills)。這並非錯誤。許多 toolset 需要自行選擇啟用,必須在 config.yaml 的 toolsets: 下明確設定,例如通訊平台配接器、瀏覽器自動化,以及資源需求較高的擷取工具等。登錄表總數代表「可用的工具」;橫幅中的數字則代表「目前 profile 已啟用的工具」。使用 hermes tools --list 查看啟用中的 toolset,並透過 ~/.hermes/config.yaml 的 toolsets: 區塊啟用或停用個別 toolset(也可在執行中的工作階段使用 /tools list//tools enable <name>//tools disable <name>;移除工具會觸發工作階段重設,讓代理程式重新建立工具清單)。
3 種 API 模式
Hermes 將供應商之間的差異抽象化為 3 種 API 模式,並在執行時自動選擇:3
| API 模式 | 使用者 |
|---|---|
chat_completions |
OpenRouter、z.ai、Kimi、MiniMax、DeepSeek、Alibaba、大多數自訂端點,以及任何與 OpenAI 相容的伺服器 |
codex_responses |
OpenAI Codex(透過 ChatGPT OAuth) |
anthropic_messages |
Anthropic API(原生)、Anthropic OAuth、與 Anthropic 相容的代理伺服器 |
runtime_provider.py 解析器會將 (provider, model) 元組對應至 (api_mode, api_key, base_url),支援超過 18 家供應商,並處理 OAuth 流程、憑證集區與別名解析。3
CLI 工作階段中的資料流
User input → HermesCLI.process_input()
→ AIAgent.run_conversation()
→ agent.prompt_builder.build_system_prompt()
→ runtime_provider.resolve_runtime_provider()
→ API call (chat_completions / codex_responses / anthropic_messages)
→ tool_calls? → model_tools.handle_function_call() → loop
→ final response → display → save to SessionDB
出自上游架構頁面。3
提示詞組合順序
提示詞堆疊包含:13
SOUL.md(代理程式身分;若無法取得,則使用內建備援內容)- 考量可用工具的行為指引
- 記憶/使用者脈絡(
MEMORY.md、USER.md) - skill 指引
- 脈絡檔案(
AGENTS.md、.cursorrules) - 時間戳記
- 平台專屬的格式提示
- 選用的系統提示詞覆加內容,例如
/personality
SOUL.md 是基礎,其餘內容都建構於其上。13
工作階段儲存
工作階段儲存以 SQLite 為基礎,支援 FTS5 全文搜尋。工作階段具備沿革追蹤(跨壓縮操作的父子關係)、各平台隔離,以及能處理資源爭用的原子寫入。3
若在 v0.21.x 安裝環境遇到儲存問題,請使用 v0.21.2 或更新版本:此版本修正了 v0.21.0 時期的一系列 state.db 穩定性問題(第 2 個寫入程序與其他寫入程序互相取消鎖定、正常資料庫被誤報為損毀、單一損壞資料列導致 sessions list 失敗),並將託管聊天室的協調功能從根儲存區移至專用的 shared-state.db,讓各 profile 的 gateway 不再以可寫入模式開啟主工作階段儲存區。hermes doctor 現在會分別指出結構損毀與 FTS 索引損毀;FTS 損毀只會讓搜尋功能降級,不再導致該輪對話失敗。hermes sessions recover --inspect-only(離線、非破壞性、鎖定指定 profile)則會回報標準資料表是否可讀取,而不建立輸出資料庫;此子命令早於這段版本期間就已存在,但先前未在此記載。請參閱 v0.21.2 新功能。48 若儲存區卡在錯誤的 SQLite 日誌模式,v0.21.4 版本期間新增了離線轉換工具 hermes sessions set-journal-mode delete|wal(請參閱頂層命令中的 hermes sessions 列)。51
外掛系統
外掛有 3 個探索來源:~/.hermes/plugins/(使用者)、.hermes/plugins/(專案)與 pip 進入點。外掛透過脈絡 API 註冊工具、掛鉤與 CLI 命令。記憶供應商是位於 plugins/memory/ 下的專用外掛類型。3 自 v0.21.6 起,plugins.isolation: host(預設為 in_process)可讓第三方 Python 外掛程式碼在 Hermes 程序之外執行:一般外掛會載入各 profile 專屬的單一外掛主機程序,且僅透過 ctx 與 Hermes 通訊;其他所有會在程序內匯入使用者程式碼的途徑(類別供應商、模型供應商 profile、儀表板外掛 API)都會拒絕執行並說明原因,而隨附外掛則仍在程序內執行。如此一來,外掛即使無回應或當機,也只會使其主機程序停止運作,不會拖垮 gateway。55 自 v0.21.2 起,另有經過精選、以 SHA 鎖定版本的外掛目錄,可供瀏覽並依名稱安裝;hermes plugins pack 則提供「宣告式、可分享的外掛組合」:透過一份 hermes-pack.yaml,將一組外掛鎖定至確切的提交 SHA。安裝組合時,會分別執行一般的版本鎖定安裝,而功能權限同意仍以個別外掛為單位。48
v0.21.4 版本期間將該目錄從 CLI 介面擴展為隨版本發布的成品。儲存庫的 plugin-catalog/ 目錄從 v2026.9.14 的 9 個項目增加至 v2026.9.21 的 228 個項目。每個外掛各有一份經審查的 YAML(名稱、儲存庫、維護者、層級、類別、功能權限),鎖定至確切的 40 字元提交 SHA,列入該目錄即代表獲准收錄。這些資料發布為 plugin-catalog.json,供 CLI 使用(即時擷取,快取於 ~/.hermes/cache/)。文件網站現在會從同一份資料,為每個外掛(/docs/plugins/<name>)與作者(/docs/plugins/by/<slug>)建立頁面。每個頁面都會呈現從鎖定提交擷取的外掛 README,絕不使用分支最新版本;內容在建置時經過允許清單篩選,移除原始 HTML,並依提交者日期標記新增/更新時間,以供排序。v0.21.4 發布說明列出的 10 個社群外掛,在該標籤版本中皆已列入目錄,其實際目錄識別名稱為:hermes-tailscale、hermes-ssh、shodan、hermes-terminal、hermes-rss(另有獨立的 rss-reader)、hermes-resetwatch、done-bell、kiwi、cognee 與 web-octen。在桌面版中,外掛中心現在可在確認對話框確認後解除安裝外掛:目錄外掛透過 plugins.manage remove 移除,獨立桌面外掛則透過 Electron 載入器移除。51
hermes plugins # Interactive enable/disable UI
hermes plugins browse # List every curated plugin catalog entry (v0.21.2+)
hermes plugins search <query> # Search the curated plugin catalog (v0.21.2+)
hermes plugins install <name|repo> # Install from the curated catalog, a Git URL, or owner/repo
hermes plugins enable <name>
hermes plugins disable <name>
hermes plugins list
hermes plugins pack install <src> # Shareable SHA-pinned plugin sets; also: pack export, pack show (v0.21.2+)
相容性過渡期(v0.21.1),現已結束:外部外掛必須在2026年9月14日前停止使用模組拆分前的匯入路徑。 2026年9月的模組拆分(PR #102117)移動了外掛常用的內部匯入項目,暫時性的
COMPAT_MANIFEST.md相容層則從舊模組重新匯出 1,148 個已移動的公開名稱,並針對每個名稱,在每個程序中發出一次警告(HermesPluginCompatWarning)。停用措施已於2026年9月14日如期生效,由隨附程式碼中的日期條件控制(hermes_cli/plugin_compat.py中的COMPAT_REMOVAL_DATE;無須進行程式碼還原):自該日起,受影響的外掛會被停用,不再載入,並在 CLI 橫幅、hermes doctor與hermes update中顯示紅色通知,桌面版會顯示一次強制回應視窗,hermes plugins list則會列出原因。外掛作者請注意:hermes plugins compat <path>仍會逐一列出每個file:line及其舊路徑 → 新路徑;只要還有未遷移項目,就會以結束代碼 1 結束(加上--json可取得機器可讀的輸出)。仍依賴無人維護外掛的使用者,可以在config.yaml中設定plugins.allow_deprecated_imports: true;該值必須是 YAML 布林字面值,不能是加上引號的字串。此設定仍有效,因為刪除舊路徑的還原變更尚未合併:清單與相容性轉接層在v2026.9.14、v2026.9.21、v2026.9.24,以及截至9月24日的main中都仍存在(v0.21.4 版本期間對相容性模組的修改僅涉及快取外掛掃描結果與正規化 Windows 路徑;v0.21.5 版本期間未變更hermes_cli/plugin_compat.py,僅移除清單中已刪除的 Hindsight 模組項目)。該還原變更一旦合併,這個應急方式就會失效,因為舊路徑本身將不復存在。相容性支援僅涵蓋公開的頂層名稱;私有名稱與測試用的動態修補接點從未屬於支援介面,也不會恢復。4253 到了v0.21.6,此應急方式已失效:清單、相容性轉接層、hermes plugins compat掃描器與plugins.allow_deprecated_imports均已移除,hermes_cli/plugin_compat.py則成為不具功能的存根,僅為仍從舊版簽出目錄執行的更新程式保留;仍匯入拆分前路徑的外掛將無法匯入。55
設計原則
出自上游架構頁面:3
| 原則 | 實務意義 |
|---|---|
| 提示詞穩定性 | 系統提示詞不會在對話途中變更。除了使用者明確執行的操作(/model),不會進行使快取失效的變動 |
| 執行過程可觀察 | 每次工具呼叫都會透過回呼呈現給使用者。CLI(旋轉指示器)與 gateway(聊天訊息)都會顯示進度更新 |
| 可中斷 | 使用者輸入或訊號可在執行途中取消 API 呼叫與工具執行 |
| 核心與平台無關 | 單一 AIAgent 類別支援 CLI、gateway、ACP、批次處理與 API 伺服器。平台差異由進入點處理 |
| 鬆散耦合 | 選用子系統(MCP、外掛、記憶供應商、RL 環境)採用登錄表模式與 check_fn 條件控制,不建立強制相依關係 |
| profile 隔離 | 每個 profile 都有各自的 HERMES_HOME、設定、記憶、工作階段與 gateway PID。多個 profile 可並行執行 |
從OpenClaw遷移
Hermes Agent是OpenClaw的後繼產品。如果您要從現有的OpenClaw安裝環境遷移:65
hermes claw migrate --dry-run # Preview what would be migrated
hermes claw migrate --preset full # Full migration including API keys
hermes claw migrate --preset user-data --overwrite # User data only, no secrets
hermes claw migrate --source /custom/path # Non-default OpenClaw location
hermes claw migrate預設會從~/.openclaw讀取資料(也會自動偵測舊版的~/.clawdbot和~/.moldbot目錄),並寫入~/.hermes。6
直接匯入(30多個類別):SOUL.md、MEMORY.md、USER.md、AGENTS.md、來自4個來源目錄的skill、預設模型、自訂供應商、MCP伺服器、通訊平台權杖與允許清單(Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Mattermost)、代理程式預設值(推理強度、壓縮、人為延遲、時區、沙箱)、工作階段重設原則(目前已無作用:自v0.21.1起,計時器不再切換對話43)、核准規則、TTS設定、瀏覽器設定、工具設定、執行逾時、指令允許清單、gateway設定,以及來自3個來源的API金鑰。6
封存以供人工檢查:cron作業、外掛程式、掛鉤/webhook、記憶後端(QMD)、skill登錄庫設定、使用者介面/身分、日誌記錄、多代理程式設定、頻道綁定、IDENTITY.md、TOOLS.md、HEARTBEAT.md、BOOTSTRAP.md。6
解析API金鑰時,會依優先順序檢查3個來源:設定值→~/.openclaw/.env→auth-profiles.json。6
疑難排解
「尚未設定推論供應商。請執行’hermes model’選擇供應商與模型」
全新安裝後最先遇到的錯誤:Hermes尚未找到可用的供應商。訊息的意思很直接:3種驗證途徑都未能提供可用的供應商。請執行:
hermes model
互動式選擇器會引導您設定各種支援的供應商,包括OAuth裝置代碼流程(Nous Portal、GitHub Copilot、Anthropic、OpenAI Codex),以及自架伺服器的自訂端點。如果您認為供應商應該已設定完成,hermes doctor會顯示Hermes實際能讀取哪些憑證。常見原因包括:API金鑰設在錯誤的位置(應放在.env中,或透過hermes config set設定,而非shell的profile檔案)、~/.hermes/auth.json中的OAuth憑證已過期,或config.yaml中的自訂端點遺失了base_url。驗證與供應商一節有各種驗證途徑的詳細說明。27
「尚未設定API金鑰」
執行hermes model以互動方式設定供應商,或執行hermes config set OPENROUTER_API_KEY your_key。hermes doctor指令會明確指出缺少哪些金鑰。7
啟動時顯示「上下文上限:2048個token」(本機模型)
Hermes會從伺服器的/v1/models端點自動偵測上下文長度,但許多本機伺服器回報的預設值偏低。請在config.yaml中明確設定:2
model:
default: your-model
provider: custom
base_url: http://localhost:11434/v1
context_length: 32768
工具呼叫顯示為文字,卻未執行
伺服器未啟用工具呼叫,或模型不支援伺服器實作的工具呼叫方式。2
| 伺服器 | 修正方式 |
|---|---|
| llama.cpp | 在啟動指令中加入--jinja |
| vLLM | 加入--enable-auto-tool-choice --tool-call-parser hermes |
| SGLang | 加入--tool-call-parser qwen(或適用的剖析器) |
| Ollama | 預設已啟用工具呼叫,請用ollama show <model>確認模型是否支援 |
| LM Studio | 更新至0.3.6以上版本,並使用原生支援工具呼叫的模型 |
回應在句子中途遭截斷
可能有2個原因:2
- 伺服器的輸出上限偏低(
max_tokens):SGLang預設每次回應最多128個token。請在伺服器上設定--default-max-tokens,或在config.yaml中設定model.max_tokens。 - 上下文空間耗盡:模型已用滿上下文視窗。請提高
model.context_length,或在Hermes中啟用上下文壓縮。
從WSL2連線至Windows上執行的模型伺服器時,出現「連線遭拒」
WSL2使用具有獨立子網路的虛擬網路介面卡,因此WSL2內的localhost指向Linux虛擬機器,而非Windows主機。有2種解決方式:2
鏡像網路模式(Windows 11 22H2以上版本):編輯%USERPROFILE%\.wslconfig:
[wsl2]
networkingMode=mirrored
接著執行wsl --shutdown並重新啟動。此時即可透過localhost雙向連線。
改用主機IP(較舊的Windows版本):在WSL2內取得Windows主機的IP,並用它取代localhost:
ip route show | grep -i default | awk '{ print $3 }'
# Use that IP as the base_url host
模型伺服器也必須綁定至0.0.0.0,而非127.0.0.1。Ollama請設定OLLAMA_HOST=0.0.0.0;llama-server/SGLang請加入--host 0.0.0.0;LM Studio則請啟用「透過網路提供服務」。2
迭代次數上限未採用agent.max_turns
如果活動狀態列顯示N/90(或其他過時的上限),但config.yaml設定的是agent.max_turns: 500,可能是~/.hermes/.env中仍留有過時的HERMES_MAX_ITERATIONS設定行。設定精靈過去會將此上限同時寫入這2處;若啟動時的銜接程序因較早發生的設定剖析錯誤而中止,.env中殘留的值就會悄悄優先生效。自v0.21.1起,hermes doctor會偵測這組互相覆蓋的設定,而hermes doctor --fix會刪除.env中的設定行,讓config.yaml成為唯一依據。41
各項資料都在哪裡?
這時hermes status和hermes dump就能派上用場。hermes logs list會列出所有日誌檔案及其大小。hermes config path會印出設定檔的位置。hermes config env-path會印出.env的位置。6
常見問題
Hermes Agent與Claude Code有什麼差別?
Claude Code是Anthropic的官方CLI,僅限使用Anthropic模型。Hermes Agent則是Nous Research開發的開源代理框架,可搭配任何相容於OpenAI的供應商使用,包括Nous Portal、OpenRouter、Anthropic、GitHub Copilot、z.ai、Kimi、MiniMax、DeepSeek、Hugging Face、Google,或您自行架設的端點。12 Hermes也內建支援Telegram/Discord/Slack/WhatsApp/Signal的訊息gateway,這是Claude Code未提供的功能。
可以使用Anthropic的API金鑰來執行Hermes嗎?
可以,有3種方式:2
- 在
~/.hermes/.env中設定ANTHROPIC_API_KEY,並執行hermes chat --provider anthropic --model claude-sonnet-4-6 - 執行
hermes model並選取Anthropic;若可用,Hermes會使用Claude Code的憑證儲存區 - 手動設定
ANTHROPIC_TOKEN(setup-token或OAuth權杖),作為備援
若已在同一台電腦上使用Claude Code,建議採用第2種方式,讓可更新的Claude憑證持續保有更新能力。
如何切換供應商,同時保留對話?
在工作階段中使用/model provider:model。對話紀錄、記憶與skill都會保留:9
/model zai:glm-5
/model openrouter:anthropic/claude-sonnet-4
/model custom:local:qwen-2.5
我已設定Anthropic,但視覺/網頁/壓縮功能無法運作
在目前版本中,大多已不會因為過去的原因而出現這種情況。預設設定(auxiliary.*.provider: "auto")會讓所有輔助任務,包括視覺、核准分類、壓縮與工作階段標題,都使用您的主要聊天模型。因此,即使只設定Anthropic,也能使用既有的OAuth處理這些任務。舊有的預設行為已移除:過去會依序自動偵測透過OpenRouter使用的Gemini Flash、Nous及Codex,若都未設定便會在不提示的情況下降級。現在則是「auto一律使用主要模型,但config.yaml中的個別任務覆寫設定仍有優先權」。34
若輔助任務仍然失敗,請檢查是否有個別任務的明確覆寫設定指向尚未設定的供應商(config.yaml中的auxiliary.<task>.provider/.model),或殘留舊版設定鍵。自標籤v2026.8.31起,壓縮摘要工具與其他輔助任務採用相同的設定方式,也就是auxiliary.compression.provider;舊版compression.summary_*設定鍵會自動遷移至此處(設定版本17)。31 網頁內容擷取也已不再是LLM任務(「不涉及LLM」),因此在目前版本中,網頁摘要失敗並非輔助模型的問題。34 若要明確指定某項任務重新使用主要供應商:
auxiliary:
vision: { provider: "main" }
compression: { provider: "main" }
SOUL.md與AGENTS.md有什麼差別?
SOUL.md定義代理的身分特質,包括語氣、風格與預設溝通方式。它位於~/.hermes/SOUL.md,在各處都會套用。AGENTS.md則專屬於個別專案,涵蓋架構、慣例、指令與路徑,存放在專案目錄中。13 若內容應在各處通用,就放入SOUL.md;若屬於特定專案,就放入AGENTS.md。
如何同時執行多個Hermes執行個體?
使用profile。每個profile都有獨立的HERMES_HOME、設定、記憶、工作階段與gateway PID:6
hermes profile create work --clone
hermes profile use work # Sticky default
hermes -p work chat -q "..." # One-off without switching
hermes profile alias work --name h-work # Wrapper script
Hermes支援本機LLM嗎?
支援,透過自訂端點即可使用。Hermes可搭配任何相容於OpenAI的伺服器,包括Ollama、vLLM、SGLang、llama.cpp/llama-server、LM Studio、LocalAI、Jan,或您自行架設的伺服器。2 各伺服器的設定方式請參閱自訂與自行架設的端點。
為什麼啟動畫面顯示的工具數量,比指南所列的Hermes工具數量少?
本指南引用上游架構登錄表中的47個工具/20個toolset,這是Hermes隨附原始碼中所有toolset的工具總數。實際執行時,啟動畫面顯示的數量較少(本指南使用的參考安裝環境顯示28個工具),是因為Hermes啟動時只會啟用預設的toolset組合。許多toolset需要自行啟用:訊息gateway介接器、瀏覽器自動化、較耗資源的資料擷取套件,以及多種專門整合,都必須明確列在~/.hermes/config.yaml的toolsets:之下才會載入。登錄表總數=「啟用後可使用的工具」。啟動畫面總數=「目前profile實際載入的工具」。使用hermes tools --list即可查看哪些toolset已啟用,以及哪些可用但尚未啟用。執行期間可透過/tools enable <name>與/tools disable <name>切換個別toolset的啟用狀態(停用會觸發工作階段重設,讓代理依照新的工具組合重建工具清單)。
主要供應商失敗時,Hermes如何切換至備援模型?
在config.yaml中設定fallback_model區塊:2
fallback_model:
provider: openrouter
model: anthropic/claude-sonnet-4
當主要供應商失敗時(流量限制、伺服器錯誤、驗證失敗),Hermes會在工作階段中途切換至備援模型,並保留對話紀錄。每個工作階段最多觸發1次。
代理能隨著時間持續改進自己的skill嗎?
可以,這正是Hermes Agent「自我改進」的部分。代理可透過skill_manage工具建立、更新及刪除skill。當它掌握較複雜的工作流程時,便會將方法儲存為skill,供日後重複使用。11 代理會在完成複雜任務(呼叫工具5次以上)、遇到錯誤並找到可行方法、您修正其做法,或它發現較複雜的工作流程時建立skill。
有IDE整合嗎?
有,Hermes可作為ACP(Agent Client Protocol)伺服器執行,供VS Code、Zed與JetBrains使用:6
pip install -e '.[acp]'
hermes acp
變更紀錄
| 日期 | 變更 | 來源 |
|---|---|---|
| 2026年11月2日 | 指南v1.30:Hermes v0.22.6(標籤v0.22.6,11月2日),即第4個精簡的彙整版本,彙整自v0.22.5以來約776個PR,整理後的版本說明仍延至v0.23.0提供。 頂端新增「最新消息」章節,列出該版本自述的項目並已在標籤中驗證;重點摘要提供該章節的導引。已將完整檔案樹與v0.22.5比對驗證(新增1,504個、移除237個、變更2,646個):目錄項目從763增至911,平台外掛維持27個,模型供應商外掛從41減至39,原因是GitHub Copilot於10月25日退出核心,改為github-copilot labs外掛(版本說明未提及;hermes update會為曾使用它的profile安裝此外掛),新增config_backends/remote與ConfigBackend介面層;記憶供應商、語系與相容性存根均未變更。內文更新:Copilot章節與對照表各列、/model reset、hermes webapp與hermes vault各列、hermes cron cancel與錯過執行的處理原則、hermes migrate <agent>(Grok Bot、OpenBot)、curator的lock與unlock、compression.prepare_ahead,以及ElevenLabs的voice_id與find_voices。 |
6667 |
| 2026年10月23日 | 指南v1.29:Hermes v0.22.3(10月21日)、v0.22.4(10月21日)、v0.22.5(10月22日,10月23日發布)——3個精簡的彙整版本,整理後的版本說明將隨v0.23.0提供。 頂端新增「最新消息」章節,分別列出各版本的變更;重點摘要提供該章節的導引。已將該標籤的完整檔案樹與v0.22.2比對驗證(新增2,303個、移除109個、變更2,298個):目錄項目從614增至763,平台外掛從21增至27,供應商維持41個,記憶外掛、語系與相容性存根均未變更,選擇器維持39列;sessions.auto_prune恢復為false;mcp_serve.py與claw/import-agent模組從核心移至mcp-serve及agent-importers外掛;委派後端位於agent/。內文更新:v0.22.0的自動清理項目、OpenClaw敘述、Nous登入段落,以及hermes mcp、hermes plugins、hermes claw與hermes import-agent各列。 |
6465 |
| 2026年10月17日 | 指南v1.28:Hermes v0.22.2(標籤v0.22.2,10月15日)——修正後的修補版本;v0.22.1「以錯誤的提交建置」,已由此版本取代。 頂端新增「最新消息」章節;重點摘要提供該章節的導引。已將該標籤與v0.22.1(移除1,135個檔案、變更846個)及v0.22.0(新增50個、移除1個、變更205個)比對驗證:目錄維持614項、精選項目優先的選擇器、Nemotron識別碼、41個供應商、39列、記憶外掛、語系與相容性存根均保留;gateway的「工作階段權限歸屬」重整、hermes_state_*模組,以及壓縮時的skill標記修正與其文件章節則未保留。v0.22.2新增2項修正:重新開機後啟動gateway(開機時間戳記+主機鎖定),以及筆記型電腦上本機模型的長時間回合(新增6個agent/模組)。v0.22.1章節已改為標示該版本已被取代;gateway與本機模型章節也補充了相關修正。 |
6263 |
| 2026年10月14日 | 指南v1.27:Hermes v0.22.1(標籤v0.22.1,10月14日)——以v0.22.0為基礎的修補版本;版本說明僅有1句話與自動產生的提交清單。 頂端新增簡短的「最新消息」章節;重點摘要提供該章節的導引,並重新標註選擇器數量所對應的標籤。已於該標籤驗證:目錄從601項增至614項(2個桌面版語言套件、TeamoRouter,以及另外8個具名項目)、模型選擇器將精選識別碼排在最前、Nemotron Super 3.5識別碼,以及已載入skill的壓縮修正;供應商維持41個,靜態列維持39列,記憶外掛、語系與相容性存根均未變更。已修訂v0.22.0章節的日期。 |
6061 |
| 2026年10月14日 | 指南v1.26:Hermes v0.22.0(標籤v0.22.0,日期為10月13日,10月14日發布)——「The Threshold Release」,彙整了v0.21.1至v0.21.7整個版本系列,以及v0.21.7之後756筆提交的變更紀錄。 頂端新增「最新消息」章節;重點摘要提供該章節的導引。涵蓋內容:桌面版首次啟動導引,含nous/welcome試用與set_theme、託管應用程式連接器(/connectors、hermes connectors)、受管理的本機llama.cpp模型、已簽署的桌面版套件與hermes pm、含600個項目的外掛目錄、Claude 5.5與GPT-6模型陣容、瀏覽器中的密碼管理器登入、Bot Screen、每台機器各1個gateway與後端、子代理監控器、7項升級注意事項,以及已還原的變更清單。CLI表格新增hermes connectors、hermes pm與hermes usage;斜線指令表格新增/connectors;更新「本機LLM伺服器」、「profile」與「外部記憶供應商」章節;修訂v0.21.7章節的日期。 |
5859 |
| 2026年10月13日 | 指南v1.25:Hermes v0.21.7(標籤v0.21.7,10月11日)——第5個彙整修補版本,首次涵蓋所有發布管道(桌面版、Store/MSIX、安裝程式、Docker、Cloud);整理後的版本說明延至v0.22.0提供。 頂端新增「最新消息」章節;重點摘要提供該章節的導引。依標籤內容深入確認的涵蓋項目:原始碼安裝改為追蹤帶有標籤的版本(使用hermes update --set-channel main可繼續追蹤main,另含--channel、--install-id,以及update.installs下各次安裝的紀錄)、桌面版的更新管道切換、恢復時重播已簽署的思考內容與Bedrock Converse推理、穩定版檢查中的403與權杖處理、Holographic移至目錄(核心保留ByteRover與RetainDB),以及目錄從493項增至552項。更新CLI表格的hermes update列與「外部記憶供應商」章節;修訂v0.21.6章節的日期。 |
5657 |
| 2026年10月11日 | 指南v1.24:Hermes v0.21.6(標籤v0.21.6,10月8日)——第4個彙整修補版本,也是首個透過新版穩定版本發布流程產出的版本(僅提供標籤、GitHub版本與Docker映像檔);整理後的版本說明延至v0.22.0提供。 頂端新增「最新消息」章節;重點摘要提供該章節的導引。依標籤內容深入確認的涵蓋項目:stt.streaming即時轉錄、auxiliary.voice_chat欄位、plugins.isolation: host、另外4個記憶供應商移至目錄(Honcho、Mem0、OpenViking、Supermemory;核心保留ByteRover、Holographic、RetainDB)、移除外掛相容層與allow_deprecated_imports、hermes status優先顯示摘要(--full、--deep;該標籤未提供--short旗標)、可插拔的語言套件、供應商外掛從38個增至41個、選擇器加入GPT-6.1 Sol與Claude Sonnet/Haiku 5.5、2個核准偵測器、cron儲存區健康狀態降級、Discord初始設定導引,以及Tenable、git-filter與電子郵件寄件者的安全性修正。已更新「輔助模型」、「在地化」、CLI表格、「外部記憶供應商」、「訊息gateway」、「外掛系統」、相容性提示框與「安全性強化」。 |
5455 |
| 2026年9月24日 | 指南v1.23:v0.14.0入門說明區塊自指南首版起便位於目前版本上方,現已移至「最新消息」歷史紀錄末尾,作為最早的章節,與其餘歷史紀錄採用由新到舊的順序一致。內容未變更;重點摘要現在從「重點整理」直接銜接來源註記與「選擇您的使用路徑」。 | 指南結構 |
| 2026年9月24日 | 指南v1.22:Hermes v0.21.5(標籤v2026.9.24,9月24日)——第3個彙整修補版本,整理後的版本說明延至v0.22.0提供。 頂端新增「最新消息」章節;重點摘要提供該章節的導引。依標籤內容深入確認的涵蓋項目:Hindsight從核心檔案樹移至外掛目錄(版本說明未提及),並提供自動移轉;停用gateway.multiplex_profiles: false、各profile個別暫停,以及gateway.standalone;Nous與OpenRouter選擇器加入GPT-6 Sol/Luna與Claude Opus 5.5。「外部記憶供應商」現列出7個內附供應商,以及目錄中的Hindsight。「訊息gateway」新增段落,說明已停用的退出選項。已於該標籤重新檢查相容性提示框:plugin_compat.py未變更,備用機制仍可使用。更正:內附供應商外掛數量為38個,而非39個,並將OpenCode Free列標示為已移除;這2項變更均始於9月18日。 |
5253 |
| 2026年9月23日 | 指南v1.21:檢查並改善正確性與可讀性,仍以Hermes v0.21.4為準(標籤v2026.9.21;尚無更新版本)。「最新消息」現採由新到舊的順序,v0.21.3有獨立章節,重點摘要則以目前版本開頭。配對:decline是唯一新增的值;只要設定任何允許清單,實際預設值即為ignore;YAML格式為platforms.<name>.unauthorized_dm_behavior或頂層鍵。stream-json接受--query-file,並為此新增選項列。set-journal-mode補充必須先停止所有相關程序的規則,以及Windows的--force。主機單一執行個體段落現在先說明操作人員應採取的動作。移除描述寫入程序的句子。 |
5051 |
| 2026-09-22 | 指南v1.20:Hermes v0.21.4(標籤v2026.9.21,9月21日)——第2次彙整修補版本:自v0.21.3以來累計「5,071筆非合併提交」、「5,169個變更檔案」、「1,812個已合併PR」、「2,116個已關閉議題」,但版本說明僅簡短帶過,將精選內容的介紹延後至v0.22.0。在v0.21.3區塊下方新增「最新動態」章節。已在本機複製的儲存庫中,於指定的統計提交4b8a8134精確重現全部5項主要數據(標籤另增加1筆版本發布提交:非合併提交共5,072筆;比較範圍若含合併提交則共5,173筆,與GitHub比較API相符);這是歷來第2大的標籤間變更區間,僅次於v0.21.1的5,139筆(已重新核對,此說法仍成立)。版本說明刻意未詳述的項目,均在核對該標籤的原始碼後才納入,並分別補入既有章節:主機單一執行個體(gateway/host_rendezvous.py:每台主機的每位作業系統使用者各限1個hermes serve與1個hermes gateway run,以主機鎖定及會合紀錄搭配(pid, createTime)確認程序仍在執行;host_attach.py有ATTACH/RESCAN/REPLACE_HOST/REFUSE/START共5種結果;Desktop端的host-backend-attach.ts依序採用紀錄帳本 -> HTTP -> 權杖 -> WS,並設有主機層級的程序啟動閘控——已在訊息gateway章節新增段落);由後端統一管理的單一連接器操作(tools/connectors/operation.py「純資料,無I/O」,300秒期限刻意不設為設定鍵,依該標籤的測試,Desktop/TUI/CLI均提供manage_connections設定卡片——已擴充Nous免費方案小節);--format stream-json(_parser.py:247-249 + hermes_cli/stream_json.py:system/init -> text/tool_use/tool_result -> 單一result封裝;必須搭配-q,隱含啟用--quiet,不允許搭配--tui,工具內容上限為5,000個字元——已在聊天選項表格新增此列);skills.auto_load(config_defaults.py:1435,「固定為在每個新工作階段中完整載入(CLI、TUI、gateway、cron、API)」,於建構提示時解析1次,找不到名稱時會警告並略過,HERMES_IGNORE_RULES可抑制此行為——新增「固定載入的skill」小節);gateway decline(gateway/config.py:139,先禮貌拒絕1次,再依DECLINE_DEDUPE_SECONDS保持24小時靜默,#88028,unauthorized_dm_decline_message,可透過platforms.<name>.extra分別設定各平台,電子郵件預設為ignore——已擴充配對章節);mcp.discovery_concurrency(config_defaults.py:526預設為4,0 = 不設上限,#117373,無效值會觸發警告並採用預設值,仍會連線至每台伺服器——已擴充MCP章節);session_search的after/before + 放寬為OR條件後重試(工具結構定義:708-725,包含/不包含邊界,支援ISO或7d/24h/2w;hermes_state_search.py:1151-1163在結果為零時,於unicode61索引上以任一詞彙符合的條件重試,保留精確命中的語意,OR/NOT/單一詞彙/CJK不適用——已擴充工作階段搜尋章節,並依34將該章節過時的「Gemini Flash摘要」說法,修正為v0.15.0不使用LLM的單一結構設計);hermes sessions set-journal-mode delete\|wal(subcommands/sessions.py:177 + sessions_cmd_journal_mode.py,針對#100896提供離線自助處理方式,若有其他程序持有資源則拒絕執行,驗證標頭的第18/19位元組,doctor會引導使用者使用此命令——已擴充sessions列與工作階段儲存章節);Desktop系列更新(字型欄位desktop.font_family可覆寫佈景主題的--dt-font-sans,建議優先考量無障礙需求;「更新引擎」可一鍵更新執行環境,失敗時會顯示重試選項;Plugins中心透過plugins.manage remove/Electron載入器解除安裝前,須先確認);影片目錄(plugins/video_gen/fal的ltx-2.5 + kling-o3,附上該標籤的功能字串;已加入toolset參考資料的名單列);外掛目錄擴充(plugin-catalog/在此區間由9個項目增至228個,YAML須固定SHA才可收錄,各外掛/作者皆有網站頁面,透過允許清單轉譯器呈現固定提交版本的README,依提交者日期排序新增/更新項目;已確認版本說明列出的10個社群外掛確實存在,其實際識別名稱為hermes-tailscale/hermes-ssh/shodan/hermes-terminal/hermes-rss/hermes-resetwatch/done-bell/kiwi/cognee/web-octen——已擴充外掛系統章節)。依版本說明本身的延期安排,整批修正類別(profile/多工隔離、cron、kanban、Desktop、state.db)留待v0.22.0檢查時處理。已重新驗證相容性狀態:刪除路徑的還原變更仍未合併——v2026.9.21以及main的a53b42ddea(2026年9月22日,當日擷取)均仍保留資訊清單與相容層;此區間內plugin_compat.py的變更僅包含外掛掃描快取與採POSIX格式的Windows路徑(#112576),布林字面值防護條件從:261-268移至:296-303,仍為is True;已更新v0.21.1項目、v0.21.3區塊、外掛系統資訊框及42,反映最新狀態。於v2026.9.21重新核定:靜態供應商39個(models_catalog_static.py:311的AST計數),供應商外掛目錄也為39個,兩者皆未變;重點摘要中的供應商數量核定版本由v2026.9.14更新為v2026.9.21;移除將v0.21.3稱為「目前版本」的措辭。 |
505142 |
| 2026-09-15 | 指南v1.19:Hermes v0.21.2(標籤v2026.9.11,9月11日)「state.db修補版本」+ v0.21.3(標籤v2026.9.14,9月14日),以及外掛相容期限屆滿後的狀況。 在v0.21.1章節下方新增版本新功能章節。v0.21.2(「947筆非合併提交」、「312個已合併PR」、「140位貢獻者」)以state.db可靠性改善計畫為主軸(6個PR、44個問題:將託管聊天室的協調作業從根儲存區移至shared-state.db——已於該標籤驗證gateway/hosted_rooms.py:398-426;儀表板優先以唯讀模式開啟;透過受追蹤的連線登錄表保護cron作業;doctor --fix拒絕執行無法證明安全的checkpoint;FTS索引損壞時降低搜尋功能,而非以封閉失敗方式中止回合;損壞的資料列顯示為?,不再導致sessions list終止;將綁定固定於指定profile;唯讀開啟不再取得寫入鎖定,耗時由4–20秒降至0.01秒;保留版本說明提供給維運人員的操作指引:先執行hermes doctor,再執行hermes sessions recover --inspect-only——剖析器位於hermes_cli/subcommands/sessions.py:185-196,且此子命令早於本次版本區間便已存在(v2026.8.31已有),因此標示為本次新增介紹,而非新增功能);強化多profile隔離(#107609–#107630修補了自v0.19.0以來「完全隔離」承諾中的實際漏洞——繼承的允許清單、憑證傳送至預設profile的主機、保管庫機密傳送至stdio MCP伺服器、跨profile的MEDIA:附件,以及同層Nous持有者權杖;已在profile章節與訊息gateway的多工處理段落補上如實說明);不暴露密碼的憑證保管庫(透過僅含中繼資料、具命名空間的控制代碼,從1Password、Bitwarden或本機保管庫登入、付款或自動填入,密碼於填入時才解析取得;主密碼絕不作為工具引數;從已儲存的驗證器金鑰產生TOTP——已於該標籤驗證agent/vault_backends/ + agent/vault_store.py:74-105);外掛目錄(hermes plugins browse/search + 支援目錄的install + pack install/export/show,以SHA固定版本——已於該標籤驗證子剖析器;已更新外掛系統的命令區塊);Nous免費方案與首次啟動導引(免費推論與連接器、在聊天中使用/login、HERMES_GUEST_ONBOARDING=1且僅字面值1會啟用——已驗證guest-onboarding-flag.test.ts;於Nous Tool Gateway下新增小節);以及桌面程序大量衍生問題的修正。另有精簡的v0.21.3區塊(「1,036筆非合併提交」、「338個已合併PR」;建立此標籤是為了讓自動更新的Cloud代理程式取得更新):將同時發生的權杖更新合併為單一請求,避免更新請求暴增導致工作階段遭撤銷(提交5dea46d13d,#110061),並停止建立重複的state.db寫入控制代碼(提交939a2f64b4,#110934);兩者僅於v2026.9.11..v2026.9.14區間內驗證;引用版本說明本身的延後記錄聲明(「此區間完整且經彙整的版本說明將隨v0.22.0發布,涵蓋自v0.21.0以來的所有內容」……「此區間的任何內容都不會略過」),並在本列列出其刻意暫不記錄的項目(推理強度選擇器、OpenRouter PKCE、HEIF/AVIF、這一波FAL更新、Slack Agent Sessions API、拒絕跨VM使用WAL),留待v0.22.0檢視時處理。將相容期限屆滿後的狀況改寫為過去式,涵蓋v0.21.1的拆分項目、外掛系統說明框及42:移除機制已按時透過日期條件生效,並非透過還原程式碼實施(v2026.9.14的hermes_cli/plugin_compat.py:32設定COMPAT_REMOVAL_DATE;位於:86–90的removal_in_effect()自2026年9月14日起回傳true),受影響的外掛目前已停用並顯示紅色通知——但刪除舊匯入路徑的還原變更尚未併入(該標籤及main的5d59366010均仍有COMPAT_MANIFEST.md + compat_manifest.json + 相容墊片,擷取時間為2026年9月15日太平洋時間12:55),因此plugins.allow_deprecated_imports: true仍可讓受影響的外掛載入;僅接受布林字面值(plugin_compat.py:261-268、is True——加上引號的字串絕不會啟用此繞過機制)。僅記錄於變更紀錄、且已由版本說明或原始碼驗證的項目:Telegram的bots_require_mention要求以@提及機器人,阻止機器人彼此回覆形成迴圈;hermes -z --resume會繼續工作階段(-z = --oneshot,hermes_cli/_parser.py:113);被動更新檢查改為每天最多存取一次GitHub API,不再每30分鐘執行git擷取(v2026.9.11的banner.py:129-131、v2026.9.14的:136-139);hermes backup -k/--keep預設會清理舊檔,僅保留最新3個zip檔(subcommands/backup.py:24-26),且config.yaml備份集中於單一、有保留上限的backups/config/目錄;model_thresholds的鍵可採用provider:substr格式,限定適用的供應商(agent/context_compressor.py:1558-1567);--clone-all不再複製cron作業(此旗標屬於hermes profile,見subcommands/profile.py:24,並非hermes cron);kanban promote會在父項目尚未完成時拒絕升級,kanban_request_review則會拒絕未知的審查者profile;/model與輔助功能的自動模式絕不會向未選取的供應商產生費用,也絕不會自動切換至未設定憑證的供應商;選擇器新增DeepSeek V4.1 Flash(Nous Portal + OpenRouter)、GPT Image 2.5,以及原生Anthropic選擇器中的Opus 5 + Fable 5.1;debug share在使用dpaste備援服務時,保留期限縮短為1天。於v2026.9.14重新確認:靜態供應商39個(以AST計算models_catalog_static.py:314中CANONICAL_PROVIDERS的數量)、供應商外掛目錄39個,兩者皆未變;--max-turns預設值500目前位於cli.py:404(41的cli.py:400對其所引用的標籤仍然正確);model_catalog.ttl_minutes為20(config_defaults.py:1866);相較於兩個新區間(本機非合併提交計數為959與1,037),v0.21.1仍是提交數最多的版本區間(5,139);重點摘要中供應商數量的確認標籤已由v2026.9.7更新為v2026.9.14。 |
484942 |
| 2026-09-08 | 指南v1.18:Hermes v0.21.1(標籤v2026.9.7,9月7日)– 彙整修補版:迄今相鄰標籤間規模最大的更新區間(「5,139筆非合併提交」、「632個已合併PR」),修補說明刻意保持精簡,將精選說明留待v0.22.0。 在Pantheon章節上方新增最新動態章節,分為6個經原始碼驗證的主題群:9月的模組拆分+2026年9月14日外掛相容性期限(COMPAT_MANIFEST.md:1,148個已搬移、延遲載入的名稱,每個名稱僅發出一次HermesPluginCompatWarning、hermes plugins compat檢查工具、plugins.allow_deprecated_imports應急設定;外掛系統章節新增相容性過渡期說明框);僅能明確指定的gateway對話邊界(SessionResetPolicy現已不再生效 – 已更新訊息gateway章節,並在claw遷移清單加註);MCP裝置代碼OAuth(hermes mcp login --flow device,RFC 8628;MCP命令區塊新增login與reauth --all;透過OAuth工作階段確立profile歸屬、忽略格式錯誤的中繼資料快取、桌面用戶端本機回呼、以-t篩選要啟動的MCP伺服器);委派可靠性(透過delegation.independent_completions搭配各任務的group設定完成通知單位,預設每次呼叫發出一次完成通知;背景程序交接,結果中明列orphaned_processes與unread_completions;delegation.fallback_providers;經正規化器驗證的子代理鏈;當機後仍可保留的部分結果;子代理一律不繼承1小時快取層級 – 以上皆查閱該標籤的委派工具原始碼);供應商/模型(GPT-6 Astra+Astra Pro,支援fast/flex層級,Codex OAuth須具備帳號權限,並提供可自行啟用的-900k變體;claude-fable-5.1;gemini-3.7/3.8-flash;qwen3.8-max-0902;Muse Spark 1.3+muse-image image_gen外掛;Tavily搜尋/擷取;受管理的llama.cpp執行環境;外部程序供應商;透過model_catalog.ttl_minutes每20分鐘重新整理目錄);以及桌面版更新(應用程式內瀏覽器的註解模式,每則註記附帶選擇器/標記/樣式,並按區域分組批次處理;結構化工作階段與自動化控制;拖曳建立工作階段;匯入外部對話紀錄作為工作階段;display.resume_last_session;首次開啟時徵求使用真實profile的同意;內建選用skill目錄;桌面版俄文語系)。僅記錄於變更紀錄、經提交或原始碼驗證的項目:cron可靠性(透過3筆已驗證的修正提交強化重新啟動交接;將傳送去重處理序列化並保留終止狀態;消除建立暫停工作時的競爭條件;將Discord cron媒體路由至指定目標並回報上傳失敗;在靜默稽核週期之間維持連續性);核准機制的shell剖析(GNU env分割跳脫字元與argv0運算元、env argv與shell註解邊界、引號內的命令替換主體保留命令邊界、隔離容器內的approvals.deny);gateway啟動存活監控程式(hermes_startup_watchdog.py;gateway.startup_watchdog設有300秒期限,逾時強制結束並回傳75);state.db復原能力(透過sqlite3的.recover搶救lost-and-found資料、like_scan FTS路由、新增docs/state-db-recovery.md);效能(search_files在本機POSIX主機上直接執行ripgrep;結構描述v30將委派子代理的對話紀錄排除於trigram FTS索引之外;主要與輔助路徑共用OpenAI httpx用戶端);gateway.trust_env;Slack Block Kit的/model選擇器;遠端沙箱媒體傳送(憑證及指向憑證的符號連結絕不離開沙箱)。疑難排解章節新增doctor檢查,可偵測殘留的舊HERMES_MAX_ITERATIONS設定。依標籤重新核定v2026.8.31 -> v2026.9.7:靜態供應商39個、供應商外掛目錄39個,兩者項目均與v0.21.0完全相同 – 掃描前「38個靜態供應商,xai已併入外掛」的說法已由原始碼證實不成立(xai元組仍在靜態清單中;只有檔案搬移,hermes_cli/models.py -> hermes_cli/models_catalog_static.py:311);概念模型與CLI資料流程中的prompt_builder.py路徑已更新為agent/prompt_builder.py;保留v0.16每小時重新整理目錄的說明,明確限定適用版本,並在旁補上每20分鐘的更新頻率。既有說明已重新驗證,維持不變:hermes approvals test命名註記、--max-turns預設500(該標籤的cli.py:400;未沿用仍寫著60的過時docstring)、read_file 2000行、委派上限250/10、compression.tail_mode: lean、Node 26、17種CLI語系。 |
41424344454647 |
| 2026-07-28 | 指南v1.12:依搜尋需求補足內容涵蓋範圍 — 兩個轉換表現良好的主題缺乏對應標題。 沒有新版本發布。GSC顯示,hermes swarm與hermes agent swarm在排名約第8時,轉換率為4.4–6.3%;hermes smart model routing在排名6.7時,轉換率為4.9%。然而,這兩類詞彙都沒有專屬章節:swarm僅出現在多代理Kanban內文與變更紀錄列中,而「智慧模型路由」只出現在註腳。在多代理Kanban下新增什麼是Hermes Swarm? — 將swarm定義為在同一個持久化看板上平行運作的工作代理,記錄v0.15.0的swarm拓撲、自動拆解、各任務的模型覆寫、排程任務與worktree管理,並以表格列出各機制所防範的失敗情況。將供應商輪替與備援改名為智慧模型路由:供應商輪替與備援,開頭說明憑證池、備援模型與輔助路由如何整合為同一套系統。沒有內部連結指向相關錨點,因此改名不會造成連結失效。 |
73 2 6 |
| 2026-08-31 | 指南v1.17:Hermes v0.21.0「The Pantheon Release」(標籤v2026.8.31,8月31日)– 精選彙整版正式推出。 在Herald章節上方新增最新動態章節,依該版本自身的功能領域編排:桌面版內建並預設啟用Bot模式(具名profile、固定產生的頭像、支援@提及的群組聊天);hermes peer機器人對機器人私訊(回覆會送達各代理的標準Bot Chat);cron連續性(continuity=true、持久化記事本、監控模式的LLM略過機制、各工作的effort固定設定 – 排程任務章節補上這4項功能在該標籤的實際運作機制);即時子代理協調(delegate_task的列出/引導/停止操作、符合JSON結構描述的子代理輸出、預設值提高至250次迭代/10個並行子代理 – 已由config_defaults.py原始碼驗證,委派文件頁面的3/50相較之下已過時);MCP命令中心(+hermes://安裝連結 – 已更新MCP章節);CLI強化更新(斜線命令表新增/palette+Ctrl+P,以及共用登錄表的/status,並註明/model支援隨輸入即時篩選;版本說明中的hermes approval-check已確認在該標籤實為hermes approvals test – 並不存在前者這個子命令);由代理操作的應用程式內瀏覽器;供應商/模型更新(6個新供應商;對照表新增Tencent TokenPlan、Nebius Token Factory、Ramp Router與Alibaba Token Plan列,環境變數引自文件;model_overrides;資料訓練層級警告;pip供應商外掛);安全性更新(寫入AGENTS.md/skill/記憶一律需要核准 – 已在該標籤驗證security.protected_instruction_files: true與tools/file_tools.py的控管機制;全面遮蔽敏感資料;Windows核准涵蓋範圍;hermes desktop --setup-tcc-identity;移除Blender MCP – 安全性強化章節新增第4波更新);gateway功能成熟化;8項skill更新;以及已撤回清單(Model Council /council、DCP context engine、僅支援WS的gateway伺服器 – 帶序號標記的重播功能#94219確實已發布;Electron退回40.10.2;grep確認本指南從未記錄任何已撤回功能)。彙整小節中延後提供說明的事項已解決,現已指向精選章節;各更新區間區塊仍保留,作為各標籤的紀錄。依標籤重新核定v2026.8.27 -> v2026.8.31:靜態供應商38 -> 39(+tencent-tokenplan)、供應商外掛目錄37 -> 39(+nebius-token-factory、+router,兩者均為auth_type="api_key")、文件供應商列41 -> 45;維持不變且重新驗證:文件平台列28筆/Platform列舉成員24個(清單相同)/配接器目錄22個,_BUILTIN_SUBCOMMANDS相同(73個,peer自彙整更新區間起即已存在,沒有version),終端機後端7個+外掛登錄表(登錄表逐位元組相同),14種個性與17種語系(逐位元組相同/清單相同),壓縮預設為lean及輔助槽位清單,_startup_fast.py/portal_cli.py逐位元組相同。驗證時修正的落差:在TTY中執行hermes chat -q現在會以指定內容啟動互動式工作階段(新增的--oneshot可恢復回答後結束的行為),並依該標籤的剖析器說明,將聊天表格中的--max-turns預設值由90修正為500。 |
35363738394033 |
| 2026-08-27 | 指南v1.16:Hermes v0.20.6(標籤v2026.8.27,8月27日)——第4次彙整。彙整版本小節新增第4個涵蓋區間,依據版本自身的說明(自v0.20.5以來,約1,313次提交,涉及約1,557個檔案,+177,113 / −21,682,約525個已合併PR):須經同意才能使用真實profile瀏覽(預設Chromium profile、Windows經核准後關閉的流程)、在獨立作業系統視窗中執行的桌面版瀏覽器、受管理的SSH遠端更新引擎與機群profile側欄、擴充遠端MCP目錄(50多個經實際連線驗證、由供應商託管的伺服器,包含Cloudflare、Grafana Cloud、Better Stack、Railway)、可自行啟用的作業系統鑰匙圈加密以保護儲存的機密資料、選擇器新增模型(GLM-5.3-Flash、MiniMax M3免費版、MiniMax H3 Max影片模型)、web_search/web_extract的TTL結果快取、支援詞幹處理的多查詢tool_search、更新程式透過控制通訊端暫停gateway、由映像檔或套件管理的安裝拒絕不安全的原地更新、cron持久化事件確認、Slack連結預覽控制,以及共用的Docker容器身分。版本說明中有2項宣告與既有章節矛盾;均已在該標籤版本確認並修正:lean-tail壓縮為預設模式(依該標籤版本的設定鍵重寫「上下文壓縮」——tail_mode: lean、threshold_tokens、protect_first_n,以及auxiliary.compression.*底下的摘要產生器設定,並納入設定版本17的自動遷移;也修正了原本寫反的疑難排解說明),以及終端機後端可透過外掛擴充(改為依供應商選擇器的方式,呈現7個內建後端加上外掛登錄表;內建名稱為保留名稱)。重新驗證以標籤版本為準的數據,並將版本標記由v2026.8.19更新為v2026.8.27:38個靜態供應商+37個供應商外掛目錄、24個Platform列舉成員/22個配接器目錄/28列文件表格、沒有version子命令(_BUILTIN_SUBCOMMANDS有73個項目,包含worktree)、剖析器選項與引用的說明字串不變,BUILTIN_PERSONALITIES仍為14個(從helpful到hype);locales/現有17個語系目錄(en+16種翻譯;已補上該標籤版本的數量)。main正好位於該標籤(ahead_by: 0,狀態相同)。驗證時另發現並修正了一項偏差:輔助系統的預設行為說明已過時——auto現在會將所有輔助任務導向主要聊天模型,不再透過OpenRouter → Nous → Codex的偵測流程使用Gemini Flash。「輔助模型」已依該標籤版本的用途欄位清單重寫(新增title_generation、tts_audio_tags、triage_specifier、kanban_decomposer、profile_describer,各附有來源支持的簡短說明;上游已移除web_extract與session_search欄位——兩者皆不再使用LLM——而預設設定中也已移除flush_memories),並重新核實僅適用於Anthropic的疑難排解項目。版本說明中的全新安裝指令使用原始GitHub指令碼URL;本指南保留標準網址hermes-agent.nousresearch.com/install.sh。精選整理的版本說明仍預定隨v0.21.0提供。 |
293031323334 |
| 2026-08-26 | 指南v1.15:更正——沒有新版本(最新標籤為v2026.8.19/v0.20.5,8月21日);已依該標籤版本重新驗證既有敘述。終端機後端:6個→7個,表格與設定註解新增vercel_sandbox。訊息平台:零散出現的「22個」已統一為該標籤版本文件比較表中的28個,並註明計數依據(24個內建Platform列舉成員、22個隨附配接器目錄),gateway清單也新增ntfy與Buzz。供應商:將「約20/約22個一級支援供應商」替換為有來源依據的數量(38個靜態CANONICAL_PROVIDERS項目,加上37個隨附供應商外掛的自動擴充;文件頁面有41列雲端/訂閱服務),移除「完整清單」字樣,修正Qwen OAuth那一列,並在對照表新增17列(OpenCode Free、OpenAI API直連、Vertex AI、Azure Foundry、Bedrock、NVIDIA NIM、Ollama Cloud、StepFun、MiniMax OAuth、Meta AI、NovitaAI、Arcee AI、GMI Cloud、Actual Computer、Tencent TokenHub、CommandCode、Alibaba Coding Plan)。hermes version → hermes --version(在該標籤版本中不是子命令)。hermes honcho已註明須有對應外掛才能使用。「機群--plan」→ hermes update --plan。「全域選項」新增--in、--tui、--cli、--dev、--ignore-rules、--ignore-user-config;「頂層命令」依_BUILTIN_SUBCOMMANDS新增34列,包含hermes worktree list\|prune及其旗標;新增/worktree斜線命令;補上hermes setup --portal與hermes portal login\|info\|open\|tools的說明。驗證時,main比該標籤多出1,104次提交(後來已全部彙整至v2026.8.27);精選整理的版本說明預定於v0.21.0提供。 |
23242526272829 |
| 2026-08-24 | 指南v1.14:v0.20.5(標籤v2026.8.19,8月21日發布)。彙整版本小節新增第3個涵蓋區間(自v0.20.4以來約746次提交/約323個PR):免金鑰網頁服務層(5家供應商免費輪替,採環狀容錯切換——全新安裝無須任何金鑰即可搜尋網頁)、CLI體驗改善(支援模糊比對的/model選擇器、Ctrl+P命令面板、更豐富的/status)、Bot Mode群組聊天室討論串+可摺疊摘要+PDF/檔案拖放、hermes worktree list/prune、hermes update執行紀錄與機群--plan驗證、cron持久記憶與個別工作的推理力度設定、依Composio評估結果加入的執行規範停滯防護、免驗證的opencode-free供應商,以及桌面版效能改善(先繪製再進行hydration、兩個轉譯器皆採用React Compiler)。附完整精選版本說明的v0.21.0仍待發布——摘要依據版本自身的涵蓋區間說明撰寫。已更新頁首版本沿革。 |
23 |
| 2026-08-20 | 指南v1.13:v0.20.3(標籤v2026.8.16.2,8月17日發布)與v0.20.4(標籤v2026.8.18,8月18日)。在Herald Release底下新增小節:彙整版本系列如今也包含新功能,不再僅限於穩定性改善。v0.20.3(約250次提交/約125個PR):MCP 2.x SDK遷移,支援2026-07-28版無狀態協定、隨附含核心隊友協定的Bot Mode外掛(hermes-bots)、CommandCode供應商外掛、Cua Driver 0.20電腦操作執行環境契約、強化Python執行階段的擁有權管理、cron排程器自我修復、修正工作階段交接時的資料遺失,以及移植生態系功能(/worktree、/rollback保留手動編輯、外掛安裝安全掃描)。v0.20.4(約146次提交/約74個PR):桌面版玻璃/半透明介面與霧面效果選擇器、分頁式SESSIONS|BOTS側欄並支援個別機器人隱藏/顯示、安裝skill時執行NVIDIA SkillEvaluator Tier 1建議性掃描(授權條款+安全性)、強化cron媒體傳送,以及讓hermes update如實呈現暫置分支狀態。兩個版本皆表示,完整精選版本說明將隨v0.21.0發布——摘要依據各版本自身的涵蓋區間說明撰寫。已更新頁首敘述與標籤沿革。 |
68 |
| 2026-08-16 | 指南v1.12:v0.20.0「The Herald Release」(8月3日,標籤v2026.8.3),以及v0.20.1(8月13日)與v0.20.2(8月16日)穩定性更新標籤。3項更正修復已無法使用的操作說明:必須使用Node 26(安裝程式固定使用NODE_VERSION="26",並拒絕較舊的執行環境——文件網站所寫的Node v22已過時,因此以安裝程式與版本說明為準)、pip與Homebrew已停止支援,而非僅標示為不建議使用(「支援的安裝管道為shell安裝程式/Docker/Nix」),以及預設迭代上限從90提高至500,使預算壓力表中的所有數字失效。安裝命令已修正為標準網址https://hermes-agent.nousresearch.com/install.sh。移除項目:claude-marketplace skill來源已移除,來源清單改由browse-sh取代;預設GitHub taps現為openai、anthropics、huggingface、NVIDIA與gstack。直接逐項計算文件比較表後,訊息gateway的平台數量由22修正為28(文件未公布官方總數)。Windows(原生)為Tier 1,並非早期測試版;macOS僅支援Apple Silicon。新增章節介紹本次版本:支援插話的語音對話、A2A v1.0、具簽章的對外生命週期webhook、grounded-citations skill、!//init//diff//context//focus這一波CLI功能與hermes import-agent、command-helper機密資料來源、hermes -w冷啟動時間從約14秒縮短至約1.8秒,以及桌面版產出物與外掛SDK。已驗證維持不變的項目:3種驗證途徑、~/.hermes/目錄結構、hermes update,以及文件所列的工具清單。 |
69 |
| 2026-07-21 | 指南v1.11:v0.19.0「The Quicksilver Release」(2026年7月20日,標籤v2026.7.20)。新增「v0.19.0新功能」章節:首輪TTFT縮短約80%(CLI/gateway/TUI/桌面版/cron的冷啟動提交→派送時間從約4.3秒降至約0.9秒),預設即時串流顯示推理內容(display.show_reasoning開啟),桌面版約20項PR的效能改進(Markdown串流速度提升14倍)+TUI增量Markdown呈現;棄用pip/Homebrew安裝方式(僅顯示「不再支援的舊版方式」警告,計畫停止發布至PyPI/Homebrew)—已將安裝章節與重點摘要修正為單行安裝指令;可插拔的SecretSource,支援Bitwarden+1Password提供者(op://參照、多保管庫、明確固定的優先順序、各變數的來源追蹤);預設啟用智慧核准(每個遭標記的命令均由獨立的LLM審查者評估)+在YOLO模式下仍有效的使用者自訂拒絕規則+/deny <reason>+重新加入外掛pre_tool_call核准升級處理;終端機帳務功能/subscription+/topup+桌面版帳務分頁(移除「沒有獨立訂閱命令」的說法);在state.db中加入即時子代理對話紀錄+可持久保存的背景委派+交付責任台帳;棄用max_async_children,改用統一的委派並行數上限;gateway依profile路由訊息(單一多工機器人權杖→隔離的profile、GATEWAY_MULTIPLEX_PROFILES、state.db中的路由索引、sessions.json作為選用的舊版鏡像);提供者/模型:Fireworks AI(選擇器第2位)、DeepInfra、Upstage Solar、GPT-5.6(Sol/Terra/Luna+Pro)端到端支援、grok-4.5正式推出、kimi-k3(kimi-k2.x退役)、Claude Sonnet 5完整整合、各提供者的enabled: false+excluded_providers、推理強度新增max/ultra級別並支援各模型/各MoA插槽的覆寫設定,以及僅對目前工作階段生效的/reasoning;CLI/MCP:hermes sessions export(Markdown/Quarto/HTML/僅提示詞/HF追蹤紀錄、--redact)、/model --once、堆疊式斜線skill呼叫、--safe-mode、hermes config get/unset、hermes serve真正無介面執行、MCP的mcp__server__tool命名。另補記遺漏的修補標籤v0.18.1(標籤v2026.7.7)與v0.18.2(標籤v2026.7.7.2),2026年7月7日至8日—基礎架構修補彙整;v0.18.2的主要修正是解除WhatsApp Baileys的原有版本鎖定,改用7.0.0-rc13,確保Docker建置可靠。 |
70 71 |
| 2026-07-16 | 首次新增針對以下啟動錯誤原文的疑難排解項目:「No inference provider configured. Run ‘hermes model’ to choose a provider and model」—依搜尋需求新增;引導讀者使用互動式選擇器、hermes doctor及3種驗證途徑。產品功能未變更。 |
2 7 |
| 2026-07-01 | 指南v1.10:v0.18.0「The Judgment Release」(2026年7月1日,標籤v2026.7.1)。新增「v0.18.0新功能」章節:所有P0/P1待辦事項均已結案(約692項);完整支援Mixture-of-Agents,提供附有模型標示的集成輸出與即時串流;完成契約—/goal透過執行專案檢查來驗證自身工作成果;/learn(描述工作流程→可重複使用的skill,符合CONTRIBUTING.md規範);/journey記憶/skill時間軸+桌面版記憶圖譜;背景子代理分派(並行委派任務);桌面版專案功能(專案/儲存庫/工作分區);可縮減至零執行個體的gateway,具備排空協調機制;Google Vertex AI(透過GCP服務帳戶使用Gemini、自動更新OAuth2);/prompt以\$EDITOR編寫提示詞。來源:hermes-agent releases。 |
22 |
| 2026-06-21 | 指南v1.9:v0.17.0「The Reach Release」(2026年6月19日,標籤v2026.6.19)。新增「v0.17.0新功能」章節。訊息傳遞:透過Photon Spectrum使用無需中繼的iMessage(hermes photon login、裝置代碼OAuth)、官方WhatsApp Business Cloud API配接器(無需橋接)、SimpleX群組+附件、Raft平台外掛。模型:z-ai/glm-5.2(1M)、anthropic/claude-fable-5、laguna-m.1、nemotron-3-ultra、grok-composer-2.5-fast(xAI OAuth、200k);xAI預設模型→grok-build-0.1;Anthropic自適應模型移除reasoning欄位。桌面版/儀表板:具備即時觀察視窗的背景子代理(delegate_task(background=true))、完整profile建立工具、重新設計的Skills Hub、自動化藍圖、安全的401登入流程、VS Code Marketplace佈景主題、日文+繁體中文介面。skill/工具:image_generate圖生圖編輯、memory的不可分割operations批次操作、simplify-code skill、布林值write_approval(取代write_mode)。架構:MCP資訊徵詢處理器、可插拔的CronScheduler+Chronos、受管理範圍(/etc/hermes)、gateway間中繼。命令:/version、/billing、hermes curator run --consolidate(需主動啟用)。安全性:修補透過Shell跳脫字元繞過拒絕清單的漏洞、核准/gateway配接器在失敗時預設拒絕、清理cron環境變數、遮蔽偵錯傾印中的機密資訊、MCP標準輸入/輸出資料外洩篩檢、升級urllib3+PyJWT以修補CVE漏洞。 |
21 |
| 2026-06-08 | 指南v1.8:v0.16.0「The Surface Release」(2026年6月5日,標籤v2026.6.5)。將指南標題更新為v0.16,並新增「v0.16.0新功能」章節。重點:Hermes不再僅限於終端機。原生Hermes Desktop應用程式(Electron、macOS/Linux/Windows),提供一鍵安裝、應用程式內自動更新、串流聊天、拖放+剪貼簿圖片貼上、Cmd+K命令面板、工作階段封存/搜尋、狀態列模型選擇器、透過安全的WebSocket連線至遠端gateway(OAuth或使用者名稱/密碼、各profile的主機、跨profile的@session連結),以及透過具型別的i18n實作完整簡體中文翻譯。瀏覽器管理面板(網頁儀表板→完整管理功能):MCP目錄啟用/停用、憑證管理、webhook/hook建立、記憶設定、gateway控制、系統頁面的更新前檢查+偵錯資訊分享、新增頻道頁面,以及可插拔的驗證機制(使用者名稱/密碼、自行託管OIDC、hermes dashboard register)。新命令:/undo [N](CLI/TUI/訊息平台)、可設定的預設介面(cli/tui、--cli)、TUI統一的/model+工作階段浮層、hermes portal、hermes prompt-size、hermes sessions optimize。新模型:deepseek-v4-flash、MiniMax-M3(1M上下文)、qwen3.7-plus、gemini-3.5-flash;桌面啟動器完整支援xAI Grok OAuth;支援模糊比對的模型選擇器;每小時更新目錄。skill:精簡預設集合(Spotify→原生外掛、Linear→hermes mcp install linear、移除已失效的skill)、environments:相關性篩選(kanban/docker/s6)、將NVIDIA/skills設為預設信任的來源庫、依範圍漸進式揭露MCP/外掛工具。安全性:針對CVE-2026-48710(Starlette BadHost)將版本限制設為≥1.0.1;將SSRF檢查移出事件迴圈;從子程序環境中移除Bedrock持有者權杖;對bws_cache.json加入讀取保護;將docker restart/stop/kill加入危險模式;清理不可見的Unicode字元。結案2項P0+62項P1(其中16項標記為安全性問題)。 |
20 |
| 2026-05-31 | 指南v1.7.1:v0.15.1(2026年5月29日01:12 UTC)—Velocity修補版。Velocity發布當日推出的緊急修正;固定於標籤v2026.5.29版本線。修正影響回送模式部署的儀表板401重新載入迴圈。Docker不再隱含啟用--insecure—若要重新啟用,請明確設定HERMES_DASHBOARD_INSECURE=1。MCP的裸命令(npx、npm、node)在Docker容器內恢復正確解析。Skills頁面的來源標籤與分類側邊欄可正常呈現。Kanban工作程序可妥善回應SIGTERM,避免留下孤兒程序。Skills.sh透過網站地圖探索,將目錄從858筆擴增至19,932筆項目。28次提交、21個已合併PR、9位貢獻者。v0.15.2(2026年5月29日13:37 UTC)—Velocity封裝修補版。修正wheel與sdist發行套件,納入plugin.yaml資訊清單,讓PyPI安裝無需另外載入原始碼目錄樹即可正常運作。僅涉及封裝的緊急修正,4位貢獻者。 |
72 |
| 2026-05-28 | 指南v1.7:新增v0.15.0(2026年5月28日)— Velocity版本(標籤v2026.5.28)。重點:大規模重構與全新的協調基礎機制。程式碼庫重構:run_agent.py縮減76%(16,083 → 3,821行),拆分為14個職責明確的模組。多代理Kanban v2:自動將高階目標拆解為子任務,以群集拓撲協調平行執行的工作代理,支援個別任務的模型覆寫、排程任務與worktree管理。效能:冷啟動再縮短1秒;每次對話的函式呼叫減少47%;session_search重新設計後加快4,500倍,並移除LLM相依套件(同時消除其API成本)。安全性:Promptware防禦在3個關鍵安全檢查點防範Brainworm類型的提示注入;整合Bitwarden Secrets Manager,以單一啟動權杖取代各供應商的多組API金鑰。Skill套件組:以一個斜線指令同時載入多個skill。TUI工作階段協調器:在單一終端機視窗內管理多個工作階段。新增供應商:支援Krea 2(Medium/Large)與FAL影像生成外掛;本輪xAI整合新增網頁搜尋外掛、OAuth上游支援、已停用模型偵測,以及自然的TTS停頓。統計:1,302次提交、747個已合併PR、321位社群貢獻者。根據GitHub版本說明,當天或隔天發布的修補版本處理了儀表板401重新載入迴圈、Docker --insecure的明確環境變數設定、Docker中MCP的無路徑指令解析(npx、npm、node)、Skills頁面還原、Kanban工作代理的SIGTERM處理,以及透過sitemap提供完整的19,932筆Skills目錄。 |
73 |
| 2026-05-21 | 指南v1.6:新增v0.14.0(2026年5月16日)— Foundation版本。重點:更輕量的安裝與執行環境基礎,並擴大供應商、gateway、媒體與驗證功能的支援範圍。新增SuperGrok OAuth,支援grok-4.3的1M上下文;為OAuth供應商提供相容OpenAI的hermes proxy;完整支援x_search;新增pip install hermes-agent、延遲安裝相依套件、啟動加快約19秒、瀏覽器CDP呼叫加快180倍、LINE與SimpleX Chat(通訊平台總數達22個)、Microsoft Teams端對端支援、/handoff、/subgoal、Telegram/Discord原生釐清按鈕、Discord歷史訊息回補、原始像素vision_analyze、每輪回合頁尾的檔案變更驗證結果、每次寫入時的LSP語意診斷、統一的video_generate、透過cua-driver為非Anthropic供應商提供computer_use、OSC8可點擊網址、Zed ACP Registry支援、OpenRouter Pareto Code路由器、NovitaAI、Codex app-server執行環境、huggingface/skills受信任套件來源、9個選用skill、外掛ctx.llm / tool_override、Brave/DDGS網頁搜尋、Qwen Cloud更名、原生Windows測試版,並結案12個P0與50個P1問題。 |
19 |
| 2026-05-07 | 指南v1.5:新增v0.13.0(2026年5月7日)— Tenacity版本。重點:具備持久運作能力的多代理Kanban看板(心跳、任務回收、殭屍代理偵測、幻覺檢查關卡、個別任務的max_retries、多專案看板),讓代理群集成為核心基礎機制,不再只是委派模式。/goal指令讓代理跨回合持續鎖定目標(將Ralph-loop模式化為斜線指令)。新增video_analyze工具,優先支援Gemini,並可擴充相容模型支援。新增具備語音複製功能的xAI Custom Voices TTS供應商。CLI與gateway訊息支援7種語言的i18n(zh-Hans、ja、de、es、fr、uk、tr);文件僅支援zh-Hans。透過可插拔配接器模式,將Google Chat新增為第20個通訊平台;IRC與Microsoft Teams也遷移至相同模式。新增ProviderProfile ABC與plugins/model-providers/,無須修改核心即可接入第三方供應商。gateway重新啟動、/update及原始碼檔案重新載入後,工作階段可自動恢復。Checkpoint v2重新編寫,採用單一儲存區設計、實際清理機制與磁碟防護。8項P0安全性問題結案:預設啟用機密資訊遮蔽、Discord跨伺服器私訊繞過(CVSS 8.1)、WhatsApp拒絕陌生人訊息與自身對話靜音、MCP OAuth TOCTOU、CLI auth.json TOCTOU、瀏覽器SSRF基礎防護、cron提示注入掃描、hermes debug share資訊遮蔽。新增Python/JSON/YAML/TOML的寫入後lint檢查、cron no_agent純指令碼模式、Slack/Telegram/Mattermost/Matrix/DingTalk的平台允許清單,以及MCP強化功能(SSE傳輸、OAuth轉送、影像MEDIA標籤)。自v0.12.0起的統計:864次提交、588個已合併PR、829個檔案變更、295位社群貢獻者、282個議題結案(13個P0、36個P1)。 |
18 |
| 2026-05-06 | 指南v1.4:新增v0.12.0(2026年4月30日)— Curator版本。重點:自主背景Curator透過gateway的cron計時機制執行(預設週期為7天),依評分規準評估skill庫、清理失效skill、整併相關skill,並撰寫每次執行的報告——Hermes會在活躍工作階段之間自行維護。自我改進迴圈也同步升級,加入依規準評分、優先主動更新、正確繼承執行環境,以及僅限記憶與skill的限定範圍toolset。4個新推論供應商:GMI Cloud、Azure AI Foundry、MiniMax OAuth與Tencent Tokenhub。LM Studio提升為完整支援。遠端模型目錄資訊清單現在可自動更新,無須等待版本發布。2個新通訊平台:Microsoft Teams(第19個,透過可插拔gateway架構)與Tencent Yuanbao(第18個,原生支援文字與媒體)。透過PKCE OAuth提供原生Spotify支援,並隨附skill;新增用於通話與轉錄的Google Meet外掛,以及Piper本機TTS供應商。ComfyUI v5與TouchDesigner-MCP由選用改為預設隨附。新增skill:Humanizer、claude-design、design-md、airtable。CLI新增功能:hermes -z單次執行模式、hermes update --check事前檢查、/reload-skills斜線指令、可插拔的忙碌指示器樣式。透過延遲初始化代理與延遲匯入,TUI顯示前的冷啟動時間縮短約57%。安全性:為避免損毀承載資料,預設停用機密資訊遮蔽;針對無法復原的指令採用嚴格封鎖清單。統計:1,096次提交、550個已合併PR、213位社群貢獻者。 |
17 |
| 2026-04-25 | 指南v1.3:新增v0.11.0(2026年4月23日)— Interface版本。以React/Ink全面重新編寫互動式TUI,搭配Python JSON-RPC後端(tui_gateway);提供固定位置的訊息編輯區、支援OSC-52剪貼簿的即時串流、穩定的選擇器按鍵、顯示每輪回合計時器與git分支的狀態列、/clear確認、淺色主題預設,以及子代理建立狀態的觀測覆蓋層。可插拔傳輸架構——將格式轉換與HTTP傳輸抽離至agent/transports/,讓供應商串接更清晰。透過Converse API提供原生AWS Bedrock支援。5種新推論途徑:NVIDIA NIM、Arcee AI、Step Plan、Google Gemini CLI OAuth與Vercel ai-gateway。透過Codex OAuth使用GPT-5.5——現在可透過ChatGPT Codex OAuth存取OpenAI的新旗艦模型,無須額外的API金鑰。QQBot(第17個通訊平台)支援掃描QR碼設定與串流。擴充外掛介面:斜線指令、工具派送、執行攔截、結果轉換。/steer <prompt>——在執行途中引導代理,注入一則備註,讓執行中的代理在下一次工具呼叫後讀取,無須中斷回合或破壞提示快取。Shell掛鉤可將指令碼接為生命週期掛鉤,無須Python外掛。Webhook直接傳遞模式將承載資料直接轉送至平台聊天室,略過代理即可分送。更智慧的委派提供協調器角色、可設定的子代理建立深度,以及檔案協調。儀表板新增外掛系統、即時主題切換、i18n與行動裝置響應式版面。自v0.9.0起的統計:1,556次提交、761個已合併PR、1,314個檔案變更、224,174行新增內容、29位社群貢獻者。 |
74 |
| 2026-04-16 | 指南v1.2:新增v0.10.0——Nous Tool Gateway。Nous Portal付費訂閱者現在可使用代管工具(Firecrawl網頁搜尋、FAL / FLUX 2 Pro影像生成、OpenAI TTS、Browser Use瀏覽器自動化),無須額外的API金鑰。透過新的use_gateway設定欄位,可逐一為工具選擇啟用。若同時設定gateway與直接使用的API金鑰,執行時會優先使用gateway。已移除HERMES_ENABLE_NOUS_MANAGED_TOOLS環境變數。Hermes Agent CLI仍採用MIT授權,完全免費。 |
75 |
| 2026-04-13 | 指南v1.1:新增v0.8.0與v0.9.0功能。本機網頁儀表板、/fast模式、iMessage與WeChat平台(共16個)、背景程序監控(watch_patterns)、可插拔context engine、hermes backup/hermes import、Termux/Android、xAI、MiMo、Google AI Studio與Qwen供應商、/debug指令,以及全面安全性強化。 |
15 16 |
| 2026-04-10 | 指南v1.0:首次發布,涵蓋Hermes Agent v0.7.0。供應商驗證、設定、CLI、斜線指令、工具、skill、記憶、gateway、cron、MCP、壓縮、架構、OpenClaw遷移、疑難排解、常見問題。 | |
| — |
參考資料
-
Nous Research,GitHub 上的 “Hermes Agent” 專案 README。產品說明(自我改進代理程式、多供應商支援、通訊 gateway、終端機後端、skill 演進、cron 排程器、任務委派)及「快速安裝」單行指令的第一手來源。 ↩↩↩
-
Nous Research,Hermes Agent 文件中的「AI 供應商」。以下內容的第一手來源:完整供應商清單、各供應商的驗證方式(Nous Portal OAuth、Codex 裝置代碼、GitHub Copilot 權杖類型、Anthropic 的 3 種驗證方式、中國 AI 供應商、Hugging Face 路由、自訂端點)、3 種驗證途徑(
.env中的 API 金鑰、透過hermes model進行 OAuth 驗證、config.yaml中的自訂端點)、/model斜線指令語法(包括custom:name:model)、Ollama/vLLM/SGLang/llama.cpp/LM Studio 設定範本、WSL2 網路設定說明、上下文長度偵測鏈、備援模型設定、智慧模型路由,以及具名自訂供應商。本文中所有供應商專屬的環境變數名稱、權杖類型、基底 URL 覆寫設定與模型識別碼,皆出自此頁。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩ -
Nous Research,Hermes Agent 開發者指南中的「架構」。以下內容的第一手來源:系統概觀圖、目錄結構、資料流經 CLI 工作階段與 gateway 訊息路徑的方式、3 種 API 模式(
chat_completions、codex_responses、anthropic_messages)、透過runtime_provider.py解析供應商、透過 SQLite + FTS5 持久儲存工作階段、通訊 gateway 平台清單、外掛系統的探索來源、profile 隔離,以及 6 項設計原則。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩ -
Nous Research,Hermes Agent 使用者指南中的「設定」。以下內容的第一手來源:設定目錄結構、
config.yaml與.env的優先規則(「非機密設定以config.yaml為準」)、設定優先順序鏈(CLI 引數 → env → config.yaml → .env → 預設值)、上下文壓縮設定(compression.*區塊包含threshold、threshold_tokens、target_ratio、tail_mode、protect_last_n、protect_first_n;自 config-version-17 遷移起,摘要模型的模型/供應商/端點設定位於auxiliary.compression.*下)、預算壓力門檻(70% 提醒注意,90% 發出警告)、可依本機供應商自動調整的串流逾時設定,以及完整的輔助模型設定區塊(auxiliary:包含vision、web_extract、approval、compression、session_search、skills_hub、mcp、flush_memories欄位)。"main"供應商僅限用於輔助/壓縮/備援欄位的限制,也出自此頁。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩ -
Nous Research,Hermes Agent 指南中的「從 OpenClaw 遷移」。OpenClaw → Hermes 遷移流程的來源。 ↩↩
-
Nous Research,Hermes Agent 參考文件中的「CLI 指令參考」。本文記載的所有頂層 CLI 指令的第一手來源,包括
hermes chat、hermes model、hermes gateway、hermes setup、hermes auth、hermes status、hermes cron、hermes webhook、hermes doctor、hermes dump、hermes logs、hermes config、hermes pairing、hermes skills、hermes honcho、hermes memory、hermes acp、hermes mcp、hermes plugins、hermes tools、hermes sessions、hermes insights、hermes claw、hermes profile、hermes completion、hermes update與hermes uninstall。本文中所有子指令旗標、選項說明、憑證集區行為、日誌篩選語法、OpenClaw 遷移旗標、profile 管理指令及服務安裝指令,皆出自此頁。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩ -
Nous Research,Hermes Agent 入門指南中的「安裝」。單行安裝指令、安裝程式行為(先決條件、平台支援、Termux 自動偵測、Windows/WSL2 需求)、選用附加項目表、手動安裝步驟及驗證指令的第一手來源。 ↩↩↩↩↩↩↩↩↩
-
Nous Research,「CLI 指令參考」——請特別參閱
hermes dump一節,其中說明此指令的輸出格式(標頭、環境、身分、模型、終端機、API 金鑰、功能、服務、工作負載、設定覆寫),以及用於分享診斷資訊的預期用途。 ↩ -
Nous Research,Hermes Agent 參考文件中的「斜線指令參考」。本文列出的所有斜線指令、
COMMAND_REGISTRY架構、CLI 與通訊平台的功能區分、動態 skill 斜線指令、config.yaml中的快速指令、前綴比對行為,以及通訊平台專用指令(/status、/sethome、/approve、/deny、/update、/commands)的第一手來源。 ↩↩↩↩↩↩↩↩↩↩ -
Nous Research,Hermes Agent 使用者指南中的「工具與 toolset」。工具分類概觀、toolset 使用指令、7 種終端機後端(local、docker、ssh、singularity、modal、daytona、vercel_sandbox)、容器設定(cpu、memory、disk、persistent)、容器安全強化、背景程序管理 API 及 sudo 支援的第一手來源。 ↩↩↩↩↩↩↩↩↩↩
-
Nous Research,Hermes Agent 使用者指南中的「skill 系統」。漸進式揭露、
SKILL.md格式、平台專屬 skill、條件式啟用(fallback_for_toolsets、requires_toolsets、fallback_for_tools、requires_tools)、透過skill_manage由代理程式管理 skill、skill 中心指令與來源清單(official、skills-sh、well-known、github、clawhub、claude-marketplace、lobehub)、安全掃描與信任等級,以及外部 skill 目錄的第一手來源。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩ -
Nous Research,Hermes Agent 使用者指南中的「持久記憶」。
MEMORY.md/USER.md字元數限制、凍結快照模式、記憶工具操作(add、replace、remove)、應儲存與略過的內容、記憶與工作階段搜尋的比較,以及外部記憶供應商的第一手來源。在v2026.9.24標籤版本中,搭配閱讀的記憶供應商頁面(第 9 行)寫道:「Hermes Agent 隨附 7 個外部記憶供應商外掛」,並補充「外掛目錄中還有更多選項(例如 Hindsight)」;該標籤版本的plugins/memory/包含byterover、holographic、honcho、mem0、openviking、retaindb與supermemory。 ↩↩↩↩↩↩↩↩ -
Nous Research,Hermes Agent 使用者指南中的「人格與 SOUL.md」。
SOUL.md行為(位於HERMES_HOME、永不覆寫、位居系統提示的第 1 個位置、納入前會進行安全掃描)、SOUL.md 與 AGENTS.md 的區別、內建人格清單(從helpful到hype共 14 種人格)、config.yaml中的自訂人格、/personality疊加模式,以及完整提示堆疊組裝順序的第一手來源。 ↩↩↩↩↩↩↩↩↩↩↩↩ -
Nous Research,Hermes Agent 指南與參考文件中的「在 Hermes 中使用 MCP」及「MCP 設定參考」。
config.yaml中mcp_servers:設定格式的來源,涵蓋command、args、env欄位。 ↩ -
Hermes Agent v0.8.0 版本說明。2026年4月8日。背景程序自動通知、Nous Portal 上免費的 MiMo v2 Pro、跨平台即時
/model切換、Google AI Studio 原生供應商、Qwen OAuth、依閒置時間判定逾時、Slack/Telegram 上的核准按鈕、MCP OAuth 2.1 PKCE、集中式日誌記錄、外掛系統擴充。 ↩↩↩↩↩ -
Hermes Agent v0.9.0 版本說明。2026年4月13日。本機網頁儀表板、快速模式(
/fast)、透過 BlueBubbles 使用 iMessage、WeChat + WeCom、Termux/Android、背景程序監控(watch_patterns)、xAI + Xiaomi MiMo 原生供應商、可插拔的 context engine、統一代理支援、安全性強化(修正路徑穿越、Shell 注入、SSRF、RCE 漏洞)、hermes backup/hermes import、/debug+hermes debug share,支援 16 個平台。487 次提交、269 個已合併的 PR、24 位貢獻者。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩ -
Hermes Agent v0.12.0 版本說明。2026年4月30日。「Curator 版本」。自主背景 Curator 由 gateway 的 cron 計時器驅動,預設每 7 天為 skill 程式庫評分、修剪及整併。自我改進迴圈升級:依評分規準評分、優先主動更新、正確繼承執行階段設定,並將 toolset 的範圍限於記憶與 skill。新增 4 家推論供應商:GMI Cloud、Azure AI Foundry、MiniMax OAuth、Tencent Tokenhub。LM Studio 提升為一級支援。遠端模型目錄資訊清單可自動更新,無須等待版本發布。新增 2 個通訊平台:Microsoft Teams(第 19 個,透過可插拔的 gateway 架構)與 Tencent Yuanbao(第 18 個,原生支援文字與媒體)。透過 PKCE OAuth 原生整合 Spotify,並隨附 skill;提供 Google Meet 外掛,支援通話與轉錄;新增 Piper 本機 TTS 供應商。預設隨附 ComfyUI v5 + TouchDesigner-MCP。新增 skill:Humanizer、claude-design、design-md、airtable。CLI:
hermes -z單次執行模式、hermes update --check預先檢查、/reload-skills斜線指令、可插拔的忙碌指示器樣式。透過延遲初始化,TUI 冷啟動時間縮短約 57%。安全性:預設停用機密資訊遮蔽;對無法復原的指令採用嚴格封鎖清單。自 v0.11.0 起的統計:1,096 次提交、550 個已合併的 PR、213 位社群貢獻者。另請參閱:v2026.4.30 版本標籤。 ↩↩↩ -
Hermes Agent v0.13.0 版本說明。2026年5月7日。「Tenacity 版本」。多代理看板具備心跳、任務回收、殭屍任務偵測、幻覺檢查關卡、各任務獨立的
max_retries,以及多專案看板。新增/goal斜線指令,可跨回合鎖定目標(Ralph 迴圈基礎機制),並設定回合額度。新增video_analyze工具,以 Gemini 為優先,並可擴充至相容的多模態模型。新增 xAI Custom Voices TTS 供應商,支援聲音複製。支援 7 種語言的 i18n:zh-Hans、ja、de、es、fr、uk、tr(涵蓋 CLI 與 gateway 訊息;文件僅支援 zh-Hans)。Google Chat 成為第 20 個通訊平台,採用可插拔的轉接器模式,搭配通用的env_enablement_fn/cron_deliver_env_var外掛掛鉤;IRC 與 Microsoft Teams 也已遷移至相同模式。透過ProviderProfile抽象基底類別(ABC)與plugins/model-providers/支援可插拔的第三方供應商。gateway 重新啟動、執行/update或重新載入原始碼檔案後,工作階段均可自動恢復。checkpoint v2 改寫為單一儲存區架構,具備實際修剪功能、磁碟保護機制,且不會留下孤立的影子儲存庫。解決 8 項 P0 安全性問題:預設啟用機密資訊遮蔽、Discord 跨伺服器私訊繞過限制(CVSS 8.1,角色允許清單限定於所屬伺服器)、WhatsApp 預設拒絕陌生人且絕不回覆與自己的對話、MCP OAuth 儲存憑證時的 TOCTOU、CLI 憑證寫入元件中auth.json的 TOCTOU、混合路由中瀏覽器對雲端中繼資料存取的 SSRF 基礎防護、掃描 cron 組合後的提示(包含 skill 內容)以防提示注入,以及hermes debug share在上傳時遮蔽日誌內容中的機密資訊。其他值得關注的項目:Python/JSON/YAML/TOML 寫入後的靜態檢查、cronno_agent僅執行指令碼的監控模式、Slack/Telegram/Mattermost/Matrix/DingTalk 的平台允許清單,以及 MCP 強化(SSE 傳輸、OAuth 轉送、以 MEDIA 標籤呈現圖片結果)。自 v0.12.0 起的統計:864 次提交、588 個已合併的 PR、829 個檔案變更、295 位社群貢獻者、282 個已結案問題(13 個 P0、36 個 P1)。 ↩↩↩↩↩↩↩↩↩↩↩↩ -
Hermes Agent v0.14.0 版本說明。2026年5月16日。「Foundation 版本」。自 v0.13.0 起:808 次提交、633 個已合併的 PR、1,393 個檔案變更、新增 165,061 行、545 個已結案問題(12 個 P0、50 個 P1),以及 215 位社群貢獻者。新增 SuperGrok OAuth,搭配具備 1M 上下文容量的 grok-4.3、
hermes proxy、x_search、PyPI 套件封裝、延遲載入相依套件、跨工作階段且有效期為 1 小時的 Claude 提示快取、啟動時間縮短約 19 秒、瀏覽器 CDP 呼叫速度提升至 180 倍、新增 LINE 與 SimpleX Chat,通訊平台總數達 22 個、/handoff、原生澄清按鈕、Discord 歷史訊息回填、使用原始像素的vision_analyze、每回合檔案變更驗證器的頁尾、LSP 語意診斷、統一的video_generate、cua-drivercomputer_use、OSC8 連結、Zed ACP Registry 支援、OpenRouter Pareto Code 路由器、NovitaAI、Codex app-server 執行環境、huggingface/skills、外掛ctx.llm、tool_override、Brave/DDGS 搜尋、危險指令防護強化、/subgoal、Qwen Cloud 更名、原生 Windows 測試版、語系總數達 16 個,以及大幅更新文件與測試。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩ -
Hermes Agent v0.16.0版本資訊,「The Surface Release」,標籤為
v2026.6.5,發布於2026-06-06T00:55:58Z(發布標籤日期為2026年6月5日);截至2026年6月8日為最新版本。新增原生Hermes Desktop(Electron,支援macOS/Linux/Windows;透過安全的WebSocket連線至遠端gateway,並使用OAuth或使用者名稱/密碼驗證;各profile可設定遠端主機;跨profile的@session連結;透過具型別的i18n提供簡體中文介面,設定項目為display.language)。網頁儀表板擴充為完整的管理面板(MCP目錄開關、憑證管理、webhook/hook建立、記憶設定、gateway控制、系統頁面提供更新前檢查與Debug Share、頻道頁面;可插拔的驗證機制,包括自行託管的OIDC及hermes dashboard register)。新增命令:/undo [N]、可設定的預設介面(cli/tui、--cli)、TUI的/model與工作階段浮動面板、hermes portal、hermes prompt-size、hermes sessions optimize。新增模型:deepseek-v4-flash、MiniMax-M3(1M上下文)、qwen3.7-plus、gemini-3.5-flash;xAI Grok OAuth;模糊比對選擇器;每小時重新整理目錄。skill:精簡預設集合、以environments:篩選相關項目、將NVIDIA/skills設為預設受信任來源、漸進式揭露工具、修正MCP誤報OAuth成功的問題。安全性:針對CVE-2026-48710(Starlette BadHost)將版本下限固定為≥1.0.1、將SSRF檢查移出事件迴圈、從子行程環境中移除Bedrock持有者權杖、為bws_cache.json加入讀取保護、將docker restart/stop/kill加入危險模式清單、清除不可見的Unicode字元;已解決2項P0與62項P1問題(其中16項標記為安全性問題)。已排除版本資訊中的行銷措辭(PR/提交次數、「這些功能在一週前都還不存在」);僅記錄與該標籤對應的具體功能及版本事實。本次工作階段驗證日期為2026年6月8日。 ↩↩↩↩↩↩↩↩ -
Hermes Agent v0.17.0版本資訊,「The Reach Release」,標籤為
v2026.6.19,日期為2026年6月19日;截至2026年6月21日為最新版本。訊息通訊:透過Photon Spectrum使用iMessage(裝置代碼OAuth、hermes photon login,無須Mac中繼);官方WhatsApp Business Cloud API介接器(取代橋接行程);SimpleX群組、原生附件、文字批次處理、自動接受;內附Raft平台外掛程式。模型/供應商:z-ai/glm-5.2(1M上下文)、anthropic/claude-fable-5、laguna-m.1、nemotron-3-ultra、grok-composer-2.5-fast(xAI OAuth,200k上下文);xAI預設模型改為→grok-build-0.1;Anthropic自適應模型採用新版思考介面契約(無reasoning欄位)。CLI/斜線命令:/version、/billing、hermes photon login、hermes curator run --consolidate(須主動啟用)、hermes model圖形介面、profile複製。桌面版:背景子代理監看視窗(delegate_task(background=true))、Composer模型選擇器、可重新綁定的快捷鍵、原生作業系統通知、各討論串獨立草稿、VS Code Marketplace佈景主題、日文與繁體中文介面。儀表板:完整的profile建立工具、全域profile切換器、整合安全掃描的Skills Hub全面改版、Automation Blueprints、安全登入(受OAuth保護,未授權時回傳401)。skill/工具:image_generate支援跨供應商圖像轉圖像編輯、memory的operations支援原子性批次操作、用於平行審查的simplify-codeskill、以布林值write_approval取代write_mode。架構:背景子代理(立即回傳控制代碼,結果以新一輪對話重新進入流程)、MCP互動確認處理常式可在工具呼叫期間請求確認、延後連線的MCP工具可在對話回合之間開放使用、可插拔的CronScheduler與Chronos代管cron、Managed範圍(由管理員在/etc/hermes固定設定)、gateway對gateway中繼。安全性:修正可繞過Shell跳脫字元封鎖清單的漏洞、缺少核准模組或採用自有政策的gateway介接器時預設拒絕執行、清理cron工作指令碼的環境變數、遮蔽偵錯傾印中的機密資訊、不在公開狀態中揭露主機中繼資料、篩查MCP標準輸入/輸出中的資料外洩模式、升級urllib3與PyJWT以修補CVE。已排除版本發布中的行銷措辭(提交/PR次數)。本次工作階段驗證日期為2026年6月21日。 ↩↩↩↩↩↩↩↩↩↩↩ -
Hermes Agent v0.18.0版本資訊(標籤為
v2026.7.1),2026年7月1日——「The Judgment Release」。全面清理優先待辦事項(所有P0/P1均已解決,12天內處理約692項);所有介面均可直接選用Mixture-of-Agents作為模型,各參考模型的完整輸出會分別顯示於附有標籤的獨立區塊,並即時串流呈現回答;/goal的完成契約(代理執行專案檢查,自行驗證工作成果);/learn命令(透過描述將任何內容轉為可重複使用的skill,並自動遵循CONTRIBUTING.md);/journey視覺化記憶/skill時間軸,支援編輯及桌面版記憶圖譜;背景子代理平行分派(同時執行多項委派任務);Desktop Projects(專案/儲存庫/工作分支模型);可縮減至零執行個體的gateway,並協調進行中的工作完成後再關閉;支援Google Vertex AI(透過GCP服務帳戶使用Gemini,自動更新OAuth2權杖);/prompt$EDITOR命令。本次工作階段於2026年7月1日(PST)對照GitHub版本發布頁面完成驗證;v0.18.0為最新版本。 ↩↩↩↩↩↩↩↩↩↩↩ -
Hermes Agent v0.20.5版本資訊(標籤為
v2026.8.19,標示發布日期為2026年8月19日,實際發布於2026年8月21日;於2026年8月24日透過GitHub API取得——prerelease: false)。該期間的描述原文譯文:「約746次提交,涉及約1,250個檔案(+111,500 / -20,701)——約323個已合併PR,涵蓋Bot Mode群組聊天室討論串、可摺疊的對話摘要、團塊臉孔頭像,以及支援拖放的PDF/檔案附件;免金鑰網頁服務層(5家供應商免費輪替,採環狀容錯移轉,全新安裝即可使用網頁搜尋,無須任何金鑰);一系列CLI細節改善(支援模糊比對的/model選擇器、Ctrl+P命令面板、資訊更豐富的/status);根據Composio評估結果加入執行規範與執行階段停滯防護;hermes update執行紀錄與機群--plan驗證;hermes worktree list/prune;無須驗證的opencode-free供應商;多問題釐清;桌面版效能改善(Bot Mode先繪製再進行hydration、合成器載入動畫、兩個渲染器皆採用React Compiler);以及cron工作新增持久記憶與各工作獨立的推理投入程度設定。」該版本再次聲明:「本期間完整且經整理的版本資訊將隨v0.21.0一同發布。」 ↩↩↩↩↩↩↩↩↩↩↩ -
標籤
v2026.8.31的終端機後端(已針對指南v1.17重新驗證;agent/terminal_env_registry.py與其v2026.8.31版本逐位元組相同,tools/terminal_tool.py文件字串中的事實未變,tools/environments/仍包含相同的7個後端模組,目前另有path_utils.py輔助模組):tools/terminal_tool.py模組文件字串的原文譯文為:「可在本機、Docker、Modal、SSH、Singularity、Daytona及Vercel Sandbox環境中執行命令的終端機工具」,環境選擇清單中的vercel_sandbox項目則為「在Vercel Sandbox雲端沙箱中執行」;該標籤下存在後端模組tools/environments/vercel_sandbox.py,與daytona.py、docker.py、local.py、modal.py、singularity.py及ssh.py並列。該標籤的README:「7種終端機後端——本機、Docker、SSH、Singularity、Modal、Daytona及Vercel Sandbox。」工具與toolset文件頁面(該標籤下的來源檔案為website/docs/user-guide/features/tools.md)在表格中將vercel_sandbox列為「Vercel Sandbox雲端microVM」,用途為「支援以快照保存檔案系統狀態的雲端執行」,顯示設定註解# or: docker, ssh, singularity, modal, daytona, vercel_sandbox,並指出:「驗證時必須同時提供VERCEL_TOKEN、VERCEL_PROJECT_ID及VERCEL_TEAM_ID。……支援的執行環境為node24、node22及python3.13;Hermes預設以/vercel/sandbox作為遠端工作區根目錄。」在v2026.8.31中,tools/environments/套件也包含共用基礎元件(含BaseEnvironment抽象基底類別的base.py、file_sync.py、modal_utils.py、managed_modal.py);套件文件字串將代管Modal列為Modal的一種模式,而非第8種後端:「Modal另有直接模式與Nous代管模式,可透過terminal.modal_mode選擇。」 ↩↩↩ -
標籤
v2026.8.31的訊息平台數量(已為指南v1.17重新驗證;與v2026.8.31相同——文件表格有28列、相同的24個Platform列舉成員,以及相同的22個介接器目錄)。Messaging Gateway文件頁面(該標籤下的原始檔為website/docs/user-guide/messaging/index.md)的「平台比較」表格有28列:Telegram、Discord、Slack、Google Chat、WhatsApp、WhatsApp Cloud API、Signal、SMS、電子郵件、Home Assistant、Mattermost、Matrix、DingTalk、Feishu/Lark、WeCom、WeCom Callback、Weixin、BlueBubbles、Photon(iMessage)、QQ、Yuanbao、Microsoft Teams、LINE、ntfy、Raft、IRC、Buzz、SimpleX。gateway/config.py定義了class Platform(Enum),包含24個明確列出的成員(local、telegram、discord、whatsapp、whatsapp_cloud、slack、signal、mattermost、matrix、homeassistant、email、sms、dingtalk、api_server、webhook、msgraph_webhook、feishu、wecom、wecom_callback、weixin、bluebubbles、qqbot、yuanbao、relay),並註明:「外掛平台使用由_missing_()視需要建立的動態成員,因此Platform("irc")無須修改此列舉即可運作。」該標籤的plugins/platforms/目錄樹包含22個介接器目錄:a2a buzz dingtalk discord email feishu google_chat homeassistant irc line matrix mattermost ntfy photon raft simplex slack sms teams telegram wecom whatsapp。平台說明:ntfy頁面的原文引述譯文:「ntfy是一項簡單的HTTP發布/訂閱通知服務。它可搭配ntfy.sh的免費公開伺服器或任何自行架設的執行個體使用……透過ntfy行動應用程式訂閱主題,傳送訊息至該主題即可與代理程式交談,並在手機上收到回覆。」Buzz頁面的原文引述譯文:「Buzz介接器將Hermes連接至Buzz社群——這是Block以Nostr協定打造的開源人類與代理程式協作平台——並在Buzz頻道(或私人訊息)與代理程式之間轉送訊息。傳出流量透過shell呼叫buzzCLI二進位執行檔……傳入流量則使用原生Nostr WebSocket訂閱。」兩個頁面皆指出:「執行hermes gateway setup並選擇……,即可依照引導逐步完成設定。」 ↩↩↩ -
標籤
v2026.8.31的供應商數量(已為指南v1.17重新驗證;v0.21.0已變更這些數量,原先v2026.8.31為38個靜態項目/37個外掛目錄/41列文件表格)。hermes_cli/models.py宣告的CANONICAL_PROVIDERS: list[ProviderEntry]包含39個靜態項目(nous、fireworks、openrouter、moa、novita、lmstudio、anthropic、openai-codex、openai-api、alibaba、xai-oauth、xiaomi、tencent-tokenhub、tencent-tokenplan、nvidia、copilot、copilot-acp、huggingface、gemini、vertex、deepseek、xai、zai、kimi-coding、kimi-coding-cn、stepfun、minimax、minimax-oauth、minimax-cn、ollama-cloud、arcee、gmi、kilocode、opencode-zen、opencode-go、bedrock、azure-foundry、ai-gateway、qwen-oauth),後方註解寫道:「將已在providers/註冊、但尚未列於上方清單的供應商自動加入CANONICAL_PROVIDERS。只要新增plugins/model-providers//,即可讓新的供應商出現在模型選擇器中」;此迴圈僅略過oauth_device_code、oauth_external、external_process、aws_sdk、copilot及vertex驗證類型(未變更)。該標籤的plugins/model-providers/目錄樹包含39個供應商目錄(nebius-token-factory與router於v0.21.0開發期間新增);其中9個沒有靜態項目的供應商(actual、alibaba-coding-plan、commandcode、deepinfra、meta-ai、nebius-token-factory、opencode-free、router、upstage)最終皆使用api_key驗證類型——7個明確宣告auth_type="api_key"(包括兩個新外掛),而commandcode與opencode-free則從providers/base.py繼承auth_type: str = "api_key"。AI供應商文件頁面(該標籤下的原始檔為website/docs/integrations/providers.md)以表格列出45個具名供應商,另有一列「自訂端點」(自v2026.8.31以來新增的列:Ramp Router、Nebius Token Factory、Tencent TokenPlan、Alibaba Cloud(Token Plan)——引述於36);新增對照表列中的每個環境變數名稱、供應商識別名稱、別名及驗證註記皆引自該表格,包括「OpenCode Free | 免金鑰——不需要API金鑰或帳號(供應商:opencode-free,別名:free、opencode_free)。透過hermes model或/model free選取;請求以匿名方式傳送」、「Google Vertex AI | ……透過服務帳戶JSON或ADC使用OAuth2,採用GCP計費」、「AWS Bedrock | ……透過boto3使用標準AWS憑證鏈」,以及「CommandCode | ……適用於GOAT/Pro/Max/Provider方案(不適用於$1的Go方案——該方案不提供API存取權)」。Meta AI列來自同一頁面中原生支援的API金鑰區塊:「Meta Model API(Muse Spark系列)……hermes chat --provider meta-ai --model muse-spark-1.2……需要:MODEL_API_KEY」。Cerebras僅出現在該頁面的「其他相容供應商」表格中(https://api.cerebras.ai/v1,「晶圓級晶片推論」),因此列於自訂端點列之下,而非列為原生支援的供應商。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩ -
標籤
v2026.8.31的CLI功能範圍(已為指南v1.17重新驗證;引述的全域選項說明字串與所有關於_BUILTIN_SUBCOMMANDS的資訊均與v2026.8.31相同——frozenset完全一致,共73個項目——而hermes_cli/_parser.py僅有hermes chat內部變更,詳見40)。全域選項及其說明字串取自hermes_cli/_parser.py:--in(「啟動或恢復前先切換至DIR。搭配’–resume latest’或-c時,會選取DIR工作區的最近一次工作階段,且工作階段會留在DIR中(略過還原已記錄工作目錄的步驟)。」)、--ignore-user-config(「忽略~/.hermes/config.yaml並改用內建預設值(仍會載入.env中的憑證)」)、--ignore-rules(「略過自動注入AGENTS.md、SOUL.md、.cursorrules、記憶及預先載入的skill」)、--tui(「啟動現代化TUI,取代傳統REPL」)、--cli(「強制使用傳統prompt_toolkit REPL(覆寫display.interface=tui)」)、--dev(「搭配–tui:透過tsx執行TypeScript原始碼(略過dist建置)」),以及--version/-V(「顯示版本並結束」)。hermes_cli/_startup_fast.py僅對argv in (["--version"], ["-V"])採用快速處理路徑,而hermes_cli/main.py中的_BUILTIN_SUBCOMMANDSfrozenset不含version項目;CLI命令參考記載的是hermes --version(「顯示版本資訊」),未列出hermes version。命令描述取自該標籤下hermes_cli/main.py與hermes_cli/subcommands/*.py的剖析器help=字串(例如approvals:「核准提示工具(從歷史記錄中挖掘允許清單建議)」;pause:「緊急停止:暫停cron/kanban派送及新的gateway回合」;sync:「Skill Sync——跨裝置並與團隊同步您的skill」;verify:「偵測專案的執行方式並進行冒煙測試」;login:「已棄用。請使用hermes auth管理憑證、使用hermes model選擇供應商,或使用hermes setup完成完整設定。」),並已與文件中的頂層命令表交叉核對。hermes update --plan位於hermes_cli/subcommands/update.py:「顯示更新計畫並結束,不做任何變更:安裝類型(git/docker/nix)、所有profile中每個執行中的Hermes服務及其監督程式與執行中程式碼版本,以及各服務的重新啟動方式。唯讀;可安全用於運作中的服務群。」;_BUILTIN_SUBCOMMANDS中不存在fleet命令。hermes worktree註冊於hermes_cli/main.py(說明:「稽核並清理累積的git工作樹與已合併分支」),包含list(別名為ls、audit;「分類每個工作樹:存續時間、大小、判定、原因(預設動作)」)、prune(「移除可安全清理的工作樹,並刪除已完全合併的本機分支」)、--repo、--dry-run(「顯示計畫,不做任何變更」)、--trees-only(「僅移除工作樹;保留本機分支」),以及--branches-only(「僅刪除已合併的本機分支;保留工作樹」)。/worktree斜線命令對應至hermes_cli/cli_commands_mixin.py中的_handle_worktree_command(語法區塊:/worktree、/worktree new [name]、/worktree list、/worktree prune [--dry-run]);CLI使用指南的「工作樹清理」一節補充:「在工作階段內,/worktree prune [--dry-run]會執行相同操作(且絕不會動到工作階段目前所在的工作樹)。」 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩ -
標籤
v2026.8.31的Nous Portal命令(已為指南v1.17重新驗證;hermes_cli/portal_cli.py與其v2026.8.31版本逐位元組完全相同)。該標籤的README在「省去蒐集API金鑰的步驟——Nous Portal」一節寫道:「全新安裝後只需一個命令:hermes setup --portal……這會透過OAuth登入,將Nous設為供應商,並啟用Tool Gateway。隨時可使用hermes portal info查看目前已連接的項目。」hermes_cli/portal_cli.py註冊了portal(說明:「設定Nous Portal(登入、模型選擇、Tool Gateway);另請參閱portal info」),其下包含login(「登入Nous Portal並完成設定(預設;一次完成初始設定)」)、info(「顯示Portal驗證與Tool Gateway路由摘要」)、open(「在預設瀏覽器中開啟Portal訂閱頁面」)、tools(「列出Tool Gateway工具,以及哪些工具透過Nous路由」),另有程式碼註解:「保留status作為info的隱藏別名,以維持向下相容。」Tool Gateway文件頁面列出hermes setup --portal # Fresh install: Nous OAuth + set Nous as provider + turn on the Tool Gateway in one go與hermes portal info # Portal auth + Tool Gateway routing summary;同一標籤的CLI命令參考仍記載hermes portal [status|open|tools]。 ↩↩↩ -
GitHub比較API,
NousResearch/hermes-agent,v2026.8.19...main,於2026年8月26日擷取:ahead_by: 1104、behind_by: 0。發行版本API將v2026.8.19(Hermes Agent v0.20.5,發布於2026-08-21T12:16:39Z)列為最新標籤,其說明指出:「此期間完整整理的版本資訊將隨v0.21.0發布,涵蓋自v0.20.0起的所有變更。」2026年8月27日針對新標籤重新檢查:v2026.8.27...main傳回ahead_by: 0、behind_by: 0、status: identical——main目前與v0.20.6標籤完全一致。 ↩↩ -
Hermes Agent v0.20.6版本資訊(標籤
v2026.8.27,標示發行日期為8月27日,發布於2026-08-27T12:06:53Z;於2026年8月27日透過GitHub API擷取——prerelease: false)。原文定位:「修補版本。此標籤將v0.20.5以來合併的約525個PR彙整為穩定的標籤版本,供下游使用者採用(Docker映像檔、託管部署、全新安裝)。」原文對此期間的描述:「自v0.20.5(v2026.8.19,於8月21日加上標籤)以來,此期間納入約1,313次提交,涉及約1,557個檔案(+177,113 / -21,682)——約525個已合併PR,包含需經同意才能使用的實際profile瀏覽功能(使用預設Chromium profile進行本機瀏覽,並提供Windows上經核准後關閉的流程);桌面Browser擁有獨立的作業系統視窗,並加入受管理的SSH遠端更新引擎及服務群profile側欄;大幅擴充遠端MCP目錄(超過50個經實際連線驗證、由廠商託管的伺服器,包括Cloudflare、Grafana Cloud、Better Stack、Railway);web_search/web_extract的TTL結果快取;預設採用lean-tail壓縮;支援詞幹處理的多查詢tool_search;可選擇啟用作業系統鑰匙圈加密,以保護儲存的機密資料(macOS Keychain不再於每次啟動時顯示提示);更新程式透過控制通訊端暫停gateway,取代終止整個程序樹;由映像檔/套件管理的安裝拒絕不安全的就地更新(#91277第3階段);cron持久化事件確認及更清楚的程式碼版本不一致錯誤;Slack連結預覽控制;共用的Docker容器身分;可插拔的終端機環境後端;以及各選擇器中的新模型(GLM-5.3-Flash、MiniMax M3免費版、MiniMax H3 Max影片)。」該版本再次強調:「此期間完整整理的版本資訊將隨v0.21.0發布,涵蓋自v0.20.0起的所有變更——重點、功能領域及完整貢獻者名單。此期間的內容皆會收錄,無一遺漏。」 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩ -
標籤
v2026.8.31的壓縮行為,已於v2026.8.31重新驗證,適用於指南v1.17:tail_mode: str = "lean"、("legacy", "lean")防護檢查、agent_init的"lean"預設值、設定版本17的遷移,以及下方關於過時輔助設定註解的說明,在新標籤中皆仍適用(context_compressor.py新增了固定摘要路由的重試流程,但未改變任何引述的預設值)。agent/context_compressor.py在ContextCompressor.__init__中將tail_mode: str = "lean"設為預設值,並附有註解:「精簡尾端模式(#compaction-v2):’lean’ = 限制長度的近期訊息尾段+保留使用者訊息原文的摘要區段+復原指標;’legacy’ = 0.20window的尾段(正式發布時的行為)」,以及防護檢查self.tail_mode = tail_mode if tail_mode in ("legacy", "lean") else "lean"。agent/agent_init.py讀取compression.tail_mode時,以"lean"為預設值;其註解量化了兩種模式:「’lean’(預設)保留2.5%、限制在10K–25K的原文尾段,並搭配復原指標機制……’legacy’則恢復#87326之前0.20threshold的原文尾段;在大型上下文視窗或提高門檻的設定下,每次壓縮會囤積100K–240K個token。」設定文件頁面(該標籤的原始檔為website/docs/user-guide/configuration.md)展示的compression:區塊包含enabled、threshold: 0.50、threshold_tokens: null、target_ratio: 0.20、tail_mode: lean(v2026.8.31的註解為:「’lean’(預設——保留2.5%的尾段,限制在10K–25K,摘要中含有詳細的工作階段記錄、錨點索引,以及session_search復原指標,全部來自單次輔助摘要模型呼叫;壓縮後保留的token數約為原本的1/3)或’legacy’(0.20×threshold的原文尾段)」)、protect_last_n: 20及protect_first_n: 3,並將摘要模型的設定項目放在auxiliary.compression下(model、provider、base_url),另註明:「含有compression.summary_model、compression.summary_provider及compression.summary_base_url的舊設定,會在首次載入時自動遷移至auxiliary.compression.*(設定版本17)。無須手動處理。」遷移由hermes_cli/config_migrations.py中的_migrate_to_17執行(「版本16 -> 17:移除舊版compression.summary_鍵」)。上下文壓縮開發者頁面(該標籤的原始檔為website/docs/developer-guide/context-compression-and-caching.md)在表格中列出tail_mode的預設值為lean,並說明「在500K個token的真實工作階段中,結果為:保留約49K,相較之下原本約為162K」,以及「精簡尾段中的舊工具結果會降為單行簡略記錄,附帶復原指標」。該頁也保留了摘要模型警告(於v2026.8.31):「摘要模型的上下文視窗必須至少與主要代理模型的一樣大。……否則,壓縮器會在沒有摘要的情況下丟棄中間回合,無聲無息地遺失對話上下文。」(上游仍有一處過時內容:設定頁面的「完整輔助設定參考」仍將auxiliary.compression欄位註解為「上下文壓縮逾時(與compression.設定分開)」;遷移程式碼、互動式hermes model輔助模型選擇器,以及該頁本身的壓縮章節,則是較新且彼此一致的來源。) ↩↩↩↩↩↩↩ -
標籤
v2026.8.31的可插拔終端機後端(已為指南v1.17重新驗證;agent/terminal_env_registry.py與其v2026.8.31版本的位元組內容完全相同)。agent/terminal_env_registry.py的模組文件字串原文譯為:「已註冊之可插拔終端機後端的中央對照表。由外掛在載入時透過PluginContext.register_terminal_environment_provider填入;由tools.terminal_tool._create_environment使用」,以及「內建後端名稱為保留名稱——register_provider會拒絕名稱與內建後端衝突的提供者,因此外掛絕不會覆蓋儲存庫內的docker/modal/……實作」;此處刻意「不處理啟用中提供者的解析:啟用的後端就是TERMINAL_ENV / terminal.backend指定的後端,與內建後端完全相同」。其BUILTIN_BACKEND_NAMES不可變集合包含7個後端,以及內部模式別名managed_modal:local、docker、singularity、modal、managed_modal、daytona、vercel_sandbox、ssh。新增的文件頁面終端機環境提供者外掛(該標籤的原始檔為website/docs/developer-guide/terminal-environment-plugin.md)原文譯為:「Hermes透過一組可插拔的終端機後端執行shell命令。內建後端(local、Docker、Singularity、Modal、Daytona、Vercel Sandbox、SSH)位於核心儲存庫的tools/environments/下。第三方沙箱供應商則以外掛形式整合——將獨立的外掛儲存庫安裝於~/.hermes/plugins/下,註冊後端後,使用者便能透過config.yaml中的terminal.backend選取,方式與內建後端完全相同」;該頁以表格列出已註冊提供者所支援的功能範圍(命令派送、hermes setup後端選擇器、儀表板探測狀態、hermes status/hermes doctor檢查、系統提示中的環境提示、容器路徑/cwd處理、機密資訊移除、各工作階段的沙箱隔離),並說明設計目標:「在提供者上宣告這些旗標,可消除典型的『新增後端時漏改第N處分類判斷』這類錯誤——核心會在每個位置查詢登錄表,而非使用寫死的名稱清單。」 ↩↩↩ -
標籤
v2026.8.31的全面重新驗證(指南v1.17)。語系:locales/目錄樹包含17份訊息目錄——en.yaml加上16份翻譯(af、ar、de、es、fr、ga、hu、it、ja、ko、pt、ru、tr、uk、zh-hant、zh)——與v2026.8.27相同。個性:hermes_cli/personality.py中的BUILTIN_PERSONALITIES仍包含相同的14個項目,從helpful到hype(helpful、concise、technical、creative、teacher、kawaii、catgirl、pirate、shakespeare、surfer、noir、uwu、philosopher、hype);該檔案與其v2026.8.27版本的位元組內容完全相同。此標籤中有變動的數量:39個靜態CANONICAL_PROVIDERS項目(原為38個),以及39個plugins/model-providers/目錄(原為37個)——請參閱26與36。未變動的數量:24個Platform列舉成員(gateway/config.py中的成員清單完全相同,僅新增了room_link_url這個gateway欄位)、22個plugins/platforms/介接器目錄、文件中平台比較表的28列;_BUILTIN_SUBCOMMANDS仍包含完全相同的73個項目(含有peer及worktree,仍無version,也沒有approval-check——這是版本資訊中對hermes approvals test的稱呼);hermes_cli/_startup_fast.py與hermes_cli/portal_cli.py的位元組內容皆與各自的v2026.8.27版本完全相同。 ↩↩↩↩ -
標籤
v2026.8.31的輔助模型路由(已為指南v1.17重新驗證;新標籤中的"auxiliary"預設值區塊包含完全相同的槽位清單、移除說明與非槽位設定,下列文件引文也仍與原文逐字相符)。設定文件頁面(該標籤下的來源檔案為website/docs/user-guide/configuration.md)原文指出:「預設情況下(auxiliary.*.provider: "auto"),Hermes會將所有輔助工作路由至您的主要聊天模型,也就是您在hermes model中選擇的同一個供應商/模型。您無須進行任何設定即可開始使用,但請留意,若使用成本較高的推理模型(Opus、MiniMax M2.7等),輔助工作會增加相當可觀的費用。」其「為何『auto』使用您的主要模型」說明指出:「早期版本會將聚合平台使用者(OpenRouter、Nous Portal)的輔助工作分流至供應商端的低價預設模型。這讓人感到意外:付費訂閱聚合平台的使用者,會發現輔助流量由另一個模型處理。現在,auto對所有使用者都會使用主要模型,而config.yaml中各工作的覆寫設定仍具有優先權。」關於網頁擷取則指出:「(網頁擷取並非輔助工作:web_extract與瀏覽器快照會依固定規則截斷過長的內容,並儲存全文,供read_file分頁讀取,不涉及LLM。)」權威槽位清單位於該標籤下hermes_cli/config_defaults.py的"auxiliary"預設值區塊:vision、compression、skills_hub、approval、review、mcp、title_generation、memory_query_rewrite、tts_audio_tags、triage_specifier、kanban_decomposer、profile_describer、goal_judge、curator、monitor、background_review、moa_reference與moa_aggregator(另有非槽位設定transient_retries、free_only、openrouter_model、stream_only_base_urls);各槽位包含provider、model、base_url、api_key、timeout、extra_body,以及各工作專屬的reasoning_effort。同一檔案中的移除說明原文指出:「web_extract不再使用輔助LLM;頁面會先截斷再儲存,並提供read_file指標(不產生摘要),瀏覽器快照也採用相同方式。舊有的auxiliary.web_extract.*區塊已在此移除。使用者config.yaml檔案中既有的值只是無害的殘留設定,系統會予以忽略。」以及「session_search不再使用輔助LLM(PR #27590:單一結構的工具直接傳回資料庫內容)」;該區塊中不存在flush_memories索引鍵。各槽位的簡述來自同一檔案的註解(「分類規格產生器:將Kanban分類欄中粗略的一句話描述擴充為具體規格,再將其移至todo。由hermes kanban specify呼叫」;「Kanban拆解器:將待分類工作拆解為子工作圖,並依描述路由至專業profile。由hermes kanban decompose與kanban自動拆解派送器呼叫」;「Profile描述器:自動產生1至2句描述,說明profile擅長的工作。由hermes profile describe <name> --auto與儀表板的自動產生按鈕呼叫」;「目標判定器:評估/goal執行的最新回應是否符合目標/契約」;「策展器:審查skill使用情況的分支」;「背景審查:在每回合結束後執行的自我改進分支,決定是否儲存記憶/修補skill」)、設定頁面完整參考資料中的註解(「插入Gemini 3.1 TTS隱藏音訊標籤」;「自動產生的工作階段標題。語言留空時會沿用對話語言」;auxiliary.title_generation.enabled: false會停用自動標題),以及Kanban文件頁面的設定表格(「auxiliary.kanban_decomposer| 產生工作圖的模型(由Decompose呼叫)」;「auxiliary.profile_describer| 自動產生profile描述的模型(由hermes profile describe --auto呼叫)」)。互動式操作路徑:執行hermes model並選擇「設定輔助模型」,即可開啟各工作的選擇器(vision、title_generation、tts_audio_tags、compression、approval、triage_specifier、kanban_decomposer、profile_describer、delegation);委派項目的設定會儲存至頂層delegation.*,因為子代理「是完整的子代理,而非附帶的LLM呼叫」。 ↩↩↩↩↩↩↩↩↩↩↩ -
Hermes Agent v0.21.0版本說明,「萬神殿版本」,標籤
v2026.8.31,標示的發行日期為8月31日,發布時間為2026-08-31T19:29:49Z。統計資料原文:「自v0.20.0以來:約5,800次提交 · 約2,475個已合併PR · 約5,680個檔案變更 · 約869,000行新增 · 約135,000行刪除 · 約2,100個已關閉議題 · 760多位貢獻者」。版本定位原文:「萬神殿版本。v0.20.0讓Hermes成為傳令使者:他開口發言,也將訊息帶給其他代理。在v0.21.0中,眾神齊聚。」以及「此版本彙整了v0.20.1至v0.20.6基礎設施修補標籤中的所有內容,這些期間的變更均完整記錄於此。」上文使用的功能領域引文原文:機器人模式:「機器人模式現已內建於桌面應用程式,並預設啟用:每個代理profile都有名稱、依固定規則產生的頭像面孔(附隨機產生/鎖定控制項),並列入共用名冊」以及「過去,『多代理』意味著底層串接;現在,它看起來就像一個滿是同事的聊天應用程式」(#87886、#88243、#89386、#96726);hermes peer:「回覆會進入各代理的標準Bot Chat,讓代理之間的對話得以持久保存並供檢視,而非送出後便不再追蹤」(#88725、#88178、#91487);cron:「continuity=true會將每次執行的輸出帶入下一次執行(讓監控器能比對已回報的內容並去除重複項目),每項作業都有可持久保存的記事本草稿區,監控模式作業在沒有任何變更時會完全略過LLM」(#91447、#80774、#81139、#81138);委派:「列出執行中的子代理,在執行途中調整其中一個子代理的方向,或提早停止並保留部分結果。另外還提供選用的子代理輸出JSON結構描述驗證、在結果中顯示各次委派的成本,並提高預設上限(250次迭代、10個並行子代理)」(#85232、#81144、#81142、#86506、#86745);MCP:「hermes://深層連結,可在明確確認後安裝MCP伺服器」(#87525-#87581);CLI:「Ctrl+P可開啟支援模糊搜尋的命令面板,/model選擇器會隨輸入即時篩選,/status會顯示推理模式、待核准項目與上下文使用量,而狀態列可顯示即時快取命中率百分比、延遲及每秒token數,且各欄位皆可個別切換顯示」(#90730、#90717、#90745、#98250、#98282、#97666);瀏覽器:「Hermes現在可直接進行導覽、點擊與讀取」(#90197、#89366);供應商:「Meta Model API(Muse Spark)成為內建供應商,同時加入的還有CommandCode、Tencent TokenPlan、Nebius Token Factory、Ramp Router與Actual Computer」(#88565、#88308、#97917、#97916、#97915,以及從#79644/#26491保留下來的成果);安全性:「受保護的代理指示檔案(AGENTS.md、skills、記憶儲存區)現在一律需要寫入核准,讓遭提示注入的代理無法悄悄改寫自身的常設指示」(#81152),另有全面遮蔽敏感資訊的修正(#80965)、Windows核准涵蓋範圍(#84428)、TCC身分識別(#95091),以及移除Blender MCP(#83404)。撤回項目原文:「模型議會模式(/council):已納入後又撤回;不包含於此版本。」;「DCP context engine:已納入後又撤回;不包含於此版本。」;「僅支援WS的gateway伺服器(#94245):合併後又撤回(#96118);FastAPI仍位於桌面應用程式的啟動路徑中。帶有序號標記的事件重播(#94219)則確實已發布。」;「Electron回退至40.10.2;TCC直譯器錨點已移除(由已發布的簽署身分識別方式取代)。」錯誤修正章節以此作結:「……以及約2,000個其他已關閉議題所涵蓋的修正;這段期間平均每天合併約85個PR。」 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩ -
標籤
v2026.8.31新增的供應商。hermes_cli/models.py新增ProviderEntry("tencent-tokenplan", "Tencent TokenPlan", "Tencent TokenPlan (Hy4 preview via api.lkeap.cloud.tencent.com, Anthropic Messages)")(第39個靜態項目)、目錄模型hy4-preview、hy3、hy3-preview,以及僅供顯示的選擇器群組"tencent": ("Tencent Hy", "Hy4 / Hy3 via TokenHub & TokenPlan", ["tencent-tokenhub", "tencent-tokenplan"])。plugins/model-providers/新增nebius-token-factory/與router/,兩者皆宣告auth_type="api_key",因此會由自動擴充機制納入。router外掛的文件字串原文如下:「Ramp Router的供應商profile;這是Ramp的LLM gateway:透過單一相容於OpenAI Responses的端點https://api.router.com/v1,將每個請求路由至各上游供應商(OpenAI、Anthropic、xAI、Fireworks等),並在伺服器端處理備援切換與支出控管」……「Responses API是原生傳輸協定。」……「有效的模型ID以該金鑰呼叫GET /v1/models所傳回的結果為準(BYOK帳戶會看到額外項目),因此此profile不附帶fallback_models;選擇器依賴即時擷取的結果,遵循Router官方切勿將模型名稱寫死的指引。」該標籤版本的AI供應商文件頁面以表格列出45個具名供應商,另有自訂端點一列;自v2026.8.27起新增的4列引述如下:「Ramp Router |~/.hermes/.env中的RAMP_ROUTER_API_KEY(供應商:router;別名:ramp-router、ramp、router.com;原生支援Responses的gateway,依帳戶範圍提供即時目錄)」;「Nebius Token Factory |~/.hermes/.env中的NEBIUS_API_KEY(供應商:nebius-token-factory;別名:nebius、nebius-tf、tokenfactory)」;「Tencent TokenPlan |~/.hermes/.env中的TOKENPLAN_API_KEY(供應商:tencent-tokenplan;別名:tokenplan、tencent-lkeap;Anthropic Messages端點)」;「Alibaba Cloud(Token Plan) |~/.hermes/.env中的ALIBABA_TOKEN_PLAN_API_KEY(供應商:alibaba-token-plan;中國大陸端點:alibaba-token-plan-cn)— Model Studio固定token額度方案」。model_overrides位於該標籤版本的hermes_cli/config_defaults.py中("model_overrides": {};明確指定的model_overrides.<provider>.<model_id>項目優先於目錄,_default項目則僅為目錄未涵蓋的模型補上缺漏設定)。 ↩↩↩↩↩↩↩↩ -
標籤
v2026.8.31的cron延續性。cron文件頁面(來源為該標籤版本的website/docs/user-guide/features/cron.md)原文如下:「設定continuity=true後,工作會在每次執行時注入自身最近一次的輸出。週期性工作通常每次執行都從失憶狀態開始:新聞蒐集工作重複報導相同新聞,監控工作則針對相同狀況重複發出警示。啟用延續性後,工作喚醒時就能看到上次回報的內容,藉此去除重複內容,並接續先前的進度」;「後續執行時,會在前文加入上次的輸出,並附上延續性指示(『避免重複已回報的內容』)……此旗標在內部儲存為context_from中的保留項目self。」;「透過CLI:使用hermes cron create "every 6h" "Scan for news" --continuity建立工作,並以hermes cron edit <job_id> --continuity/--no-continuity切換現有工作的設定。儀表板的cron編輯器與桌面版Bot Mode例行工作對話框也提供相同的切換選項。」個別工作的推理強度,原文如下:「工作可以固定使用自己的思考層級,與固定使用的模型各自獨立:可選值為none、minimal、low、medium、high、xhigh、max、ultra。設定後,該工作執行時會覆寫全域agent.reasoning_effort與個別模型的agent.reasoning_overrides」;透過hermes cron create/edit --reasoning-effort high設定。Bot Chat傳遞方式,原文如下:「bot-chat會將輸出作為實際訊息,傳入profile的標準『Bot Chat』工作階段……此處的接收者是機器人本身:它會將輸出視為傳入訊息,處理其中需要採取行動的事項,並在聊天中回覆。」記事板:cron/notepad.py模組的文件字串描述為「每個cron工作都能使用的輕量KV暫存區,用於在排程喚醒之間保留狀態(游標、進度標記、監看清單)」,上限為「MAX_VALUE_BYTES(16 KB)」與「MAX_JOB_TOTAL_BYTES(64 KB)」(「記事板會在每次執行時注入提示,因此若無限制地增長,每次喚醒時的提示都會變得臃腫」),以及「寫入途徑為CLI(hermes cron notepad <job_id> set <key> <value>),由執行中的代理透過終端機工具呼叫;未新增模型工具。」監控模式:cron/monitor.py的文件字串描述為「cron監控模式支援:以雜湊比對抑制重複執行的變更偵測」,搭配「低成本的監控來源(monitor_script或monitor_url)」;「未變更 -> 完全略過代理執行(不呼叫LLM,也不傳遞訊息);此次排程觸發會記錄為無通知的no_change執行」;「輸出以完全相同的位元組進行比對,不移除時間戳記,也不將空白正規化。監控指令碼應產生穩定的輸出……否則每次排程觸發都會被視為有變更。」;「實作基礎:#80774。」 ↩↩↩↩↩↩↩ -
標籤
v2026.8.31的即時子代理協調。委派文件頁面(來源為該標籤版本的website/docs/user-guide/features/delegation.md)中的「引導執行中的子代理」:控制介面為{"action": "list"}、{"action": "steer", "subagent_id": "sa-0-1a2b3c4d", "message": "focus on pricing instead"}、{"action": "stop", "subagent_id": "sa-0-1a2b3c4d"};原文如下:「list傳回此對話中仍在執行的子代理:subagent_id、目標、狀態、running_seconds、accepting_steer,以及即時對話紀錄的路徑」;「stop會在子代理的下一個迭代邊界提前結束執行;部分結果仍會以一般完成訊息的形式回傳至對話」;控制動作「僅限於呼叫者自身的衍生樹狀結構:對話絕不會看到或控制其他工作階段的子代理,而且控制動作不會占用每回合的子代理建立額度,因此即使達到上限,stop仍可運作」;引導訊息的傳遞會如實反映競爭狀況(「排入佇列不等於已送達,但絕不會虛報成功」,pending_steer會被取出並納入結果,若子代理先行完成,則標記為missed_steer)。預設值:hermes_cli/config_defaults.py設定delegation.max_iterations: 250(「每個子代理的迭代上限;各子代理都有自己的額度,與父代理的max_iterations無關」)與delegation.max_concurrent_children: 10(「統一的並行上限:同時限制每批次可平行執行的子代理數,以及可同時在背景(background=true)執行的委派單元數……(取代已棄用的max_async_children。)」)。上游仍有一處過時內容:委派文件頁面本身仍寫著「預設為3項工作」,且設定參考中顯示「max_iterations: 50……(預設:50)」;隨版本提供的config_defaults.py與版本說明(「提高預設值:250次迭代、10個並行子代理」)則是較新且彼此一致的來源。 ↩↩ -
標籤
v2026.8.31中的一系列安全性更新。受保護的指令檔案:hermes_cli/config_defaults.py將security.protected_instruction_files: True設為預設值(註解:「寫入代理指令檔案(AGENTS.md/CLAUDE.md/SOUL.md/…)」),並搭配protected_instruction_extra_patterns: [](以fnmatch比對檔案基本名稱);tools/file_tools.py實作此核准關卡:「受保護的代理指令檔案(每次都需詢問的核准關卡)」,套用於_PROTECTED_INSTRUCTION_BASENAMES = frozenset({"agents.md", "claude.md", "soul.md", ".cursorrules", ...}),並明確描述威脅模型,原文意為:「攻擊途徑:注入指令,編輯AGENTS.md / CLAUDE.md / SOUL.md」以及「專案情境指令檔案會從目前工作目錄的目錄樹載入,因此,代理日後可能在其中執行的任何位置,只要有AGENTS.md,就會成為有效的攻擊目標。」TCC身分:hermes desktop --setup-tcc-identity實作於hermes_cli/main.py,函式為_desktop_macos_setup_tcc_identity(identity: str = "Hermes Local Signing"),說明為「為hermes desktop --setup-tcc-identity進行一次性設定」,並設有「(–setup-tcc-identity僅適用於macOS;略過)」與「(–setup-tcc-identity需要openssl、security和codesign …)」等條件檢查。全面遮蔽敏感資訊(#80965、#80964、#81675、#81686、#88232)、Windows核准涵蓋範圍(#84428)、移除Blender MCP(#83404),以及Tier-1外掛安裝掃描(#80728),皆依據版本說明。35 ↩↩↩↩ -
標籤
v2026.8.31中的CLI介面變更。hermes_cli/commands.py中的COMMAND_REGISTRY註冊了CommandDef("palette", "Open the fuzzy command palette (also Ctrl+P)", "Info", ...)與CommandDef("status", "Show session, model, token, and context info", "Session", ...)——/status是共用登錄表中的工作階段指令,並非僅限訊息平台使用。_BUILTIN_SUBCOMMANDS中沒有approval-check項目(共73個項目,與v2026.8.27完全相同);v0.21.0版本說明稱為hermes approval-check(#81137)的試執行功能,實際指令是hermes approvals test——該標籤中hermes_cli/subcommands/approvals.py的剖析器說明為:「試行評估指令的核准判定(絕不執行該指令)」,並提供--backend(「評估時使用的終端機後端類型(預設:local …」)與--json。hermes_cli/_parser.py僅變更了hermes chat內部:-q/--query的說明現在是「要執行的查詢。在實際TTY上,提示會啟動互動式工作階段(原樣提交為第一輪內容);搭配–oneshot或-Q,或在非TTY環境下,則會回答後結束。」;新增的--oneshot旗標說明為「搭配-q/–query-file:回答查詢後結束(舊版單次查詢行為),而非啟動互動式工作階段。在非TTY標準輸入輸出環境及使用-Q/–quiet時,會隱含啟用。」;--max-turns則說明為「每輪對話的工具呼叫迭代次數上限(預設:500,或設定中的agent.max_turns)」。 ↩↩↩↩↩↩↩↩↩ -
Hermes Agent v0.21.1版本說明,標籤
v2026.9.7,標示發布日期為9月7日,發布時間為2026-09-07T22:17Z。內文刻意保持精簡;原文意為:這是「修補版本」,「彙整自v0.21.0以來目前main上的變更,供採用標籤版本的部署與下游使用者使用」;準備發布時,此期間的統計為「5,139次非合併提交,涉及4,364個變更檔案(+601,014 / -768,419)」與「632個已合併PR」;並表示「此期間完整整理的版本說明將隨v0.22.0發布。」本機複本檢查:git rev-list --count --no-merges v2026.8.31..v2026.9.7= 5,140,git diff --shortstat= +601,018 / -768,423——內文數字是發布提交前的快照,差異恰好就是該次發布提交;此前最大的相鄰標籤區間為v2026.7.20..v2026.7.30,共有2,790次非合併提交(已在本機複本中測量自v2026.3.12起的每一組相鄰標籤)。疑難排解條目中的doctor檢查位於該標籤的hermes_cli/doctor_config.py:330-362(_drift_max_iterations_ghost):當啟動橋接程序因先前的設定剖析錯誤而提前退出時,.env中過時的HERMES_MAX_ITERATIONS會遮蔽agent.max_turns(議題#17534),而hermes doctor --fix會移除.env中的該行。於2026年9月8日的當次工作階段驗證。 ↩↩↩↩↩ -
標籤
v2026.9.7中的COMPAT_MANIFEST.md(儲存庫根目錄,共3,869行)。原文意為:「2026年9月的拆分作業(PR #102117)將Hermes Agent的大型模組拆分為職責明確的檔案」;「內部匯入路徑並非穩定的API」;「此相容層僅為暫時措施,將於2026-09-14移除。它以單一提交加入,並會透過還原該提交移除。」;行為說明表(2026-09-14之前:顯示黃色通知,列出外掛名稱、日期與hermes plugins compat;外掛「會載入;每個舊路徑的解析都會發出一次HermesPluginCompatWarning」;自2026-09-14起:「紅色通知:外掛已停用」且「不會載入;hermes plugins list會顯示原因」;桌面版:「一次性強制回應對話方塊」);例外機制的原文意為:「在config.yaml中設定plugins.allow_deprecated_imports: true,可讓受影響的外掛在該日期之後繼續載入,直到還原提交真正移除這些路徑為止。」;各類型數量:moved-lazy 1148、import 592、restored-def 290、restored-helper 41、restored-import 17、module-stub 3、unrestorable 34;適用範圍:僅限公開的頂層名稱,「測試用的monkeypatch接點同樣不予保留。」檢查工具的剖析器位於hermes_cli/subcommands/plugins.py:104-112:hermes plugins compat [path] [--json],說明原文意為「靜態掃描所有已啟用的外部外掛,檢查是否匯入拆分前的模組路徑(請參閱COMPAT_MANIFEST.md),並印出檔案:行號、舊路徑->新路徑。只要有任何外掛受影響,就以結束碼1結束。」已在該標籤驗證拆分結構:agent/= 214個頂層模組+7個子套件(lsp、monitoring、pet、proxy_sources、secret_sources、transports、verify),hermes_cli/subcommands/= 61個模組,hermes_cli/models_catalog_static.py:311中的CANONICAL_PROVIDERS有39個項目,其slug與v2026.8.31中hermes_cli/models.py的清單完全相同(包含xai靜態元組;plugins/model-providers/仍有39個目錄),原本的頂層prompt_builder.py已移除(現為agent/prompt_builder.py),而根目錄的run_agent.py仍是AIAgent所在之處。後續情況,已為指南v1.19重新驗證(2026年9月15日):移除機制如期透過日期條件生效,而非透過還原提交——在標籤v2026.9.14中,hermes_cli/plugin_compat.py:32設定COMPAT_REMOVAL_DATE = _dt.date(2026, 9, 14),removal_in_effect()(第86–90行)自該日期起或清單檔案缺失時傳回true,而allow_deprecated_imports()(第261–268行)僅接受布林字面值(判斷條件為... is True;原始碼註解為「僅限布林字面值」,因此"false"或"no"之類的YAML字串絕不可能啟用移除後的繞過機制)。刪除舊路徑的還原提交尚未合併:COMPAT_MANIFEST.md、compat_manifest.json與hermes_cli/plugin_compat.py在v2026.9.14及main的提交5d59366010(2026年9月15日12:55太平洋時間,於當日擷取)中都仍存在,因此例外機制仍可解析舊路徑;還原提交一旦合併,此機制就會立即失效。已為指南v1.20重新驗證(2026年9月22日):仍未還原——這3個檔案在標籤v2026.9.21及main的提交a53b42ddea(於2026年9月22日提交,當日擷取)中都仍存在。在v2026.9.21中,日期關卡與判斷條件實質上未變:COMPAT_REMOVAL_DATE仍位於plugin_compat.py:32,removal_in_effect()位於:86,而allow_deprecated_imports()現位於:296-303,布林字面值判斷條件完全相同(... is True;註解現為「僅限布林字面值:YAML"false"/"no"不得啟用移除後的繞過機制。」)。v0.21.4期間對此模組的變更僅涉及效能與可攜性:新增整個程序共用的掃描快取,以各外掛目錄的(relpath, mtime_ns, size)檔案特徵作為索引鍵(多工gateway會為每個服務中的profile探索一次外掛,而在啟動流程中,重新剖析所有外掛的原始碼,每個profile約需0.4秒),並在原生Windows上採用POSIX格式的命中路徑(#112576);此外,清單本身移除了2筆與opencode相關的項目(_OPENCODE_KEYLESS_EXTRA_SLUGS、is_opencode_zen_free_model)——沒有結構性變更。 ↩↩↩↩↩↩↩↩↩ -
標籤
v2026.9.7的docs/session-lifecycle.md,第6節「明確的對話邊界」,完整原文如下:「閒置狀態與實際經過時間絕不會觸發對話輪替。/new與/reset會建立明確邊界;上下文壓縮會持續管理冗長的歷史紀錄。舊版計時器設定會被忽略。現有的SessionResetPolicy資料型別只是保留相容性用的被動資料,並非執行階段原則。明確暫停仍會在下一個傳入回合建立邊界。復原時會遵守明確設定及歷史上已確定的邊界,不會重新開啟這些邊界。僅針對資源的移除與WebSocket孤兒資源回收,仍會讓對話保持可恢復狀態。」 ↩↩↩↩ -
標籤
v2026.9.7的MCP授權。剖析器:hermes_cli/subcommands/mcp.py:55-66–login(「強制重新驗證採用OAuth的MCP伺服器」)接受--flow,可選值為browser/device,說明原文為:「OAuth流程(覆寫oauth.flow):瀏覽器PKCE或RFC 8628裝置代碼」;reauth(「重新驗證一個OAuth MCP伺服器,或全部伺服器(–all)」)接受選填名稱及--all。裝置代碼流程於本次期間內加入:提交f5afe8bd40「feat: 從CLI使用裝置代碼授權MCP伺服器」。相關強化措施,依本次期間內的提交標題列出:f914c9b070「fix(mcp): 在整個OAuth工作階段強制落實profile擁有權」;f94307a7f7「fix: 忽略格式錯誤的MCP OAuth中繼資料快取」;e3ba651b6d「fix(desktop): 透過用戶端本機回呼轉送MCP OAuth」。依toolset篩選啟動項目:tools/mcp_tool_discovery.py:412-426– 此篩選器讓「hermes -z -t <toolsets>」能夠「略過呼叫端不需要的伺服器冷啟動」,而空篩選器會完全略過MCP載入。 ↩↩↩ -
標籤
v2026.9.7的委派可靠性,依委派工具原始碼整理。完成單位:tools/delegate_tool_dispatch.py:326-341(_units_of)– 原文:「預設停用(delegation.independent_completions):整次呼叫視為一個單位,並以一則訊息回傳。各任務接連送出的完成通知(每則都會開啟新回合),會打亂未事先因應此行為的協調器流程。」每個不同的任務group各算一個單位(依首次出現順序),每個未分組任務也各算一個單位,各自獨立重新進入對話;本次期間內的提交c89f3b8800「fix(delegation): 預設每次呼叫只回報一次完成;佇列中的單位不再停滯」。背景程序交接:提交3c0d90e8ef「feat(delegation): 子代理將背景程序交接給父代理;殘留程序會明確列出,不會直接信任」;在該標籤中,tools/delegate_tool_child_run.py:744-763(account_background_processes)會將已交接程序記錄於結果,在cleanup終止其他程序之前,將仍在執行但未交接的程序列為orphaned_processes,將已結束但從未讀取結果的程序列為unread_completions(附上輸出尾段)。文件字串指出:父代理「必須從執行階段取得這項資訊」,不能相信子代理聲稱的「監看程序正在執行」;交接操作為process_manage(action="handoff")(僅限子代理),透過process_registry.transfer_ownership,在持有登錄表鎖定期間變更ProcessSession.owner_task_id(該標籤的tools/AGENTS.md,委派一節)。備援設定介面:hermes_cli/config_defaults.py中的delegation.fallback_providers,註解原文:「對未固定設定的子代理,null = 繼承父代理備援鏈;[] = 停用備援。若子代理已固定供應商、端點或模型,則不提供備援,除非此設定明確宣告備援。」備援鏈驗證位於tools/delegate_tool_config.py:417-425(_resolve_child_fallback_chain):「格式錯誤的項目會由標準正規化程序捨棄。」當機時的資料持久性:tools/async_delegation.py:222-246會將仍在執行的多子代理單位中,每個已完成的子代理持久化記錄在該單位自己的資料列("partial": True),因此即使單位完成前發生當機,仍能保留已完成的子代理。快取層級:tools/delegate_tool.py:106-112(_apply_child_cache_ttl),原文:「受委派的子代理絕不使用1小時快取層級。」帶有_cache_ttl == "1h"的子代理會被設為"5m"。 ↩↩ -
標籤
v2026.9.7的供應商與模型。Astra層級:hermes_cli/models_catalog_static.py:22-25–openai/gpt-6-astra-fast「2倍價格,優先層級」、-flex「0.5倍價格,彈性層級」,以及-pro-fast/-pro-flex;gpt-6-astra與-pro位於OPENROUTER_MODELS中,且未列入_OPENROUTER_ONLY排除集合,因此Nous Portal也提供這些模型。Astra存取限制與900K:hermes_cli/codex_models.py:96-101(「Astra受帳戶權限限制:只有即時查詢、以帳戶為範圍的目錄才能列出它」)與agent/model_metadata.py:1447-1462– Codex OAuth標示272K,gpt-6-astra符合900K資格,註解為「標示272K;920,043輸入可接受,1,000,043遭拒(2026-09-04實測)」,而CODEX_CONTEXT_VARIANT_SUFFIX = "-900k"是「僅供選擇器使用、需主動選用的後綴;絕不透過網路傳送」(依model_metadata.py:334,OpenRouter端的Astra上下文為1,050,000)。同一靜態檔案中的新增目錄項目(第30-42行):anthropic/claude-fable-5.1、google/gemini-3.8-flash與gemini-3.7-flash、qwen/qwen3.8-max-0902與qwen/qwen3.8-flash、meta/muse-spark-1.3與-contributor(依agent/model_metadata.py:349,上下文為1M)。muse-image:plugins/image_gen/meta-ai/__init__.py(「Meta Model API(muse-image):相容於OpenAI(https://api.meta.ai/v1)」,模型包括muse-image-1.0)。Tavily:hermes_cli/config_defaults.py:2522-2525,原文為「用於AI原生網頁搜尋與擷取的Tavily API金鑰(選填 – 選用Tavily時,無金鑰亦可運作)」,工具為web_search與web_extract;web區塊註明Tavily「可透過hermes tools主動選用無金鑰模式,不屬於輪替群組」。受管理的llama.cpp執行環境:hermes_cli/local_runtime/套件(「受管理的llama.cpp執行環境」)、config_defaults.py:2327的設定區塊(「官方二進位檔,單一受監督的」伺服器;文件指向user-guide/local-models),以及桌面端介面apps/desktop/src/api/local-models.ts。外部程序供應商:agent/auxiliary_client.py:4740-4799(_resolve_external_process_branch,「PROVIDER_REGISTRY中的external_process供應商,透過其已註冊的profile提供服務」,以已註冊的profile為索引鍵,讓「原始碼樹之外的ACP供應商」也能完成解析)。目錄更新頻率:hermes_cli/config_migrations.py:622-627中的設定遷移39 -> 40(「model_catalog.ttl_hours -> ttl_minutes(預設20)」,使用者訊息為「模型目錄現在每20分鐘重新整理一次(model_catalog.ttl_minutes)」),而hermes_cli/model_catalog.py「僅在ttl_minutes仍為預設值時」採用舊版ttl_hours。 ↩↩↩ -
標籤
v2026.9.7的桌面版更新。留言模式:該標籤中的website/docs/user-guide/desktop.md,核心原文為:「在預覽瀏覽器列中按一下註記,接著在即時頁面上按一下任意元素(或拖曳框選),再輸入備註;每則儲存的留言都會以編號標記留在頁面上」;「儲存標記絕不會送出對話回合」;「新增 N 則留言會將每個標記的裁切螢幕擷取畫面,以及逐一指出各則留言的簡短提示,附加至訊息編輯區」;「每則元素留言都帶有其CSS選擇器、標記內容,以及影響版面配置的計算樣式,讓代理能在原始碼中找到該元素,無須憑圖片猜測」;「在標記內容離開頁面之前,系統會先在頁面上遮蔽密碼與隱藏欄位的值,以及任何疑似金鑰或權杖的屬性」;「較大批次的留言會依所在頁面區域分組,因此20多則留言會整併為幾項工作,而非每則各成一項任務」;「由於各組屬於不同的 DOM 子樹,通常會涉及不同檔案,因此能安全地交由平行工作代理處理」。此期間的提交:10f2a20966「feat(desktop):在應用程式內建瀏覽器中新增留言模式」;e4bda3ff77「feat(desktop):瀏覽器留言附帶元素的選擇器、標記內容與樣式」;工作階段控制項8cb2bcc8c1「提供結構化工作階段控制項」+bfddf556bf「載入結構化工作階段控制項的狀態」+dffd8d62c2「新增工作階段自動化控制項」;6b1e12c7f4「支援從『新增工作階段』、專案+控制項,以及 profile 群組拖曳建立工作階段」;9186e3ebc5「用於匯入其他程式設計代理對話紀錄的工作階段匯入檢視」;a1c25d393a「在『功能 → Skills』中內建可選 skill 目錄,支援一鍵安裝」;俄文語系a922dad9d8「feat(desktop):新增俄文(ru)語系」+269e5bde33(在語系測試與文件中註冊ru;apps/desktop/src/i18n/ru.ts為此期間新增,而CLI的locales/仍維持17份目錄)。display.resume_last_session:hermes_cli/config_defaults.py:777,預設值為True,註解原文為「桌面版冷啟動時會重新開啟上次的聊天/頁面(也可在『設定 → 外觀』中設定)。」使用真實 profile 的同意提示:apps/desktop/src/app/chat/right-rail/real-profile-consent-dialog.tsx(「首次開啟時顯示的真實 profile 瀏覽同意提示」,當browser.use_real_profile關閉且開啟瀏覽器窗格時顯示;接受後會寫入與『功能』切換開關相同的設定鍵;『暫時不要』會在本次應用程式執行期間停用提示,『不要再顯示』則會在後續啟動時持續生效)。 ↩↩ -
Hermes Agent v0.21.2 版本說明,「state.db 修補版本」,標籤
v2026.9.11,標示發布日期為9月11日,發布時間為2026-09-11T19:20Z。原文說明:「v0.21.0 大幅改寫了工作階段儲存區的連線處理方式,卻讓部分安裝環境中的state.db變得脆弱:多個寫入者互相取消對方的鎖定、正常的資料庫被回報為損毀,以及單一損壞資料列導致sessions list整體失敗。」在提交04dd80a977時統計:「947次非合併提交」、「1,869個檔案變更」、「312個已合併 PR」、「140位貢獻者」(本機複本檢查:git rev-list --count --no-merges v2026.9.7..v2026.9.11=959——內文數字是發布前的快照,與 v0.21.1 的情況相同)。專案標題原文為:「state.db 可靠性改善計畫(6個 PR,關閉44個議題)」(PR #108076、#108082、#108130、#108086、#108074、#108067);更新指引原文為:「先執行hermes doctor;它現在能正確區分結構損毀與索引損毀,並在重建不足以解決問題時,指向hermes sessions recover --inspect-only(固定使用指定的 profile)。」該標籤的原始碼驗證:gateway/hosted_rooms.py:398-426將託管房間狀態移出根儲存區——default_db_path會將 profile gateway 的路徑解析為「共用的 ROOTshared-state.db,而非主資料庫state.db」,其文件字串指出,在6個 gateway 組成的環境中反覆觀察到的多寫入者損毀途徑(2026-09-03),正是 profile gateway 絕不可用可寫入模式開啟主工作階段儲存區的原因。hermes sessions recover的剖析器位於hermes_cli/subcommands/sessions.py:185-196,其中--inspect-only的說明原文為「僅回報標準資料表是否可讀取;不要建立輸出資料庫」;此子命令早於本次期間便已存在(v2026.8.31的hermes_cli/main.py已有),但先前未記載於本指南。憑證保管庫:agent/vault_backends/__init__.py的文件字串(「瀏覽器憑證保管庫的登入後端」;控制代碼依後端劃分命名空間,因此瀏覽器工具無須變更結構描述即可進行路由;外部管理工具會保持鎖定,直到個別工作階段解鎖;主密碼「絕不作為工具引數、絕不出現在 argv 中、絕不持久儲存」)、agent/vault_backends/base.py(LoginBackend「列出登入中繼資料(絕不包含機密),並在填入時取得單一密碼」),以及agent/vault_store.py:74-105(驗證器金鑰僅接受 base32 種子或otpauth://totpURI,拒絕以計數器為基礎的 HOTP,驗證碼由totp_now產生);該標籤中均已存在後端local.py、onepassword.py、bitwarden.py,以及agent/secret_sources/{onepassword,bitwarden,command}.py。hermes_cli/subcommands/plugins.py中的外掛目錄子剖析器:install說明為「從精選目錄、Git URL 或 owner/repo 安裝外掛」,search為「搜尋精選 Hermes 外掛目錄」,browse為「列出精選外掛目錄中的所有項目」,pack為「宣告式、可分享的外掛組合(hermes-pack.yaml)」,提供install/export/show。訪客初始設定位於apps/desktop/electron/guest-onboarding-flag.test.ts:測試標題原文為「guestOnboardingEnabled:只有環境變數值恰為『1』或 argv 中含有 –guest-onboarding,才會啟用免費方案」;測試套件斷言'true'、'0'與空值均不會啟用,且desktopBackendSpawnEnv「最後才寫入啟動決策,絕不讓繼承的值滲入」。多 profile 強化議題群組 #107609-#107630,詳見版本說明所列內容。本次工作階段的驗證日期為2026年9月15日。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩ -
Hermes Agent v0.21.3 版本說明,標籤
v2026.9.14,標示發布日期為9月14日,發布時間為2026-09-14T16:04Z。目的原文為:此標籤「是為了讓下列遠端 gateway 登入修正能送達 Cloud 代理,這些代理會自動更新至最新版本標籤」。在提交9b419a2d3c時統計:「1,036次非合併提交」、「2,642個檔案變更」、「338個已合併 PR」(本機複本檢查:git rev-list --count --no-merges v2026.9.11..v2026.9.14=1,037,差異同樣來自發布提交)。兩項已記載的變更均已在本機複本中驗證,且僅出現於此期間:提交5dea46d13d「fix(dashboard-auth):讓 Cookie 閘門與原生路由共用單一進行中的更新作業,並移出事件迴圈」(#110061,修正 #55712;搭配 Portal 端 hermes-portal#1209,採用隨活動順延的30天閒置期限,並為輪替後的權杖提供5分鐘寬限期),以及提交939a2f64b4「fix:長時間執行的程序不再重複建立 state.db 寫入者控制代碼」(#110934,修正 #100896 與 #103339)。延後說明的原文為:「此期間完整整理的版本說明將隨 v0.22.0 一同發布,屆時會記載自 v0.21.0 起的所有變更」,以及「此期間的變更一項也不會遺漏」;該版本刻意暫不記載的項目包括伺服器對用戶端的JSON-RPC 請求與 Pydantic 傳輸契約登錄表、每個模型選擇器中的推理強度選項、OpenRouter OAuth PKCE、HEIF/HEIC/AVIF 解碼、Honcho 對等模型重構、FAL 目錄新增項目(Wan 3.0、Kling 3.0/Kling Image v3、MiniMax H3 Max Turbo、Gemini Omni Flash 1.1、Meta Muse)、Slack 貼上表格與 Agent Sessions API、多工 profile 隔離與 gateway 存活狀態修正,以及在跨虛擬機檔案系統上拒絕使用 state.db WAL——依版本說明本身的安排,全部留待 v0.22.0 檢視。本次工作階段的驗證日期為2026年9月15日。 ↩↩↩ -
Hermes Agent v0.21.4版本說明,標籤
v2026.9.21,標示的發布日期為9月21日,發布時間為2026-09-21T18:10:55Z。用途原文譯文:「修補版本。此標籤將自v0.21.3以來合併的約1,800個PR彙整為穩定的標籤版本,供下游使用者使用(Docker映像檔、Hermes Cloud、託管部署)。此期間完整且經整理的說明延至v0.22.0提供。」以提交4b8a8134009a為基準的統計:「5,071個非合併提交」,涉及「5,169個變更檔案」(+312,961 / -62,855)、「1,812個已合併PR」及「2,116個已關閉議題」——在本機複製的儲存庫中檢查,這5項數值皆完全吻合(git rev-list --count --no-merges v2026.9.14..4b8a8134= 5,071;git diff --shortstat= 5,169個檔案,+312,961 / -62,855;標籤提交d337b736aa「chore(release): v0.21.4 (v2026.9.21)」是4b8a8134的子提交,因此非合併提交為5,072個,計入合併提交後共5,173個,而GitHub的比較API針對v2026.9.14...v2026.9.21回報total_commits: 5173, ahead_by: 5173, behind_by: 0)。期間排名(9月23日為指南v1.21重新檢查):依所有相鄰v2026.*標籤之間的非合併提交數計算,v2026.8.31..v2026.9.7以5,140個(含版本發布提交)居首,v2026.9.14..v2026.9.21以5,072個居次,領先v2026.7.20..v2026.7.30的2,790個;依版本說明所列的已合併PR數計算,1,812個是所有單一期間彙整說明中的最高紀錄(v0.21.1為「632個已合併PR」,v0.19.1為「約1,000多個PR」;v0.21.0的「約2,475個」涵蓋自v0.20.0以來的6個v0.20.x標籤,因此並非單一標籤到下一個標籤的期間)。延後說明原文譯文:「此期間完整且經整理的版本說明將隨v0.22.0發布,記錄自v0.21.0起的所有變更」,以及「此期間的任何內容都不會遺漏」。刻意暫未記錄的項目清單包括:gateway單一執行個體鎖與會合紀錄,讓Desktop連接至執行中的主機後端;由後端管理的連接器操作及其Desktop/TUI/CLI設定卡片;--format stream-json;skills.auto_load;Desktop聊天/介面字型選擇器、一鍵更新本機引擎及Plugins中心的解除安裝功能;針對未授權私訊的decline行為;mcp.discovery_concurrency;session_search的after/before範圍限制,以及改用OR放寬條件的召回重試;hermes sessions set-journal-mode;影片目錄中的LTX 2.5與Kling O3;目錄網站上各外掛/作者的頁面,提供固定提交版本的README,並可依新增/更新時間排序;「目錄中十多個新的社群外掛(tailscale、ssh、shodan、terminal、rss、resetwatch、done-bell、kiwi、cognee、Octen)」(版本說明採用簡稱;該標籤中的目錄項目為hermes-tailscale、hermes-ssh、shodan、hermes-terminal、hermes-rss、hermes-resetwatch、done-bell、kiwi、cognee、web-octen);以及「大量針對profile/多工隔離、cron、看板、Desktop與state.db的修正」。更新方式:hermes update(透過git安裝者),或使用單行安裝指令;「Docker / Hermes Cloud:映像檔由此標籤建置(nousresearch/hermes-agent:v2026.9.21)」。本次工作階段驗證日期:2026年9月22日。 ↩↩↩↩↩↩ -
v0.21.4 公布的項目已對照標籤
v2026.9.21的原始碼驗證(指南 v1.20,2026年9月22日;操作規則補充於指南 v1.21,9月23日)。主機單一實例:gateway/host_rendezvous.py的文件字串——「主機範圍的單一實例協調:每位作業系統使用者的每個 ROLE 各有一個鎖定與一筆記錄」;「每台主機恰好只有一個hermes serve和一個hermes gateway run,各自以多工方式處理所有 profile」;主機 flock/msvcrt鎖定「在成功取得鎖定的程序整個生命週期內持續持有」,並搭配協調記錄,讓第二次啟動能「證明這是同一個仍在執行的程序,並採取 ATTACH,而非繫結第二個連接埠」;透過(pid, createTime)「證明記錄已失效,絕不逕自假定」(「附加的用戶端絕不可連線至已回收 PID 的連接埠」);鎖定根目錄為$HERMES_GATEWAY_LOCK_DIR,否則使用$XDG_STATE_HOME/hermes/gateway-locks,範圍限定於該作業系統使用者(gateway/status.py:308-324:若XDG_STATE_HOME為相對路徑,則予以忽略,改用~/.local/state)。操作流程:gateway/run.py:5466-5499的_host_attach_or_none在ATTACH時印出附加訊息並以結束碼 0 結束,在REFUSE時拒絕,在REPLACE_HOST時將--replace傳給「HOST 程序,無論它是由哪個 home 啟動」,並在使用--force時略過詢問(「當擁有者卡住或回報不實時,供操作者脫困的手段」);_claim_host_gateway_role(gateway/run.py:5331-5346)讓鎖定競爭的落敗者以EX_TEMPFAIL(75)結束,因為「我們產生的每個程序監督器都會在結束碼為 75 時重試,而重試時擁有者的記錄已存在」。gateway/host_attach.py中的五種結果:ATTACH、RESCAN->ATTACH(控制通訊端的rescan-profiles)、REPLACE_HOST、REFUSE(「絕不在未告知的情況下啟動第二個實例」)、START(各 profile 的獨立 gateway 可共存,「直到強制進行該項遷移(#109417)」)。Desktop 端:apps/desktop/electron/host-backend-attach.ts(「附加至主機上執行中的 Hermes 後端(僅限多工,Desktop 端)」;IO 階梯流程讀取機器根目錄的啟動紀錄簿,依序透過「HTTP 就緒狀態 -> 所提供的工作階段權杖 -> WebSocket 驗證」驗證候選實例,並持有「主機層級的閘鎖,讓兩個應用程式同時啟動時只產生一個後端,而非兩個」;HOST_SPAWN_GATE_STALE_MS = 60_000)。連接器操作:tools/connectors/operation.py:1原文意為「每次manage_connections呼叫對應一個由後端持有的連線操作。純資料,無 I/O。」;OPERATION_DEADLINE_SECONDS = 300.0,註解為「這不是設定鍵:允許使用者調整等待時間,即使設有上下限,仍容易造成誤用(PR1 曾提供此設計,未合併)」;工具註冊名稱為manage_connections(tools/connectors/tool.py:16,48,113);每個目標的required_env為「({name, prompt, required});卡片為每個項目繪製一個欄位,並在所有必填欄位都有文字前暫緩執行其動作」;tests/hermes_cli/test_mcp_catalog_env_boundary.py:330提及涵蓋三種前端的卡片(「連接器卡片後端(Desktop/TUI/CLI 設定卡片)採用相同的分離方式,僅將機密資料分開處理」)。stream-json:聊天剖析器中的hermes_cli/_parser.py:247-249——--format可選text/stream-json,預設為text,說明原文意為「’stream-json’ 輸出以換行分隔的 JSON 事件(JSONL),隱含啟用 –quiet,且不可與 –tui 合併使用」;hermes_cli/stream_json.py的模組文件字串為「stdout 每行一個 JSON 物件……system/init->text增量 /tool_use/tool_result-> 一個最終result封裝(結束碼、最終文字、權杖統計)。診斷資訊與session_id保留在 stderr」,_TOOL_OUTPUT_CAP = 5000,遇到禁止的組合時以結束碼 2 結束,hermes_cli/stream_json.py:23的stream_json_requested接受query或query_file,兩者皆無才以結束碼 2 結束(cli.py:1703-1705的 Fire 進入點檢查已解析的查詢);hermes_cli/_parser.py:218-222的--query-file PATH與-q同屬互斥群組(說明原文意為「從檔案讀取單一查詢,而非從命令列讀取(’-’ 代表讀取 stdin)。可安全處理任意文字:不會由 shell 解譯任何內容」),由_read_query_file(hermes_cli/main.py:1735-1762)讀取,自標籤v2026.8.19起即已存在;契約測試位於tests/hermes_cli/test_stream_json.py(包括「在 stream-json 模式下絕不可進入 stdout」)。skills.auto_load:hermes_cli/config_defaults.py:1435,預設為[],註解原文意為「固定在每個新工作階段中完整載入的 skill 名稱(CLI、TUI、gateway、cron、API)。在首次建構代理的提示詞時解析一次;名稱不存在或已停用時,發出警告並略過;HERMES_IGNORE_RULES 會抑制此清單,如同其他自動注入的上下文。」decline:gateway/config.py:137-139——註解原文意為「’pair’ 以私訊傳送配對碼,’ignore’ 不作回應直接捨棄,’decline’ 傳送一次禮貌拒絕後,在 gateway.pairing.DECLINE_DEDUPE_SECONDS 期間不再回應該傳送者(#88028)」,UNAUTHORIZED_DM_BEHAVIORS = {"pair", "ignore", "decline"},欄位預設為"pair"(:626),unauthorized_dm_decline_message為空 ->DEFAULT_UNAUTHORIZED_DM_DECLINE_MESSAGE(配對一節所引述的回覆);DECLINE_DEDUPE_SECONDS = 24 * 3600,以及gateway/pairing.py:37,565-576中可辨識別名的拒絕時間戳記;各平台的解析方式與 Email 預設值見get_unauthorized_dm_behavior(gateway/config.py:803-809,「Email 採收件匣模式,因此預設為"ignore",除非它自己的unauthorized_dm_behavior明確啟用其他行為(全域預設值不算)」)。此鍵本身、pair/ignore及 Email 規則均早於此期間(已存在於v2026.9.14,gateway/config.py:564,736-742;由 #1919 於2026年3月引入);只有decline是新增項目。實際生效的預設值:gateway/authz_mixin.py:699-740的_get_unauthorized_dm_behavior,其文件字串列出的順序為「明確指定的各平台設定;Email -> “ignore”;明確指定且非預設的全域值;介接器 dm_policy(pairing -> “pair”,allowlist/disabled -> “ignore”);任何已設定的允許清單 -> “ignore”……;否則為 “pair”」(#9337),僅在全域值!= "pair"時才採用。YAML 結構:platforms.<name>下的各平台鍵會提升至PlatformConfig.extra(gateway/config.py:456-460,#10206),頂層鍵或巢狀的gateway.unauthorized_dm_behavior由gateway/config_loader.py:39-46,102銜接,而hermes gateway setup透過write_platform_config_field寫入platforms.<name>.unauthorized_dm_behavior(hermes_cli/config.py:2061-2069;hermes_cli/gateway_setup_wizard.py:182-184,219-249,選項為「禮貌拒絕不明傳送者(傳送一次訊息後不再回應)」)。拒絕訊息僅能以全域方式設定(gateway/run_inbound.py:139)。discovery_concurrency:hermes_cli/config_defaults.py:526預設為 4;tools/mcp_tool_discovery.py:27-40(「mcp.discovery_concurrency可覆寫此值,0 = 無限制(#117373)」;若值不是整數或為負數,則記錄「不是非負整數;使用 %d」並採用預設值);tests/tools/test_mcp_tool.py:2813明確驗證這是同時連線數的上限,而非阻擋連線的閘門(「限制同時連線數(仍為並行,每個伺服器」都會連線)。session_search 界限與重試:tools/session_search_tool.py:578,621-635,708-725——after為「工作階段開始時間的下限,包含該時間。ISO 日期/日期時間(例如 2026-06-01)或相對期間(7d、24h、2w = 最近 N 個時間單位內)」,before為「工作階段開始時間的上限,不含該時間。ISO 日期/日期時間(僅有日期的值代表該日 UTC 午夜)或相對期間(7d = 早於一週前)」,兩者皆「僅適用於探索形式」,且「sort 是排名偏好,並非界限」,新參數「附加於detail之後」以維持結構綱要穩定;hermes_state_search.py:1151-1163中放寬為 OR 的重試,註解原文意為:「詞彙之間隱含的 AND,會讓改寫措辭後的多詞查詢漏掉已儲存的句子,即使該句子只缺少一個詞也一樣……當精確查詢與子字串備援皆未命中時,重試 unicode61 索引,匹配任一詞彙。……僅在零結果時啟用,使已有命中結果的查詢維持精確匹配語意;明確使用 OR/NOT、單詞及採 CJK 路徑處理的查詢不受影響」;專用測試套件為tests/hermes_state/test_search_or_relaxed_fallback.py。set-journal-mode:剖析器位於hermes_cli/subcommands/sessions.py:177,說明原文意為「離線將 state.db 在 journal_mode=WAL 與 DELETE 之間轉換(所有持有者均已停止)」;hermes_cli/sessions_cmd_journal_mode.py的文件字串——針對 #100896 提供的離線自助處理途徑(在此之前,「唯一的脫困方式是手動執行未記載於文件中的PRAGMA journal_mode=DELETE」),「只要任何其他程序仍持有該檔案或附屬檔案,就拒絕執行(foreign_state_db_holders);切換時不等待已開啟檔案的程序釋放檔案(_set_journal_mode_no_wait),接著驗證 SQLite 為該模式寫入的標頭位元組 18/19」;分派處標記為「離線:不可開啟正在轉換的儲存區」(hermes_cli/sessions_cmd.py:982);hermes doctor對非預設儲存區建議搭配--db使用(hermes_cli/doctor_platform.py:148,163)。剖析器描述原文意為「請在 gateway、dashboard 與所有 CLI 停止後執行:只要任何程序仍持有檔案,就會拒絕執行;確認後切換模式,並驗證檔案標頭」;--force說明為「僅限 Windows:自行停止所有 Hermes 程序後,略過持有者掃描(該平台沒有此功能)並繼續」(hermes_cli/subcommands/sessions.py:176-189),由_refusal強制執行(sessions_cmd_journal_mode.py:40-44:「無法在 Windows 上證明資料庫未被使用——沒有持有者掃描功能」)。Desktop 這波更新:字型欄位位於apps/desktop/src/app/settings/chat-font-setting.tsx(CONFIG_PATH = 'desktop.font_family',550 毫秒自動儲存),搭配themes/chat-font.ts(建議字型為 OpenDyslexic、Atkinson Hyperlegible、Lexend、Inter、IBM Plex Sans、Source Sans 3、Noto Sans、Segoe UI、SF Pro Text;空值代表使用佈景主題字型),透過themes/context.tsx:279套用,覆寫佈景主題權杖--dt-font-sans;引擎更新位於apps/desktop/src/app/settings/local-models-settings.tsx與對應測試(受管理的本機執行環境回報update_available時,顯示「更新引擎」按鈕,以回報進度的runtime-install工作驅動installLocalRuntime;測試「讓明確觸發但失敗的更新持續顯示,提供直接重試,且不暫存任何模型」);外掛中心的解除安裝功能位於apps/desktop/src/app/capabilities/plugins/plugins-tab.tsx與對應測試(「僅在確認對話方塊獲得同意後,才透過 plugins.manage remove 解除安裝」;獨立桌面外掛透過 Electron 載入器上的uninstallDiskPlugin解除安裝)。影片目錄:plugins/video_gen/fal/__init__.py:43-44,99-101——ltx-2.5(「LTX 2.5」、「Lightricks 開源影音模型。原生音訊,最長 20 秒/最高 4K(i2v),鏡頭運動預設。」,低價級距,lightricks/ltx-2.5/text-to-video/fast與/image-to-video/fast,長寬比 16:9/9:16,整數時長;:128「fal 不接受 LTX 2.5 在 1440p/2160p 下超過 10 秒的影片」)及kling-o3(「Kling O3(標準版)」、「快手前沿模型。原生多鏡頭敘事、可選音訊、3–15 秒。」,高價級距,時長為字串形式的 3–15,i2v 從圖片推導長寬比,generate_audio為實際生效的開關);承載資料測試位於tests/plugins/video_gen/test_fal_plugin.py:641,681;清單列位於website/docs/reference/toolsets-reference.md:72。目錄擴充:v2026.9.14的plugin-catalog/= 9 個項目 +removed.yaml,v2026.9.21= 228 個項目 +removed.yaml;項目結構見plugin-catalog/hermes-tailscale.yaml(名稱、儲存庫、40 位十六進位sha、描述、維護者、tier: community、類別、docs_url、能力);收錄與發布模式見hermes_cli/plugin_catalog.py:4-10,33(「固定於精確的 40 字元提交 SHA。存在於目錄中即代表」獲准收錄;website/scripts/extract-plugins.py發布/docs/api/plugin-catalog.json;擷取LIVE_CATALOG_URL並快取至~/.hermes/cache/plugin-catalog.json);網站頁面見website/plugins/plugin-catalog-pages/index.js(「/docs/plugins/ 每個項目各一頁」、「/docs/plugins/by/ 每位維護者各一頁」、「只有合併目錄 PR,頁面才會出現、變更或消失」,且網站「只會降級,絕不失效」)及readme.js(每個項目的 README 皆透過指向該 sha 的原始檔 URL,「從固定的提交」轉譯,「絕不使用分支最新版本」,因此頁面顯示的 README 與目錄審查者閱讀的內容完全相同;建置時採允許清單轉譯,移除原始 HTML,上限為 512 KB,主機僅限 raw.githubusercontent.com 與 gitlab.com;可用readme: false停用);作者短網址代稱與依提交者日期產生的新增/更新時間戳記見website/scripts/extract-plugins.py:80,142;發行說明中點名的全部 10 個社群外掛,在該標籤下皆有對應項目,短網址代稱如 50 所列。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩ -
Hermes Agent v0.21.5版本說明,標籤
v2026.9.24,標示的發布日期為9月24日,實際發布時間為2026-09-24T10:09:38Z。用途原文譯文:「修補版本。此標籤將v0.21.4以來合併的約460個PR彙整為穩定的標籤版本,供下游使用者使用(Docker映像檔、Hermes Cloud、託管部署)。這段期間的完整整理說明延至v0.22.0提供。」在標籤所指的提交f97608f178(「chore: 發布v0.21.5(2026.9.24)」)測得的統計資料:「1,610個非合併提交」,涵蓋「4,828個變更檔案」(+164,132 / -149,440)、「460個已合併PR」及「475個已關閉議題」。本機複製儲存庫的檢查結果完全重現提交數與差異統計(git rev-list --count --no-merges v2026.9.21..v2026.9.24= 1,610;含合併提交則為1,638;git diff --shortstat= 4,828個檔案,+164,132 / -149,440);PR與議題數未經獨立查核。內文刻意不詳述的項目清單列出Nous與OpenRouter目錄中的GPT-6「Sol/Terra/Luna」及Claude Opus 5.5、透過gateway.standalone個別停止/啟動/重新啟動profile,以及一波Desktop外掛SDK更新;未提及Hindsight。更新方式原文譯文:「hermes update(透過git安裝),或重新執行單行安裝指令」,以及「映像檔由此標籤建置(nousresearch/hermes-agent:v2026.9.24)」。 ↩↩↩ -
已在標籤
v2026.9.24的原始碼中驗證的v0.21.5項目(指南v1.22,2026年9月24日)。Hindsight:提交4cbf862abe「chore(memory): 移除隨附的hindsight提供者(已移至外掛目錄)」(9月22日)是此標籤的祖先提交;該標籤的plugins/memory/包含7個提供者目錄(byterover、holographic、honcho、mem0、openviking、retaindb、supermemory),而v2026.9.21有8個;提交73c598e319「build: 移除hermes-agent[hindsight]選用相依套件組」將其從pyproject.toml移除。plugin-catalog/hindsight.yaml:repo: https://github.com/vectorize-io/hindsight、maintainer: vectorize-io、tier: community、requires_hermes: ">=0.21.4"。遷移:hermes_cli/memory_provider_migration.py的文件字串(第1-14行)列出2個掛鉤:「hermes update」與「代理程式初始化」;第75行輸出「記憶提供者’{name}’已移出核心——已從目錄安裝其外掛」;recover_at_startup()(第110行)「遵循security.allow_lazy_installs設定」;此函式由hermes_cli/update_cmd_deps.py:535-536及agent/agent_init.py:1315-1316呼叫。磁碟上的變更與驗證指令:memory-providers.md:482-490。多工處理:hermes_cli/gateway_multiplex_mode.py第10行,「明確設定為false的用法已停用」,以及第43-44行,「gateway.multiplex_profiles: false已停用,並已改寫為true」(提交b936546561,9月23日)。gateway.standalone:hermes_cli/profiles.py:979-982,「預設profile絕不會獨立執行——它本身就是主機——若在其中設定此鍵,每個處理程序會發出一次警告」(提交0238c9d740)。暫停:提交4c342c05de「在主機多工器下停止、啟動及重新啟動單一profile」;multi-profile-gateways.md:120-138, 233-244(「暫時性的相容層」;「gateway.standalone優先」)。模型:hermes_cli/models_catalog_static.py的OPENROUTER_MODELS第32行與第36-37行(anthropic/claude-opus-5.5、openai/gpt-6-sol、-sol-pro、gpt-6-luna、-luna-pro);第162行的nous清單由此衍生。該標籤的選擇器目錄中未出現gpt-6-terra模型ID,因此此處僅列出Sol與Luna。提供者:第314行的CANONICAL_PROVIDERS解析後共有39個項目(以AST計數,未變更);plugins/model-providers/在v2026.9.21與v2026.9.24均有38個目錄,v2026.9.14則有39個。提交998f614c7f「feat(providers): 移除無需金鑰的opencode-free方案」(9月18日)刪除了該外掛;提交訊息寫道:「OpenCode的免費方案現在會對OpenCode用戶端以外的匿名流量回傳HTTP 403」。hermes_cli/auth.py:1255-1259仍保留針對opencode-free、free與opencode_free的錯誤訊息,引導使用者改用opencode-zen與opencode-go。相容性:COMPAT_MANIFEST.md、compat_manifest.json與hermes_cli/plugin_compat.py均存在於該標籤及main的aa8a33d22d提交(9月24日)。git diff v2026.9.21 v2026.9.24 -- hermes_cli/plugin_compat.py的輸出為空(COMPAT_REMOVAL_DATE位於第32行;「僅接受布林字面值」檢查位於第296-303行)。這2個資訊清單僅移除了已刪除的plugins.memory.hindsight項目(-7 / -12行)。 ↩↩↩↩↩↩↩↩ -
Hermes Agent v0.21.6版本說明,標籤
v0.21.6(首個未採用v2026.M.D格式的版本標籤),標示的發布日期為10月8日,實際發布時間為2026-10-08T11:51:57Z。用途原文譯文:「修補版本。此標籤將v0.21.5以來合併的約2,100個PR彙整為穩定的標籤版本,供Docker與Hermes Cloud使用。這段期間的完整整理說明將隨v0.22.0提供。」流程原文譯文:「這是首個透過全新穩定版本發布流程產出的版本:每次嘗試使用一個參照、一個經過測試的Docker映像檔,並在發布時建立回執標籤。此流程會發布標籤、這份GitHub版本及Docker映像檔。桌面應用程式、Termux套件與Microsoft Store目前仍維持現有組建,將隨下一個整合版本更新。」統計資料「於提交818c13be測得」:「8,867個非合併提交」,涵蓋「8,342個變更檔案」(+772,490 / -225,600)、「2,106個已合併PR」及「3,027個已關閉議題」;GitHub的v2026.9.24...v0.21.6比較結果顯示,包含合併提交在內共9,180個提交(此次未在本機重現差異統計)。刻意不詳述的項目清單原文譯文列出:「在CLI、TUI與Desktop中說話時即時轉錄(stt.streaming)」、「將語音對話回合路由至專用模型(auxiliary.voice_chat),預設關閉推理」、「第三方外掛在各profile專屬的外掛宿主中執行(plugins.isolation: host)」、「優先顯示摘要的hermes status(--short、--full)」、「涵蓋核心、Desktop與TUI的可插拔分層語言套件」、「hermes model中的本機模型,以及Linux x64與arm64上的llama.cpp CUDA」、「憑證上傳與終端機指令中不可見Unicode字元的核准旗標」、「會檢查機器人權杖並輸出邀請連結的Discord設定流程」、「統一的看板工作流程定義」、「activate.fish」、「目錄中的GPT-6.1 Sol與Claude Sonnet 5.5 / Haiku 5.5」,以及「最新消息」章節引述的Desktop項目。安全性章節部分原文譯文:「感謝Tenable Research通報全部4個問題(TRA-725、TRA-726、TRA-727、TRA-728)」;「自動執行的git呼叫(工作階段工作區快照、子代理程式工作樹、看板、工作樹清理、hermes -w)可能在首次提示之前,執行不受信任儲存庫自身設定所定義的clean/smudge/process篩選程式(#130661)」;「From標頭中以引號括住的顯示名稱……可能讓攻擊者的郵件通過電子郵件允許清單檢查,被視為允許的寄件者(#125212)」。更新方式原文譯文:「Docker / Hermes Cloud:nousresearch/hermes-agent:stable(或:latest)。CLI(透過git安裝):hermes update,或重新執行單行安裝指令。」 ↩↩↩↩↩↩ -
v0.21.6項目已於標籤
v0.21.6的原始碼中驗證(提交818c13be;指南v1.24,2026年10月11日)。STT:hermes_cli/config_defaults.py預設設定stt.streaming: False(「說話時即時顯示部分文字(openai/xai/elevenlabs);失敗時改走檔案路徑」)及streaming_model: "gpt-live-transcribe"(「唯一能在語句尚未結束時傳回增量內容的模型」)。語音路由:auxiliary.voice_chat預設使用120秒的時段,並設定"reasoning_effort": "none";agent/voice_turn_route.py的文件字串寫道:「語音回合(CLI語音輸入、Desktop/TUI語音對話、通訊平台語音訊息)可使用比工作階段主要模型更快的模型……若回合開始時,請求超過語音模型的壓縮門檻,該回合便改由主要模型執行」。隔離:hermes_cli/plugin_isolation.py(「in_process(預設)會將所有外掛程式匯入Hermes處理程序……host則將第三方外掛程式碼隔離於該處理程序之外:一般外掛程式會載入各profile專屬的外掛程式宿主處理程序……且僅透過ctx與Hermes通訊……隨附的外掛程式與Hermes一同發行,仍在同一處理程序內執行」);config_defaults.py預設設定plugins.isolation: "in_process"。記憶:plugins/memory/包含byterover、holographic及retaindb(v2026.9.24時有7個目錄);plugin-catalog/honcho.yaml(plastic-labs)、mem0.yaml(mem0ai)、openviking.yaml(volcengine)及supermemory.yaml(supermemoryai)均為tier: community;hermes_cli/memory_provider_migration.py將_LEFT_CORE設定為全部8個名稱(「曾隨核心一同發行的供應商。無人值守時的同意範圍僅涵蓋這些供應商」)。相容性:hermes_cli/plugin_compat.py的文件字串寫道:「該層,以及回報哪些外掛程式仍在使用該層的掃描器,皆已移除」;compat_report()傳回{};整個原始碼樹中均未出現allow_deprecated_imports;COMPAT_MANIFEST.md及compat_manifest.json也不存在。狀態:hermes_cli/subcommands/status.py定義了--full/--all(「顯示所有區段(金鑰已遮蔽),取代單一畫面的摘要」)及--deep(「隱含啟用–full」),沒有--short。語言:hermes_cli/config_language.py(「接受的語言集合為agent.i18n.supported_languages():隨附的翻譯目錄、profile的覆寫目錄,以及所有已載入的外掛程式語言套件」);locales/包含17個<lang>.yaml及16個<lang>.tui.yaml檔案。供應商:plugins/model-providers/包含41個目錄(v2026.9.24時有38個;新增了lmstudio、solstice、tencent-tokenhub);hermes_cli/models_catalog_static.py中的CANONICAL_PROVIDERS在這兩個標籤中皆有39列;其OPENROUTER_MODELS清單新增了anthropic/claude-sonnet-5.5、anthropic/claude-haiku-5.5、openai/gpt-6.1-sol及openai/gpt-6.1-sol-pro,這些項目均未出現在v2026.9.24中。核准:tools/approval_detection.py的規則包括「透過curl/wget上傳機密或憑證檔案(可能造成資料外洩)」、「透過管線將憑證檔案傳入curl/wget上傳程序(可能造成資料外洩)」及「不可見或雙向Unicode控制字元(可能用於混淆)」。cron:cron/store_health.py(「cron儲存區無法寫入時的降級狀態(ENOSPC、EROFS、EACCES)……每個儲存目錄只保留1筆記憶體內紀錄……hermes cron status及hermes doctor也使用probe_store」)。Discord:plugins/platforms/discord/onboarding.py(invite_url()、INVITE_PERMISSION_BITS;「Message Content Intent未啟用(Discord會因此拒絕機器人的連線)」)。Git篩選器:tools/subagent_worktree.py(「簽出作業會執行儲存庫指定的smudge篩選器;若無法停用該篩選器,便略過隔離」)透過hermes_cli._subprocess_compat.noninteractive_repo_git_env處理,以及hermes_cli/worktree_ops.py(「若無法停用,便拒絕執行」)。電子郵件:plugins/platforms/email/adapter.py(「使用parseaddr,而非比對第一個<…>的正規表示式(GHSA-rxqh-5572-8m77);先還原RFC 5322的折行」)。儀表板驗證:hermes_cli/dashboard_auth/request_utils.py(「絕不在此解析用戶端提供的X-Forwarded-For」)。本機執行環境:hermes_cli/local_runtime/binaries.py將"cuda"對應至llamacpp-cuda;hermes_cli/models_local.py涵蓋Ollama、LM Studio及Ollama Cloud。activate.fish位於儲存庫根目錄(「./activate的fish對應版本」)。Kanban工作流程定義及Desktop項目尚未於原始碼中查核。 ↩↩↩↩↩↩↩↩↩↩↩↩ -
Hermes Agent v0.21.7版本說明,標籤
v0.21.7,標示的發布日期為10月11日,實際發布時間為2026-10-12T05:53:41Z;標籤對應的提交為71d34bad「fix(release):建置表格的轉譯程序可取得所需的R2憑證,且不會阻擋發布」(2026-10-12T03:17:10Z)。用途原文:「修補版本。此標籤將v0.21.6之後合併的約204個PR彙整為穩定版本,適用於桌面應用程式(macOS Apple silicon、Windows)、Microsoft Store及MSIX、安裝程式、Docker及Hermes Cloud。這段期間的完整整理版說明將隨v0.22.0發布。」統計資料「於提交1fd18277測量」:「740個非合併提交」,涉及「4,156個變更檔案」(+86,775 / -26,980)、「204個已合併PR」及「69個已關閉議題」;GitHub的v0.21.6...v0.21.7比較結果則顯示777個提交,包含合併提交。原始碼安裝項目原文:「從官方儲存庫進行的原始碼安裝,會更新至最新發布的vX.Y.Z版本,而非追蹤main上的每個提交。若已安裝的版本比最新發布版本更新,則維持目前版本並等待下一次發布;不會回退。若要繼續追蹤每個提交:hermes update --set-channel main。分支儲存庫與鏡像儲存庫仍持續追蹤main。Store、MSIX及隨附套件的桌面安裝方式維持不變。」;「設定▸關於▸更新針對原始碼安裝提供了更新通道切換選項(穩定版本/每個提交),更新對話方塊現在也會顯示目前使用的通道。」;「執行hermes chat --resume後,以及下一個gateway回合中,會重播已簽章的思考內容;Bedrock Converse推理模型也不再於恢復的工作階段中遭到拒絕。」;「追蹤main的安裝不再擷取可能遭區域防火牆以403回應的版本紀錄。穩定版本檢查會在已設定GitHub權杖時使用該權杖(GITHUB_TOKEN或gh auth login),並將GitHub的速率限制明確回報為速率限制。」刻意未納入文件的清單列出ctx.runAction、ctx.pet.say、「由核心發出Codex請求,讓外掛程式永遠不必持有權杖」、「在工作階段中途安裝的skill無須重建提示詞即可傳遞給模型」、「新付費訂閱者預設使用Krea 2 Medium Turbo產生影像,若代管的Krea拒絕請求,則改用FAL」、更快的桌面更新、「固定版本的安裝僅簽出指定版本」、「傳送至Relay的壓縮標記」,以及memory-shield、command-ledger、Memoria、Model Router、wyoming-voice-bridge、codex-account-switch及redline外掛程式。更新方式原文:「桌面應用程式:自行更新。Microsoft Store安裝透過Store更新。CLI:hermes update,或重新執行單行安裝指令。Docker/Hermes Cloud:nousresearch/hermes-agent:stable(或:latest)。」 ↩↩↩ -
v0.21.7項目已於標籤
v0.21.7的原始碼中驗證(提交71d34bad;指南v1.25,2026年10月13日)。更新管道:hermes_cli/subcommands/update.py定義了--set-channel CHANNEL(「永久儲存此安裝實例的更新管道(每個安裝實例分別記錄於config.yaml的update.installs下)……官方原始碼簽出預設使用『stable』(最新發布的vX.Y.Z版本,對應確切提交);『main』則追蹤原始碼分支」)、--channel CHANNEL(「僅在本次執行追蹤CHANNEL……『stable』與『canary』選擇已發布版本,『main』選擇分支最新提交。僅適用於從原始碼安裝的實例」)及--install-id;hermes_cli/update_channel.py(「一份config.yaml供多個安裝實例共用(主機、docker gateway及桌面版都以繫結掛載方式共用同一個~/.hermes),因此在家目錄層級共用的update.channel設定鍵並不安全,也不存在」;「未設定的官方簽出追蹤stable;分支專案與鏡像則維持main」;_tracks_official_origin:「分支專案、鏡像及本機路徑來源不會發布官方版本」);hermes_cli/source_releases.py(「解析已正式推出的原始碼版本,絕不僅憑Git標籤推斷是否已發布」;_head_containing:「未經使用者選定的預設行為,絕不能憑猜測將簽出版本往回移動,因此若關係不明(淺層歷史、無法存取GitHub),就保留HEAD」;來自「區域性WAF」的403回應「不得中止」檢查;「傳輸失敗會指出原因(速率限制不等於『沒有發布版本』)」;「權杖遭拒時,以匿名方式重試」;GITHUB_TOKEN與gh auth login的措辭沿用該版本原文)。桌面版:apps/desktop/src/app/settings/update-channel-row.tsx與apps/desktop/src/i18n/en_update_channel.ts(標題「更新管道」;「穩定版僅安裝已發布版本。每次提交模式會隨變更納入而追蹤main分支。」;選項為「穩定版本」與「每次提交」)。推理:agent/anthropic_thinking_policy.py(「思考區塊帶有上游會驗證之簽章的路由:會重播已簽署的區塊」);agent/anthropic_thinking_replay.py(「我們僅持久儲存遭拒之不透明簽章/資料值的指紋,然後從每份重建的請求副本中篩除這些區塊。這不僅是立即重試時的需求,因為後續的上下文選取與程序恢復,仍可能從標準歷史記錄重建請求」);agent/bedrock_adapter.py(「來自已持久儲存之reasoning_details的思考內容……Converse要求推理內容位於toolUse之前」;「Converse上依模型處理推理重播」)。記憶:plugins/memory/包含byterover與retaindb(v0.21.6時有3個目錄);plugin-catalog/holographic.yaml(repo: https://github.com/itpartypattaya/hermes-plugin-holographic、tier: community、requires_hermes: ">=0.21.5");hermes_cli/memory_provider_migration.py中的_LEFT_CORE仍列出全部8個名稱。目錄:plugin-catalog/包含552筆YAML項目(依據GitHub內容API,v0.21.6時為493筆)。此標籤下未變動的項目:41個供應商目錄、39個靜態列、17個核心與16個TUI語系目錄、hermes_cli/plugin_compat.py仍為22行的佔位實作,以及hermes status仍僅提供--full/--all與--deep。桌面版動作:apps/desktop/src/contrib/plugin.ts記載了ctx.runAction?.('view.showBrowser');Relay:agent/relay_compaction.py(「在所屬工作階段的範圍堆疊上,將hermes.compaction記錄輸出為NeMo Relay標記」)。未在原始碼中找到、採自版本說明的項目:ctx.pet.say、由核心發出的Codex請求、工作階段中途的skill、Krea預設值與FAL備援、固定版本安裝的簽出,以及更快速的桌面版更新。 ↩↩↩ -
Hermes Agent v0.22.0版本說明,標籤
v0.22.0,標示發布日期為2026年10月13日,實際發布時間為2026-10-14T03:21:46Z;標籤提交為e06df9c2「fix(desktop-e2e):核心初始設定規格涵蓋不使用試用方案的供應商設定」(2026-10-13T22:07Z)。統計列原文:「自v0.21.0以來:約24,200次提交·約6,080個已合併PR·約15,600個檔案變更·約2,045,000行新增·約1,140,000行刪除·約7,180個議題已關閉·約2,520位貢獻者」;「這是Hermes迄今發布範圍最大的一次,約為v0.21.0週期的2.5倍,並彙整且完整記錄了v0.21.1–v0.21.7修補版本。」GitHub的v0.21.7...v0.22.0比較結果顯示756次提交。上文採用的引文:初始設定「使用免費試用模型(nous/welcome,每位作業系統使用者限用一次),因此不需要金鑰;略過設定會結束流程,設定→重新執行初始設定則會重新啟動流程」,以及「CLI、TUI與gateway不提供帳號或免費模型。HERMES_GUEST_ONBOARDING已移除」;連接器「桌面版新增了連接器頁面,將託管應用程式與您的MCP伺服器整合至同一份清單(取代原有的MCP分頁)」,以及「nous.guest: false會停用訪客身分;tools.connectors.enabled: false會停用連接器」;本機模型「依據硬體選用合適的引擎(CPU、CUDA、Metal、Vulkan或ROCm),安裝並維護llama.cpp」,以及「每個後端都執行llama.cpp b11370」;套件「Windows可透過App Installer或Microsoft Store取得已簽署的MSIX(x64與ARM64);macOS則提供適用於Apple Silicon、已簽署並經公證的建置版本」;升級注意事項「受管理的安裝實例以Python 3.14作為執行環境(套件管理員會代為安裝)。KittenTTS無法在3.14上使用」、「Windows桌面版僅提供MSIX,且需要Windows 11 22H2或更新版本;NSIS/MSI安裝程式已移除」、「預設每台機器執行一個gateway。」、「session_reset的閒置/每日模式已停用(仍設定這些模式的組態會記錄警告)」、「sessions.auto_prune現在預設啟用:已結束且閒置90天的工作階段會在啟動時刪除」、「舊版外掛相容性匯入層已移除」、「hermes sync(Skill Sync)已移除」、「隨附的tirith掃描器已移除」,以及「多項工具已重新命名(todo→todo_list、cronjob→cronjob_manage、process→process_manage);舊名稱仍可使用」;目錄「增加至600筆項目」;模型「Claude Fable 5.1、Opus 5.5、Sonnet 5.5與Haiku 5.5,GPT-6 Astra、Sol與Luna,以及GPT-6.1 Sol和Gemini 4 Argon」;Bot Screen「預設停用;需要主機套件」;子代理「顯示於CLI(F6)、TUI(Ctrl+T)及桌面版的訊息輸入區上方」;程式碼庫「原始碼從約106萬行減至69.8萬行(−34%),gateway/run.py則從34,847行縮減至5,512行」;已還原的變更「Collective Wisdom V1(原始碼樹內的組織skill市集)合併後又遭移除;此版本不包含wisdom程式碼」。更新路徑原文:「Docker:固定使用Debian 13基底,包含完整Chromium;stable/latest僅在版本發布時更新」。 ↩↩↩↩↩↩↩ -
已在標籤
v0.22.0的原始碼中驗證的v0.22.0項目(提交e06df9c2;指南v1.26,2026年10月14日)。初始設定:hermes_cli/welcome_trial.py(「桌面版的歡迎試用:首次安裝可免費使用nous/welcome推論,每位作業系統使用者限用一次」);apps/desktop/src/app/settings/onboarding-settings.tsx(「進階→再次執行初始設定」);HERMES_GUEST_ONBOARDING位於apps/desktop/electron/updater/channel-protocol.ts的RETIRED_BUNDLE_ENV_KEYS中;已無任何initiate-setup介面;tools/set_theme_tool.py註冊set_theme(強調色、淺色/深色/系統模式、版面配置預設;「簡易模式僅顯示」簡易版面配置)。連接器:hermes_cli/subcommands/connectors.py(「管理託管應用程式連接器及其帳號」);ui-tui/src/app/slash/commands/core.ts中的/connectors;hermes_cli/config_defaults.py預設設有tools.connectors.enabled: True(「此旗標供使用者關閉功能;要使用此功能,還必須登入入口網站,這也是所有受管理工具的必要條件」);tools/connectors/gateway/config.py讀取nous.guest;hermes_cli/subcommands/auth.py中的hermes auth upgrade(「使用Nous帳號登入,並保留您的連接器」)。本機模型:hermes_cli/model_setup_flows_local.py(「hermes model→本機模型:在終端機中使用桌面版的本機模型設定功能」);hermes_cli/local_runtime/catalog.json列出qwen3.8-27b、qwen3.8-flash-next、qwen3.6-35b-a3b與deepseek-v4-flash;pm/lock.json針對各平台鎖定llama.cppb11370建置版本。套件管理器:pm/cli.py定義doctor(「依鎖定檔檢查安裝狀態」)、repair(「重建已記錄的相依套件環境,不變更其相依關係圖」)、gc(「移除儲存區中未被任何項目參照的項目」)及status(「輸出最新的pm同步紀錄」);hermes_cli/main.py將hermes pm路由至該處;pm/install.py讀取security.allow_lazy_installs(預設為true);pm/lock.json鎖定cpython-3.14.7+20260901,而pyproject.toml宣告requires-python = ">=3.11,<3.15"。hermes_cli/config_defaults.py中的預設值:sessions.auto_prune: True、agent.turn_liveness: {timeout_s: 600.0, poll_s: 15.0}、agent.auto_recovery_cycles: 5、prompt_caching.cache_ttl: "5m"(註解表示也接受"auto")、mcp.discovery_concurrency: 4、plugins.isolation: "in_process"、display.tui_native: False、display.suppress_warning_notifications: False、skills.auto_load: [],以及一個telemetry.shared_metrics區塊;hermes_cli/cli_init_mixin.py讀取display.vim_mode(「僅能透過設定檔設定」),ui-tui/src/app/createGatewayEventHandler.ts讀取bell_on_prompt,hermes_cli/cli_status_bar_mixin.py讀取git_branch狀態欄位;hermes_cli/_parser.py定義--native/--tui-native與-z/--oneshot。gateway:hermes_cli/gateway_multiplex_mode.py(「gateway.standalone: true是暫時性的回溯相容層,並非受支援的拓撲」;「請規劃使用hermes gateway migrate --multiplex整併此profile」);hermes doctor透過hermes_cli/session_reset_retirement執行「工作階段重設(計時器已於2026年9月7日移除)」檢查。子代理監控:hermes_cli/cli_tui_mixin.py綁定c-t與f6;ui-tui/src/content/hotkeys.ts將Ctrl+T對應至expandAgents。工具:tools/todo_tool.py註冊todo_list(toolset為todo);tools/mcp_oauth_provider.py(「MCP裝置授權需要hermes mcp login <server> --flow device」);tools/bot_desktop/sandbox_host.py指定nousresearch/hermes-sandbox:desktop;tools/voice_live.py記載voice.voice_chat_mode: gpt-live;hermes_cli/subcommands/cron.py接受--paused與--interpreter;hermes_cli/subcommands/usage.py輸出hermes usage --json文件。移除項目:hermes_cli/config_migrations.py從49至50的遷移「移除了security.tirith_*(不再隨附掃描器)」;hermes_cli/subcommands/下沒有sync子命令;hermes_cli/plugin_compat.py仍是v0.21.7的22行存根。該標籤的數量統計:plugin-catalog/含有601個YAML項目(版本說明稱600個;v0.21.7時為552個);plugins/model-providers/有41個目錄,CANONICAL_PROVIDERS有39列,兩者皆與v0.21.7相同;plugins/memory/含有byterover與retaindb;locales/有17個核心與16個TUI語系目錄。未在原始碼中找到、採自版本說明的項目:歡迎對話的卡片順序、以連接器頁面取代MCP分頁、Bot Screen的主機套件、程式碼行數從106萬降至69.8萬、/queue編輯介面,以及將/s作為/steer的別名。 ↩↩↩↩↩↩↩↩↩↩ -
Hermes Agent v0.22.1版本說明,標籤
v0.22.1,標題為「Hermes Agent v0.22.1 (rc.5-v0.22.1)」,標示發布日期為2026年10月14日,發布時間為2026-10-14T23:59:24Z;標籤提交為297552a9「fix(compression):備援摘要、多行設定備註與平行載入可確保skill標記正確」(2026-10-14T21:56:35Z)。說明原文譯文:「這是修補版本,包含針對Windows Store、外掛更新及其他項目的數項修正。」其餘內容為自動產生的提交主旨清單,附有連結:「功能」下有111項、「改進」21項、「錯誤修正」315項、「文件」28項、「測試」121項、「基礎設施」41項、「其他變更」22項,另列貢獻者;產生器會移除Conventional Commits前綴,因此項目呈現為「Cli):在模型選擇器清單頂端新增精選模型清單」、「Agent):新增nemotron super 3.5預設參數」、「更新nemotron super 3.5名稱」、「Plugin-catalog:新增hermes-lang-pt-br(巴西葡萄牙語語言套件)」、「Plugin-catalog:新增teamorouter(TeamoRouter模型供應商)」、「Plugins):將Kumiho Memory移至記憶目錄分類」,以及「透過已驗證的Python管道啟動Windows桌面版票證流程」。GitHub的v0.22.0...v0.22.1比較結果顯示2,216筆提交(提交者日期介於9月24日至10月14日);v0.22.0是main的祖先,撰寫本文時,main比v0.22.1多出66筆提交。 ↩↩↩↩ -
已在標籤
v0.22.1的原始碼中驗證的v0.22.1項目(提交297552a9;指南v1.27,2026年10月14日)。plugin-catalog/含有614個YAML項目(v0.22.0時為601個),包括hermes-lang-ko.yaml、hermes-lang-pt-br.yaml、teamorouter.yaml、author-feed.yaml、wait-ledger.yaml、lightningai.yaml、lightningai-rate-limit.yaml、hermes-aac.yaml、openinvest.yaml、hermes-agent-mixer.yaml與kumiho-memory.yaml。選擇器:hermes_cli/model_setup_flows_common.py中的_models_dev_merged(「精選識別碼優先(我們精選的代理模型置於最前,models.dev更新延遲也不會讓新模型被隱藏),其餘則優先採用models.dev的順序,再採用精選順序」),另有_LIVE_FIRST_PICKER_PROVIDERS集合,讓即時取得的順序保持優先。目錄:hermes_cli/models_catalog_static.py列出nvidia/nemotron-3.5-super-vl-120b-a12b。壓縮:website/docs/developer-guide/context-compression-and-caching.md新增「壓縮前後已載入的skill」一節;標籤提交及其相鄰提交(71e815de、a36fb64f、d6020828、036c31d2)包含fix(compression)的skill標記變更。與v0.22.0相比未變更的項目:plugins/model-providers/有41個目錄、CANONICAL_PROVIDERS有39列、plugins/memory/含有byterover與retaindb、locales/有17個核心與16個TUI語系目錄、hermes_cli/plugin_compat.py有22行。除清單外未找到其他佐證的項目:說明中提及的Windows Store修正。 ↩↩↩ -
Hermes Agent v0.22.2版本說明,標籤
v0.22.2(附註標籤7b77e29e指向提交d923a5eb「從release/0.22.1發布0.22.2,並以已發布的v0.22.1作為父提交」,2026-10-15T05:52:56Z),標示的發布日期為2026年10月15日,發布時間為2026-10-15T08:21:32Z。開頭原文:「v0.22.1是從錯誤的提交建置的。它包含尚未發布的gateway變更,而且Microsoft Store應用程式可能卡在『連線中』。0.22.2才是0.22.1原本應該發布的版本。」已知問題原文:「曾在0.22.1 gateway下執行的工作階段,無法在0.22.2中刪除。」重點原文:「重新開機後,gateway又能正常啟動了。重新啟動後,Linux可能將較早使用的PID分配給無關的程序,gateway卻將其誤認為仍在執行的gateway,導致受監管的gateway(systemd、launchd、Docker)拒絕啟動。Hermes現在會記錄自身啟動時所屬的開機週期;若無法判定,就會查詢主機鎖定,而只有仍在執行的gateway才會持有該鎖定」(#138594,修正#133744);「筆記型電腦上的本機模型長回合不再中斷。本機請求一律以串流方式傳輸,並顯示提示讀取進度(顯示於狀態列);停滯計時器不計入電腦睡眠的時間;本機伺服器恢復後會再嘗試一次,不再因斷路器而讓後續每則訊息都失敗;伺服器仍在讀取長篇對話時,壓縮也不再逾時。在採用統一記憶體的Windows電腦上,模型啟動與提示快取會依可用記憶體調整大小」(#138560)。「以下列出0.22發布分支自v0.22.0以來的所有變更:原定隨0.22.1發布的修正,加上上述2項。僅存在於main的變更將隨v0.23.0發布。」更新說明原文:「CLI及透過安裝指令碼安裝的桌面版:執行hermes update,或重新執行單行安裝指令。這會讓已安裝v0.22.1的版本回到發布分支。」清單包含:功能19項、改進7項、錯誤修正58項、文件8項、測試9項、基礎架構31項、其他變更35項,以及49位貢獻者。GitHub的v0.22.1...v0.22.2比較顯示11次提交(7次日期為10月14日的fix(gateway)與fix(local)提交、2次合併,以及發布提交);發布分支的v0.22.0...4ccc5806比較顯示179次提交;v0.22.2是main的祖先,10月17日時,main已比它多出1,531次提交。 ↩↩↩↩↩↩↩↩ -
透過比較
v0.22.0、v0.22.1與v0.22.2的完整遞迴git樹狀結構,已在標籤v0.22.2的原始碼中驗證v0.22.2(提交d923a5eb;指南v1.28,2026年10月17日)(比較用的API將檔案清單上限設為300,因此大部分差異不會顯示)。從v0.22.1到v0.22.2:新增60個blob、移除1,135個、變更846個;依目錄列出移除項目:tests/gateway/下466個、apps/desktop/下132個、gateway/下118個(session_authority.py、session_admission.py、runtime_ownership.py、run_*與hosted_room_*模組)、hermes_cli/下47個(gateway_runtime*.py、gateway_client.py、kanban_worker_client.py、sessions_owner.py、update_downgrade_guard.py)、21個頂層hermes_state_*.py模組、agent/managed_worker.py、agent/runtime_session_store.py、agent/context_compressor_tail.py、acp_adapter/gateway_server.py;新增:agent/auxiliary_managed_local.py、agent/chat_completion_local.py、agent/conversation_compression_deadline.py、agent/local_prompt_progress.py、agent/model_metadata_llamacpp.py、agent/sleep_clock.py,以及桌面版後端集區與防止睡眠的檔案。從v0.22.0到v0.22.2:新增50個(13個目錄項目、6個agent/模組、hermes_cli/profile_model_seed.py、pm/user_facing.py、scripts/releases/lanes.py、測試、貢獻者對應資料)、移除1個、變更205個。v0.22.2保留的內容:plugin-catalog/中的614個YAML項目;hermes_cli/model_setup_flows_common.py與hermes_cli/models_catalog_static.py和v0.22.1完全相同(優先採用精選項目的_models_dev_merged、nvidia/nemotron-3.5-super-vl-120b-a12b);plugins/model-providers/中的41個目錄;hermes_cli/providers.py完全相同(39列);plugins/memory/中的byterover與retaindb;locales/中的17個核心與16個TUI翻譯目錄(全部35個檔案的內容皆有變更,沒有新增或移除);hermes_cli/plugin_compat.py共22行。v0.22.2不包含的內容:v0.22.1標籤提交中agent/context_compressor.py的程式碼行(「保留該存根本身的判定」)與agent/skill_commands.py的程式碼行(_TRAILING_BLOCK_ENDS),以及website/docs/developer-guide/context-compression-and-caching.md的「壓縮前後保留已載入的skills」一節。 ↩↩↩↩ -
Hermes Agent版本說明:v0.22.3(標籤提交
5b147ab0「fix(ci): Docker manifest-list作業重新在GitHub託管的執行器上執行」,2026-10-21T11:14:29Z;標示的發布日期為10月21日,發布時間為2026-10-21T12:21:11Z)、v0.22.4(標籤提交4d043038,2026-10-21T16:16:45Z;發布時間為2026-10-21T18:49:24Z),以及v0.22.5(標籤提交bf0203a7「fix(launchers): 重新固定Python版本時會重新發布hermes.exe,而非.cmd」,2026-10-23T02:24:27Z;標示的發布日期為10月22日,發布時間為2026-10-23T05:28:45Z)。v0.22.3原文:「修補版本。此標籤彙整自v0.22.2以來合併的約620個PR,為CLI與安裝程式、Microsoft Store應用程式、Docker及Hermes Cloud提供穩定版本。此期間的完整精選說明將隨v0.23.0發布」;「以提交5b147ab036d為準,自v0.22.2以來的期間包含2,911次非合併提交,涉及4,206個變更檔案(+360,278 / -64,308)、約620個已合併PR與326個已關閉議題」;本節引用了「同樣屬於此期間,但刻意不在此處記錄」清單。v0.22.4原文:「桌面版不再於訊息輸入區上方顯示膠囊狀建議按鈕。這些按鈕出現的原因不明,內容多半是催促您設定MCP伺服器」(#142559);「不安裝任何內容的外掛程式會略過相依套件同意步驟」(#142569);「外掛程式目錄也新增了:bubblewrap(Linux上的bwrap終端機後端)、Singularity/Apptainer、mcp-serve(將Hermes作為MCP伺服器)、agent-importers(hermes import-agent,現在支援Cursor),以及Hermes Labs的inbox與workflow-record。Telegram Business移至Hermes Labs社群層級」;「自v0.22.3以來的期間包含14次非合併提交,涉及82個變更檔案」。v0.22.5原文:「此標籤彙整自v0.22.4以來合併的約81個PR」;「以提交bf0203a794a為準,自v0.22.4以來的期間包含231次非合併提交,涉及804個變更檔案(+35,212 / -17,885)、81個已合併PR與30個已關閉議題」;本節引用了刻意不記錄的項目清單。3個版本皆註明:「透過安裝程式(.exe / .dmg)安裝的桌面應用程式:此版本沒有變更;將隨下一個整合發布版本更新。」GitHub的v0.22.2...v0.22.5比較顯示領先3,291次提交;v0.22.5是main的祖先,10月23日時,main已比它多出459次提交。 ↩↩↩↩↩↩ -
透過比較
v0.22.2、v0.22.3、v0.22.4和v0.22.5的完整遞迴 git 樹,已在標籤v0.22.5的原始碼中驗證 v0.22.5(提交bf0203a7;指南 v1.29,2026年10月23日)。Blob:v0.22.2至v0.22.3新增 2,154 個、移除 71 個、變更 2,001 個;v0.22.3至v0.22.4新增 14 個、移除 14 個、變更 54 個;v0.22.4至v0.22.5新增 136 個、移除 25 個、變更 643 個;v0.22.2至v0.22.5新增 2,303 個、移除 109 個、變更 2,298 個。v0.22.5的統計:plugin-catalog/有 763 個 YAML 項目(v0.22.2時有 614 個;新增 150 個,移除codex-account-switch.yaml),plugins/platforms/有 27 個目錄(新增bluebubbles、qqbot、signal、weixin、whatsapp_cloud、yuanbao),plugins/model-providers/有 41 個,plugins/memory/有byterover和retaindb,locales/有 17 份核心翻譯目錄及 16 份 TUI 翻譯目錄,hermes_cli/plugin_compat.py有 22 行,hermes_cli/models_catalog_static.py的CANONICAL_PROVIDERS有 39 列。v0.22.5的hermes_cli/config_defaults.py:sessions區塊寫著「# auto_prune 鍵,當存放 state.db 的磁碟空間不足時,各介面都會詢問」及"auto_prune": False(在v0.22.2時為True)。從樹中移除的項目:mcp_serve.py(根目錄)、hermes_cli/claw.py、hermes_cli/subcommands/claw.py、hermes_cli/subcommands/import_agent.py、hermes_cli/agent_import.py、hermes_cli/agent_import_sync.py、hermes_cli/setup_whatsapp_cloud.py和optional-skills/migration/openclaw-migration/;hermes_cli/subcommands/mcp.py現在寫著「將 Hermes 本身作為 MCP 伺服器執行的功能,由 mcp-serve 外掛提供:hermes plugins install mcp-serve」。該標籤的目錄卡片:mcp-serve.yaml(「原先以hermes mcp serve內建於 Hermes 核心中(MCP 用戶端須將引數改為 ["mcp-serve"])」)、agent-importers.yaml(「hermes import-agent:以單一指令將 OpenClaw(~/.openclaw,或舊版 ~/.clawdbot / ~/.moltbot)、Claude Code(~/.claude)、Codex CLI(~/.codex)或 Cursor(~/.cursor)的設定匯入 Hermes;一律先顯示預覽,並在套用前詢問」、「OpenClaw(核心原有的hermes claw migrate;外掛保留此指令名稱、hermes claw cleanup及 openclaw-migration skill)」、「hermes setup偵測到其中任一設定時,會提供安裝此外掛的選項」)、bubblewrap.yaml(「適用於 Linux 的 Bubblewrap 終端機後端……(hermes config set terminal.backend bubblewrap)」)。新增:agent/delegation_backends.py、agent/delegation_provider.py、agent/delegation_registry.py和website/docs/developer-guide/delegation-provider-plugin.md。 ↩↩↩↩↩↩↩ -
Hermes Agent v0.22.6版本說明(標籤提交
f0d94882「test(install-e2e): 將v2026.7.30 macOS DMG應用程式更新遭拒的情況歸類為已知問題」,2026-11-02T15:57:32Z;標示的發布日期為11月2日,發布時間為2026-11-02T17:18:36Z)。原文:「修補版本。此標籤彙整自v0.22.5以來合併的約776個PR,為GitHub發行版(CLI與安裝程式)、Microsoft Store應用程式、Docker及Hermes Cloud提供穩定版本。此期間的完整精選說明將隨v0.23.0發布」;「以提交f0d94882e89為準,自v0.22.5以來的期間包含3,448次非合併提交,涉及4,316個變更檔案(+248,579 / −94,077)、776個已合併PR與385個已關閉議題」;「同樣屬於此期間,但刻意不在此處記錄」清單列出「由gateway自身的監聽器提供的Webapp(hermes webapp、可在您的網路或自訂URL上以Nous登入保護開啟它的Desktop Web Access面板,以及在瀏覽器分頁中載入的Desktop外掛)、用於清除工作階段模型固定設定且不遺失歷史紀錄的/model reset、防止自主寫入的個別skill鎖定(可從Desktop Capabilities面板鎖定)、可選擇啟用的預先準備壓縮(compression.prepare_ahead)、hermes cron cancel加上個別工作的錯過執行處理原則與Desktop cron編輯器中的Stop按鈕、為下一個工作階段保存的/delegation選擇、將Grok Bot與OpenBot使用者遷移過來的hermes migrate與設定流程、可選擇啟用的保管庫金鑰作業系統鑰匙圈儲存、在外掛安裝與更新時強制檢查目錄的requires_hermes、text_to_speech中由代理挑選的ElevenLabs語音、可在推論前阻止回合的pre_llm_call掛鉤、Desktop群組聊天的重新命名、解散、提及與附件貼上、每個profile顯示為Desktop側邊欄區段、Telegram video note、討論串上下文中的Slack表情符號回應,以及套件管理器的續傳下載。」更新方式原文:「透過安裝程式(.exe / .dmg)安裝的桌面應用程式:此版本沒有變更;將隨下一個整合發布版本更新。」 ↩↩↩↩↩ -
透過比較
v0.22.5與v0.22.6的完整遞迴git樹,已在標籤v0.22.6的原始碼中驗證v0.22.6(提交f0d94882;指南v1.30,2026年11月2日):新增1,504個blob、移除237個、變更2,646個。v0.22.6的統計:plugin-catalog/有911個YAML項目(v0.22.5時有763個;新增148個,無移除),plugins/platforms/有27個目錄,plugins/model-providers/有39個(copilot與copilot-acp已移除),plugins/memory/有byterover和retaindb,hermes_cli/plugin_compat.py有22行,hermes_cli/config_defaults.py的sessions下為"auto_prune": False;hermes_cli/models_catalog_static.py的CANONICAL_PROVIDERS少了copilot與copilot-acp列,其餘保留。Copilot:提交1da2eb42(2026-10-25)「refactor!: 將GitHub Copilot移出核心(現為github-copilot labs外掛)」:「刪除樹內的模型供應商外掛plugins/model-providers/copilot/(供應商copilot:透過GitHub->Copilot權杖交換使用Copilot API)與plugins/model-providers/copilot-acp/(供應商copilot-acp:透過ACP使用Copilot CLI)。兩者合併為同一個外掛github-copilot,位於NousResearch/hermes-labs-plugins;在此提交之前加入的LEFT_CORE列會為每個透過copilot/copilot-acp路由的profile安裝它,且每個『未知供應商』介面都會指出hermes plugins install github-copilot」;hermes_cli/left_core_migration.py(「hermes update會為共用該venv且使用此功能的每個profile home安裝外掛。代理啟動與gateway啟動會針對目前的home每個處理程序重試一次」);plugin-catalog/github-copilot.yaml(tier: community,儲存庫為hermes-labs-plugins)。功能:hermes_cli/subcommands/webapp.py(說明文字「在瀏覽器中開啟Hermes Desktop工作區」;「當config.yaml中的webapp.enabled為true時由gateway提供服務;此指令會視需要建置套件、啟動gateway並開啟一次性登入連結」;--no-open、--rebuild、--skip-build、--build-only、--status);gateway/slash_commands_model.py(「/model reset:移除此工作階段的/model覆寫設定」);hermes_cli/curator.py(_set_lock:「hermes curator lock|unlock:與pinned並列儲存的使用者宣告」;status會印出「代理無法變更這些項目;hermes curator unlock <skill>可解除鎖定」)與tools/skill_lock.py;agent/agent_init.py(prepare_ahead=is_truthy_value(cfg.get("prepare_ahead"), default=False));cron/cancellation.py(「隨選取消執行中的cron工作(hermes cron cancel)」)與cron/missed_runs.py(「每項工作都可帶有catch_up:true會針對錯過的所有執行補跑一回,false則跳到下一個時段。未設定時,週期性工作遵循cron.catch_up_missed(預設為true),單次工作則維持120秒的寬限規則」;「在執行帳本中記為一列missed ×N」);agent/delegation_backends.py(「config.yaml中的delegation.backend即為保存的選擇」);hermes_cli/migrate.py(「hermes migrate <agent>:缺少agent-importers外掛時先安裝,再執行其」匯入工具;「hermes migrate xai會診斷並(加上–apply時)改寫參照」)與hermes_cli/setup_agent_import.py(來源為「Grok Bot」與OpenBot,「含openbot.db的Electron使用者資料」);hermes_cli/config_defaults.py(vault.key_storage: "file",「新保管庫的金鑰:file(權限0600的vault.key)| keychain(作業系統;若無則改用file)。請參閱hermes vault key」)、hermes_cli/vault.py(「hermes vault key顯示保管庫金鑰的存放位置;key migrate --to keychain|file可搬移」)、agent/vault_keychain.py(「Linux上為KWallet,透過keychain選用套件提供的keyring套件」);hermes_cli/plugins_cmd_catalog.py與hermes_cli/plugins_loader.py(requires_hermes_error);tools/tts_elevenlabs_voices.py(「text_to_speech的find_voices引數背後的ElevenLabs語音搜尋。此引數(以及voice_id)僅存在於ElevenLabs版本」;來源為library與account);hermes_cli/plugins_dispatch.py(「pre_llm_call可回傳{"context": "..."}(或字串)以注入內容,或回傳{"action": "block", "message": "..."}以在送出任何推論請求前結束該回合」);plugins/platforms/telegram/adapter.py(video_note對應至MessageType.VIDEO);plugins/platforms/slack/adapter_reactions_context.py;apps/desktop/src/plugins/hermes-bots/bot-row.tsx(onDisband)、apps/desktop/src/api/cron.ts(cancelCronJobRun)、apps/desktop/src/app/settings/web-access-settings.test.tsx;plugins/config_backends/remote/plugin.yaml(「從config-config平面(代理在此實例與profile下的有效文件)提供各profile的設定,取代config.yaml:啟動時擷取(失敗即封閉),由ETag輪詢器重新整理,並以比較並交換方式寫回鍵層級的變更。僅能透過環境中的HERMES_CONFIG_BACKEND=remote選用;絕不會作為一般外掛載入」)與hermes_cli/config_backend.py。未在標籤中找到:套件管理器的續傳下載。 ↩↩↩↩↩↩↩↩↩↩↩↩ -
Hermes Agent v0.20.3 版本說明(標籤
v2026.8.16.2,標示的發行日期為8月16日,於2026年8月17日發布)及 v0.20.4 版本說明(標籤v2026.8.18,2026年8月18日);兩者皆於2026年8月20日透過 GitHub API 取得(prerelease: false)。v0.20.3 原文:「MCP 2.x SDK 遷移與 2026-07-28 無狀態協定支援、隨附的 Bot Mode(hermes-bots)外掛及核心隊友協定、CommandCode 供應商外掛、子程序 Python 執行環境所有權強化(PYTHONHOME/PYTHONPATH 隔離)、用於電腦操作的 Cua Driver 0.20 執行環境契約。」v0.20.4 原文:「桌面玻璃/半透明介面改進(霧面玻璃、霧化選擇器、macOS 預先選取)、採用 SESSIONS|BOTS 分頁的側邊欄,可個別隱藏/顯示機器人,……安裝 skill 時執行 NVIDIA SkillEvaluator Tier 1 建議性掃描(授權與安全檢查)。」兩個版本皆註明:「此期間經完整整理的版本說明將隨 v0.21.0 一併發布。」 ↩↩↩↩↩↩↩↩↩↩↩↩↩ -
Hermes Agent v0.20.0 版本說明,「The Herald Release」,標籤
v2026.8.3,2026年8月3日,另有穩定性修正標籤 v2026.8.13 和 v2026.8.16。版本說明原文:「所有安裝程式/修復/升級流程皆須使用 Node 26」;「停用 brew + pip/PyPI wheel 管道(支援的管道為 shell 安裝程式/Docker/Nix)」;「預設迭代次數上限 90 → 500」;「移除 claude-marketplace 來源」。另於安裝程式原始碼 scripts/install.sh 中獨立確認 Node 最低版本要求——NODE_VERSION="26"及防護檢查訊息「Node.js $(node –version) 版本過舊(Hermes 需要 Node >=26)」——其檔頭註解也記載了標準單行安裝指令curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash。請注意其中的矛盾:文件的安裝頁面仍寫著 Node v22,相較於上述兩項來源已過時。平台支援層級取自平台支援;skill 來源及預設 tap 來源取自 skill;28 個平台的數量是逐一計算訊息功能頁面的比較表所得,該頁未公布官方總數。所有資料皆於2026年8月16日取得並驗證。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩ -
Hermes Agent v0.19.0版本說明,「The Quicksilver Release」,標籤
v2026.7.20,2026年7月20日;截至2026年7月21日為最新版本。自v0.18.0以來的統計:約2,245次提交、約1,065個已合併PR、約3,300個已結案議題、450多位社群貢獻者。核心效能改善:首輪TTFT縮短約80%,CLI/gateway/TUI/桌面版/cron的冷啟動提交→派送時間從約4.3秒降至約0.9秒(PR #59332);預設開啟display.show_reasoning,即時串流顯示推理內容,並逐一繪製回應token(PR #59389);桌面版透過約20個PR提升速度,包括Markdown串流處理速度提升14倍;TUI採用增量式Markdown處理。pip/Homebrew安裝方式已棄用,目前僅顯示「不再支援的舊版方式」警告,並計畫停止向PyPI/Homebrew發布(PR #57225)。可插拔的SecretSource介面支援Bitwarden與1Password提供者、op://參照、多個保管庫、明確的優先順序,以及個別變數的來源追溯(PR #59498)。預設啟用智慧核准(每個被標記的命令均由獨立的LLM審查者審核),使用者自訂的拒絕規則在YOLO模式下仍然有效,並支援/deny <reason>(PR #62661、#59164、#54518);外掛pre_tool_call升級為需核准的機制重新納入(PR #60504)。終端機帳務功能/subscription與/topup,以及桌面版帳務分頁(PR #51639)。即時子代理對話記錄檔與可持續保存的背景委派(PR #67479、#63494);在state.db中記錄交付義務(PR #67181);棄用max_async_children,改採統一的委派並行數上限(PR #56955)。gateway依profile路由,支援GATEWAY_MULTIPLEX_PROFILES,並將路由索引移至state.db;sessions.json則作為選用的舊版鏡像(PR #64835、#65700、#60589、#59203)。提供者/模型:完整支援Fireworks AI,並將其列為選擇器的第2個選項(PR #62593);支援DeepInfra、Upstage Solar,以及GPT-5.6 Sol/Terra/Luna與Pro的端到端整合(PR #61616);grok-4.5正式推出、kimi-k3上線(kimi-k2.x退役)、Claude Sonnet 5完整整合,並可依提供者設定enabled: false與excluded_providers(PR #67971);推理強度新增max/ultra層級,支援依模型/MoA欄位覆寫,以及僅適用於目前工作階段的/reasoning(PR #62650、#64458)。CLI/MCP:hermes sessions export支援Markdown/Quarto/HTML/僅提示詞/HF追蹤記錄格式,並提供--redact(PR #60186)、/model --once(PR #67113)、堆疊式斜線命令skill呼叫(PR #57987)、--safe-mode、hermes config get/unset(PR #65540)、hermes serve真正的無介面模式(PR #55923),以及MCP的mcp__server__tool命名方式(PR #52750)。此處省略版本發布的行銷措辭;發布期間內已撤回的項目(iron-proxy對外連線防火牆、動態工作流程skill、記憶提供者動作)刻意不列為已交付功能。本次工作階段的查證日期為2026年7月21日。 ↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩↩ -
Hermes Agent v0.18.1版本標籤與v0.18.2版本標籤,2026年7月7日至8日。v0.18系列的基礎設施修補彙整;v0.18.2的主要修正解除WhatsApp Baileys的版本鎖定,改用7.0.0-rc13,以確保Docker建置穩定可靠。這兩次修補期間的變更均已彙整至v0.19.0版本說明,並完整記錄於其中。 ↩
-
Hermes Agent v0.15.1版本說明與Hermes Agent v0.15.2版本說明。v0.15.1(2026年5月29日01:12 UTC)是當日發布的Velocity緊急修補:修正儀表板在回送模式下因401錯誤而反覆重新載入的問題;Docker現在要求明確設定
HERMES_DASHBOARD_INSECURE=1;MCP可在Docker容器中解析未附路徑的命令(npx、npm、node);還原skill頁面的來源標籤與分類側邊欄;Kanban工作程序會回應SIGTERM;Skills.sh目錄透過網站地圖,從858筆擴增至19,932筆。共28次提交、21個已合併PR、9位貢獻者。v0.15.2(2026年5月29日13:37 UTC)僅修補套件封裝,將plugin.yaml資訊清單納入wheel與sdist發行套件,讓透過PyPI安裝的版本無須額外載入原始碼即可運作。共4位貢獻者。 ↩ -
Hermes Agent v0.15.0版本說明與Hermes Agent版本發布頁面。「The Velocity release」,標籤
v2026.5.28。統計:1,302次提交、747個已合併PR、321位社群貢獻者。重構run_agent.py,將其行數減少76%(16,083→3,821行,拆分至14個模組)。新增多代理Kanban平台(自動拆解、群集拓撲、個別任務模型覆寫、排程任務、worktree管理)。重新設計session_search,速度提升4,500倍,並移除對LLM的相依性。在3個關鍵安全檢查點加入Promptware防護,抵禦Brainworm類型的提示注入。整合Bitwarden Secrets Manager,以單一啟動權杖取代各提供者的多組API金鑰。skill套組可透過單一斜線命令載入多個skill。TUI工作階段協調器可在同一個終端機視窗中管理多個工作階段。支援Krea 2(Medium/Large)與FAL外掛的圖像生成功能。本輪xAI整合新增網頁搜尋外掛、OAuth上游支援、已退役模型偵測,以及語音輸出的自然TTS停頓。GitHub提及的一個修補版本處理了以下問題:儀表板因401錯誤而反覆重新載入、Docker的--insecure須明確設定HERMES_DASHBOARD_INSECURE=1環境變數、MCP在Docker中解析未附路徑的命令(npx、npm、node)、skill頁面繪製、Kanban工作程序處理SIGTERM,以及透過網站地圖提供完整的19,932筆skill目錄。該版本另含少量修正,涵蓋.md交付、gateway探測安全性、網頁URL遮蔽、kanban-worker視覺能力,以及hindsight觀察預設值。 ↩↩↩↩ -
Hermes Agent v0.11.0版本說明。2026年4月23日。「The Interface release」——以React/Ink全面重寫互動式CLI,搭配Python JSON-RPC後端(
tui_gateway);可插拔的傳輸架構(agent/transports/);透過Converse API原生支援AWS Bedrock;新增5種推論途徑(NVIDIA NIM、Arcee AI、Step Plan、Google Gemini CLI OAuth、Vercel ai-gateway);透過Codex OAuth提供GPT-5.5;QQBot成為第17個訊息平台,支援掃描QR碼設定;擴充外掛可介入的功能範圍(斜線命令、工具派送、阻擋執行、結果轉換);/steer <prompt>可在代理執行途中提供引導,於下一次工具呼叫後注入上下文,且不影響提示快取;透過shell掛鉤處理生命週期事件,無須使用Python外掛;webhook直接交付模式可將酬載直接轉送至平台聊天室;更智慧的委派機制,支援協調器角色、可設定的代理建立深度及檔案協調;儀表板外掛系統、即時主題切換、i18n及行動裝置響應式設計。自v0.9.0以來的統計:1,556次提交·761個已合併PR·1,314個檔案變更·新增224,174行·29位社群貢獻者。另請參閱:Hermes Agent v0.11.0 GitHub版本標籤。 ↩↩↩ -
Hermes Agent v0.10.0 版本說明。2026年4月16日。「Tool Gateway 版本」。為 Nous Portal 付費訂閱者整合 Nous Tool Gateway,透過代管服務存取 Firecrawl 網頁搜尋、FAL / FLUX 2 Pro 圖像生成、OpenAI TTS 與 Browser Use 瀏覽器自動化,無須額外的 API 金鑰。透過新增的
use_gateway設定欄位,可逐一選擇要啟用的工具。同時設定 gateway 與直接使用的 API 金鑰時,執行階段會優先使用 gateway。與hermes tools和hermes status完整整合。取代已棄用的HERMES_ENABLE_NOUS_MANAGED_TOOLS環境變數。由 @jquesnelle(emozilla)實作。Hermes Agent CLI 仍採用 MIT 授權,並維持完全開源;gateway 是與現有 Portal 訂閱產品的整合,並未對 CLI 設置付費門檻。另請參閱 Nous Portal,瞭解訂閱價格與註冊方式。 ↩↩↩