主题教程

定制你的 Codex Dream Skin 主题

准备一张横向图片，保证原生文字可读，再用仓库记录的 macOS 编辑器生成主题资源。

查看原始项目查看上游问题

平台能力

仓库记录了 macOS 用户图片编辑器。当前 Windows 包使用随附装饰资源，没有提供相同的选择器。

准备图片

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

使用 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，同时检查主页和任务页。如果文字对比不足，请换用更安静的裁切或调整强调色。