返回首頁

GitHub Repo

Hermes 修補 Claude CLI 外掛,空參數工具不再觸發備援供應商切換

Nous Research 更新 DirectSDK 外掛固定提交,修正空參數工具、思考設定與介面相容性問題。版本號仍維持 0.3.0,部署者須核對提交值及實際工具執行流程。

Digital Bodleian This file comes from the Bodleian Libraries, a group of research libraries in Oxford University.This tag does not indicate the copyright status of the attached work. A normal copyright tag is still required. See Commons:Li… · CC BY 4.0 · Image source
zh-Hant

Nous Research 於 9 月 22 日合併 Hermes 外掛目錄更新,將 Claude Subscription DirectSDK 的固定提交由 `c92c27c` 改為 `f1c1220`,納入五項修補。版本號仍是 0.3.0,因此只看版本字串無法辨認是否取得修正;透過目錄安裝的使用者須核對提交值。[合併紀錄](https://github.com/NousResearch/hermes-agent/pull/118750)

這個實驗性外掛讓 Hermes 經由已登入的官方 Claude Code CLI 呼叫模型,使用原生 `stream-json` 協定,無須 Python Agent SDK。工具執行、人工核准與歷史壓縮仍由 Hermes 負責。每次模型請求另啟程序,並透過本機轉送器只放行首次上游請求,避免 CLI 自行恢復時產生額外模型呼叫。[官方文件](https://hermes-agent.nousresearch.com/docs/plugins/claude-subscription-directsdk)

此次空參數修補處理的是串流協定邊界:不需要參數的工具可能送出空的 `partial_json`,舊程式卻直接解析空字串,導致回覆擷取無法完成。接續的重試又被單次請求限制拒絕,最終可能讓 Hermes 切到備援供應商。固定提交中的程式已將空白內容轉成 `{}`,使合法工具提案能交回主代理處理。[問題分析](https://github.com/NousResearch/hermes-plugin-claude-subscription-directsdk/pull/3)、[修補程式](https://raw.githubusercontent.com/NousResearch/hermes-plugin-claude-subscription-directsdk/f1c1220/admission.py)

這也凸顯代理系統的故障會跨層傳播:有效工具呼叫可能先被解析器誤判,再被重試限制放大,最後改變工作階段使用的模型。由此推論,回歸測試除了檢查輸出,還應確認實際供應商、上游請求次數與工具結果是否完整保存,才能判斷修補是否恢復預期流程,並核對既有備援路由是否在故障後被意外保留。

同批變更也修正 Haiku 4.5 不支援的自適應思考參數、工具頂層 schema 組合條件造成的 HTTP 400,以及執行檔搜尋路徑與錯誤訊息。對工程團隊而言,這些修補有助區分模型拒答、介面格式錯誤與轉送層失敗,減少把基礎設施故障誤判為模型能力不足。[更新內容](https://github.com/NousResearch/hermes-agent/pull/118750)

導入仍須搭配 Hermes 0.21.4 以上版本與已登入的 CLI,並以自己的無參數工具、取消操作及多輪歷史重播重測。維護者明列尚未保證所有歷史轉換與跨模型重播相容;工具呼叫成功也不能證明計費相同,文件中的成本數值只是 API 定價等值,實際訂閱額度與超額費用仍由帳戶設定決定。[部署限制](https://hermes-agent.nousresearch.com/docs/plugins/claude-subscription-directsdk)

來源

  1. plugin-catalog: claude-subscription-directsdk pin → f1c1220
  2. Claude Subscription DirectSDK 外掛目錄與技術文件
  3. fix(admission): accept a tool call with an empty input
  4. 固定提交 f1c1220 的 admission.py