夜雨聆风想给 Codex 换皮肤，最怕把 App 改坏：这个 7k Star 项目给了条能还原的路
我见过最容易翻车的“桌面美化”，不是图不好看，而是教程上来就让你替换 app.asar。主题是换上了，下一次官方更新、签名校验或应用闪退，排查的人还是你。
GitHub 上的 Codex Dream Skin 最近涨到约 7k Star。它做的事很直白：把一张图变成 Codex Desktop 的整窗主题。但我觉得它值得装的原因不是壁纸，而是它没有去碰官方安装包，并且把 Verify 和 Restore 做成了桌面入口。
它不是 OpenAI 官方产品。下面的操作基于项目公开文档整理，没有在所有 macOS 版本上逐台验证；第一次安装请在不着急赶活的时候做。
它不是“拿截图糊满窗口”
这个项目通过本机回环地址的 CDP 给 Codex 渲染页面注入主题层。侧栏、项目选择、输入框和任务页仍是 Codex 原生控件，背景图只在它们下面。
这解释了两个实际体验差异：
首页可以把氛围做足，进入任务页后背景会变轻，代码和输入框不该被一张图抢走。 主题不改 .app、app.asar或代码签名；项目会校验官方 Codex，再只把调试端口绑到127.0.0.1。
真正让我放心的不是“本机 CDP”这四个字，而是它明确写了停止条件：Restore 只会在记录的 PID、可执行文件、脚本路径和启动时间都匹配时才停止注入器。主题工具有还原按钮不稀奇，还原时知道自己在停谁，才比较像能长期用的工具。
项目 README 里放的效果图，才是它在 GitHub 上最容易让人停下来的原因。粉色主题、财神主题、红白科幻，乍看像是把整个客户端重新设计了；但项目强调，侧栏、卡片和输入框仍是原生交互，变化的是整窗背景和配色。
这里有个容易误会的点：这些图是带完整界面的概念效果图，不是可直接丢进工具里的壁纸。想复刻类似感觉，应该按项目的背景规则生成一张没有窗口、没有侧栏、没有按钮的纯 16:9 图，再让主题层覆盖到原生 Codex 上。把效果截图再次当背景导入，只会得到 UI 叠 UI 的灾难现场。
我会这样装：先让它通过测试，再换第一张图
前提只有一个：官方 Codex Desktop 已经安装并至少启动过一次，~/.codex/config.toml 存在。项目使用 Codex 内置且已签名的 Node，不要求额外装全局 Node。
从仓库克隆后，在 macos 目录按这个顺序执行：
# 先检查本机环境和脚本 ./tests/run-tests.sh # 安装到稳定目录，但先不自动启动 ./scripts/install-dream-skin-macos.sh --no-launch # 第一次换成内置的抽象预设 ~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh \ --id preset-midnight-aurora随后不要急着导入自己的图，先打开桌面的 Codex Dream Skin.command，确认首页、任务页、输入框和代码块都能正常交互。确认无误后，再双击 Codex Dream Skin - Verify.command。
这一步有点反直觉：最值得先试的不是“我最喜欢的那张图”，而是项目自带的抽象预设。它没有人物、品牌或作品角色，能先把安装和视觉问题分开。主题没跑通时，少一个素材变量，排查就少一半猜测。
自己做背景图，记住这 4 条就够了
项目文档给的图片规则，比“找一张好看的壁纸”更实用：
用纯背景图，推荐 2560 × 1440的 16:9 横图，宽度至少 2000 像素。左侧约一半保持干净、低对比。Codex 首页的原生标题和操作会落在这里。 主体放在右侧偏中间的位置，不要贴边。人物、建筑、产品都别压住输入区。 别把带窗口、侧栏、按钮、可读文字、Logo 或水印的“效果图”当壁纸导入。那是宣传图，不是主题素材。
如果用生成式图片做背景，提示词里最好直接写“16:9 纯背景、左侧留白、右侧主体、无 UI、无文字、无 Logo”。你想要的是给原生 Codex 让位的画布，不是一张伪造的 Codex 截图。
项目对本地图片也设了上限：准备后的文件不超过 16 MB，单边不超过 16384 像素，总像素不超过 5000 万。别用一张几十兆的超高分原图赌加载速度，主题不是显卡压测。
哪些情况我会直接点 Restore
只要出现下面任意一种，我会先还原，不会继续叠加脚本“试试看”：
Codex 启动异常、页面空白，或输入框/项目切换不再像原生控件那样工作。 本机同时跑着来源不明的软件。CDP 虽只绑定本机回环地址，但调试端口本身仍应当作敏感能力。 你准备把含有人物、影视游戏角色或品牌标识的主题图发到公开账号、交给客户或二次分发。
前两种是技术边界，第三种是素材边界。项目的 MIT 许可只覆盖仓库代码及它自己的抽象 demo，不会自动授权 Codex 商标、官方应用、用户导入的图片，或预设中出现的人物/IP 素材。
这东西适合谁，不适合谁
如果你每天都开着 Codex，希望把工作区弄得更有自己的感觉，又不想在每次官方更新后重新折腾环境，它值得花十分钟试一下。
如果你只是想拿“带完整 Codex 界面”的网图当背景，或者准备给团队分发含第三方人物/IP 的主题包，先别装。前者会让 UI 叠 UI，后者会把换肤从个人偏好变成素材权利问题。
一套主题最重要的不是好看，而是你点下 Restore 后，Codex 能干净地回到原来的样子。
说明：本文基于 Codex Dream Skin GitHub 仓库、macOS README 和 NOTICE 整理，项目并非 OpenAI 官方产品。本文未使用仓库内人物或 IP 效果图；安装、兼容性和素材权利请以项目文档与实际环境为准。
