Codex 看不到 Spark：检查权限、配置与模型目录

面向仍在维护 Spark 模型菜单实验的高级用户。保留历史配置的识别方法，说明如何区分账户可用性、CLI 配置和桌面显示，不提供修改应用安装包的解锁步骤。

内容更新 2026-09-05

先看结论

模型名出现在本地目录，不等于账户获准调用；先核对接入方式，再用独立 CLI profile 观察，不为菜单显示修改 app.asar。

先判断你要验证哪一层

层次	可采用的证据	不能据此推断
账户与服务	当前接入方式、项目/Key 模型权限、公开规则	本地目录出现名称就一定获准调用
CLI 配置	实际 CLI 版本、选择的 profile、受支持的配置键	与桌面使用相同二进制或配置层
桌面显示	当前桌面版本和新会话中的模型入口	菜单文字等于实际调用模型及其能力
一次请求	预期短回复、服务侧脱敏请求/用量元信息	工具调用、长任务或图片也已通过验收

只查看必要配置，不收集凭据

在自己的设备上核对 model、model_provider、所选 profile 与 model_catalog_json 是否存在；需要查路径时只在本机查看。不要让 AI 读取整个 ~/.codex，也不要发送 auth.json 或原始配置。

model 是请求的模型标识；显示名不是另一个可互换的模型 ID。gpt-5.3-codex 与 gpt-5.3-codex-spark 不应混用。
model_catalog_json 是启动时读取的可选文件路径。使用明确的绝对路径可避免工作目录歧义，但路径正确不证明目录结构或权限正确。
旧材料中的 custom provider、gpt-5.6-sol 与 high 推理配置只用于识别历史设置，不作为当前模型或强度推荐。

日常使用、CLI 实验与桌面显示分开

profile 是命名配置层，不是安全沙箱。它会与基础配置等层合并，已有凭据、规则和工具不因新文件自动隔离。

日常使用：从当前授权入口选择可用模型，不为保留旧型号牺牲可维护性。
CLI 实验：官方文档规定从 0.134.0 起，--profile spark 叠加 ~/.codex/spark.config.toml，文件内用顶层配置键，不再读取 config.toml 内的旧 [profiles.spark] 表。旧版本必须查看对应版本说明。
桌面显示：不要假定 CLI --profile 自动控制桌面菜单；CLI 实验通过后，桌面仍需单独核对支持方式。

不要用简化 JSON 覆盖完整模型目录

官方 ModelInfo 结构除了 slug 和显示名，还包含执行与能力元数据。仅有一个 models 数组、几个名称和可见性字段的示例，不能当成可加载的完整目录。不要从另一型号复制工具能力或推理强度来凑字段。

已有经过版本核对的完整目录：先在本地保留原件；目标 slug 若已存在，不重复追加。
需要合并时只能使用与客户端版本匹配、来源明确的完整条目，并保持原有模型及必要元数据。没有这样的条目就停止合并。
验收先检查 JSON 语法、slug 唯一性和未丢模型，再用该版本客户端验证；语法检查只证明格式，不能证明功能。

字段	含义	审阅规则
slug / display_name	模型标识 / 展示名称	按来源原值保留，不用展示名代替请求 ID
visibility	目录中的可见性描述	不把改为 list 当成授权或桌面必显示的保证
supported_in_api	客户端的 API 支持元数据	不手改为 true 声称取得服务端权限
input_modalities	输入类型	Spark 按文本模型处理，不添加 image
supported_reasoning_levels	声明的推理强度选项	不照搬其他模型的 low/medium/high/xhigh

目录查询结果如何解释

codex debug models 属于实验性调试入口。--bundled 跳过刷新，适合区分“程序内置有什么”；不带该参数的命令可能刷新目录，不能冒充纯离线检查，也不要输出原始目录给他人。

纸面练习，以下为虚构观察，不是运行记录：
A：内置目录有 Spark；API 服务未确认该 Key 可用。
B：已获准的 CLI 请求返回 SPARK_OK；桌面菜单仍没有 Spark。
C：桌面有 Spark；请求返回 401。

参考判断：
A：只有本地元数据证据，停止调用与目录修改。
B：CLI 的最小请求通过；桌面显示问题尚未解决。
C：先查认证与请求目标，不修改菜单。

不要修改应用安装包来补模型入口

app.asar 是 Electron 应用内部资源；旧注入方式依赖应用结构并可能影响签名、更新和恢复。
本地补菜单不会改变服务端的授权、路由或计费。没有权限时应使用受支持的模型，而不是改变标志位。
研究已有第三方补丁时，先读 /article/codex-plusplus-tweak-system 的维护状态与恢复说明。

第三方兼容 API 的额外边界

1A1API 帮助页 /codex 明确针对 CLI，不含桌面定制，并标注其历史配置未记录客户端版本。页面中的根地址与认证文件写法只能作为该服务接入线索，不能推广成所有 Responses 客户端通用规则。

当前配置规则查看 https://help.1a1api.top/codex；模型说明入口 https://help.1a1api.top/models 仅作导航，实时可用性以所用服务的当前授权列表为准。
第三方服务的同名模型、路由与上游授权需要服务方证据；本地 supported_in_api 字段不能替代这些证据。
接入字段、路径和最小请求的主要说明放在 /article/1a1api-integration；不要在多个实验篇复制默认 provider 配置。

修改后怎样验收与恢复

