模型清单¶

捆绑的清单 允许离线启动；从 main 获取它可以让模型元数据在版本之间发生变化。获取失败或数据无效时，会保留最后一份可用的清单。远程数据必须同时通过目录引用验证和所属提供方的适配器验证，才能替换缓存。

较新的捆绑包会依据 updatedAt 优先于缓存的远程清单，因此某个发行版可以在下一次成功获取之前修正模型数据。只要文件发生变化，就应更新 updatedAt。获取时间无法判断哪一份副本包含更新的编辑。

通用目录数据描述展示信息和能力。每个提供方拥有自己的适配器 schema 和分发映射。提供方从不直接读取清单本身：服务器通过 ModelCatalog 端口暴露每个驱动器的条目，兼容性策略保留在服务器端。Claude 使用该清单作为其整个内置目录。为已有能力配置文件的模型添加条目只需编辑 JSON；只有出现新的能力组合时才需要新建配置文件。Codex 仍从其应用服务器获取模型列表。

需要更新 provider CLI 的模型仍应在其发布时立即公布。Claude 条目设置 adapter.claudeCode.minVersion；Codex 条目设置 adapter.codex.minVersion，因为 Codex 自身的 model/list 无法列出安装版本之后发布的模型。快照会在 updateRequiredModels 中报告这些模型，选择器会告诉用户哪个更新可以解锁它们。

currentModels.claudeAgent 是用于早于目录发现的发行版的当前模型分类覆盖层；它不会向这些目录添加模型。支持目录的发行版改用 providers.claudeAgent.models[].status。Codex 使用 currentModels.codex 作为已发现模型的旧式分类覆盖层。

模型数据是经过 schema 验证的配置。测试应使用合成模型名称覆盖解析器、缓存和适配器语义，这样添加模型永远不需要编写重复配置的测试。