模型排序

Codex 模型选择器不会保留 opencodex 配置中 provider 的声明顺序或模型数组顺序。最终顺序由目录 priority 决定；priority 相同的路由模型则使用确定性的字母顺序。

Codex 应用的规则

Codex 的 models-manager 按 priority 升序排列选择器中可见的目录条目。目录数组本身的顺序会被 丢弃，因此在生成的 JSON 数组中把某个条目前移，并不会让它在选择器中前移。该约束直接记录在 src/codex/catalog.ts:881-884 中。

因此，opencodex 通过分配更低的 priority 控制置顶位置，而不依赖数组位置。相关 priority 如下：

目录条目	Priority	来源
subagentModels[i]	i（0 至 4）	src/codex/catalog.ts:885-896 中的 featured rank map
其他路由模型	5	src/codex/catalog.ts:892-896 中创建路由条目的逻辑
默认原生 GPT slug	9	src/codex/catalog.ts:887-890 中创建原生条目的逻辑
存在 featured 列表时未选中的原生模型	至少为 featured.length + 100	src/codex/catalog.ts:1348-1355 中合并原生目录的逻辑

管理 API 在 src/server/management-api.ts:626-634 中使用 slice(0, 5)，把 subagentModels 限制为最多五项。这与 Codex spawn_agent 界面只公布前五个模型 override 的行为 一致。五项之外的模型仍可继续显示在主选择器中，也可通过精确 id 调用。

Priority 相同时如何排序

所有普通路由模型的 priority 都是 5，因此需要处理并列顺序。在创建目录条目之前， gatherRoutedModels() 会先按 provider 名称、再按模型 id 对路由模型列表进行字母排序 （src/codex/catalog.ts:1241-1270）。

因此，以下配置顺序不会影响最终顺序：

• providers 对象中各 key 的声明顺序；
• 每个 provider 的 models 数组中各 id 的排列顺序。

随后，orderForSubagents() 使用稳定排序，把 featured 模型按 subagentModels 中的顺序移到最前。 非 featured 模型会保持之前确定的 provider/id 字母相对顺序 （src/codex/catalog.ts:1307-1321）。创建条目时，featured rank 还会转换为 0 至 4 的 priority，因此 Codex 的 priority 排序会保留这个开头序列。

可见性与排序彼此独立

selectedModels 和 disabledModels 只决定暴露哪些路由模型，不控制排序。 filterCatalogVisibleModels() 会把两类选择转换为 Set 查询，并在不把数组当作 rank 的情况下过滤 已收集的列表（src/codex/catalog.ts:1216-1237）。

因此，调整 selectedModels 或 disabledModels 的数组顺序不会改变模型在选择器中的位置，只会 影响模型是否包含在内。

最终选择器顺序

featured 列表非空时，最终顺序为：

1. 严格按照配置的 subagentModels 顺序排列，priority 为 0 至 4；
2. 所有剩余路由模型，先按 provider、再按模型 id 的字母顺序排列，priority 为 5；
3. 在目录合并过程中被移到 featured 区块之后的未选中原生模型。

如果没有 subagentModels，路由模型保持 priority 5，原生 GPT 条目使用正常 priority （opencodex 创建的条目通常为 9），路由组内部仍按 provider/id 字母排序。

示例

假设 subagentModels 按以下顺序包含五个 id：

subagentModels = [
  "gpt-5.5",
  "opencode-go/glm-5.2",
  "anthropic/claude-opus-4-6",
  "gpt-5.6-sol",
  "gpt-5.6-terra",
]

选择器开头的实际顺序如下：

选择器位置	模型	Priority	出现在此处的原因
1	gpt-5.5	0	第一个 subagentModels 选择
2	opencode-go/glm-5.2	1	第二个选择，即使其 provider 在字母顺序上位于 anthropic 之后
3	anthropic/claude-opus-4-6	2	第三个选择
4	gpt-5.6-sol	3	第四个选择
5	gpt-5.6-terra	4	第五个选择
6	anthropic/claude-fable-5	5	剩余路由模型中按 provider/id 字母排序的第一项
第 7 项起	其余路由模型	5	先按 provider 字母排序，再按模型 id 字母排序
路由模型之后	其余原生模型	featured.length + 100 或更高	未选中的原生模型移到 featured 区块之后

前五个条目是向 spawn_agent 公布的 override，其余模型继续按普通选择器顺序排列。

更改顺序

自定义开头模型顺序的唯一受支持方式是重新排列 subagentModels。你可以在仪表盘的 Sub-agents 页面或 opencodex 配置中修改它。该列表最多接受五个模型，其数组顺序有实际意义。

目前 OcxConfig 中没有通用的 modelOrder、providerOrder 或 priority map 设置。受支持的排序 字段是 subagentModels（src/types.ts:238-246）；disabledModels 和各 provider 的 selectedModels 都是可见性字段（src/types.ts:276-282、src/types.ts:439-446）。因此，要更改 选择器其余部分的顺序，需要修改代码行为，而不是调整配置。