先保存工作，结束当前实验会话；macOS 可通过应用菜单 Quit 正常退出，再从预期入口打开。其他系统用对应应用的退出入口，不套用 macOS 安装路径。
重新确认程序版本、认证类型和新会话配置。只看旧窗口中的名称不算 profile 或目录加载成功。
SPARK_OK 是最小文本请求的参考结果。仍需确认没有多余工具动作、没有错误，且服务侧元信息对应本次请求；文本本身不能证明第三方上游模型身份。
恢复日常配置时不选择 spark profile，并撤回本次新增引用；不要用旧整文件备份覆盖后来无关的配置变更。

官方依据与历史适用范围

Spark 发布与模型说明：https://openai.com/index/introducing-gpt-5-3-codex-spark/；https://learn.chatgpt.com/docs/models
配置与 profile：https://learn.chatgpt.com/docs/config-file/config-reference；https://learn.chatgpt.com/docs/config-file/config-advanced
CLI 调试、exec 与参数：https://learn.chatgpt.com/docs/developer-commands?surface=cli
模型元数据结构：https://raw.githubusercontent.com/openai/codex/main/codex-rs/protocol/src/openai_models.rs
历史注入机制与恢复风险（Codex++ 项目）：https://raw.githubusercontent.com/b-nnett/codex-plusplus/main/docs/ARCHITECTURE.md
认证路径：https://learn.chatgpt.com/docs/auth
本页讨论历史菜单实验。缺少对应客户端构建和完整目录时，不能直接复现当时桌面行为；当前 CLI 检查也不能证明历史桌面结果。

适合谁看

旧 Spark 配置还在，但不确定它对应哪种认证方式或客户端版本。
CLI 可以选择某模型，桌面菜单却没有同名选项。
希望恢复日常配置，同时保留可以复查的实验文件。

操作步骤

记录当前客户端名称、版本、操作系统和认证类型。只核对需要的配置键，不导出 auth.json、完整配置或日志；没有适用版本信息就先停止改文件。
确认授权路径：订阅登录看受支持的客户端模型入口；API 接入看该服务和当前项目/密钥支持的模型列表。普通 API /models 与 Codex 本地目录不是同一个接口契约，不能互相替代。
需要观察本地内置目录时，先看所装 CLI 的 debug models 帮助，再用 --bundled。它跳过刷新，只显示该二进制内置目录，不证明当前账户能调用，也不验收自定义目录已加载。
只有模型与接入权限已确认，才保存必要配置的本地备份，在受支持的 CLI 版本创建 spark.config.toml；不改全局默认、不覆盖原目录、不改认证方式。
决定发送最小请求前，人工确认费用、运行目录和现有 Hook/Skill/插件。read-only 限制模型生成命令的写入，不阻止读取或模型请求；提示词禁用工具也不是系统隔离。只用虚构短文本；出现不必要的审批时停止，不扩权完成测试。一次请求后检查结果与服务侧脱敏用量元信息，失败不循环重试。
CLI 可用而桌面仍不显示时，保留现状并查看桌面版本对应文档。恢复日常使用只需不选择实验 profile；不要通过修改 app.asar、伪装模型能力或绕过账户权限补菜单。

命令与示例

# 目录查询：在已有可信 Codex CLI 上逐条运行；不发送生成请求。
codex debug models --help
codex debug models --bundled

# CLI 配置文件示例：~/.codex/spark.config.toml
# 适用：官方文档所述 Codex 0.134.0 及以后 profile 文件规则。
# 先确认当前认证路径确实允许此历史型号；不改 provider 或凭据。
model = "gpt-5.3-codex-spark"

# 仅当已有经过版本核对的完整目录时，才启用下面一行。
# 此路径是 macOS 形式的占位示例；不是 Windows 路径。
# model_catalog_json = "/Users/EXAMPLE/.codex/model-catalogs/spark-enabled.json"

# 可选联网验证，会使用模型额度；不是目录查询。
# 先进入只含虚构资料的已审阅测试 Git 仓库，确认费用与现有扩展。
# 未确认权限、CLI 参数或 profile 版本时不要执行。
codex --ask-for-approval on-request exec --sandbox read-only --profile spark "Reply exactly SPARK_OK. Do not use tools."

需要解决的问题

目录里有 gpt-5.3-codex-spark，菜单没有；或菜单有，生成请求却失败。
修改用户配置后仍像在使用旧模型，无法区分配置未加载和旧会话状态。
看到 model_catalog_json 或 spark.config.toml，不知道它们是本地描述还是后端授权。

先理解这些

模型目录是客户端读取的能力描述，不是账户授权表。visibility、supported_in_api 等本地字段不能扩大服务端权限。
ChatGPT 登录、OpenAI API Key 和第三方兼容 API 是不同接入路径。一个路径支持某模型，不能推出另外两个也支持。
model_catalog_json 指定启动时读取的目录；CLI、桌面所用程序、配置层和会话可能不同。CLI 的一次结果不能证明桌面已加载相同配置。
Spark 在 OpenAI 模型页仍按文本研究预览模型介绍；不应把旧目录手改为 image 输入来虚构视觉能力。

遇到困难时

API 模型列表不含目标或服务方未确认支持：停下，不手改 supported_in_api=true 来继续；保留此前可用模型。
CLI 报 profile 或字段未知：对照实际版本文档处理；不要把新旧 profile 结构同时塞进配置碰运气。
JSON 解析通过但 Codex 拒绝目录：语法正确不代表符合该版本完整模型元数据结构；恢复原引用，不靠补几个猜测字段修复。
返回认证、路由或模型错误：按 /article/api-error-codes 分层排查；不继续修改菜单或无限重发。
曾修改 app.asar 且无法启动：保存工作后，从与应用版本匹配的可信备份恢复；没有可靠备份时重装官方客户端，不关闭系统安全检查。