Codex-Dream-Skin README

The project's README from github.com/Fei-Away/Codex-Dream-Skin. As one markdown file: README.md.

Codex Dream Skin

中文 · English

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

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

官方主题库:DreamSkin.cc · 主题库 Gallery · 在线 Studio

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

🤝 独家赞助

Passion8 感谢 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 下载:

不需要 clone 源码、安装 Node.js 或手动运行 .sh / .ps1。首次未签名放行、更新和卸载步骤见 macOS 安装说明 / Windows 安装说明。

主题库与社区

DreamSkin.cc

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

浏览主题库 →  ·  在线 Studio →

社区主题「悟空(WUKONG)」在桌面模拟器里的实机效果
「悟空(WUKONG)」by JamesOpsLab
社区主题「DeepSeek-鲸鱼娘」在桌面模拟器里的实机效果
「DeepSeek-鲸鱼娘」by powerdog996

在 DreamSkin.cc 在线 Studio 里调好的一套自定义背景效果
在线 Studio · 换一张喜欢的背景图,调好焦点与配色,就是你自己的主题

macOS 菜单栏和 Windows 托盘都有「主题库 Gallery」和「在线 Studio」入口,可以直接打开。

一键换肤

在 DreamSkin.cc 上看到喜欢的主题,点「一键换肤」就能让本机客户端直接装上,不用先下载再手动导入。 需要 v1.5.0 或更新的客户端(建议 v1.5.5 及以上)。

流程与安全边界:

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

实测精选预设

Gothic Void Crusade / 哥特虚空远征

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

哥特虚空远征主题实机效果
真实 Codex 首页注入效果(仅预览)

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

桥本有菜 / Arina Hashimoto

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

桥本有菜主题浅色实机效果
浅色 · 真实注入截图(未发送输入已在截图时遮蔽,仅预览)

桥本有菜主题暗色实机效果
暗色 · 真实注入截图(未发送输入已在截图时遮蔽,仅预览)

这组人物素材留在源码仓库用于参考与权利核验,不进入公开 DMG / Setup.exe;公开安装包只预置已确认 可分发的 Gothic Void Crusade。普通用户仍可从菜单里的「更换背景图」导入自己有权使用的纯背景, 保存后继续一键切换。

可下载的用户源图是 docs/images/presets/arina-hashimoto-source.png(1672 × 941);源码参考预设使用 macos/presets/preset-arina-hashimoto/background.jpg(规范化派生 2560 × 1440)。上面两个效果图包含真实 UI,只作预览,绝不能当背景导入。背景为用户提供的 AI 生成示例,不代表 OpenAI/Codex 官方视觉或背书;未确认人物与素材权利前不得把它打进公开安装包。

它能做什么

快速开始

普通用户:下载安装包

不需要 clone 仓库,也不需要安装 Node.js 或运行 .sh / .ps1。从 GitHub Releases 下载对应平台的最新安装包, 按平台文档完成一次图形界面安装:

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

安装后从菜单栏(macOS)或系统托盘(Windows)使用。更新时下载新安装包覆盖安装,主题和图片会保留; 未签名的新下载文件在个别系统上仍可能再次出现一次安全提示,文档列出了放行方法。

导入下载的主题

从 DreamSkin.cc 装主题优先用一键换肤。下面是手动导入 .zip 的兜底路径,也适用于任何 其他来源的主题包。

在 macOS 菜单栏选择“导入主题 ZIP…”,或在 Windows 托盘选择同名菜单。只支持普通 .zip, 不支持 .dreamskin 后缀,也不要仅改后缀伪装。正式 Studio 主题包包含 manifest.json、 theme.json、非空 theme.css 和恰好一张 background.webp|jpg|png;还可包含 LICENSE.txt 和预留的 manifest.sig。这些文件可以位于 ZIP 根目录或唯一一层主题目录。导入器会核对适用平台、最低客户端 版本,以及清单中每个负载文件的大小和 SHA-256。theme.css 必须通过本机 Safe CSS 校验,导入后只会 作用于 12 个注册部件;每次切换/应用仍会重新校验。manifest.sig 当前不参与签名验证。

