正文
安装脚本执行完、Codex 窗口出现，并不代表 Dream Skin 一定注入成功。真正的验证要回答四个问题：主题层是否加载、首页是否正常、任务页是否可用、恢复入口是否仍然有效。
第一层：运行 Verify
Windows：
macOS：
验证器会检查 CDP 端点、Browser ID、预期 renderer 标记和注入标记，也会检查背景层是否连续铺开。命令成功后，再进行人工检查。
powershell -ExecutionPolicy Bypass -File .\windows\scripts\verify-dream-skin.ps1 -ScreenshotPath "$PWD\dream-skin-check.png"~/.codex/codex-dream-skin-studio/scripts/verify-dream-skin-macos.sh --screenshot "$HOME/Desktop/Codex Dream Skin Verification.png"第二层：检查首页
首页应同时满足：
首页漂亮但人物正好挡住输入框，不算合格主题。可以调整 focusX、safeArea，或重新准备左侧更安静的图片。
- 背景从窗口边缘连续铺开，而不是贴在一张卡片里。
- 侧栏、项目选择器和建议卡仍然可点击。
- 输入框可以获得焦点，光标和文字没有被装饰层挡住。
- 图片主体没有压住标题、项目按钮或输入区域。
第三层：打开普通任务
让 Codex 解释一段代码，观察消息、代码块、复制按钮和输入区域。至少点击一次侧栏项目、项目选择器、输入框、发送按钮和代码复制按钮。若这些控件可用，说明主题没有用假截图覆盖窗口。
如果只有视觉变化而按钮无法点击，应立即 Restore，并检查是否导入了带 UI 的图片或装饰层版本过旧。
第四层：检查日志和截图
Windows 日志位于 %LOCALAPPDATA%\CodexDreamSkin，重点看 injector.log、injector-error.log 和 verify.log。macOS 日志与状态位于 ~/Library/Application Support/CodexDreamSkinStudio。
验证截图只用于留存结果，不要直接发布。截图可能包含项目名称、任务内容或本地路径，公开前应裁切和脱敏。带 UI 的截图也不能重新作为背景导入。
只有首页有背景
可能是任务页 taskMode 设置为 off，也可能是注入器在路由切换后退出。先运行 Verify。验证成功但任务页刻意保持原生外观，则属于主题配置。
背景有了但文字重叠
通常是图片信息量太高或安全区方向不对。换一张左侧低对比图片，先调整 safeArea，再改颜色参数。
窗口打开仍是官方外观
检查是否还有旧 Codex 实例运行。启动脚本需要带 CDP 参数的新实例。关闭旧实例后重启，不要连续点击多个启动器。
端口或身份不匹配
端口可能被其他程序占用，或 Store 更新后路径发生变化。未显式指定端口时重新启动，让脚本寻找空闲端口并发现当前包。显式端口被占用时换端口，不要关闭未知程序。
什么时候停止排查
如果恢复脚本无法确认进程身份、CDP 端点不属于 Codex，或状态文件与当前版本不匹配，不要手动杀掉所有 Node 进程。保留日志，先关闭 Codex，再 Restore；仍失败时提交脱敏的版本信息和日志到项目 Issue。
常见问题
这篇教程适合直接照做吗？
可以作为操作参考，但执行命令前应先确认来源、平台路径、当前 Codex 版本和恢复方式。
如果换肤后界面异常，先做什么？
先停止当前自定义会话并运行 Restore，不要继续叠加新主题或手工删除配置。