Codex Dream Skin

中文 · English

给 Codex 桌面端换一张会呼吸的脸。
外部主题 / 换肤工具 · 本机 CDP 注入 · 不改官方安装包

一张图，一种心情 · 写代码，也要有氛围感

非 OpenAI 官方产品。不修改 .app / app.asar / WindowsApps。

关于这个分支

本仓库基于上游原项目 Fei-Away/Codex-Dream-Skin 继续开发。感谢上游作者与所有贡献者完成跨平台换肤基础、安装脚本、主题预设和安全边界设计。

在保留原有能力的基础上，这个分支重点增强了 Windows 使用体验：

• 在 Codex 内实时调节透明度、亮度、清晰度、动态氛围和正文增强
• 支持 GIF 动态壁纸，同时保留 Codex 原生界面与交互
• 改进控制面板交互、调节流畅度和普通对话的阅读体验

下方基础介绍与使用说明继续沿用上游项目结构，并按本分支的实际功能补充。详细更新见 windows/CHANGELOG.md。

实测精选预设

Gothic Void Crusade / 哥特虚空远征

特别感谢 @seansong-ideogram 为社区设计并贡献这套精美、极具氛围感的原创哥特科幻作品。 它是当前实测精选的第一套预设，也是 macOS 全新安装时默认启用的主题。

_{真实 Codex 首页注入效果（仅预览）}

macOS 安装后可从「已保存主题」直接切换，也可以运行：

~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh \
  --id preset-gothic-void-crusade

桥本有菜 / Arina Hashimoto

下面这套「桥本有菜 / Arina Hashimoto」已经在真实 Codex 首页分别验证浅色和暗色外观。用户提供的源 PNG 为 1672 × 941，主题包在保持源图近 16:9 构图的前提下派生导出 2560 × 1440 JPEG，并不代表增加了源图细节。截图中的侧栏、卡片、项目选择和输入框都是 Codex 原生控件。

_{浅色 · 真实注入截图（未发送输入已在截图时遮蔽，仅预览）}

_{暗色 · 真实注入截图（未发送输入已在截图时遮蔽，仅预览）}

从仓库安装并一键切换（macOS）：

cd macos
./scripts/install-dream-skin-macos.sh --no-launch
~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh \
  --id preset-arina-hashimoto

Windows 使用本地主题仓库与系统托盘，并会预置同一套「桥本有菜」。首次从仓库使用：

powershell -ExecutionPolicy Bypass -File .\windows\scripts\install-dream-skin.ps1
powershell -ExecutionPolicy Bypass -File .\windows\scripts\start-dream-skin.ps1

启动后可直接从「已保存主题 → 桥本有菜」切换；不需要跨目录手动导入。托盘里的「更换背景图」仍可导入你自己的纯背景，保存后继续一键切换。

可下载的用户源图是 docs/images/presets/arina-hashimoto-source.png（1672 × 941）；macOS 一键预设使用 macos/presets/preset-arina-hashimoto/background.jpg（规范化派生 2560 × 1440）。上面两个效果图包含真实 UI，只作预览，绝不能当背景导入。背景为用户提供的 AI 生成示例，不代表 OpenAI/Codex 官方视觉或背书；公开再分发前请确认人物与素材权利。

概念效果图（不可直接导入）

下面八张图用于表达可实现的视觉方向，但它们是带界面的概念效果图，不是可直接使用的主题背景。需要同类效果时，先按参考生图提示词生成无 UI 的 2560 × 1440 素材；八种风格的详细拆解见概念图提示词。

_粉系定制

_{财神打工版}

_红白科幻

_清透定制

_{灵感小宇宙}

_紫夜限定

_{青蓝虚拟歌姬}

_舞台黑金

它能做什么

• 真·可交互：侧栏、建议卡、项目选择、输入框都是原生控件，不是整窗假截图贴上去
• 真背景层：一张 16:9 纯壁纸连续铺满整窗，首页突出氛围，任务页自动降低干扰
• 可换图：换一张喜欢的纯背景，自适应焦点、安全区和配色后变成你的主题
• 可存主题：macOS 菜单栏与 Windows 系统托盘都能保存/切换本地主题
• Windows 实时调节：在 Codex 内直接调透明度、亮度、清晰度、动态氛围和正文增强
• Windows 动态壁纸：托盘与窗口内均可导入 GIF，动画保持播放且不替换原生控件
• 可恢复：一键还原官方外观
• 相对安全：本机回环 CDP 注入，不改官方二进制与签名

快速开始

仓库内按平台放了现成脚本（实现细节不同，效果都是「主题化 Codex」）：

平台	目录	入口
Apple Silicon / Intel Mac	macos/	双击 Install Codex Dream Skin.command
Windows	windows/	从 Releases 下载并双击 Setup.exe

更细的说明：

• Mac：macos/README.md
• Windows：windows/SKILL.md
• 路径对照：docs/platforms.md
• 可直接复制的参考生图模板：docs/reference-background-prompt-guide.md
• 八种概念方向详细提示词：docs/background-generation-prompts.md
• 项目记录：docs/PROJECT.md

反馈与贡献

• Issue： 请用 Issue 模板（Bug / 功能）；已关闭空白 Issue。提交前建议先跑 Verify / Restore 自检。
• PR： 请按 PR 模板 写清改动，并勾选对应自测（如 macos/tests/run-tests.sh、verify / restore）。

安全边界

• CDP 只绑 127.0.0.1，主题运行期间勿跑来路不明的本机程序
• 不修改官方安装目录与代码签名
• 不会自动改写 API Key / Base URL；中转与换肤分开

许可与声明

• 见 macos/LICENSE（MIT）与 macos/NOTICE.md
• 非 OpenAI 官方产品；Codex 及相关权利归其权利人
• 随仓库预设及效果图中的人物 / IP 素材仅作主题示意；商用或公开再分发请自行确认肖像、素材与商标权利

---

Star 一下，然后挑一张图，把你的 Codex 变成今天想要的样子。