Codex 更新后皮肤失效怎么办？Dream Skin 重新应用教程

正文

Codex Desktop 更新后，Dream Skin 可能暂时失效。这不一定是主题文件损坏。更新会更换 Store 包版本、可执行文件路径或 renderer 页面结构，而项目为了安全会重新验证这些身份。正确做法是让脚本重新发现当前 Codex，再重新应用注入。

更新后先观察

先完全退出 Codex，再重新打开一次官方版本。如果只是客户端升级，主题目录中的自定义图片和已保存主题通常仍在 %LOCALAPPDATA%\CodexDreamSkin 或 ~/Library/Application Support/CodexDreamSkinStudio。不要一看到官方外观就删除主题目录。

如果 Codex 能正常工作但没有背景，先运行 Verify，区分“主题没有启动”和“主题配置关闭了任务页背景”。

Windows 重新应用

保存任务并退出 Codex。进入项目目录更新：

如果本地改过脚本，先不要直接覆盖。普通用户不建议把旧注入器与新版脚本混用。

重新安装和启动：

安装器会动态查找当前注册的 OpenAI.Codex Store 包，不依赖旧版本路径。主题和导入图片由主题库管理，通常不需要重新导入。

最后验证：

cd C:\你的路径\Codex-Dream-Skin
git pull --ff-only

powershell -ExecutionPolicy Bypass -File .\windows\scripts\install-dream-skin.ps1
powershell -ExecutionPolicy Bypass -File .\windows\scripts\start-dream-skin.ps1

powershell -ExecutionPolicy Bypass -File .\windows\scripts\verify-dream-skin.ps1 -ScreenshotPath "$PWD\after-update.png"

macOS 重新应用

在仓库的 macos 目录执行：

安装器会重新发现官方应用、校验签名和内置 Node.js，并部署到稳定路径。现有 custom-* 主题不会因为预设重新播种而被覆盖。

./scripts/install-dream-skin-macos.sh --no-launch
./scripts/start-dream-skin-macos.sh --port 9341 --prompt-restart
./scripts/verify-dream-skin-macos.sh --screenshot "$HOME/Desktop/after-update.png"

为什么可能失效

CDP 注入依赖客户端允许本地调试端口，也依赖页面存在预期 renderer 标记。官方更新可能改变页面结构、路由或安全策略。Dream Skin 不修改 app.asar，更新后重新应用通常更容易；代价是重大 UI 改版仍需要项目适配。

需要保留的数据

Windows 的主题、图片、暂停标记和日志在 %LOCALAPPDATA%\CodexDreamSkin；macOS 对应 ~/Library/Application Support/CodexDreamSkinStudio。这些目录可能含有个人路径和图片，备份或提交 Issue 前应脱敏。

不要把 API Key、auth.json 或中转站密钥放进主题仓库。换肤工具与 API 配置是两件独立的事。

常见问题

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

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

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

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

正文