Codex 怎么换成自己的背景图？Dream Skin 自定义主题教程

正文

第一次给 Codex 换肤时，很多人会把一张带窗口、按钮和文字的效果截图直接导入。结果是两个界面叠在一起，既不美观，也看不清输入框。Dream Skin 的正确思路是：准备一张没有 UI 的纯壁纸，让工具铺在官方控件下面，再用透明层保证文字可读。

尺寸和格式

项目推荐 2560 × 1440 的 16:9 图片，宽度至少约 2000 像素。macOS 支持 PNG、JPEG、HEIC、TIFF 和 WebP；Windows 会检查文件大小、尺寸和像素总量。超过 16 MB、单边超过 16384 像素或总像素超过 50MP 的图片会被拒绝。

生成图片时可以这样描述：

反向提示词可加入 no UI、no text、no watermark、no screenshot、no frame。

制作一张 2560x1440、16:9 的编程桌面背景。
画面连续铺满，没有窗口、按钮、侧栏、输入框、Logo、文字和水印。
左侧 50% 保持低对比、低信息量，主体放在右侧 58%-88%。

构图安全区

首页的项目选择器、建议卡和输入框通常占据左侧和中间区域。建议左侧约 50%～58% 留出安静区域，把人物、建筑或抽象高光放在右侧 58%～88%，不要贴到最右边。主体过于靠左时，会被原生内容盖住。

任务页的代码、消息和输入框需要更强对比度。如果希望任务页更安静，可把 taskMode 设为 ambient 或 off；超宽横幅图才考虑 banner。

macOS 导入背景

安装后运行：

路径有空格时要保留引号。脚本会把图片复制到主题库，并在本机 Canvas 中分析亮度、主色、焦点和安全区。分析在 Codex 渲染器内完成，不会上传图片。

需要手动调整颜色时，可加入 --accent、--secondary 和 --highlight。需要调整构图时：

focusX 和 focusY 范围为 0 到 1，0 表示最左或最上，1 表示最右或最下。safe-area left 会让左侧更适合放原生内容。

~/.codex/codex-dream-skin-studio/scripts/customize-theme-macos.sh --image "/Users/你的用户名/Pictures/codex-bg.png" --name "我的编程主题"

~/.codex/codex-dream-skin-studio/scripts/load-image-theme-macos.sh --file "/path/to/image.png" --appearance auto --focus-x 0.72 --focus-y 0.45 --safe-area left --task-mode ambient

Windows 导入背景

Windows 版通过系统托盘“更换背景图”导入。导入后可以“保存当前主题”，再从“已保存主题”切换。主题和图片保存在 %LOCALAPPDATA%\CodexDreamSkin，不会写进 Codex 的 config.toml。

首次建议先用一张小于 16 MB 的 JPEG，成功后再调整。托盘没有出现时，先运行 start-dream-skin.ps1，再查看 injector.log。

怎么判断效果合格

首页中，项目选择器和输入框要清楚，主体不要压住卡片。普通任务中，代码块、消息和输入区域必须有足够对比度。切换浅色和深色外观，确认图片不会擅自改变 shell 模式。

文字难读时，不要只把所有透明层调黑。优先重新裁切图片、降低左侧信息量，或关闭任务页背景。目标是“有氛围但能工作”。

图片版权

人物照片、动漫角色、品牌 Logo 和带水印素材可能受到肖像权、版权或商标权保护。个人本地使用和公开发布不同。分享主题包前，应使用自己创作或明确可再分发的素材。

常见问题

这篇教程适合直接照做吗？

可以作为操作参考，但执行命令前应先确认来源、平台路径、当前 Codex 版本和恢复方式。

如果换肤后界面异常，先做什么？

先停止当前自定义会话并运行 Restore，不要继续叠加新主题或手工删除配置。

正文