当前支持范围
Apple Silicon 已验证，Intel 尚未测试。
首个验证基线为 arm64 架构、macOS 26.3.2、Codex 26.707.72221（build 5307）。环境不符合下方检查时，请停止安装。
01
开始之前
请使用 macOS 上的官方 Codex Desktop，至少启动过一次，并确认你能识别官方应用及上游工具将创建的本地文件。
官方应用
预期 Bundle ID 为 com.openai.codex。重新打包或改名的应用不在已验证边界内。
Apple Silicon
首发基线是 arm64。Intel Mac 仍明确标记为未测试。
Codex 已初始化
先正常打开一次 Codex，让应用在安装主题引擎前建立本地配置。
明确恢复路径
启用本地 CDP 前，先确认 Restore 启动器位置，并关闭敏感工作。
02
使用 Codex 辅助安装
主题详情页会生成固定提示词，让 Codex 检查本机并引导执行上游流程。它不是深链，本身不会自动执行任何操作。
- 01选择一个已验证主题，复制其“使用 Codex 安装”提示词。
- 02让 Codex 检查操作系统、架构、官方 Bundle ID、Codex 版本和预期路径。
- 03批准前逐条审阅命令。提示词会固定一个上游 commit，并明确禁止 curl 管道直连 shell。
- 04把主题背景下载到临时文件，并将其 SHA-256 与主题页上的值对比。
- 05应用主题，运行上游 Verify 启动器，并确认 Restore 启动器位置后，才算完成安装。
03
手动安装
如果偏好直接操作，请按固定上游 commit 的 macOS README 执行。DreamSkin Studio 不镜像安装器、不托管可执行 ZIP，也不复制上游引擎。
- 完成上游安装后的预期引擎路径
- ~/.codex/codex-dream-skin-studio
- 状态、日志、图片与备份的预期路径
- ~/Library/Application Support/CodexDreamSkinStudio
04
停止条件
安全检查失败时不要绕过。出现以下任一情况，都应停止并先查清差异。
身份不匹配
应用 Bundle ID、签名、Team ID、架构或内置 Node 不符合上游预期。
来源没有固定
命令指向持续变化的 main 分支，而不是本网站标明的固定 commit。
校验和不一致
下载背景图的 SHA-256 与 ThemeRecord 中记录的值不一致。
操作越界
任何步骤试图修改 API Key、Base URL、模型服务商、代理、账号或无关 Codex 设置。
05
主题安装只处理外观
安装主题绝不能顺便配置 HiAPI 或其他模型服务商。API 设置是另一条可选流程，需要单独审阅和授权。