用途:为 OpenAI Codex Desktop 提供一键主题与换肤,采用 Chrome DevTools Protocol(CDP)在回环地址 127.0.0.1:9341 注入自定义 CSS 和背景,不修改 app.asar、二进制或签名资源。
主要能力:内置 12 套主题(含初音未来、原神、鸣潮、火影、恋与深空、龙珠等);支持上传任意 PNG/JPG/WebP 图片,自动提取配色并生成明暗两套变体;回复区 90% 透明自适应背景的阅读增强可切换;可选持久化启动项(macOS LaunchAgent / Windows 计划任务)在每次 Codex 重启后重新应用主题;.skill 文件支持由 Codex 端到端生成图片并应用为主题。
安装与使用:macOS 执行 cd /path/to/heige-codex-skin-studio 后 open scripts/install.command;Windows 执行 scripts\windows\install.bat。日常恢复会话可运行 scripts\windows\apply.ps1 或 scripts\windows\enable-skin.bat。卸载(Windows)运行 scripts\windows\uninstall.bat,会移除计划任务、开始菜单快捷方式、AppData 状态与安装目录。命令行选项包括 --restart、--theme miku、--custom /path/to/image.png(Windows 为 -Restart、-Theme、-CustomImage)。主题以 themes/<theme-name>/theme.json 存放,含 background.light/dark、colors.light/dark 八色板与 codexAppearance 字段。
限制:CDP 回环端口无鉴权,同用户权限的本地进程可连接;Codex 需以 --remote-debugging-port=9341 启动;部分 UI 元素使用 Codex 内置样式,皮肤仅覆盖注入的 CSS;持久化依赖 LaunchAgent 或计划任务,失败时需重跑安装脚本;常见问题包括皮肤不显示、窗口卡顿、自定义主题不保存、CDP 连接被拒、持久化开关卡在 Waiting、卸载残留文件等,可按资料中的排查步骤处理。价格与收费未提供信息。