主题格式 / V1

创建 Codex Desktop 主题

使用引导式编辑器或公开的 codex-styler-theme-v1 协议,制作纯数据的本地 Codex Desktop 主题。

01

从可视化开始

导入本地图片后,根据明暗、主色、强调色和对比度生成四套经过设计的视觉方向,再在实时预览中调整布局、图标处理、细节、表面、圆角、动态和伙伴位置。

02

主题是数据,不是代码

.codex-styler-theme 包只包含 theme.json、本地 PNG/JPEG/WebP 资源和 LICENSES.json。JavaScript、远程 URL、SVG、视频、任意 CSS 和可执行字体都会被拒绝。

基础外观色会自动推导出覆盖表面、控件、交互状态、代码、Diff、终端、图表和状态反馈的完整可读色板;高级主题也可覆写稳定的语义角色,而不依赖 Codex 私有 CSS 变量。

分享之前,请使用仓库内公开的 JSON Schema 和主题校验命令。

03

为恢复能力设计

即使背景加载失败或用户开启减少动态,工作区也必须保持清晰。每个主题都必须提供亮色和暗色版本,并可在隔离安全模式下使用。

开源项目检查真实实现,而不只是产品承诺。查看 GitHub 仓库 →