项目定位：Codex Dream Skin 是面向官方 Codex 桌面端的第三方开源主题工具，并非 OpenAI 官方产品。它通过本机 Chromium DevTools Protocol 会话注入视觉主题，不修改官方 .app、app.asar、WindowsApps 文件或代码签名。
主要能力：可为整个 Codex 窗口铺设连续背景，根据图片自动调整明暗、强调色、视觉焦点和安全区域，并支持保存、切换、暂停、验证及一键恢复主题。侧栏、项目选择、卡片和输入框仍是原生可交互控件，不是把界面截图覆盖到窗口上。
macOS 安装：先安装官方 Codex Desktop，并至少正常启动一次。下载或克隆仓库后进入 macos 目录，双击 Install Codex Dream Skin.command 即可安装；命令行方式为 ./scripts/install-dream-skin-macos.sh --no-launch。安装器会验证并使用 Codex 自带的签名 Node 运行时，不要求全局安装 Node.js。
macOS 使用与恢复：通过桌面的 Codex Dream Skin.command 启动或重新应用主题；需要换图时使用 Customize，检查状态时使用 Verify，恢复官方外观时使用 Restore。主题引擎安装在 ~/.codex/codex-dream-skin-studio，状态、日志、用户图片和备份位于 ~/Library/Application Support/CodexDreamSkinStudio。
Windows 安装：准备 Node.js 22 或更高版本并关闭 Codex。在仓库根目录依次运行 powershell -ExecutionPolicy Bypass -File .\windows\scripts\install-dream-skin.ps1 和 powershell -ExecutionPolicy Bypass -File .\windows\scripts\start-dream-skin.ps1，后续可使用安装器创建的快捷方式启动。验证使用 scripts\verify-dream-skin.ps1，恢复使用 scripts\restore-dream-skin.ps1。不要替换、接管或编辑 WindowsApps 内的文件。
背景图片要求：应使用无窗口框架、无侧栏、无卡片、无按钮、无可读文字、无 Logo 和无水印的纯背景图。建议母版为 2560 x 1440、16:9；左侧约一半区域保持安静和低对比，主体放在右侧且不要贴边。公开或商用前，需要自行确认人物肖像、商标、版权和再分发权利。
工作原理：启动器会发现并校验已安装的 Codex，只将 CDP 绑定到 127.0.0.1，并仅接受符合预期的 Codex 渲染目标，再注入可撤销的视觉层。一个本机注入进程会在导航和刷新后维持主题；执行 Restore 后会停止注入，并让 Codex 回到正常启动方式。
安全边界：CDP 权限较高，即使只监听本机回环地址，也没有同一用户下的独立认证。主题运行期间不要同时运行来路不明的本机程序；使用结束后建议执行 Restore 关闭调试会话。该项目不会修改 API Key、模型 Provider 或 Base URL。
适用人群：适合希望个性化 Codex 桌面端、并能够先审阅本机脚本的用户。如果设备受严格管理、无法审阅脚本，或必须保持完全原生客户端，建议继续使用官方外观。
项目与许可：安装前应查看仓库的平台说明、脚本、测试、MIT 许可证和 NOTICE。软件许可证不代表仓库内所有用户素材或第三方图片都可自由使用。项目地址：https://github.com/Fei-Away/Codex-Dream-Skin
把目标拆成输入、动作和输出，再逐步加入检查点。
保留示例、失败条件和复核标准，教程才真正可复用。