给 Codex 桌面端换上主题、静态壁纸和动态壁纸。
保留原生侧栏、任务、项目选择器与输入框，不修改官方安装包。
中文 · English
下载 Windows 安装包 · 单文件 EXE · macOS 安装 · 查看效果展厅 · 加入讨论 · 反馈问题
非 OpenAI 官方产品。Codex 动态壁纸通过仅绑定
127.0.0.1的本机 CDP 注入主题，不修改 WindowsApps、.app、app.asar或官方代码签名。
- 原生 UI 保持可用：不是把一张假界面贴满窗口；侧栏、聊天、任务和输入框仍可正常交互。
- Codex 内部动态壁纸：Windows 支持本地 MP4/WebM 静音循环，不是修改桌面壁纸。
- 社区主题生态：导入主题 ZIP（manifest + 本机 Safe CSS 校验），托盘内置主题库 Gallery 与在线 Studio 入口；主题 CSS 只作用于注册部件，不能执行任意命令。
- 紧跟 Codex 更新：v1.6.0 采用选择器合同引擎（
selectors.json三重兜底），已适配 2026 年 9 月版 Codex（26.915）。 - 一键式 Windows 管理器：浏览、搜索、预览和切换壁纸，调整透出度，暂停或恢复官方外观。
- 图片变主题：导入喜欢的 PNG、JPEG 或 WebP，自动适配全窗背景与内容可读性。
- 可恢复、可审计：不改官方二进制；随时停止注入并恢复 Codex 官方外观。
- Windows + macOS：Windows 提供中文安装包与自包含 EXE，macOS 提供菜单栏 Studio 与安装脚本。
方式一：安装包（推荐）
- 从 Releases 下载最新的
CodexDreamSkin-Setup-vX.Y.Z.exe。 - 双击安装：中文向导，按当前用户安装，不需要管理员权限，内置 Node.js 运行时；可勾选开机自启。
- 从开始菜单「Codex 动态壁纸」启动，或勾选后由开机自启的托盘接管。
方式二：单文件管理器 EXE
- 下载
CodexDreamSkinManager.exe。 - 双击运行，点击「添加壁纸」导入 PNG、JPEG、WebP、MP4 或 WebM。
- 点击「应用到 Codex」。需要时点击「启动 / 重新应用」。
管理器是自包含的单文件程序，内置经过测试的动态壁纸引擎与 Node.js 运行时；最终用户不需要安装 .NET SDK、Node.js 或手动执行 PowerShell。
两种方式共用同一套本机数据（主题、图片与受管引擎），可互换或共存。首次启用会使用独立的受管 CDP 配置启动 Codex，需要在 Codex 中重新登录一次，之后保持登录。
当前发布版尚未进行代码签名，Windows 可能显示“未知发布者”。请只从本仓库的 Releases 下载，并使用同页
.sha256文件核对。
右侧滑杆控制主题蒙层与壁纸的关系：
100%：显示原始壁纸/视频画面，整页主题蒙层降为零。- 较低数值：提高文字区与主题蒙层可见度，适合任务页或高对比背景。
在仓库的 macos/ 目录双击：
Install Codex Dream Skin.command
也可在终端执行：
cd macos
./scripts/install-dream-skin-macos.sh安装后通过菜单栏 Studio 导入、保存和切换图片主题。完整说明见 macos/README.md。
| 功能 | Windows | macOS |
|---|---|---|
| PNG / JPEG / WebP 图片主题 | ✅ | ✅ |
| MP4 / WebM 动态壁纸 | ✅ | — |
| 社区主题 ZIP（Safe CSS 校验） | ✅ | ✅ |
| 中英双语托盘 / 界面 | ✅ | ✅ |
| 图形化主题管理 | ✅ 安装包 + 独立 EXE | ✅ 菜单栏 Studio |
| 壁纸库搜索与预览 | ✅ | ✅ |
| 保存与切换主题 | ✅ | ✅ |
| 壁纸透出度 | ✅ | — |
| 暂停注入 / 恢复官方外观 | ✅ | ✅ |
| 修改官方应用文件 | 不会 | 不会 |
| Windows / 通用主题 | macOS 暗色主题 |
|---|---|
 |
 |
