一个真正能用的 Codex skin，不只是把壁纸放到透明窗口后面。它还包含焦点位置、内容表面、正文颜色、操作色和验证方法。好看的截图只能证明某一瞬间成立，不能证明任务文字、代码 diff、菜单和输入框在日常工作中仍然清楚。
你可以直接打开 Codex Skin Maker 边看边调。图片解码、裁切、WebP 生成、PNG 预览、SHA-256 校验和 ZIP 打包都在浏览器本地完成；网站不会替你安装桌面软件。
第一步：选择你有权使用的图片
优先使用自己创作或明确获得授权的图片。网上能看到，不等于可以重新打包和公开分发。动漫角色、游戏截图、明星照片、品牌 Logo、委托作品都可能涉及著作权、商标权、肖像权或合同限制。
构图上建议选择长边约 2000 像素以上的横图，这样在不同窗口比例下有足够裁切空间。PNG、JPEG、WebP 的浏览器兼容性最稳妥；浏览器支持时也可使用 AVIF。当前制作器只处理单张、最大 20 MB 的图片。
适合的素材通常有以下特点：
- 主体明确，但不是全画面都充满细节；
- 侧栏所在的一边有暗部或安静区域；
- 正文阅读区背后没有重要人脸、文字或 Logo；
- 降低亮度后仍保留层次；
- 不依赖只有原图放大时才能看见的微小细节。
第二步：围绕界面构图
最常见的错误是把主体放在正中央，因为原图这样最平衡。但在 Codex 中，中央是最宝贵的阅读区，会出现任务说明、长文本、代码、diff 和工具输出。
把人物、发光物体或建筑主体移到外侧三分之一。左侧栏如果覆盖了高频纹理，就提高表面不透明度，或者让图片本身的安静区域落在左侧。制作器中的水平和垂直位置会同时用于实时预览与导出的背景图。
不要只按全屏效果判断。Codex 可能处于窄窗口、分屏或不同显示缩放下，cover 裁切会丢掉更多边缘内容。重要元素应留在较宽的安全区内。
第三步：分清变暗、模糊和面板透明度
三个参数解决的问题不同：
- 变暗降低图片整体存在感，适合压制抢眼的高光；
- 模糊降低细节频率，适合树叶、星点、城市灯光或颗粒纹理；
- 面板透明度把工作内容与背景分开，任务越密集，越需要稳定的表面。
建议从中等变暗、很少模糊、较高面板不透明度开始。等 Home、Task、Diff 都清楚后，再逐步露出更多背景。宣传截图偏爱大面积玻璃效果，但长时间阅读更需要稳定。
第四步：把颜色当成一组系统
操作色、表面色和正文色不能单独判断。操作色会出现在按钮、焦点、选中状态和提示标记；表面色决定侧栏、卡片、输入框的整体气质；正文色则必须在表面上持续可读。
制作器会计算两个关键 WCAG 对比度：
- 正文与表面的比例，普通文字建议至少达到 4.5:1；
- 操作色与表面的比例，可见控件建议至少达到 3:1。
通过比例不代表整个主题自动优秀，但未通过通常说明存在明显风险。安装后还要检查弱化文字、占位符、禁用状态、语法高亮以及危险操作颜色。
第五步：分别测试 Home、Task 和 Diff
Home 页面空间最大，最容易“看起来不错”；Task 和 Diff 才能暴露真正的问题。
在 Home 中检查背景、侧栏、建议卡片和输入框是否像同一套界面。不要使用带假按钮或假侧栏的整窗截图，否则用户很难区分哪些是真正可点击的原生控件。
在 Task 中检查长文本、状态信息、工具活动和输入框。高光不要刚好落在段落背后，弱化文字也不能消失。
在 Diff 中检查红绿语义色是否仍然明确。背景和操作色不应与新增、删除状态混淆。必要时提高面板不透明度。
第六步：审查导出包
Codex Skin Maker 导出的 .dreamskin.zip 只包含数据：
manifest.json：包名称、文件列表和安全标记；theme.json：构图、透明度、模糊、明暗与颜色；background.webp：浏览器本地裁切后的背景；preview.png：用于人工确认的预览图；checksums.json：主要文件的 SHA-256；README.txt：安装边界和恢复提醒；LICENSE.txt：图片权利与商标提示。
正常导出包中不应出现可执行文件、Shell/PowerShell 脚本、API Key、Base URL、登录信息或模型服务商设置。外观调整不应该偷偷改变 Codex 如何连接服务。
第七步：把安装视为独立的信任决策
公开的 Dream Skin 方案目前通过本机回环 Chromium DevTools Protocol 会话注入装饰性 CSS，并尽量保留原生控件。回环地址降低了远程暴露，但本机调试接口仍然具有较高权限，也不能简单理解为对同一用户下所有进程都完成了认证隔离。
运行前应阅读当前仓库源代码、平台说明、验证和恢复脚本。先看本站的 安装与恢复指南 和 安全模型，再回到一手仓库核对最新版本。
第八步：验证功能，而不是只看外观
应用皮肤后至少测试：
- 侧栏导航和项目切换；
- 首页建议卡片与新任务；
- 一段较长的正常任务；
- 菜单、弹窗和键盘焦点；
- 代码 diff；
- 输入框和提交动作；
- 文档中的恢复入口。
最终结果应该仍然是可交互的原生 Codex 界面，而不是覆盖在窗口上的假截图。Codex 或皮肤引擎大版本更新后，应重新执行这套检查。
发布前清单
- 图片是否有权再分发？
- 中央阅读区是否足够安静？
- 正文和操作色对比度是否通过？
- Home、Task、Diff 是否都可用？
- 压缩包是否只包含数据？
- 安装器是否与配方分离且可审查？
- 是否已经测试恢复？
- 是否明确说明这是非官方皮肤？
这份清单没有炫酷截图那么吸引眼球，却决定了一个 Codex skin 是短暂展示，还是能陪人真正工作的界面。