定制你的 Codex Dream Skin 主题

准备图片

• macOS 支持 PNG、JPEG、HEIC、TIFF 或 WebP。
• 源文件不超过 50 MB，处理后资源不超过 16 MB。
• 建议宽度至少 2000px，这是一项构图建议。
• 左侧尽量安静，并为原生标题保留足够明暗对比。

为什么单图只能折中

同一张原图既会作为超宽首页横幅，也会作为任务页背景。只针对一个页面做得完美的裁切，在另一处可能遮住人脸、文字或关键细节，因此应优先围绕两处共用的安全区构图。

CodexSkin 实测构图建议

以下数值来自 CodexSkin 的实际使用经验，不是 OpenAI 或上游项目的官方要求。

• 使用 20:9 超宽画布。
• 人脸中心放在画面宽度的 70% 至 82%、画面高度的 35% 至 50%。
• 人物高度不超过画面 45%，并为完整头部保留充足头顶空间。
• 左侧 55% 保留为暗色、低细节负空间，保证首页和任务正文可读。
• 关键细节远离底部输入框区域，避免被任务页 composer 遮挡。
• 背景细节保持克制，图片中不要生成文字、Logo、边框或界面元素。

复制可用原图提示词

可将下面这段中立提示词用于能够生成超宽原图的图片生成工具；生成后仍需按下一节检查两个页面的实际裁切。

应用前检查图片

• 使用上方提示词生成一张 20:9 原图。
• 分别预览超宽首页横幅裁切和常规任务背景裁切。
• 通过下方上游文档记录的 macOS 流程应用图片。
• 实际检查首页和任务页，包括标题、正文与底部输入框。
• 如果任一页面遮住主体或影响阅读，就移动主体、简化背景后重新生成并复查。

使用 Finder 选择器

~/.codex/codex-dream-skin-studio/scripts/customize-theme-macos.sh

不带参数运行即可在 Finder 选择图片，编辑器会处理本地资源并更新主题配置。

使用 macOS 命令行

~/.codex/codex-dream-skin-studio/scripts/customize-theme-macos.sh \
  --image "/path/to/image.png" \
  --name "My theme" \
  --accent "#7cff46" \
  --secondary "#36d7e8" \
  --highlight "#642a8c"

重新应用并检查可读性

更换图片后启动或重新应用 Dream Skin，同时检查主页和任务页。如果文字对比不足，请换用更安静的裁切或调整强调色。

编辑复核说明

为两个页面构图，而不是只为一张截图

首页更像带有大标题和卡片的超宽横幅，任务页包含更高的阅读区域、代码、状态信息和固定在底部附近的输入框。同一张图片会被不同裁切和遮挡。应先满足更困难的长时间阅读：在文字后方留出宽阔、低细节区域，再把主体放到首页仍能识别的位置。一张背景是否成功，取决于界面能否持续轻松浏览，而不是空白页面截图是否惊艳。

人脸位于宽度 70% 至 82%、高度 35% 至 50% 是工作区间，并不要求图片必须有人物。风景、产品、建筑和抽象图也可把主要视觉重量放在右侧同一区域，并保持左侧 55% 安静。主体高度不超过 45% 可以保留头顶与裁切余量。底部输入框区域应视为不可用空间：纹理可以经过，但人脸、手部、符号、地平线和其他关键细节不应依赖该区域完整表达。

用真实界面状态检查可读性

暗色图片也可能难以阅读。星点、发丝、树叶、城市灯光或生成的伪文字具有高频局部对比，即使平均亮度很低，也会与文字笔画竞争。除了大标题，还应检查正文、弱化元信息、代码、选中态、链接、错误提示、禁用控件和焦点边框。低细节区域在全尺寸与响应式裁切后都应保持安静。如果必须用厚重不透明面板覆盖整张图，应先简化原图。

• 按实际使用窗口尺寸检查，不要只看导出分辨率。
• 关注小号弱化文字背后的最亮和最暗区域，而不只看主标题。
• 临时使用灰度预览，发现饱和色可能掩盖的明暗冲突。
• 滚动长任务，让不同内容经过同一背景区域。
• 检查焦点和选中边框，避免背景让键盘导航模糊。
• 先降低纹理、亮度变化和主体尺寸，再增加不透明遮罩。

建立可重复的裁切复核流程

把原始母版保存在主题状态目录之外，导出工作副本并通过文档记录的平台流程应用。每次记录首页和任务页发生的变化，重点寻找三类失败：主体被裁切或遮挡；文字落在明亮、密集区域；底部输入框覆盖关键元素。一次只改变主体位置、尺寸、背景细节或明暗范围中的一个变量，这样下一版才能说明调整是否有效。

• 导入前同时预览 20:9 首页裁切和 16:9 任务页近似裁切。
• 导入后检查宽、中、窄三种桌面窗口，因为可见边缘会随布局变化。
• 对比空白首页与内容丰富的任务页，任何一个都不能代表全部场景。
• 为导出文件保留版本号，失败时可以对比或回滚，不覆盖母版。
• 裁切确认后仍要重复平台验证与恢复，视觉通过不能代替技术验证。

保留可证明的图片授权记录

自己的摄影或插画应保留原始文件和创作日期；委托作品应保存说明改编与展示权的协议；素材库或生成内容应记录供应商、素材页或生成记录、许可证版本、必要时的购买凭证，以及商业使用、再分发、可识别人物、商标和敏感地点限制。提示词本身不能建立完整授权链，移除 Logo 也不能修复未经授权的来源。

个人桌面使用和公开下载主题是不同用途。分享主题页前必须确认背景文件允许再分发，并能按要求提供署名。不要把 OpenAI 或 Codex 标识当作自己的品牌，也不要暗示官方批准。本站原创主题页会记录素材来源和使用条款；你对外分发的素材也应采用同样做法。

导入后效果不正确时

• 主体被裁切时回到母版，缩小主体或把焦点向右侧安全区内部移动。
• 文字嘈杂时降低阅读区细节或压缩明暗范围，不要只提高文字亮度。
• 输入框遮住关键元素时把元素上移，在原图内留出底部空间通常更稳定。
• 颜色不协调时把背景与强调色分开测试，每次只改一个配色变量。
• 导入失败时用图片副本核对格式和大小限制，再查看平台诊断输出。
• 只有一个页面变化时，应视为运行时或兼容问题，并保留验证证据提交上游。