给 Codex 桌面端换主题，常见做法是覆盖 app.asar、替换安装目录资源，或者直接用一张带 UI 的截图铺满窗口。这些方案不仅容易在升级后失效，还可能破坏签名、遮挡原生控件，甚至导致客户端异常。
Codex Dream Skin 采用另一种思路：通过本机 CDP（Chrome DevTools Protocol）在 Codex 启动后动态注入 CSS 和背景层，不修改官方安装包，让侧栏、卡片、项目选择、输入框和快捷键继续使用原生逻辑。
.app、app.asar 或 WindowsApps，但仍依赖 Codex 当前界面结构，客户端大改版后可能需要更新主题脚本。它与普通“贴图换肤”有什么不同？
Codex Dream Skin 并不是把一张完整效果图覆盖到窗口上。真正的实现是把背景和视觉样式插入原有界面，让功能组件继续保持可交互：
- 顶部或全窗背景使用独立图片资源。
- 建议卡片仍然是 Codex 原生组件，可以正常点击。
- “选择项目”区域保持官方控件和展开逻辑。
- 输入框仍可正常输入，快捷键与任务操作不受贴图遮挡。
- 首页强化氛围，任务页可降低背景干扰。
不覆盖 app.asar、官方资源和代码签名。
界面组件仍由 Codex 自身渲染和响应。
停止注入或运行恢复脚本即可回到官方外观。
换肤原理：通过本机 CDP 动态注入
工作流程可以概括为：
启动 Codex
↓
启动 Codex Dream Skin
↓
连接本机 127.0.0.1 的 CDP
↓
动态注入 CSS 与背景层
↓
完成主题化因为没有直接改动官方文件，Codex 更新后通常只需要重新启动 Dream Skin 进行注入；如果界面 DOM 或组件类名发生变化，则需要等待项目更新兼容。
下载前先确认完整目录
不要只复制 CSS 或 Banner 图片。Windows 与 macOS 的脚本、资源和配置分平台组织，必须保留对应目录的完整结构。当前仓库大致包含：
Codex-Dream-Skin/
├── docs/
├── macos/
│ ├── scripts/
│ ├── presets/
│ └── README.md
├── windows/
│ ├── scripts/
│ ├── assets/
│ └── SKILL.md
└── README.md项目地址：Fei-Away/Codex-Dream-Skin GitHub。建议从仓库主页阅读当前安装说明，不要从来源不明的网盘获取改版脚本。
Windows 安装与启动
下载或克隆完整仓库后，在项目根目录打开 PowerShell。首次安装：
powershell -ExecutionPolicy Bypass -File .windowsscriptsinstall-dream-skin.ps1安装完成后启动主题：
powershell -ExecutionPolicy Bypass -File .windowsscriptsstart-dream-skin.ps1当前项目提供系统托盘和本地主题仓库，可在保存的主题之间切换，也能导入自己的纯背景图。
macOS 安装与切换
macOS 同时支持 Apple Silicon 与 Intel Mac。进入仓库的 macos 目录后运行：
cd macos
./scripts/install-dream-skin-macos.sh --no-launch安装后可通过脚本切换预设主题，例如：
~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh
--id preset-romantic-rose也可以按仓库说明双击 Install Codex Dream Skin.command 完成图形化安装。首次运行若被系统拦截，应核对脚本来源和内容后，在系统安全设置中处理，而不是盲目关闭所有安全保护。
如何恢复官方界面？
Windows 版可使用仓库内的恢复脚本：
powershell -ExecutionPolicy Bypass -File .windowsscriptsrestore-dream-skin.ps1macOS 则使用项目提供的 Restore/卸载入口。恢复过程的目标是停止注入并清理主题启动项，不需要重新安装 Codex。实际脚本名称以当前仓库对应平台文档为准。
背景图片怎么准备？
项目推荐使用接近 16:9 的纯背景图，并根据安全区、焦点位置和浅色/暗色模式调整。仓库中的概念效果图包含真实 UI，只能作为视觉方向参考，不能直接当作背景导入，否则会再次出现“假界面覆盖真界面”的问题。
- 优先使用无 UI、无文字按钮的纯背景图。
- 常用分辨率可准备为 2560×1440，再由主题工具适配窗口。
- 人物主体不要压住输入框、项目列表和侧栏。
- 分别检查浅色与暗色模式下的文字对比度。
- 公开发布主题前确认人物肖像、IP、字体和图片素材权利。
CDP 注入的安全边界
“不改 app.asar”不等于完全没有风险。CDP 允许外部程序检查和控制 Chromium/Electron 页面，因此必须限制在本机回环地址，并避免主题运行期间启动来历不明的本地程序。
127.0.0.1，不要暴露到局域网或公网；安装前阅读 PowerShell/Shell 脚本；不要使用要求输入 OpenAI API Key、账号密码或修改模型 Base URL 的“换肤包”。官方仓库明确说明换肤与模型供应商配置相互独立。升级 Codex 后主题失效怎么办？
- 先恢复官方外观，确认 Codex 本身能正常启动。
- 拉取 Dream Skin 最新代码，查看 Issue 和平台说明。
- 重新运行安装或启动脚本，让主题再次注入。
- 若控件错位，停止注入并等待兼容更新，不要直接修改官方资源。
- 提交问题时注明系统、Codex 版本、主题版本和可复现步骤。
适合谁使用？
这套工具适合长时间使用 Codex 桌面端、希望改善视觉氛围，又不想反复覆盖官方文件的用户。准备了解 Codex 本身，可查看 Codex 站内工具页；第一次使用新版桌面端，可阅读 新版 ChatGPT Codex 完全新手教程；关心权限、额度与改版争议，可继续看 ChatGPT Codex 改版与额度分析。
总结
Codex Dream Skin 的价值，不只是让界面更好看，而是把主题层与官方客户端文件分离。背景、配色和布局可以改变，Codex 的项目选择、输入框、任务操作和快捷键仍然保留。
安装时务必保留完整仓库，按 Windows 或 macOS 文档执行，不要只复制 CSS 和效果图。先验证恢复，再长期使用；官方客户端大版本更新后，也应先确认兼容性。
说明：Codex Dream Skin 是第三方开源项目，并非 OpenAI 官方产品。功能、命令和兼容性可能随仓库更新变化；主题素材的肖像、IP、字体和商用权利由使用者自行确认。
