恢复 Codex 官方外观

Windows 恢复

使用桌面 Restore 快捷方式，或运行仓库脚本。下面的参数只恢复安装时保存的外观项。

.\scripts\restore-dream-skin.ps1 -RestoreBaseTheme

macOS 恢复

双击 Codex Dream Skin - Restore.command，或运行安装后的恢复脚本。

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

会保留什么

• 官方 Codex 应用与签名
• 对话、项目、宠物/插件和登录状态
• API Key、Base URL 和模型供应商设置
• Dream Skin 状态目录中的用户图片与日志，除非另行删除

验证恢复结果

确认 Codex 重新打开后不再显示主题，并且回环调试会话已经关闭。状态不明确时使用对应平台的验证或 doctor 脚本。

编辑复核说明

准备一次可控恢复

先保存 Codex 中的工作，并记录哪个窗口仍显示定制外观。关闭无关终端和重复辅助进程，确保接下来的恢复动作只对应本次会话。找到安装时使用的源码或启动器，与当前上游说明核对。如果问题发生在更新之后，记录变化来自 Codex、操作系统还是第三方项目；这条时间线可以避免把应用兼容问题误认为恢复失败。

不要首先删除状态目录、快捷方式、图片或日志。已记录会话和保存的外观值能帮助脚本只针对预期辅助进程和主题窗口。正常恢复前手动清理会破坏上下文，使后续诊断更困难。如果本页命令与你使用的源码提交不同，应停止并遵循当前源码，不要把两个版本拼接执行。

确认官方应用回到干净状态

• 从开始菜单、Applications、Dock 或其他官方入口启动 Codex，不要再次使用 Dream Skin 启动器。
• 同时检查首页和任务页，确认背景、强调色和其他运行时样式已经消失。
• 确认项目、对话、登录状态、供应商设置与键盘交互仍正常。
• 使用平台 verify 或 doctor 输出确认已记录的本机样式会话不再活动。
• 退出并再次打开官方应用；能够经受一次干净重启的结果更可靠。
• 如果之后要卸载辅助文件，先保留必要且已脱敏的日志，直到确认恢复成功。

干净恢复不等于必须删除每张用户图片、日志或快捷方式。恢复与卸载是两个决定：前者停止已记录的视觉会话、按文档恢复保存的外观值并正常打开官方应用；后者才处理残留用户文件。只有在当前上游文档中确认文件用途，并确定不再需要定制与诊断历史后，才执行额外删除。

不猜测地排查残留现象

背景仍然存在时，先确认你是否误用了主题启动器而不是官方入口。只有一个旧窗口保留主题时，关闭它并重新走官方启动。官方应用在没有辅助层时也无法打开，应先独立复现，问题可能来自 Codex 或系统更新。恢复脚本无法识别进程或状态时，保留输出，并比较安装文件与当时使用的源码提交。

• 每次登录都重新出现主题，可能仍在使用快捷启动器或可选菜单集成。
• 普通外观已恢复但快捷方式仍存在，属于卸载问题，不代表运行时样式活动。
• 恢复后官方窗口空白或异常，应先在无辅助层状态复现，再判断是否是主题缺陷。
• 本机端口被占用时应识别占用进程，不要结束无关开发工具。
• 两台机器表现不同，应提供平台、架构、源码提交和启动器，而不是假设原因相同。

带着证据反馈，并保护隐私

网站文案、链接或独立指南不清晰的问题反馈给 CodexSkin；脚本错误、进程选择、兼容性和恢复行为提交到原始项目，因为本站不维护或分发工具。公开前移除用户名、主目录、令牌、账户标识、可能泄露私人工作的仓库名和任务内容。只分享包含错误与必要上下文的最小日志片段。

反馈中还应区分事实、推测和已经尝试过的操作。按时间顺序写清最初状态、执行的恢复入口、终端输出、官方应用重新打开后的结果，以及问题能否稳定复现。不要为了获得更多日志而重复执行未经确认的高权限命令；一份范围明确、隐私已处理的记录，比大量无关截图更容易帮助维护者定位原因。

• 写明 Windows 或 macOS、系统版本、处理器架构和官方 Codex 分发来源。
• 提供上游提交或发布版本、恢复启动器或命令，以及安装是否使用自定义选项。
• 说明官方入口打开后的表现、仍有哪些主题效果，以及第二次干净重启是否改变结果。
• 附脱敏 verify 或 doctor 输出，并说明恢复、退出和重启顺序。
• 除非必要、具有授权并彻底脱敏，否则不要公开背景图片或任务截图。