用六位 ID 应用 Codex 皮肤
复制已发布主题的六位 ID，完成设备授权，并确认目标皮肤已在当前 Codex 窗口通过可见验证
这份指南从插件已经安装完成的状态开始，跟随一笔主题请求走到当前窗口验证成功。如果还没有安装插件，请先看快速开始。
应用前准备
你需要一台受支持的 macOS 或 Windows 电脑、当前 Codex Skin 插件，以及一个真实的六位主题 ID。请从主题图库或主题详情页复制 ID，不要猜编号，也不要提供下载链接、本地包路径、CSS 或命令片段。
Free 与 Pro 主题使用同一种 ID 和校验流程。Pro 主题还需要当前有效的 Pro 访问权，这部分由 Pro 访问说明负责，不在这里重复价格与账户规则。
复制主题 ID
六位 ID 会让图库条目、签名主题包和最终可见结果指向同一套主题。例如，Ember Dune 是已经发布的 Free 主题，ID 为 100002。
复制时请保留完整六位数字。Codex Skin 不会根据主题名称猜测 ID，也不会接受用户自己提供的主题包。
只提交一次 Apply 请求
打开一个普通 Codex 任务，并在请求中写明 ID：
Codex Skin，请应用主题 100002插件会调用专用 Apply Skill，再把 ID 作为独立参数交给固定的平台 wrapper。你不需要自己拼 Helper 命令。
一般应用或切换需要 20–60 秒。在 Codex 明确显示成功或失败前，不要在当前 Codex 窗口点击、输入、导航或关闭窗口。如果操作打开了浏览器授权页或 Pricing 页面，可以在那个浏览器页面操作。不要再次提交 Apply 请求。
如果不小心碰了当前 Codex 窗口，请让原操作继续，不要再发一次。第二笔请求不会修复第一笔，还可能遇到已经批准或正在运行的事务。
设备授权与 Pro 访问
第一次执行受保护操作时，系统可能会打开 Codex Skin 浏览器页面。请在页面中登录并批准显示的电脑，然后回到原来的 Codex 任务。原事务会保留原主题 ID 并自动继续。
授权完成后不需要重复提示词。授权被取消、过期或返回 CS-FLOW-AUTH-001 时，请在 Codex Skin 官方页面完成或重试授权。
如果当前账户没有 Pro 访问权，Pro 主题可能打开 Pricing。有限等待结束并返回 CS-FLOW-ACCESS-001 时，请完成购买或核对当前访问状态，再按照 Codex Skin 显示的动作继续。第一笔事务仍在运行时不要新建第二笔请求。
Helper 会先核对什么
一次性 Helper 在修改当前 Codex 界面前，会按照下面的顺序执行：
validate -> stage -> backup -> apply -> verify -> commit校验范围包括官方 Codex 身份、仅限 loopback 的本地控制连接、签名 descriptor、主题包 hash 与内容白名单，以及当前 renderer 是否具备所需能力。主题包只包含声明过的结构化数据与本地图片，不能携带 CSS、JavaScript、Shell、PowerShell、selector 或远程执行 URL。
第一次 Apply 前，Helper 会把原生 system、light 或 dark 选择以及相关代码主题设置保存在可替换插件 cache 之外。深色皮肤使用原生 dark，浅色皮肤使用原生 light。这份恢复点会一直留给 Restore。
如果无法确认官方身份、主题包或所需界面能力，操作会停止，不会猜测。完整边界可以查看安全与兼容。
需要确认一次重启时
有些路径需要让当前 Codex 使用同一个 profile 关闭并重新打开一次。此时 Codex Skin 会返回 CS-FLOW-RESTART-001，并在继续前让你明确回答 yes 或 no。
回答 yes 只是允许同一笔签名 Helper 事务继续，不代表主题已经成功。不要再次 Apply、重复授权或重新提交 ID。
macOS 的受信任窗口在深浅模式切换时，会优先使用已经验证的应用内 Appearance 路径。如果固定界面合同在修改前不可用，才回退到一次经过确认的受控重载。Windows 跨模式切换使用一次确认的受控重载。同一深浅模式内的可信替换不需要重写原生外观，也不需要重启。
Codex 重新打开后，新建或恢复一个任务并查看本地状态：
Codex Skin，请显示本地主题状态如果 restartStatus 仍是 running，短暂等待后再查一次，最长不要超过 60 秒。restart_approved 与 running 都是中间状态。
确认当前窗口的结果
只有目标皮肤已经在当前 renderer 可见，并且公开 ID 与版本和本次请求一致，Codex Skin 才会报告成功。
不需要重启时，结果必须同时包含 ok: true、请求的 themePublicId、themeVersion 与 operationId。经过重启的路径必须显示 restartStatus: completed，并且应用的 ID 与版本一致。
下面这些都不能单独证明成功：
- 主题包已经成为 desired 或完成下载
- 浏览器授权已经结束
- 已经同意重启
- Helper 仍在运行
- 另一个 renderer 中的旧 Apply 曾经成功
有限事务完成验证与提交后，Helper 会退出。它不会变成 controller、Guardian、heartbeat、托盘应用或后台自动修复服务。
Apply 结束后
可见保证只属于当前 Codex 窗口。完全退出 Codex、重启电脑或之后的 renderer reload 会结束这份保证。下次想继续使用，请再次通过 Codex Skin 应用主题。
本地 Status 会保存最近一次完成可见验证并提交的操作。它能告诉你上次应用的是哪一套主题，但不能证明后来新建的 renderer 仍然保持皮肤。
想直接换另一套已发布主题，不需要先恢复官方外观，可以继续看切换主题。
Apply 停止时怎么处理
保留原始稳定代码，并采取对应动作：
| 结果 | 下一步 |
|---|---|
CS-FLOW-AUTH-001 | 在 Codex Skin 官方页面完成或重试设备授权 |
CS-FLOW-ACCESS-001 | 完成 Pro 访问步骤或核对当前访问状态，不要重复请求 |
CS-FLOW-VERIFY-001 | Helper 无法证明最终 renderer 状态；先查 Status，如果当前没有 rollback 问题，再重试原 Apply |
CS-FLOW-ROLLBACK-001 | 当前回滚没有得到确认；先使用权威 Restore 路径，不要开始新 Apply |
CS-FLOW-RESTART-002 | 另一笔已批准或运行中的事务正在占用窗口，请等待它结束 |
不要根据旧对话判断现在必须 Restore。先读取当前本地 Status。历史失败不会阻止新 Apply，除非当前状态明确报告回滚没有确认。
如果遇到主题包、安装或状态读取问题，请进入故障排查。不要删除恢复文件或插件 cache。
常见问题
浏览器授权后需要再发一次请求吗？
不需要。回到同一个任务，让原事务继续使用原来的 ID。
主题包下载完成就算应用成功吗？
不算。只有目标主题在当前窗口完成准确的可见验证，Codex Skin 才会报告成功。
为什么 Codex 有时需要关闭并重新打开？
当前能力或原生外观变化可能需要使用同一个 profile 完成一次受控重载。Codex Skin 会在操作前征求明确同意，并在 Codex 返回后验证最终结果。