为什么 Hermes 的模型列表只显示部分模型？

说明 Hermes 模型选择器每个 Provider 的 50 条上限，以及如何通过完整模型 ID 切换列表之外的模型。

​

简短回答

在本次核对的 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 和同一份目录。

​

先分清三种数量

入口	表示什么
/v1/models 或 provider_models_cache.json	API 返回或 Hermes 缓存的模型 ID 数量
Hermes Desktop / /model 选择器	每个 Provider 最多展示 50 个模型 ID
/model <模型 ID>	按完整名称切换当前会话模型，不要求该 ID 出现在前 50 项

​

排查步骤

1. 核对 Provider 行：openai-api、openai 和 openrouter 是不同 Provider 项；上限按 Provider 分别计算。先确认 Desktop 与终端比较的是同一行，而不是把一个 Provider 的可选数与另一个的目录总数相比。
2. 列表里找不到时直接输入模型 ID：在会话中使用 /model gpt-5.5，或用 hermes chat --model gpt-5.5 启动。把 gpt-5.5 换成 API 端点实际返回的完整模型 ID；如果需要，按 Hermes 支持的 Provider 前缀格式指定 Provider。
3. 设置默认模型并复核：可用 hermes config set model.default gemini-3.8-flash 设置默认模型，然后运行 hermes config show 确认值已写到正确字段。hermes config set 不会替模型名做可用性验证；拼错后仍要通过真实请求确认。
4. 区分列表上限与模型调用失败：选择器显示 50 项只能说明菜单截断，不能证明第 51 项以后全部可用。对选中的完整模型 ID 发起最小请求，并在 API易调用日志中检查请求是否到达、状态码和错误信息。

当前没有可在 config.yaml 中调整的 50 项上限。若同一 Hermes 版本、Profile、Provider 和缓存下，Desktop 与终端菜单仍返回不同数量，记录两边的 Provider 名、完整模型 ID、Hermes 后端版本和调用日志，再进一步定位。提交日志前请移除 API Key。

​

相关文档

• Hermes Agent 接入 API易
• 如何选择合适的 AI 模型？
• 为什么有些模型我用不了？
• 如何查看我的调用记录？

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。