Hermes Ollama 模型未顯示：目錄與供應商檢查

如果你的 Ollama 模型從 Hermes 選擇器中消失，請在修改設定前先檢查版本：造成完全相同症狀的原生目錄快取錯誤已於 2026 年 9 月 17 日標記為完成，其修正包含在標籤 v2026.9.21（hermes-agent 0.21.4）中，但不在 v2026.9.14 中。不過，該已關閉的報告並不是全部情況。2026 年 9 月 21 日仍有另外兩份關於 Ollama 模型從選擇器中消失的報告尚未關閉；第三個未關閉的 issue 描述了 Hermes Desktop 的一種機制，任何曾自訂可見模型清單的供應商都可能出現相同症狀，而我在同一標籤的已發布原始碼中讀到該行為仍然存在。第四個常見原因根本不是缺陷。每個原因都留下不同的辨識特徵，而本頁就是用來說明這些特徵。

先釐清兩件事，因為兩者都會在搜尋結果中混淆。Hermes Agent 是 Nous Research 的 Python agent（MIT 授權、未封存；根據 GitHub API，最近一次推送為 2026 年 9 月 21 日）。Hermes 3 與 Hermes 4 是同一實驗室的開放權重 LLM 家族，是完全不同的產品；此外還有一個無關的 JavaScript 引擎叫做 Hermes——它們的版本號都不適用於此處。而且，本機 Ollama 不是 Ollama Cloud：Hermes 透過 Custom Endpoint 流程，在連接埠 11434 上連線免費的本機執行環境；Ollama Cloud 則是獨立的付費產品，使用自己的供應商 slug 與自己的快取檔案。一方缺少模型，不能說明另一方的情況。

三個層級必須彼此一致，且只有其中一個屬於 Ollama

「模型不在選擇器中」是在描述三個層級中的最後一個，而診斷的關鍵是找出第一個不一致的層級。

# 1. Does Ollama itself list the model? This is the native catalog
#    Hermes reads when the endpoint qualifies for the /api/tags branch.
curl -s http://127.0.0.1:11434/api/tags | jq '.models[].name'

# 2. Does the OpenAI-compatible surface list it too? This is what a
#    generic custom endpoint is probed on.
curl -s http://127.0.0.1:11434/v1/models | jq '.data[].id'

第一層有一件事需要排除：ollama list包含 embedding 模型，而 embedding 模型不是程式碼 agent 可以選取的聊天模型。Kunavo 同樣不提供 embedding、文字轉語音或語音轉文字模型，因此託管路由無法在此補足這項缺口。

先檢查你的版本，並仔細讀取版本資訊

Issue #112898——「本機 Ollama 模型清單在選擇器中閃爍」——已標記為完成並關閉，於 2026 年 9 月 16 日開啟，並於 2026 年 9 月 17 日關閉。Pull request #113129 將修正合併為提交 d6d6565，而 GitHub compare 將該提交置於標籤 v2026.9.21 之內、v2026.9.14 之外：比較 v2026.9.21…d6d6565 會回傳狀態 behind，領先提交數為零，表示該提交是該標籤的祖先；而比較 v2026.9.14…d6d6565 會回傳狀態 ahead，落後提交數為零，表示該標籤是該提交的祖先，而非反過來。貢獻者自己的 #112900 仍然開啟中，這不表示修正未包含在 main 中：其內容已透過 cherry-pick 納入已合併的 pull request，並保留原作者的署名。所有狀態均於 2026 年 9 月 21 日從 GitHub API 讀取。

現在來看陷阱。同一個標籤內包含兩個不同的版本號：在 v2026.9.21 中，pyproject.toml 顯示 version = "0.21.4"，而 apps/desktop/package.json 顯示 "version": "0.17.6"。因此，標題為「Hermes Desktop 0.17.6」的錯誤報告描述的是一個目前版本的建置，而不是舊版本；將這類報告斥為過時，反而會使你自己的證據日期判斷錯誤。也請注意版本檢查的限制：這裡檢查的是標籤中的 git 包含關係，並未驗證你實際安裝的 pip 發行版、Homebrew 公式、容器映像或桌面自動更新通道是否包含該提交。

五個原因，以及區分它們的判斷線索

其中兩項值得另行說明。桌面凍結最容易被誤認為快取問題：在標籤 v2026.9.21 中讀取 apps/desktop/src/store/model-visibility.ts 時，只要某個提供者儲存過任何金鑰，轉譯器就會完全略過合併提供者預設值，因此之後發現的模型永遠不會進入選單。Issue #114369 正好在一個自訂提供者上重現了這種情況，該提供者使用 discover_models: true，並且被關閉為重複問題，而非已修正問題；其重現使用 vLLM 端點，因此應將此機制視為與提供者無關，而不是 Ollama 重現案例。另有兩項仍處於開放且未解決狀態：#89874（自訂 Ollama 提供者顯示零個模型，帶有 needs-repro 標籤，因此是未確認報告，而非已確立的缺陷）以及 #71169（模型存在於 Ollama API 中，但不在桌面下拉選單中）。兩者是否與 #112898 共用根本原因，尚未確立。

