Codex 皮肤故障排查

排查时先看当前本地状态，不要从旧 Codex 对话开始推断。之前的 Apply 可能完成、失败或中断，但当前窗口已经处于另一种状态。Status Skill 会提供下一步真正可以使用的本地事实。

先查看当前状态

让 Codex Skin 读取本地 Status：

Codex Skin，请显示本地主题状态

Status 不会访问网络，可以报告：

本地是否存在设备引用
是否有 pending 的六位主题 ID
最近一次完成可见验证并提交的主题包
当前有限重启的 kind、status 与稳定错误码

这些字段不能扩大解释。deviceLinked: true 不代表当前网站会话或 Pro 访问权有效。appliedThemePublicId 记录上一次通过可见验证的操作，不能证明完全退出后新建的 renderer 仍有皮肤。

不同 restart state 也不能混在一起：

状态	含义
`pending_confirmation`	用户还没有批准受控重载
`restart_approved`	已经批准，但最终主题尚未验证
`running`	一次性 Helper 正在工作
`completed`	重启事务达到终止成功，还要核对对应 ID 或 `restartKind`
`failed`	报告当前稳定 `restartErrorCode`，再采取对应动作

当前按需设计没有 runtimeStatus，也没有 session keeper。

插件安装问题

先确认安装列表中恰好有一个 codex-skin@codex-skin 条目，并且 installed: true、enabled: true：

codex plugin list --json

然后完全退出 Codex，重新打开并新建任务，再运行：

$codex-skin-version

当前 Production Paid Alpha 应该显示 Plugin 0.1.0-paid-alpha、Helper .17、Bootstrap .16 与 https://codexskin.ai。发布渠道是 GitHub prerelease，并非 stable/latest。

Marketplace add、upgrade 或 Plugin add 失败时，请保留仍然可用的插件，并保存失败命令与原始报错。不要编辑 Codex 配置，也不要删除 Marketplace 与插件 cache。插件说明提供了唯一一条可逆 Marketplace 刷新路径。

Apply 或 Switch 仍在运行

一般 Apply 或 Switch 需要 20–60 秒。期间不要在当前 Codex 窗口点击、输入、导航或关闭窗口。操作打开的浏览器授权页或 Pricing 页面可以使用。

不要因为暂时没有新消息就再提交一次。如果不小心碰了 Codex 窗口，请让原命令继续。长时间操作在状态变化前最多提醒一次，不应该引导第二次提交。

受控重载已经批准或正在运行时，竞争请求可能返回 CS-FLOW-RESTART-002。请等待当前事务结束，再读取 Status。

授权与 Pro 访问错误

CS-FLOW-AUTH-001 表示受保护设备授权没有完成。请在 Codex Skin 官方页面完成或重试批准。原请求会保留六位 ID，不要换一个 ID 来尝试修复授权。

CS-FLOW-ACCESS-001 表示 Pro 访问权没有在有限等待内就绪。请完成购买，或核对当前账户与访问状态。callback 页面、可编辑本地文件或 cache 包都不能证明 Pro 访问权。

Free 与 Pro 主题包都需要经过授权的插件设备才能下载，Pro 主题另外增加访问检查。Pro 访问说明负责到期、退款与重新应用规则，Pricing仍是价格事实源。

重启状态

CS-FLOW-RESTART-001 且 action 为 confirm_restart 时，表示操作正在请求明确同意，并不是修改后失败。请回答 yes 或 no。没有 yes 之前不要继续，也不要重复 launch。

批准后，一次性 Helper 会负责准确关闭、重新打开、Apply 或 Restore、可见验证与清理。restartAccepted: true、restart_approved 和 running 都不代表成功。

Codex 返回后请查看 Status。状态仍是 running 时，短暂等待后再查，最长不要超过 60 秒。Apply 或 Switch 需要 completed 以及匹配的公开 ID 与版本；Restore 需要 restartKind: restore 和 restartStatus: completed。

主题 ID 或主题包问题

确认请求中只有一个从主题图库复制的已发布六位 ID。不要用名称代替 ID，不要猜编号，也不要提供本地包或下载 URL。

下载与验证发生在提交前。签名、hash、schema、路径、内容类型、大小或平台不一致时，主题包会被停止，不会以半应用状态继续。请保留当前操作返回的稳定代码，报告时不要附上私有 URL、存储 key 或本地包路径。

图库已经不再展示该 ID 时，请回到图库选择已发布主题。如果 ID 仍在公开目录，但主题包持续失败，请停止重复尝试并报告当前代码。

验证与回滚

CS-FLOW-VERIFY-001 表示一次性 Helper 无法证明目标主题已经到达最终 renderer 状态。已经下载或局部可见的主题都不能当作成功。

请读取当前 Status。当前状态没有报告 rollback 问题时，可以在原操作结束后重试一次。不要拿旧对话里引用的错误码推断现在的状态。

CS-FLOW-ROLLBACK-001 表示当前事务无法确认安全回滚。再次 Apply 或 Switch 前，请使用权威 Restore 指南。不要手动删除 marker、状态或恢复文件。

Codex 更新后

完全退出、电脑重启、renderer reload 或 Codex 更新，都可能结束可见保证，不代表之前的主题包一定损坏。打开 Codex 后，可以再次请求原主题。

新 Apply 前，Helper 会核对官方身份、loopback 控制、所需 renderer 结构、能力与最终 marker。更新导致固定合同缺失或有歧义时，新操作会安全停止。项目没有 Guardian 或后台自动修复服务去猜测已经变化的界面。

请保留恢复点。即使新的 Apply 无法证明兼容，仍然可以使用 Restore。安全与兼容解释了 compatibility stop 与普通 Codex 故障的区别。

恢复问题

优先使用普通插件请求：

Codex Skin，请恢复 Codex 官方外观

插件路径不可用时，请使用文档列出的 macOS 或 Windows 固定离线入口，不要换成来源不明的 Helper。

Restore 请求一次受控重载时，请明确回答 yes 或 no，并且只启动一次。Restore 或 continuation 返回稳定失败码后，请报告代码并停止，不要删除状态、恢复文件、离线入口或插件 cache。

安全分享诊断信息

安装或 Marketplace 报告可以包含下面三条命令的结果：

codex --version
codex plugin marketplace list
codex plugin list --json

同时保留失败命令与原始报错，不需要报告的 device ID 应该移除或避免展示。

不要分享 Token、Cookie、账户或付款数据、提示词、对话、源码、项目文件、截图、本地绝对路径、operation journal 或恢复内容。不含私密信息且可以复现的插件问题，可以提交到公开 GitHub 仓库；账户或订单问题请使用联系页面。

错误码与下一步

当前代码或状态	下一步
`CS-FLOW-AUTH-001`	完成或重试设备授权
`CS-FLOW-ACCESS-001`	完成购买或核对当前 Pro 访问，不要重复主题请求
`CS-FLOW-RESTART-001`	回答一次明确重启问题，只有 yes 后才继续
`CS-FLOW-RESTART-002`	等待已经批准或正在运行的事务结束
`CS-FLOW-VERIFY-001`	先查 Status，原操作结束且没有 rollback 问题时才重试
`CS-FLOW-ROLLBACK-001`	再次 Apply 或 Switch 前先 Restore
Restore failure	报告当前稳定代码并停止，不删除恢复文件