为 Windows 版 Codex 打造的非官方主题工具包：一键安装、切换和自定义背景，同时保留原生界面的完整交互能力。
Codex SkinKit 为 Microsoft Store 版 Codex 添加可定制的首页横幅和任务背景。侧边栏、卡片、项目选择器、任务内容、菜单和输入框仍然可以正常交互。
项目不会修改官方 MSIX 安装包或 app.asar。主题通过仅监听 127.0.0.1 的本地 Chrome DevTools Protocol 调试会话注入，恢复后即可回到 Codex 原始外观。
| World Cup Night | Deep Space Mission Control | Ember Bloom |
|---|---|---|
 |
 |
 |
| Aurora Veil | ||
 |
点击 Codex 右上角的主题入口即可打开主题中心，不需要重启应用：
- 在 5 套内置主题之间即时切换
- 使用“系统默认”随时恢复原生 Codex
- 上传 PNG、JPEG 或 WebP，自动压缩并提取配色
- 自定义主题只保存在当前电脑，不会覆盖内置主题
- 双击脚本即可完成安装、启动、验证和恢复
- 在 Codex 页面右上角直接切换 5 套内置主题，无需重启
- 永久提供“系统默认”，可随时回到原生 Codex 界面
- 支持电影横幅、沉浸任务板和指挥中心 3 种布局
- 支持星火、轨道扫描、极光和花瓣 4 种环境特效
- 在页面内上传 PNG、JPEG 或 WebP，自动压缩、取色并保存为本地主题
- Codex 正常重启后由 watchdog 自动恢复主题，带重试熔断保护
- 自动保存并恢复 Codex 原始基础色
- 校验 Codex 包、Node.js 签名及复制文件哈希
- 无需全局安装 Node.js
- Windows 10 或 Windows 11（x64）
- 从 Microsoft Store 安装的官方 Codex App
- PowerShell 5.1 或更高版本
当前版本仅支持 Windows，不支持其他安装来源的 Codex。
- 安装并至少启动一次官方 Codex App，然后关闭 Codex。
- 下载本仓库，并完整解压到一个普通文件夹中。
- 双击
Codex SkinKit.cmd，选择 Install / Update。 - 按提示允许 Codex 重启。
启用后，Codex 页面右上角会出现主题入口。页面内切换会立即生效并记住选择；不需要为了换主题重启 Codex。
安装完成后，桌面只会生成一个 Codex SkinKit.cmd。双击即可打开管理中心：
| 管理中心操作 | 用途 |
|---|---|
| Install / Update | 安装或更新 SkinKit |
| Start Codex | 以当前主题启动 Codex |
| Switch Theme | 切换内置主题 |
| Customize Theme | 使用自己的图片创建主题 |
| Verify Theme | 检查主题状态并保存验证截图 |
| Restore Codex | 移除主题并恢复 Codex 原始外观 |
| Open Portal | Deep Space Mission Control | World Cup Night |
|---|---|---|
 |
 |
 |
| Aurora Veil | Ember Bloom |
|---|---|
 |
 |
Aurora Veil 与 Ember Bloom 改编自 Finderchangchang/codex-autoskin 的 MIT 许可原创演示主题，并已转换为 SkinKit 的主题配置格式。
推荐直接点击 Codex 页面右上角的主题入口进行无重启切换。桌面管理中心里的 Switch Theme 作为兼容入口保留。
推荐在页面内主题中心点击 上传图片。支持不超过 50 MB 的 PNG、JPEG 或 WebP；图片会在本机缩放到 1600×1000 范围、压缩到 5 MB 以内并自动提取配色，最多保存 12 款。
图片和主题配置只保存在本机 IndexedDB，不会发送到网络。外部管理中心的 Customize Theme 仍保留兼容旧流程，支持不超过 16 MB 的 PNG、JPG 或 JPEG。
建议使用宽度至少为 2000 px 的横向图片，并避免把重要主体放在图片左侧，以免被界面内容遮挡。
如需通过命令行进一步设置名称、文案和颜色，可运行：
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\customize-theme-windows.ps1 `
-Image "C:\path\to\background.jpg" `
-Name "My Theme" `
-Accent "#7cff46"打开管理中心并选择 Verify Theme。验证成功时会返回 pass: true，并在桌面保存 Codex SkinKit Verification.png。
开发者也可以在仓库目录运行：
npm test或：
powershell -NoProfile -ExecutionPolicy Bypass -File .\tests\run-tests-windows.ps1真实运行验证：
# 验证当前界面、主题中心和系统默认入口
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\verify-dream-skin-windows.ps1
# 逐个测试全部布局与动态特效
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\verify-dream-skin-windows.ps1 -TestAllEffects
# 测试上传、压缩取色、保存、应用、删除和恢复
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\verify-dream-skin-windows.ps1 -TestThemeStudio
# 验证“减少动态效果”模式
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\verify-dream-skin-windows.ps1 -TestReducedMotion
# 验证系统默认清理并恢复原主题
powershell -NoProfile -ExecutionPolicy Bypass -File .\scripts\verify-dream-skin-windows.ps1 -TestSystemDefault打开管理中心并选择 Restore Codex。脚本会移除当前主题、恢复已保存的 Codex 基础色、关闭本地调试会话，并正常重启 Codex。
- 只接受官方
OpenAI.CodexMicrosoft Store 包。 - 不修改官方安装包、签名或
app.asar。 - Chrome DevTools Protocol 只监听本机
127.0.0.1。 - 注入器只接受 Codex 原生的
app://页面。 - 会验证随附 Node.js 的数字签名和复制文件的哈希。
- 上传图片只经过本机 Canvas、Blob 和 IndexedDB，不访问远程服务。
- watchdog 会核对进程路径、命令行和启动时间，并在连续失败后暂停恢复。
主题启用期间，CDP 是本机上的未认证调试接口。请勿同时运行不可信的本地软件；不需要主题时，建议使用 Restore 关闭调试会话。
先正常启动一次官方 Codex App，等待首页加载完成后关闭，再重新运行安装器。
确认图片格式为 PNG、JPG 或 JPEG，且文件大小不超过 16 MB。
打开桌面的 Codex SkinKit.cmd 并选择 Restore Codex。以后需要时可以通过 Install / Update 重新安装。
如果 Codex SkinKit 对你有帮助，欢迎通过赞赏码支持项目维护。产品合作、项目赞助、问题反馈或 Codex 相关交流，可以扫码添加微信；添加时请注明来意。
| 微信联系 | 赞赏支持 |
|---|---|
 |
 |
欢迎提交 Issue 或 Pull Request。请尽量说明 Windows 版本、Codex 版本、复现步骤和验证结果；涉及界面问题时，附上截图会更容易定位。
感谢 Finderchangchang/codex-autoskin 项目及其作者 Vikicc。该项目提供了程序化生成的原创主题素材和完整的主题设计思路；本项目中的 Aurora Veil 与 Ember Bloom 在其 MIT 许可基础上适配为 Codex SkinKit 的主题格式。
页面内主题中心、本地上传工作流、布局系统、环境特效和相关动态验证逻辑参考并改编自 MIT 许可的 Codex ThemeScape Studio。
本项目采用 MIT License。Codex 和 OpenAI 是 OpenAI 的商标。
Codex SkinKit 是社区维护的非官方项目，与 OpenAI 无隶属关系，也未获得 OpenAI 认可或背书。用户提供的图片仍由其原权利人所有，MIT License 不授予这些图片或相关商标的使用权。