Taffy Codex Theme Studio

面向 Windows Codex 桌面端的永雏塔菲主题与界面定制方案。

提供15套预设配色和5个自定义配色槽位，可以替换背景图片，系统会自动对图片主色调进行采样并匹配最接近的配色。用户也可以在白天模式 / 黑夜模式、亚克力 / 液态玻璃之间调整界面风格，更可以直接关闭本界面回归 codex 经典。

本项目采用本机回环 CDP 注入，不替换 WindowsApps、app.asar 或 Codex 官方程序文件，也不修改用户的 config.toml、登录数据和任务数据。

本项目为非官方主题项目，是二创项目，与 OpenAI 及永雏塔菲官方无隶属或授权关系。

效果预览

主题主页

配色与背景设置

实际任务界面

界面支持更换背景、切换配色与材质，也可以在设置中导入自己的图片，并分别设置应用到顶部横幅、桌面背景和右下相框。

主要功能

• 15 套预设配色 + 5 个自定义配色槽位，支持独立切换白天和黑夜模式。
• 亚克力（Fluent 磨砂板：强模糊 + 噪点颗粒 + 斜向微光）与液态玻璃（真实背景折射 + 色散色边，边缘宽度/折射/高光/暗边/光源方向/色散/模糊七项参数可调）两种界面材质。
• 时钟、右下相框、星光小组件可独立开关，时钟、相框和设置按钮可拖动换位并记忆位置。
• 本地图片导入、持久化存储和自动配色匹配。
• 顶部横幅、桌面背景、右下相框三处图片独立设置。
• Codex 原生文字、图标、边框、浮层、输入框和活动状态语义联动。
• 支持热更新，并可在设置面板中临时切换回 Codex 原皮。
• 保留完整 CSS、界面脚本、测试和修改说明，方便继续制作个人主题。

使用要求

• Windows 10 或 Windows 11
• Microsoft Store 官方 Codex 桌面端
• Node.js 22 或更高版本

请完整解压下载的 ZIP，并保持目录结构不变。不要把脚本复制到 WindowsApps 或 Codex 官方安装目录。

使用方式一：交给 Codex 应用

更适合普通用户的方式。

1. 在 Codex 中把解压后的文件夹作为项目或工作区打开。
2. 新建任务并发送下面这段提示词：

请完整读取根目录 AGENTS.md、README.md 和当前目录，理解现有皮肤结构，完成环境检查后应用皮肤。不要修改 WindowsApps、app.asar、config.toml，也不要创建快捷方式或常驻后台程序。

3. Codex 会先检查运行环境和文件，再根据 AGENTS.md 中的约束应用当前皮肤。

这种方式的意义是：安装过程仍然透明可读，遇到 Codex 版本变化时，也可以先检查实际界面结构再调整，而不是盲目覆盖官方文件。

使用方式二：PowerShell 手动应用

在发布包根目录打开 PowerShell，执行：

powershell -NoProfile -ExecutionPolicy Bypass -File .\runtime\scripts\apply-taffy-skin.ps1

脚本会处理以下状态：

• Codex 未打开：以本地 CDP 模式启动 Codex，然后应用皮肤。
• Codex 已以可注入模式打开：直接热更新，不重启窗口。
• Codex 已普通打开：提示用户先正常关闭 Codex，不会强制结束进程。

V2.3.3 默认使用一次性注入。应用完成后 PowerShell 会退出，不保留长期 watcher。需要刷新皮肤时，重新执行同一条命令即可。

使用方式三：热重载（改皮肤源码时推荐）

powershell -NoProfile -ExecutionPolicy Bypass -File .\runtime\scripts\hot-reload-taffy-skin.ps1

脚本会先按同样规则确认或启动 CDP 模式的 Codex，然后以前台 watcher 运行：之后对 runtime/assets 下的 CSS、界面脚本或图片的任何保存都会在约 0.25 秒内自动重新注入，立即在 Codex 窗口中看到效果。按 Ctrl+C 停止热重载；皮肤保持应用状态，直到 Codex 关闭或在设置中切换回原皮。

回到原皮

在塔菲皮肤的“界面设置”中点击 切换为原皮，即可移除当前页面的皮肤样式，并恢复本次注入前的 Codex 原生颜色 Token。

要彻底结束本地调试端口，请正常关闭 Codex，再从系统原有的 Codex 图标启动。

修改自己的主题

• 主要视觉样式：runtime/assets/dream-skin.css
• 界面控件与交互：runtime/assets/renderer-inject.js
• 内置背景图片：runtime/assets/backgrounds/
• 调试和样式修改说明：docs/样式修改说明.md

修改时应同时检查白天 / 黑夜、文字 / 图标、选中 / 悬停、对话框 / 下拉框等状态，避免只改变背景而遗漏前景内容。

目录结构

runtime/
  assets/       皮肤 CSS、界面脚本和内置图片
  scripts/      手动应用、验证和打包脚本
  tests/        本地回归测试
  references/   DOM 与运行时说明
docs/
  安装说明.md
  故障排除.md
  Demo图片说明.md
  样式修改说明.md
demo/images/     两张可直接试用的塔菲 Demo 图

本地验证

powershell -NoProfile -ExecutionPolicy Bypass -File .\runtime\tests\run-tests.ps1
node --check .\runtime\assets\renderer-inject.js
node --check .\runtime\scripts\injector.mjs

更详细的操作见 安装说明，常见问题见 故障排除。

安全声明

• CDP 仅绑定在本机回环地址，不向局域网或公网开放。
• 不修改 Codex 官方安装包、代码签名和用户账号数据。
• 不自动创建快捷方式，不安装常驻后台进程。
• 使用第三方图片前，请自行确认相应的著作权、角色形象和公开传播授权。

上游参考

CDP 注入方案参考 Fei-Away/Codex-Dream-Skin。感谢上游项目提供的实现思路。