Codex Dream Skin：Codex App 换肤 Skill 与自定义主题工具

Codex Dream Skin 是一个免费开源的 Codex App 换肤 Skill。它可以为 Codex Desktop 安装可交互的背景皮肤：macOS 支持本地图片、CDN Banner 和主题库，Windows 支持本地图片与托盘切换；两个平台都支持运行验证和恢复官方外观。

macOS 第一次使用：复制后选择主题

不要下载 ZIP，不要打开终端，不要自己退出或重新打开 Codex。

把下面整段复制给 Codex：

请安装或覆盖更新这个 GitHub 仓库里的 codex-dream-skin Skill：
https://github.com/aithink001/Codex-Dream-Skin-Themes/tree/main/skills/codex-dream-skin

安装后请完整读取新版 SKILL.md，并按 Ordinary-user path 操作。

如果我还没有指定主题，只问我选择哪一种：
1. 世界杯主题
2. 使用我自己的图片

我选世界杯主题时，直接执行一键安装流程；我选自己的图片时，等我上传图片或粘贴 HTTPS 图片地址后，再执行自定义图片一键安装流程。

除一次“安装主题”确认弹窗外，不要让我运行任何命令，不要让我手动退出或重新打开 Codex。请自动完成安装、一次受控重启、主题应用和 Verify；只有 Verify 真正通过后才能告诉我成功。

接下来只需要：

1. 回复 “1” 使用世界杯主题，或回复 “2” 后发送自己的图片。
2. 看到系统弹窗后，点击安装。
3. 等待 Codex 自动重新打开，不要手动操作。

两种方式都会自动使用适合背景图片的沉浸式深色外观，不受用户当前浅色或深色设置影响，也不会出现整层发白的背景。

看到选择的背景，并且 Codex 确认 Verify 通过，才算安装完成。如果没有变化，不要再次重启，只需要对 Codex 说：

检查 Dream Skin 主题安装结果并自动诊断，不要重启 Codex，也不要让我运行命令。

主题选择与一键安装目前用于 macOS。Windows 用户请看Windows 简单用法。

原生侧栏、项目选择、建议卡片、任务内容和输入框仍然可以正常点击与输入；主题图片只用于 Banner 和装饰背景，不会把一张假界面截图盖在 Codex 上。

没有合适的背景图？打开 Codex Dream Skin Banner 在线生成器

第一次使用 · 其他主题 · 功能对比 · 效果预览 · 验证与恢复 · 常见问题

Codex Dream Skin 下载与安装

推荐：让 Codex 自动安装

直接使用本文最上方的主题选择提示词。Codex 会安装或更新 Skill，再根据你的选择自动完成主题应用和验证。

如何给 Codex 更换自定义主题

macOS：使用本地图片或 CDN Banner

准备一张横向图片，建议宽度不低于 2000px。可以直接把本地图片路径或 HTTPS CDN 地址交给 Skill：

使用 $codex-dream-skin，把这张图片设置为我的 Codex 主题：
https://cdn.example.com/my-codex-banner.png

主题名称叫「Purple Night」。应用完成后运行 Verify 并保存验证截图。

还可以继续告诉 Codex：

使用 $codex-dream-skin 列出我保存的主题，并切换到「Purple Night」。

macOS 支持：

• 本地 PNG、JPEG、HEIC、TIFF、WebP；
• HTTPS CDN 图片；
• 主题名称、标语、引用文字和强调色；
• 保存多套主题并快速切换；
• SwiftBar 菜单栏控制；
• 暂停皮肤、重新应用、验证截图和完整恢复。

Windows：使用本地图片和托盘主题控制

Windows 会先安装一套可用的内置主题，并提供系统托盘控制器：

使用 $codex-dream-skin 在 Windows Codex App 中安装主题，完成后运行 Verify。

安装后，在系统托盘的 Codex Dream Skin 菜单中选择“更换背景图”，即可使用本地 PNG、JPEG 或 WebP。托盘还支持保存当前主题、切换已保存主题、暂停/继续、重新应用和完整恢复。

支持哪些系统和功能

完整命令和高级选项见 codex-dream-skin/SKILL.md。

Codex Dream Skin 效果预览

下面的图片适合用来选择配色、构图和氛围。最终主题会保留 Codex 原生控件，实际效果以 Verify 截图为准。

选择一个风格并生成自己的 Codex Dream Skin Banner

Codex 换肤是怎样工作的