本地简化 ZIP 也必须恰好包含非空 theme.json、非空 theme.css 和其引用图片;该格式没有正式清单的 完整性与兼容性声明,只应从可信来源使用。压缩包最大 32 MiB、最多 32 个条目、解压后最多 64 MiB。 导入成功后主题只会加入“已保存的主题”,不会自动替换当前主题;相同内容不会重复写入。同 ID 的新版本会在 确认旧目录身份后原地更新,并仅清理语义指纹完全一致、已确认属于同一主题的旧版 -2/-3 重复目录;无法 确认身份时会拒绝覆盖,也不会根据名称猜测并删除其他主题。

也可以先手动解压,再把包含 theme.json、theme.css 和背景图的完整主题目录移动到本机主题库:

菜单里有“打开主题文件夹”快捷入口。移动后重新打开菜单/托盘即可;不要再套一层目录,也不要放链接、 嵌套压缩包或缺少三件套的文件夹。手动目录不会经过 ZIP 导入器的归档校验,请只使用可信内容。升级前 已经保存且没有 CSS 的 legacy 主题仍可切换,但不会注入额外 CSS。

开发者:从源码运行

仓库内按平台放了现成脚本(实现细节不同,效果都是「主题化 Codex」):

平台 目录 入口
Apple Silicon / Intel Mac macos/ 双击 Install Codex Dream Skin.command
Windows windows/ scripts/install-dream-skin.ps1 → start-dream-skin.ps1

更细的说明:

反馈与贡献

安全边界

许可与声明


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

Codex-Dream-Skin (Fei-Away/Codex-Dream-Skin)

Searching Database…

Что это такое?Codex Dream Skin — это внешний инструмент оформления, который меняет внешний вид настольного клиента Codex (и ChatGPT) с помощью собственных фонов и CSS, не изменяя пакет официального приложения.
Это пакет тем или приложение меняет сам Codex?Это отдельное вспомогательное приложение, которое во время работы внедряет CSS и фон в клиент Codex через локальный Chrome DevTools Protocol (CDP); оно никогда не редактирует официальный .app, app.asar или файлы WindowsApps.
Как установить и пользоваться?Один раз закройте официальное приложение Codex/ChatGPT, затем скачайте CodexDreamSkin-vX.Y.Z.dmg (macOS) или CodexDreamSkin-Setup-vX.Y.Z.exe (Windows) из GitHub Releases и запустите установщик; после этого выбирайте или импортируйте темы через меню в строке меню macOS или через значок в трее Windows.
Установка темы в один клик с DreamSkin.cc всегда доступна?Применение в один клик работает только в клиенте версии v1.5.0+ (рекомендуется v1.5.5+) и только для тем, которые полностью соответствуют контракту пакета тем (фон, theme.json, непустой theme.css, заявленная поддержка безопасного CSS); в остальных случаях нужно вручную импортировать .zip.
Поддерживаются ли Mac на Apple Silicon и Intel, а также Windows?Да, поддерживаются Mac на Apple Silicon и Intel, а также Windows.
Что именно я могу настроить?Вы можете заменить фоновые обои 16:9 за интерфейсом Codex, настроить стилизацию с помощью безопасного CSS, влияющего на 12 зарегистрированных виджетов, сохранять и переключать несколько локальных тем, а также в любой момент вернуть исходный официальный вид.
Что такое DreamSkin.cc?Это официальная галерея тем проекта и онлайн-студия, где можно просматривать темы, проверенные сообществом, смотреть их предпросмотр в симуляторе рабочего стола, создавать собственные, настраивая фон, цвета и безопасный CSS, а также экспортировать или отправлять пакеты тем в формате .zip.
Какая тема по умолчанию после чистой установки на macOS?Gothic Void Crusade — оригинальная готическая научно-фантастическая тема, созданная дизайнером сообщества seansong-ideogram; она включена по умолчанию при новой установке на macOS.
Может ли импорт темы когда-либо автоматически заменить текущую тему?Нет, успешно импортированная тема только добавляется в список сохранённых тем и никогда не заменяет текущую активную тему автоматически.
Creator
Fei-Away
Size
30.1 MB
Stars
15.1K
Age
3mo
Commits · 90 Days