更多实机截图、人物预设与八种概念方向见 docs/showcase.md。
本地壁纸 / 主题配置
↓
Codex 动态壁纸本地主题仓库
↓
127.0.0.1 回环 CDP
↓
Codex renderer 中的独立背景层
↓
原生侧栏、任务与输入框继续交互
Windows 视频会分块传入 renderer 并组装为 Blob URL；切换、暂停或清理时会释放播放器与 Blob。页面隐藏后自动暂停视频，避免无意义播放。
主题与 DOM 的对接由 selectors.json 选择器合同驱动：每个部件带多重兜底选择器，官方 Codex 改版后通常只需更新合同数据即可恢复兼容，不必改渲染器代码。
- CDP 只绑定
127.0.0.1，不会对局域网开放调试端口。 - 不修改 WindowsApps、
.app、app.asar或官方签名。 - 不读取或改写 API Key、Base URL、模型供应商或 Codex 聊天内容。
- 主题运行期间不要运行来路不明的本机程序；本机恶意进程可能尝试访问调试端口。
- Codex 官方更新可能改变 DOM。若主题失效，请先使用管理器「启动 / 重新应用」，再查看 Issues。
powershell.exe -ExecutionPolicy Bypass -File .\windows\scripts\install-dream-skin.ps1
powershell.exe -ExecutionPolicy Bypass -File .\windows\scripts\start-dream-skin.ps1需要 .NET 8 SDK 和 Node.js 22+：
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\windows\app\build-manager.ps1输出位于 windows/dist/。构建会运行 Windows 回归测试、发布自包含 win-x64 EXE，并执行发布后自检。
powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\windows\tests\run-tests.ps1bash macos/tests/run-tests.sh2026 年 9 月 Codex 更新后皮肤失效了？
v1.1.0 及更早版本依赖旧版 DOM 选择器，在 Codex 26.915 上会失效。升级到 v1.6.0 或更新版本（安装包可直接覆盖安装，已保存的主题和图片会保留）即可恢复。
安装包和单文件 EXE 用哪个？
两者功能等价、共用本机数据。安装包提供开始菜单快捷方式、中文向导和卸载入口，适合长期使用；单文件 EXE 免安装、适合便携场景。已安装上游 Codex Dream Skin v1.5.x 的机器可直接用 v1.6.0 安装包原地升级，旧的英文快捷方式会自动清理。
这是 Wallpaper Engine 的替代品吗？
不是。它只控制 Codex 应用内部的主题背景。Windows 管理器可以扫描并直接引用 Wallpaper Engine 已下载到本地的 type: video MP4/WebM 项目；超过 1080p 时会生成本地流畅代理。type: scene 的 scene.pkg 目前可通过独立 GPL-3.0 侧车进行开发预览；Web 壁纸和项目脚本仍不会执行。
为什么 Codex 更新后主题可能失效？
动态壁纸引擎依赖 Codex 的 renderer DOM 和本机 CDP。官方更新可能调整结构；通常点击「启动 / 重新应用」即可恢复，兼容性修复会持续发布在本仓库。
能否恢复完全原生的 Codex？
可以。Windows 管理器提供「恢复官方外观」，macOS Studio 也提供卸载/恢复入口。项目不会修改官方应用包。
壁纸文件会上传吗？
不会。壁纸与主题保存在本机，注入只通过本机回环连接完成。
感谢 passion8.cc 赞助本项目。换肤与 API 配置互相独立，本项目不会自动改写模型供应商设置。
- 公告、主题分享与使用交流：GitHub Discussions。
- 首个版本公告：Codex 动态壁纸 v1.0.0 正式发布。
- 使用 Bug / 功能 Issue 模板 提交问题。
- PR 请说明平台、复现或目标、验证命令与恢复测试。
- 贡献指南：中文 · English
本仓库是 Fei-Away/Codex-Dream-Skin 的增强派生版本，并保留完整上游历史。
MIT License。非 OpenAI 官方产品；Codex 及相关商标归其权利人。随仓库预设与效果图中的人物/IP 素材仅作主题示意，公开再分发前请自行确认肖像、素材和商标权利。
如果 Codex 动态壁纸让你的工作空间更舒适，欢迎点一个 Star，也欢迎分享你的主题截图。