Codex Theme Maker — 从零做出「迪迦奥特曼主题」水平的 Codex 皮肤

你（Agent）将把一张概念图或一种 IP 风格，变成 Codex 桌面应用里完整、可交互、可开关的素材化主题。本文是完整作战手册：跟着七个阶段走，每一步的工具、参数、坑都已为你踩平。基准线是内置主题 guts-terminal（迪迦奥特曼 TPC/GUTS 指挥终端）——做完后你的主题应达到同等水平。

最终交付物不是主题目录，而是一个 .codexskin 包（Phase 6 产出）——它是 Codex App Manager 的画廊、导入与后续云端分发消费的统一格式。验收通过但没有打出 .codexskin 的主题视为未完成。

什么叫"迪迦主题水平"（验收基准）

• 素材化而非调色：背景、输入台、卡片、全部 icon、品牌 Logo、按钮道具都是 AI 生成的位图素材；文字全部是活的原生 DOM（素材上绝不烙文字）。
• 全覆盖：首页、对话页、设置页、侧栏、右栏、底部面板、浮层菜单、tooltip 无一处漏网原生样式。
• 深浅双模式：跟随 Codex 外观设置自动切换，两种模式下所有文字可读。
• 零破坏：所有交互正常、无新增滚动、无布局位移、无闪烁；off 一键完全还原原生。
• 有惊喜：开屏动画、双态按钮（如神光棒开壳=可发送/收拢=禁用）这类叙事细节。

依赖（开工前必须确认）

1. 工作台：awesome-codex-skins 仓库的 studio/——CLI、注入器、运行时都在这里，参照皮肤在同仓库 skins/guts-terminal。定位顺序：环境变量 CODEX_SKINS_REPO → ~/awesome-codex-skins → 询问用户 clone 位置（git clone https://github.com/Wangnov/awesome-codex-skins）。下文所有 node bin/codex-theme.mjs … 均在 <repo>/studio/ 下执行；皮肤目录为 <repo>/skins/<id>/（CLI 自动定位，可用 CODEX_SKINS_ROOT 覆盖）。
2. 素材生成——任选其一：优先 gpt-image-2-skill（开源，含品红底抠图与 alpha 验证管线，node <skill>/scripts/gpt_image_2_skill.cjs --json ...；开工按其 runtime freshness 规则检查版本，再跑 config inspect、doctor、auth inspect；Provider 不做假设：用 --provider auto，全局参数放在 images edit / transparent generate 等命令组之前）。在 Codex 环境下也可 fallback 到 Codex 自带的 image generation 能力——生成质量要求不变，但抠图/验证需自行走本仓库 scripts/ 的 Python 管线。无论哪个引擎，素材硬约束（品红底、无文字、2MB 上限、alpha 验证）一律不变。
3. 运行环境：macOS、Node ≥ 20（系统 node 或 Codex 自带 Contents/Resources/cua_node/bin/node）、官方 Codex.app（bundle id com.openai.codex）、Python3 + Pillow（素材后处理）。