簡短回答
在本次核對的 Hermes 實現中,模型選擇器每個 Provider 最多顯示 50 個模型。這是傳給選擇器的資料上限,不是 API Key 的模型權限上限。API 端點或 Hermes 快取裡可以有更多模型 ID;超出列表上限的模型仍可嘗試通過完整模型 ID 選擇,但是否能成功呼叫要單獨測試。 選擇器把models 欄位擷取為 model_ids[:max_models],而 total_models 記錄截斷前的數量。因此 50 available 表示選單最多顯示 50 項,不表示 Provider 總共只有 50 個模型。
Hermes Desktop 與終端選擇器在同一後端、Profile、Provider 和模型目錄下應使用相同的選擇邏輯。因此,如果兩邊看到的數量不同,50 條上限解釋的是“選單少於完整目錄”,但還應確認比較的是同一個 Provider 和同一份目錄。
先分清三種數量
排查步驟
- 核對 Provider 行:
openai-api、openai和openrouter是不同 Provider 項;上限按 Provider 分別計算。先確認 Desktop 與終端比較的是同一行,而不是把一個 Provider 的可選數與另一個的目錄總數相比。 - 列表裡找不到時直接輸入模型 ID:在會話中使用
/model gpt-5.5,或用hermes chat --model gpt-5.5啟動。把gpt-5.5換成 API 端點實際返回的完整模型 ID;如果需要,按 Hermes 支援的 Provider 字首格式指定 Provider。 - 設定預設模型並複核:可用
hermes config set model.default gemini-3.8-flash設定預設模型,然後執行hermes config show確認值已寫到正確欄位。hermes config set不會替模型名做可用性驗證;拼錯後仍要通過真實請求確認。 - 區分列表上限與模型呼叫失敗:選擇器顯示 50 項只能說明選單截斷,不能證明第 51 項以後全部可用。對選中的完整模型 ID 發起最小請求,並在 API易呼叫日誌中檢查請求是否到達、狀態碼和錯誤資訊。
config.yaml 中調整的 50 項上限。若同一 Hermes 版本、Profile、Provider 和快取下,Desktop 與終端選單仍返回不同數量,記錄兩邊的 Provider 名、完整模型 ID、Hermes 後端版本和呼叫日誌,再進一步定位。提交日誌前請移除 API Key。
相關文件
Hermes 官方說明可參考:hermes-agent.nousresearch.com/docs/user-guide/desktop、hermes-agent.nousresearch.com/docs/user-guide/configuring-models、hermes-agent.nousresearch.com/docs/reference/model-catalog。