源码系统概览
文章正文
这套源码是一套给 Codex 桌面端做界面换肤的外部主题工具，主打不动官方安装包就能换上自定义背景与配色。
下面按真实仓库结构梳理它的能力与部署方式，方便想个性化 AI 编码环境的同学学习参考。
源码简介
这套源码是一款给 Codex 桌面端做界面换肤的外部主题工具，不用改动官方安装包就能给编码界面换上自定义背景与配色。
它走本机回环 CDP 注入，只注入样式表，不动官方二进制与签名，适合想个性化 AI 编码环境、又不想破解客户端的学习参考。
仓库分 macOS 与 Windows 两套实现，主题以 CSS 变量加背景图的形式组织，可保存与一键切换，也能一键还原官方外观。
适用场景
- 想给 Codex 桌面端换背景、改配色、做个性化氛围的开发者
- 研究 CDP 注入、Electron/桌面端主题化方案的爱好者
- 需要把工具改造成团队私有视觉风格的二次开发场景
功能亮点
- 本机回环 CDP 注入：injector.mjs 仅连接 127.0.0.1/localhost 的调试端点并注入 CSS 样式，不改官方 app/asar/签名（强证据：macos/scripts/injector.mjs 的 LOOPBACK_HOSTS 与 validatedDebuggerUrl 校验）。
- 跨平台主题切换：macOS 菜单栏（SwiftBar 集成）与 Windows 系统托盘都能保存、暂停与一键切换本地主题（强证据：macos/menubar、windows/scripts/tray-dream-skin.ps1）。
- 多套内置预设：amber-dusk、cyber-neon、forest-mist、midnight-aurora、romantic-rose、sakura-dawn 等氛围主题开箱即用（强证据：macos/presets 目录）。
- 可安全恢复：一键还原官方外观，并对 config.toml 做 UTF-8 原子写与可恢复备份（强证据：AGENTS.md 测试规范与 restore 脚本）。
- 自定义背景：可导入自己的纯背景图，自适应焦点、安全区与配色后变成专属主题（中证据：load-image-theme / customize-theme 脚本）。
技术架构与部署指南
| 维度 | 本套源码 | 同类通用方案 |
|---|---|---|
| 技术栈 | 前端/注入：JavaScript（Node ESM）配合 CSS 变量注入 平台实现：macOS shell 脚本 + |
依具体方案选型，需自行搭建与维护 |
| 部署方式 | macOS：进入 macos 目录，运行 install-dream-skin-macos.sh 安装到稳定路径，再用菜 | 多托管于第三方平台或订阅云服务 |
| 功能侧重 | 本机回环 CDP 注入：injector.mjs 仅连接 127.0.0.1/localhost 的调试端点并注入 CS | 功能通用，定制深度有限 |
| 数据归属 | 数据自持，部署在自有服务器，不出站 | 数据通常留存于服务商侧 |
| 成本模式 | 获取后自主部署，无持续授权费用 | 通常按订阅或调用量计费 |
技术栈与运行环境
- 前端/注入：JavaScript（Node ESM）配合 CSS 变量注入
- 平台实现：macOS shell 脚本 + SwiftBar 菜单栏；Windows PowerShell + 系统托盘
- 运行环境：需已安装并启动过官方 Codex 桌面端（~/.codex/config.toml 存在）；macOS 复用 Codex 自带的签名 Node，无需单独装 Node
- 其他依赖：Windows 端需要 Node 环境运行 CDP 注入脚本；无额外第三方服务
安装与部署提示
- macOS：进入 macos 目录，运行 install-dream-skin-macos.sh 安装到稳定路径，再用菜单栏或 Install Menu Bar 启动；切换主题用 switch-theme-macos.sh –id <preset-id>。
- Windows：以合适权限运行 install-dream-skin.ps1 与 start-dream-skin.ps1，托盘里从「已保存主题」切换并更换背景图。
- 注入仅限本机回环，运行期间勿启动来路不明本机程序；工具不修改官方目录与签名，也不自动改写 API Key/Base URL。
截图与演示说明
从源码结构看，可优先补充以下截图：macOS 菜单栏主题切换面板、Windows 系统托盘「更换背景图」界面。
Codex 首页浅色与暗色注入实机效果可参考 docs/images/presets/ 下的 romantic-rose-light.jpg 与 romantic-rose-dark.jpg。
概念图画廊见 docs/images/gallery/skin-01 至 skin-08（八种风格），内置预设背景见 macos/presets/*/background.jpg。
安全风险提示
特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！
补充说明：内置竖绘/人物风格预设（如 romantic-rose）的人物素材仅作主题示意，公开再分发前请确认肖像与素材权利。
本工具不修改官方二进制、不改写 API Key，本身不含后门逻辑，但仍建议下载后在隔离环境做一次安全审计。
下载说明
源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。
内置竖绘/人物风格预设如用于公开再分发，请先确认肖像、素材与商标权利。
GitHub开源地址：https://github.com/Fei-Away/Codex-Dream-Skin