用途:把概念图或某种 IP 风格,制作成 Codex 桌面应用完整、可交互、可开关的素材化主题,最终交付 .codexskin 包。触发场景包括给 Codex app 做新主题、换肤、把截图或 IP 风格还原成界面、迭代 Codex-Theme-Studio 现有主题。
主要能力:七阶段管线,涵盖预检、设计拆解(位图层与 DOM 层、素材清单与部件映射)、素材生产(生成、抠图、alpha 验证、裁剪、WebP、登记)、主题组装(theme.json、theme.css、chrome.html)、CDP 注入迭代、全面验收、交付打包。基准参照同仓库的 guts-terminal 主题。
使用方式:需 macOS、Node ≥ 20、官方 Codex.app、Python3 + Pillow,工作台位于 awesome-codex-skins 仓库 studio/ 目录,可用 git clone https://github.com/Wangnov/awesome-codex-skins 获取。常用命令(在 studio/ 下执行):node bin/codex-theme.mjs start --theme <id> 启动并首次注入;use <id> 改完热重载;screenshot 截图对照;verify --screenshot 验收;preview-shot <id> 生成预览图;pack <id> 打包产出 .codexskin。
适用场景与限制:面向 Codex 桌面端的个人主题制作,素材需品红底、无文字(品牌艺术字 Logo 除外)、单素材小于 2MB,装饰层 pointer-events: none。硬约束包括不修改应用文件、CDP 仅监听 127.0.0.1、可逆还原、config.toml 仅在 Codex 未运行时写入。素材生成可选用 gpt-image-2-skill 或 Codex 自带图像能力。其他平台支持、收费与价格信息暂未提供。