桌面端的症狀也比人們預期的更明顯。在該標籤的 model-catalog-menu.tsx 中，若提供者折疊後的系列清單為空，便會直接略過；這就是為什麼抱怨通常是「我的提供者消失了」，而不是「我的提供者顯示空清單」。

為什麼一般開啟選擇器時會看到過時清單

這是整個故障類別背後的機制，值得一次弄清楚。直接開啟選擇器時，只有目前的自訂端點會即時探測；其他所有已設定的端點都會從磁碟快取 $HERMES_HOME/provider_models_cache.json 回應。HERMES_HOME 預設為 ~/.hermes，但可以覆寫，因此不要假設路徑固定不變。在標籤 v2026.9.21 的 hermes_cli 中，三個時間視窗決定重新探測的時機：

這些是內部原始碼常數，而非已記錄的設定；在此次檢查中，沒有找到可供使用者調整這三項設定的介面。該程式碼中有一個值得了解的刻意例外：空的原生目錄只有在短 TTL 內才會被視為權威資料，且永遠不會以過時資料提供，正是為了避免一開始沒有模型的 Ollama 在整個七天視窗內隱藏剛拉取的模型。此外，快取資料列會以正規化 URL 加上認證、API 模式與額外標頭的指紋作為鍵，因為多個提供者列合理地可能共用一個代理 URL，但使用不同金鑰。實際結果是：輪替金鑰、變更傳輸方式或編輯 extra_headers 都會使該資料列的快取項目失效，而下一次不進行探測的開啟會將其顯示為空白，直到有其他操作重新整理它。

依序進行的檢查

1. 確認 Ollama 擁有該模型。 執行上面的兩個 curl。如果 /api/tags 沒有列出該模型，後續任何環節都不可能找到它。
2. 確認版本。 如果你使用的是早於標籤 v2026.9.21 的建置，且症狀是清單在正確與空白之間閃爍，那麼你遇到的是已修正的錯誤；請先升級，再進行除錯。
3. 強制重新整理。 hermes model 上的 --refresh 旗標在其說明文字中明確指出，會清除選擇器磁碟快取，並重新取得每個提供者的即時清單；請注意，它會清除所有提供者，而不是單一提供者。在工作階段內，斜線命令參考文件將 /model --refresh 說明為重新取得提供者的模型清單；桌面版也有明確的「重新整理模型」控制項，會要求取得新目錄，而一般開啟則維持使用一小時快取。
4. 檢查你的端點會使用哪條探測路徑。 當提供者名稱為 ollama、名稱為 custom:ollama 或以 -ollama 結尾、URL 符合已設定的 Ollama 基礎 URL，或位於連接埠 11434 上的模糊自訂 URL 實際回應 /api/tags 時，會採用原生 /api/tags 分支。以其他連接埠提供服務、名稱僅為 custom 的 Ollama，則會改用一般 /v1/models 探測；這是程式碼路徑所呈現的行為，本頁未實際執行以確認該回退路徑是否有效。
5. 如果問題本身出在探索，就停止探索。 discover_models 預設為 true；將其設為 false 後，選擇器會顯示你設定的清單，而不是進行即時探測。
6. 如果只有桌面選單不正確，你很可能遇到 #107391 的情況；重新整理也無法清除它，因為後端會回傳模型，而轉譯器的整理層將其捨棄。

providers:
  # The published reference documents `api` for a providers entry.
  local-ollama:
    api: http://127.0.0.1:11434/v1
    # No key for local Ollama. Discovery is on by default; turn it off and
    # hand-write the list when the probe is the thing that is failing.
    discover_models: false
    models:
      - qwen3-coder:30b

model:
  default: qwen3-coder:30b
  provider: custom:local-ollama

有一項設定細節反覆讓人困惑，值得在此釐清。參考文件將 api 記錄為 providers: 項目的基礎 URL 金鑰，且該項目的欄位清單將 base_url 與 url 列為它可接受的別名；base_url 則是頂層 model: 對映中的另一個金鑰。文件也記錄，較舊的設定使用頂層 custom_providers: 清單，其中使用 base_url 而非 api；這種寫法仍可運作，並會在設定版本 v12 的 hermes update 中自動遷移。追蹤器中的錯誤報告兩種寫法都有，這正符合兩者都會被讀取的情況。因此，未生效的 providers: 項目不太可能是因為此金鑰名稱錯誤；請檢查端點及該項目的其他欄位。

