用途：为官方 Codex 桌面应用创建、重设计、校验、预览、打包并准备统一主题，输入可以是视觉简报或参考图。主题为可逆的装饰性改动，不修改 app.asar、签名应用包、WindowsApps、用户任务或认证数据，除非所选布局模式明确允许，否则保留原生布局与交互。
主要能力：提供脚手架、校验、可逆会话应用与恢复的 TypeScript 脚本；支持 native-background、native-immersive、editorial-showcase、palette-only 四种布局模式；可生成 1440x900 与窄视口预览；导出 .codex-theme 分享包。
使用方式：需 Node.js、npx 和官方 Codex 桌面应用。生成文件默认保存在 ~/.codexthemes 下（themes、previews、exports、state）。创建前需阅读 references 下的 design-playbook、qa-checklist、theme-schema、asset-rights，并先写设计契约。脚手架命令：npx tsx scripts/scaffold-theme.ts --id <safe-slug> --name "<display name>" --layout-mode <...> --background-scope <home|workspace> [--art /absolute/artwork.png]。校验：npx tsx scripts/validate-theme.ts /absolute/theme-directory。应用：npx tsx scripts/apply-theme.ts apply /absolute/theme-directory（无调试端点时加 --launch）。状态：npx tsx scripts/apply-theme.ts status。恢复：npx tsx scripts/apply-theme.ts restore。对比度检查：npx tsx scripts/qa-contrast.ts。导出：npx tsx scripts/export-theme.ts ~/.codexthemes/themes/<theme-id>。
适用场景：需要为 Codex 桌面应用制作统一视觉主题、从参考图生成主题、预览与打包分享。
限制：应用或重启 Codex 前需明确许可；Windows 上部分安装包（如 Microsoft Store 包）会丢弃调试标志，此时只能完成源码、预览、校验与打包；.codex-theme 包须为 UTF-8 JSON，不含绝对路径、外部 CSS、脚本、追踪、密钥或私有引用，且小于 30 MB；完整退出应用后需重新应用主题。其他平台支持与收费信息暂未提供。