Codex 主题与皮肤

Codex 主题是一套面向 ChatGPT 桌面应用中受支持 Codex 区域的结构化视觉数据与本地图片。Codex Skin 是一个独立第三方产品，负责展示、交付、校验、应用和恢复这些主题。

不少用户也会把最终外观称为 Codex 皮肤。在这个产品里，“主题”和“皮肤”不是两种不同的包格式，只是描述同一种视觉变化时采用的不同说法。

Codex 主题改变受支持的工作区外观

主题包为一个确定的主题 ID 与版本提供设计数据。固定本地引擎会把这些数据映射到经过验证的 Home、对话和输入区域，其中可以包括受允许的背景、表面、主要与次要文字颜色、边框和其他白名单视觉 token。

主题不会改变模型、任务内容、工具执行方式和用户权限。它只是受支持 Codex 工作区区域的外观层。

在英语环境中，theme 是更稳定的品类词，dark theme、light theme、custom themes 和 theme switcher 都很常见。因此，图库把每一套发布项目称为 Codex theme。

skin 更常用来描述一整套视觉处理或 skin pack，也是 Codex Skin 品牌的一部分。实际使用中，可以说用户“应用一套主题”，随后在当前 Codex 窗口看到对应“皮肤”。

两个词之间没有隐藏的技术分界，都指向同一种 data-only 发布格式和同一条验证应用路径。

单独一张壁纸还不是 Codex Skin 主题。原图是一项已声明图片资产，完整主题包还需要识别、校验和安全渲染所需的结构化信息。

已声明原图
+ 受允许的设计数据
+ Helper 持有的渲染规则
= 一套已发布 Codex 主题

manifest 会标识六位 public ID、主题版本、深浅模式、允许的设计 token、区域开关、兼容字段和资产 hash。布局模板、adapter 与验证规则由引擎持有，主题包不能用自己的代码替换这些规则。

资产就绪时，主题详情页会展示两个相关视图：主题原图，以及套入固定 Codex 工作区外壳后的 applied preview。前者用于看源图，后者用于看图片与设计数据放进周边界面后的效果。

当前已发布主题可以影响 Home、对话和输入体验中经过允许的部分，例如：

具体覆盖范围取决于当前主题与引擎版本。Codex Skin 不承诺所有原生工具或功能页面都会加入自定义原图。Sites、Scheduled、Plugins、设置与右侧原生工具区域继续使用与皮肤匹配的官方 Codex palette，不继承对话区域专用样式。

主题包不能包含任意 CSS、JavaScript、Shell、PowerShell、selector、可执行文件、符号链接、路径穿越、未声明文件或远程执行 URL。进入 Apply 前，包内容和资产都会经过严格白名单检查。

主题也不能改变 Codex 功能逻辑、网络请求、账户权限和安全设置。Codex Skin 不会修改官方 .app、Windows package、app.asar、代码签名或系统保护目录。

当前支持面是 ChatGPT 桌面应用中的 Codex 界面。Codex Skin 主题不会调整 ChatGPT 网页版、Codex CLI、IDE 扩展或浏览器扩展。

每套已发布主题都有六位 public ID，例如 100002，并且带有版本。这个 ID 让图库、插件请求、交付服务和可见验证指向同一套主题。同一个主题可以通过新版本更新内容或兼容数据，不需要换一个 public ID。

Free 和 Pro 是访问层级，不是两种安全格式。两类主题包都需要经过授权的设备才能交付，都要通过相同的签名与内容检查，只有完成相同的可见验证后，插件才会报告成功。

主题图库和独立详情页负责每套主题的名称、预览、ID、版本、访问层级与相关选择。本页只解释共享格式，不复制 23 套目录数据。