另一項值得明確指出的細節是：Ollama 自己的 Hermes 頁面將設定提示寫成「Context length in tokens [leave blank for auto-detect]」，而Hermes 的提供者文件要求代理程式至少使用 64,000 tokens，並說明若本機端點提供的視窗較小，啟動時就會被拒絕。兩者均於 2026 年 9 月 21 日檢查。將欄位留白本身沒有錯，但對只提供小型視窗的伺服器不起作用；因此請在伺服器上提高視窗大小，或將其固定在 Hermes 設定中以符合 Hermes 的數值，並記住，此故障會在啟動時拒絕並指出所提供的視窗大小，而不是造成選擇器列遺失。

驗證後，再決定本機部署是否值得

變更後依序進行三件事：在不使用 --refresh 的情況下重新開啟選擇器，並確認模型在冷啟動時列出；選取該模型；傳送一個有界限的請求並取得完成結果。中間這一步很重要，因為只有在探測後立即正確的清單，正是快取錯誤的特徵，而不是修正結果。以上是供你執行的指示；撰寫本頁時未執行 Hermes 安裝、Ollama 執行個體或選擇器。

如果結論是對這項工作而言，本機部署不值得費心，那麼費用問題可以清楚分成兩部分：軟體的費用，以及模型使用的費用。

Ollama Cloud 的 Pro 方案也列為每年 $200，按年計費；其方案包含每月使用額度 — Pro 為 $60、Max 為 $300、Team 共用 $1,000。這些屬於雲端產品，不是你正在修復的本機端點。

至於按量計費的路徑，以下是說明性的 token 算術，不是實際測得的工作成本，也不是帳單上限。假設一個工作階段傳送 200,000 個未快取的輸入 token，並接收 12,000 個輸出 token，沒有快取讀取，也沒有外部工具費用。費率是目前Kunavo 目錄中每百萬 token 的價格。

在將其視為預算前，請依你每天實際使用的工作階段數量換算；並注意，列出的最低費率與完成工作的最低成本是不同的說法——需要嘗試三次的低價模型，成本可能高於只需一次的模型。Kunavo 目錄金額是計費底線，而非上限：上游回報費用時，帳單金額取目錄成本與上游成本乘以適用加成兩者中的較高者。請參閱 計費詳細資訊。

哪條路徑更合適取決於工作內容。本機 Ollama適合小型、私密或離線工作，不收取每次請求費用，真正的限制是硬體與 64,000 token 的最低要求。當你主要使用某家供應商的旗艦模型，並希望使用其自有的快取與批次方案時，直接供應商 API更合適。當你會依工作切換模型，並希望使用一把金鑰與一個餘額時，閘道更合適。當固定費率的高頻每日使用比按 token 計費更適合你時，訂閱更合適。

將 Hermes 指向其他位置

如果你決定在本機端點旁新增託管端點，機制與一般自訂提供者流程相同；但在嘗試前，有一項界線值得了解：新增提供者必須在 hermes model 中執行，且在工作階段之外進行，因為工作階段內的 /model 只能在已設定的提供者之間切換，不能新增提供者或接受金鑰。Hermes Agent 自訂 API詳細說明項目格式、傳輸方式與回復操作；Hermes Agent 定價說明四項獨立費用。Kunavo 發布的是設定參考，而非相容性測試：本次工作從未對 Kunavo 端點進行 Hermes 執行時測試，因此本文沒有證明 Hermes 能成功對其進行探索。在嘗試時請保留目前可運作的路徑。Ollama 的 OpenAI 相容 API說明相同的用戶端程式碼為何能連接兩者；若要為金鑰儲值，請建立 Kunavo 帳戶。

還在選擇用戶端，而不是除錯其中一個？Hermes Agent 替代方案與OpenAI 相容 API涵蓋更廣泛的選項。

常見問題

2026 年 9 月 21 日檢查的內容與方式如下：問題與提取要求的狀態、兩項修正的標籤包含關係、最新發布標籤，以及儲存庫的授權與封存狀態，均來自 GitHub API；快取常數、探索條件、桌面可見性儲存區、--refresh 說明字串與文件引文，均從標籤 v2026.9.21 的原始碼讀取；Ollama 定價頁面、Ollama 自己的 Hermes 整合頁面及 Nous Portal 方案清單也於同日取得。未檢查的內容：你安裝的 pip、Homebrew、容器或桌面自動更新套件是否包含任一修正。本頁沒有進行任何執行時測試——未執行 Hermes 安裝、未啟動 Ollama，也未開啟選擇器。Kunavo token 費率來自即時目錄，美元範例是說明性的 token 算術，而非實際測得的工作成本。