KO
|
EN
gitlite — search
Search
#python
#java
#python3
#arduino
#golang
#machine-learning
#rust
#html
#flask
#javascript
#seismology
#nodejs
Codex-Dream-Skin
★ 13,789
Open GitHub ↗
Codex Dream Skin
Download README (.md)
Explore Similar Repositories
LibreTV
:
一分钟搭建影视站，支持Vercel/Docker等部署方式
emoji-cheat-sheet
:
A markdown version emoji cheat sheet
llm-universe
:
本项目是一个面向小白开发者的大模型应用开发教程，在线阅读地址：https://datawhalechina.github.io/llm-universe/
fresh
:
The framework so simple, you already know it.
GenericAgent
:
Self-evolving agent: grows skill tree from 3.3K-line seed, achieving full system control with 6x less token consumption
// repository documentation
Was this content helpful?
★ 0
(0 ratings)
Select Rating:
★
★
★
★
★
Submit Feedback
Recent Feedback
×
Download README
Do you want to download the
README.md
file for
Codex-Dream-Skin
?
Download (.md)
# Codex Dream Skin <p align="center"> <strong>中文</strong> · <a href="./README.en.md">English</a> </p> <p align="center"> <strong>给 Codex 桌面端换一张会呼吸的脸。</strong><br> 外部主题 / 换肤工具 · 本机 CDP 注入 · 不改官方安装包 </p> <p align="center"> 一张图，一种心情 · 写代码，也要有氛围感 </p> <p align="center"> 官方主题库：<a href="https://dreamskin.cc"><strong>DreamSkin.cc</strong></a> · <a href="https://dreamskin.cc/gallery">主题库 Gallery</a> · <a href="https://dreamskin.cc/studio">在线 Studio</a> </p> <p align="center"> 非 OpenAI 官方产品。不修改 <code>.app</code> / <code>app.asar</code> / WindowsApps。 </p> ## 🤝 独家赞助 <table> <tr> <td width="180"> <a href="https://passion8.cc/sign-up?aff=ZgLT"><img src="docs/images/sponsor-passion8.png" alt="Passion8" width="150"></a> </td> <td> 感谢 Passion8 独家赞助本项目！Passion8 是一家面向开发者的 AI API 中转服务商，为个人开发者与团队提供稳定、低成本的主流大模型接入。<br><br> <strong>满血 AI · 触手可及</strong>：OpenAI、Claude 全系列原版模型，无降智、无套壳；使用前沿 AI 模型仅需官方价格的一小部分，充值 1:1，<strong>1$ = 1¥</strong>。保留原有官方 SDK，只把 Base URL 换成 Passion8，Claude Code、Codex、Grok 以及任意 OpenAI 兼容客户端都能直接跑——一行配置，代码不用改。 <strong>全球节点加速</strong>：Cloudflare 全球边缘 + 多线路 BBR 加速，低延迟、高可用、稳定如一；7×24 稳定中转，99.9% SLA，首 Token 目标 1 秒内。 <strong>安全可靠</strong>：独立 API Key、密钥加密存储、全链路 HTTPS，隐私优先。<br><br> Passion8 为本项目用户准备了专属福利：通过<a href="https://passion8.cc/sign-up?aff=ZgLT">此链接</a>注册，首次充值自动赠送 10% 额度，无需申请，30 分钟内到账。有问题联系 <a href="mailto:support@passion8.cc">support@passion8.cc</a>。 </td> </tr> </table> <sub>换肤与 API 配置互相独立，本项目不会自动改写你的模型供应商设置。</sub> ## 直接安装 普通用户只需先安装并退出一次官方 Codex / ChatGPT，然后从 [GitHub Releases](https://github.com/Fei-Away/Codex-Dream-Skin/releases) 下载： - macOS：打开 `CodexDreamSkin-vX.Y.Z.dmg`，把 App 拖进 Applications。 - Windows：双击 `CodexDreamSkin-Setup-vX.Y.Z.exe`，按安装向导完成。 不需要 clone 源码、安装 Node.js 或手动运行 `.sh` / `.ps1`。首次未签名放行、更新和卸载步骤见 [macOS 安装说明](./docs/install-macos.md) / [Windows 安装说明](./docs/install-windows.md)。 ## 主题库与社区 <p align="center"> <a href="https://dreamskin.cc"> <img src="docs/images/dreamskin-mark.svg" alt="DreamSkin.cc" width="140"> </a> </p> <p align="center"> <strong>DreamSkin.cc</strong> · 本项目的官方主题库与创作平台<br> <sub>Make your workspace <em>yours.</em></sub> </p> <p align="center"> <a href="https://dreamskin.cc/gallery"><strong>浏览主题库 →</strong></a> · <a href="https://dreamskin.cc/studio"><strong>在线 Studio →</strong></a> </p> - [**主题库 Gallery**](https://dreamskin.cc/gallery)：浏览社区已审核的主题，支持最新 / 热门排序和创作者榜单。 每套主题都能先在网页里的桌面模拟器中试穿，再决定装不装。 <table align="center"> <tr> <td align="center"> <img src="docs/images/悟空.png" alt="社区主题「悟空（WUKONG）」在桌面模拟器里的实机效果" width="420"><br> <sub>「悟空（WUKONG）」by JamesOpsLab</sub> </td> <td align="center"> <img src="docs/images/DeepSeek-鲸鱼娘.png" alt="社区主题「DeepSeek-鲸鱼娘」在桌面模拟器里的实机效果" width="420"><br> <sub>「DeepSeek-鲸鱼娘」by powerdog996</sub> </td> </tr> </table> - [**在线 Studio**](https://dreamskin.cc/studio)：在浏览器里换背景图、调主题色、写 Safe CSS，导出 `.zip` 主题包， 也可以直接投稿到主题库（需登录，经人工审核后公开）。 <p align="center"> <img src="docs/images/studio-custom-look.png" alt="在 DreamSkin.cc 在线 Studio 里调好的一套自定义背景效果" width="900"> <br> <sub>在线 Studio · 换一张喜欢的背景图，调好焦点与配色，就是你自己的主题</sub> </p> macOS 菜单栏和 Windows 托盘都有「主题库 Gallery」和「在线 Studio」入口，可以直接打开。 ### 一键换肤 在 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` 能力）的主题 才会显示一键换肤按钮；不满足的走下面的手动导入。 ## 实测精选预设 ### Gothic Void Crusade / 哥特虚空远征 **特别感谢 [@seansong-ideogram](https://github.com/seansong-ideogram) 为社区设计并贡献这套精美、极具氛围感的原创哥特科幻作品。** 它是当前实测精选的第一套预设，也是 macOS 全新安装时默认启用的主题。 <p align="center"> <img src="docs/images/presets/gothic-void-crusade-preview.jpg" alt="哥特虚空远征主题实机效果" width="900"><br> <sub>真实 Codex 首页注入效果（仅预览）</sub> </p> 安装后可直接从 macOS 菜单栏的「已保存主题」切换。 ### 桥本有菜 / Arina Hashimoto 下面这套「桥本有菜 / Arina Hashimoto」已经在真实 Codex 首页分别验证浅色和暗色外观。用户提供的源 PNG 为 `1672 × 941`，主题包在保持源图近 16:9 构图的前提下派生导出 `2560 × 1440` JPEG，并不代表增加了源图细节。截图中的侧栏、卡片、项目选择和输入框都是 Codex 原生控件。 <p align="center"> <img src="docs/images/presets/arina-hashimoto-light.jpg" alt="桥本有菜主题浅色实机效果" width="900"><br> <sub>浅色 · 真实注入截图（未发送输入已在截图时遮蔽，仅预览）</sub> </p> <p align="center"> <img src="docs/images/presets/arina-hashimoto-dark.jpg" alt="桥本有菜主题暗色实机效果" width="900"><br> <sub>暗色 · 真实注入截图（未发送输入已在截图时遮蔽，仅预览）</sub> </p> 这组人物素材留在源码仓库用于参考与权利核验，不进入公开 DMG / Setup.exe；公开安装包只预置已确认 可分发的 Gothic Void Crusade。普通用户仍可从菜单里的「更换背景图」导入自己有权使用的纯背景， 保存后继续一键切换。 > 可下载的用户源图是 [`docs/images/presets/arina-hashimoto-source.png`](./docs/images/presets/arina-hashimoto-source.png)（`1672 × 941`）；源码参考预设使用 [`macos/presets/preset-arina-hashimoto/background.jpg`](./macos/presets/preset-arina-hashimoto/background.jpg)（规范化派生 `2560 × 1440`）。上面两个效果图包含真实 UI，**只作预览，绝不能当背景导入**。背景为用户提供的 AI 生成示例，不代表 OpenAI/Codex 官方视觉或背书；未确认人物与素材权利前不得把它打进公开安装包。 ## 它能做什么 - **真·可交互**：侧栏、建议卡、项目选择、输入框都是原生控件，不是整窗假截图贴上去 - **真背景层**：一张 16:9 纯壁纸连续铺满整窗，首页突出氛围，任务页自动降低干扰 - **可换图**：换一张喜欢的纯背景，自适应焦点、安全区和配色后变成你的主题 - **可存主题**：macOS 菜单栏与 Windows 系统托盘都能保存/切换本地主题 - **一键换肤**：在 [DreamSkin.cc](https://dreamskin.cc) 上点一下，客户端核对来源与校验和后直接装上 - **可导入主题包**：两端都可直接选择普通 `.zip`，安全校验后加入本地主题库 - **可恢复**：一键还原官方外观 - **相对安全**：本机回环 CDP 注入，不改官方二进制与签名 ## 快速开始 ### 普通用户：下载安装包 不需要 clone 仓库，也不需要安装 Node.js 或运行 `.sh` / `.ps1`。从 [GitHub Releases](https://github.com/Fei-Away/Codex-Dream-Skin/releases) 下载对应平台的最新安装包， 按平台文档完成一次图形界面安装： | 平台 | 下载 | 安装说明 | |------|------|----------| | macOS | `CodexDreamSkin-vX.Y.Z.dmg` | [`docs/install-macos.md`](./docs/install-macos.md) | | Windows | `CodexDreamSkin-Setup-vX.Y.Z.exe` | [`docs/install-windows.md`](./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` 和背景图的完整主题目录移动到本机主题库： - macOS：`~/Library/Application Support/CodexDreamSkinStudio/themes/` - Windows：`%LOCALAPPDATA%\CodexDreamSkin\themes\` 菜单里有“打开主题文件夹”快捷入口。移动后重新打开菜单/托盘即可；不要再套一层目录，也不要放链接、 嵌套压缩包或缺少三件套的文件夹。手动目录不会经过 ZIP 导入器的归档校验，请只使用可信内容。升级前 已经保存且没有 CSS 的 legacy 主题仍可切换，但不会注入额外 CSS。 ### 开发者：从源码运行 仓库内按平台放了现成脚本（实现细节不同，效果都是「主题化 Codex」）： | 平台 | 目录 | 入口 | |------|------|------| | Apple Silicon / Intel Mac | [`macos/`](./macos/) | 双击 `Install Codex Dream Skin.command` | | Windows | [`windows/`](./windows/) | `scripts/install-dream-skin.ps1` → `start-dream-skin.ps1` | 更细的说明： - Mac：[`macos/README.md`](./macos/README.md) - Windows：[`windows/README.md`](./windows/README.md) - 路径对照：[`docs/platforms.md`](./docs/platforms.md) - 可直接复制的参考生图模板：[`docs/reference-background-prompt-guide.md`](./docs/reference-background-prompt-guide.md) - 八种概念方向详细提示词：[`docs/background-generation-prompts.md`](./docs/background-generation-prompts.md) - 项目记录：[`docs/PROJECT.md`](./docs/PROJECT.md) ## 反馈与贡献 - **Issue：** 请用 [Issue 模板](./.github/ISSUE_TEMPLATE/)（Bug / 功能）；已关闭空白 Issue。提交前建议先跑 Verify / Restore 自检。 - **PR：** 请按 [PR 模板](./.github/pull_request_template.md) 写清改动，并勾选对应自测（如 `macos/tests/run-tests.sh`、verify / restore）。 ## 安全边界 - CDP 只绑 `127.0.0.1`，但**没有身份认证**；同一台电脑上的其他进程仍可能连接并读取或控制 renderer - 暂停主题或只停止 injector 不会关闭已启动 Codex 的调试端口；使用完整 Restore/重启，或退出全部 Codex 后从官方普通入口重新打开，风险窗口才结束 - 不修改官方安装目录与代码签名 - **不会**自动改写 API Key / Base URL；中转与换肤分开 - 完整威胁模型与操作建议见 [`SECURITY.md`](./SECURITY.md) ## 许可与声明 - 见 [`macos/LICENSE`](./macos/LICENSE)（MIT）与 [`macos/NOTICE.md`](./macos/NOTICE.md) - 非 OpenAI 官方产品；Codex 及相关权利归其权利人 - 随仓库预设及效果图中的人物 / IP 素材仅作主题示意；商用或公开再分发请自行确认肖像、素材与商标权利 --- Star 一下，然后挑一张图，把你的 Codex 变成今天想要的样子。