Skill 会启动官方 Codex Desktop，并通过只监听 127.0.0.1 的 Chromium DevTools Protocol 注入主题 CSS 和装饰层。它不会修改、替换或重新签名官方应用文件。

Codex Dream Skin Skill
        ↓
启动官方 Codex + 本机回环 CDP
        ↓
注入主题 CSS、Banner 和装饰背景
        ↓
原生侧栏、项目、任务和输入框保持可交互

运行时固定到已检查的提交 a1c48b3a84cc64532196e624fdf33ee1277cb018，下载后会再次核对 Git commit。主题运行期间，请避免运行来路不明的本机程序；不再使用时可以随时运行 Restore 关闭主题和调试会话。

如何验证主题已经生效

发送下面的提示词：

使用 $codex-dream-skin 验证当前主题，并保存一张验证截图。

Verify 会检查：

• 主题 CSS 和注入标记是否存在；
• 原生侧栏与输入框是否仍然可见；
• 首页 Banner、建议卡和项目选择是否正常；
• 是否出现横向溢出或装饰层遮挡点击；
• 页面重新加载后主题是否可以重新应用。

只有 Verify 通过，才表示当前 Codex Dream Skin 已正常运行。

如何卸载或恢复 Codex 官方外观

发送：

使用 $codex-dream-skin 恢复 Codex 官方外观，并关闭主题调试会话。

恢复功能会移除主题 CSS 和装饰层，并恢复安装前保存的外观设置。macOS 还可以删除桌面启动器，Windows 可以选择恢复完整的安装前配置备份。

常见问题

Codex Dream Skin 是官方功能吗？

不是。这是面向 Codex Desktop 的非官方开源换肤工具，与 OpenAI 没有隶属、认可或赞助关系。

它会修改 Codex.app 或 app.asar 吗？

不会。主题通过本机回环 CDP 运行，不会修改 .app、app.asar、WindowsApps 或官方代码签名。

Codex Dream Skin 支持 Windows 吗？

支持。Windows 可以通过系统托盘选择本地图片、保存和切换主题、暂停或重新应用皮肤，也可以运行 Verify、保存验证截图并恢复官方外观。

可以使用自己生成的图片吗？

可以。macOS 支持本地图片和 HTTPS CDN 地址；Windows 支持从系统托盘选择本地 PNG、JPEG 或 WebP。建议使用横向构图，并让左侧保持简洁，以免影响原生标题和控件的可读性。

出现 Explicit theme directory is missing theme.json 怎么办？

这是早期版本的首次安装初始化错误，当前版本已修复。请更新或重新复制 codex-dream-skin Skill，关闭 Codex 后重新运行安装；新版本会自动创建默认主题，不需要手动清理缓存或编写 theme.json。

Codex 更新后主题失效怎么办？

重新运行安装、启动和 Verify。Codex 更新可能改变界面结构，因此每次更新后都建议重新验证。

为什么手动重启后没有变化？

普通方式重新打开 Codex 不会携带主题所需的启动参数。不要反复手动重启；使用 Skill 的一键安装流程，让它自动完成一次受控重启、应用和验证。

为什么世界杯背景像蒙了一层白色？

这是旧版世界杯主题跟随 Codex 浅色外观造成的。请覆盖更新本仓库中的 Skill，再按页面顶部的一键安装提示操作；新版会自动使用适合该图片的深色外观，不需要修改系统设置。

图片会保存在 GitHub 仓库里吗？

不会。展示图片全部通过 HTTPS CDN 加载，仓库不提交 JPG、PNG、WebP 等图片二进制。

项目文件

• skills/codex-dream-skin/SKILL.md — install, customize, switch, verify, package, and restore workflows.
• skills/codex-dream-skin/scripts/dream-skin-macos.sh — macOS command wrapper.
• skills/codex-dream-skin/scripts/dream-skin-windows.ps1 — Windows command wrapper.
• prompts/themes.json — machine-readable Codex theme Banner prompts.

开源许可与商标

仓库代码与文本采用 MIT License。外部 CDN 图片不随仓库许可证自动授权。Codex、OpenAI 以及相关商标归各自权利人所有；人物、角色或商标素材用于公开再分发或商业项目时，请自行确认相应授权。

---

English: Open-source Codex Dream Skin Skill for Codex Desktop themes on macOS and Windows. Install a reversible skin, use custom images on both platforms, verify the live native interface, and restore the official appearance at any time.