正文

换肤工具最重要的能力不是“换上去”，而是“随时能还原”。Dream Skin 会保存安装前的外观配置，并记录注入器、端口和 Codex 身份。需要暂时回到官方界面时，请使用 Pause 或 Restore，不要直接删除目录。

暂停和恢复的区别

暂停适合短时间停止主题，例如线上演示或排查页面问题。它保留主题文件和设置，之后可以从托盘或菜单栏重新启用。

Restore 是完整运行时还原：停止注入器、移除页面主题层、关闭调试会话，并按选项恢复官方外观。它适合准备升级、长期不用或遇到 UI 异常。

Windows 恢复

需要恢复安装前 Appearance 时：

要把 config.toml 精确恢复为备份字节，使用 -RecoverConfigBackup。两者不要同时使用。恢复配置可能重启 Codex，先保存未发送输入。

确认不再使用后，可加 -Uninstall 删除项目创建的桌面和开始菜单快捷方式。它不会删除官方 Codex、任务、插件或认证信息。

powershell -ExecutionPolicy Bypass -File .\windows\scripts\restore-dream-skin.ps1
powershell -ExecutionPolicy Bypass -File .\windows\scripts\restore-dream-skin.ps1 -RestoreBaseTheme

macOS 恢复

只停止注入而不恢复 Appearance 时，去掉 --restore-base-theme；只删除桌面启动器时加 --uninstall。macOS 脚本还会移除持续注入的 launchd 看门程序，确保退出 Codex 后不会自动重启。

~/.codex/codex-dream-skin-studio/scripts/restore-dream-skin-macos.sh --restore-base-theme --restart-codex

恢复前检查

恢复后重新打开 Codex，确认官方外观、项目和历史任务仍然存在。换肤不应影响模型、API Key 或 Base URL。如果这些内容异常，说明发生了超出正常换肤范围的问题。

  • 保存未发送输入和正在运行的任务。
  • 关闭可能连接 Codex CDP 的本机工具。
  • 使用项目脚本，不要手动删除 config.toml。
  • 如果提示身份不匹配，保留日志并停止操作。

为什么不建议手工删除

直接删除主题目录可能留下 Node 注入器、CDP 端口或快捷方式。手工编辑 config.toml 还可能破坏 UTF-8 编码。Restore 会按进程身份、端口和配置备份执行，失败时保留状态，便于诊断。

常见问题

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

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

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

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

来源与延伸阅读