README

Codex Dream Skin

 给 Codex 桌面端换一张会呼吸的脸

一张图，一种心情。换掉壁纸，原生控件一个不动 —— 侧栏、卡片、项目选择和输入框都是真的。










English | 中文 | 更新日志

安装 · 主题库 · 它能做什么 · 导入主题 · 开发者 · 安全边界

 🌐 官方网站与主题库：dreamskin.cc

主题库 Gallery · 在线 Studio

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



 ❤️ 赞助







感谢 Passion8 独家赞助本项目！Passion8 是一家面向开发者的 AI API 中转服务商，为个人开发者与团队提供稳定、低成本的主流大模型接入。
满血 AI · 触手可及：OpenAI、Claude 全系列原版模型，无降智、无套壳；使用前沿 AI 模型仅需官方价格的一小部分，充值 1:1，1$ = 1¥。保留原有官方 SDK，只把 Base URL 换成 Passion8，Claude Code、Codex、Grok 以及任意 OpenAI 兼容客户端都能直接跑——一行配置，代码不用改。
全球节点加速：Cloudflare 全球边缘 + 多线路 BBR 加速，低延迟、高可用、稳定如一；7×24 稳定中转，99.9% SLA，首 Token 目标 1 秒内。
安全可靠：独立 API Key、密钥加密存储、全链路 HTTPS，隐私优先。
Passion8 为本项目用户准备了专属福利：通过此链接注册，首次充值自动赠送 10% 额度，无需申请，30 分钟内到账。有问题联系 [email protected]。




换肤与 API 配置互相独立，本项目不会自动改写你的模型供应商设置。

 安装

先安装并退出一次官方 Codex / ChatGPT，然后从 GitHub Releases 下载对应平台的安装包：

| 平台 | 下载 | 安装说明 |
|---|---|---|
| macOS · Apple Silicon / Intel | CodexDreamSkin-vX.Y.Z.dmg | docs/install-macos.md |
| Windows · x64 | CodexDreamSkin-Setup-vX.Y.Z.exe | docs/install-windows.md |

不需要 clone 源码、安装 Node.js 或运行 .sh / .ps1。安装后从 macOS 菜单栏或 Windows 系统托盘使用。更新是手动的：下载新安装包覆盖安装即可，主题和图片会保留。公开安装包目前未签名，新下载的文件在个别系统上仍可能出现一次安全提示，文档里有图形界面的放行方法。

 主题库与社区


  
    
  



  DreamSkin.cc · 本项目的官方主题库与创作平台
  Make your workspace yours.



  浏览主题库 →
   · 
  在线 Studio →


- 主题库 Gallery：浏览社区已审核的主题，支持最新 / 热门排序和创作者榜单。每套主题都能先在网页里的桌面模拟器中试穿，再决定装不装。


  
    
      
      「悟空（WUKONG）」by JamesOpsLab
    
    
      
      「DeepSeek-鲸鱼娘」by powerdog996
    
  


- 在线 Studio：在浏览器里换背景图、调主题色、写 Safe CSS，导出 .zip 主题包，也可以直接投稿到主题库（需登录，经人工审核后公开）。


  
  
  在线 Studio · 换一张喜欢的背景图，调好焦点与配色，就是你自己的主题


macOS 菜单栏和 Windows 托盘都有「主题库 Gallery」和「在线 Studio」入口。本机主题的透明度调节和删除入口见主题管理。


一键换肤 —— 在 DreamSkin.cc 上点一下，本机客户端直接装上，不用先下载再手动导入

在 DreamSkin.cc 上看到喜欢的主题，点「一键换肤」即可。需要 v1.5.0 或更新的客户端（建议 v1.5.5 及以上）。

流程与安全边界：

- 网页通过 dreamskin://apply?version=ver_... 唤起本机 App。链接只能携带一个主题版本 ID，不能携带任意 URL、文件路径或命令，也不存在静默应用参数。
- App 只向固定的官方 API 取包，并拒绝重定向。
- 换肤前弹出原生确认框，并核对该版本的审核状态、一键兼容标记、版本号、包大小、实际下载字节数和 SHA-256。
- 通过后复用与手动导入完全相同的 ZIP、manifest、图片与 Safe CSS 校验。
- 只有真实渲染进程确认新主题已生效才算成功。启动或渲染失败会自动尝试恢复换肤前的主题，恢复结果同样要经过可见性验证；无法确认时会明确报告状态未确认，而不是假装已恢复。

只有完整满足当前主题包契约（背景图 + theme.json + 非空 theme.css + 声明 safe-css 能力）的主题才会显示一键换肤按钮；不满足的走下面的手动导入。



 它能做什么

| 特性 | |
|---|---|
| 真·可交互 | 侧栏、建议卡、项目选择、输入框都是原生控件，不是整窗假截图贴上去。 |
| 真背景层 | 一张 16:9 纯壁纸连续铺满整窗，首页突出氛围，任务页自动降低干扰。 |
| 可换图 | 换一张喜欢的纯背景，自适应焦点、安全区和配色后变成你的主题。 |
| 可存主题 | macOS 菜单栏与 Windows 系统托盘都能保存 / 切换本地主题。 |
| 一键换肤 | 在 DreamSkin.cc 上点一下，客户端核对来源与校验和后直接装上。 |
| 可导入主题包 | 两端都可直接选择普通 .zip，安全校验后加入本地主题库。 |
| 可恢复 | 一键还原官方外观。 |
| 相对安全 | 本机回环 CDP 注入，不改官方二进制与签名。 |

 实测精选预设

 Gothic Void Crusade / 哥特虚空远征

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


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


安装后可直接从 macOS 菜单栏的「已保存主题」切换。

 桥本有菜 / Arina Hashimoto

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


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