Codex Themes

优先安全恢复

Dream Skin 故障排查

请保留错误信息,必要时执行恢复;切勿为强行得到结果而删除配置或修改官方应用包。若本地脚本或界面已变更,请遵循当前官方仓库文档。

安装后主题没有出现

请先确认 Dream Skin 是否确实已启动;在两个平台上,安装和启动都是独立步骤。

请按此顺序检查

  • 再次运行对应平台的启动程序或桌面启动器。
  • 可选:运行验证脚本并保留结果。
  • 确认 Codex 已连接到 Dream Skin 记录的本地 CDP 端口。
  • 检查受支持的状态/日志目录,但不要公开敏感内容。
  • Codex 更新后,请先比较兼容性再重试。

仍然失败时: 若缺少注入标记或预期的渲染器目标,请先恢复,并在进行其他改动前查看上游问题。

背景图片没有显示

确认你选择的是纯背景资源,而不是包含 Codex UI 的预览截图。

请按此顺序检查

  • 使用可信的 JPG、PNG 或 WebP;macOS 本地流程也支持 HEIC 和 TIFF。
  • 优先使用 2560 × 1440,并缩小异常大的文件。
  • 准备后的文件应不超过 16 MB,单边不超过 16384px,总像素不超过 5000 万。
  • 在 macOS 中通过 Customize,或在 Windows 中通过系统托盘重新选择图片。
  • 可选:验证并保留一张截图。

仍然失败时: 不要通过本站转换或上传图片。若本地解码失败,请保留源文件相关信息并查阅上游说明。

CPU 占用异常偏高

先恢复到基础外观,再比较 CPU 占用,避免过早假定原因。

请按此顺序检查

  • 记录操作系统、Codex 版本、Dream Skin 提交版本和受影响页面。
  • 恢复并正常重启 Codex 后,检查问题是否仍存在。
  • 避免反复运行验证或重载循环。
  • 查看当前上游性能问题。

仍然失败时: 网站无法修复本地性能问题。只有确认问题仍可归因于 Dream Skin 时,才分享经过脱敏的复现信息。

config.toml 解析导致安装停止

复杂或多行 TOML 可能触发安装器的安全拒绝流程。这是停止条件,不代表可以重写文件。

请按此顺序检查

  • 不要删除、清空或重建 config.toml。
  • 不要对复杂 TOML 使用正则表达式改写。
  • 保留完整错误,并记录操作期间文件是否发生变化。
  • 使用所在平台已记录的恢复方式或明确的备份恢复路径。

仍然失败时: 请带着脱敏后的错误查看上游问题。绝不可公开 API 密钥、Base URL、MCP 密钥或完整配置文件。

大图片失败或占用过多内存

重试前先缩小源图;尺寸极大或压缩方式异常的图片可能消耗过多解码内存。

请按此顺序检查

  • 可行时导出 2560 × 1440 的主文件。
  • 使用常见且可信的图片格式。
  • 缩小文件并使准备后的资源保持在 16 MB 以下。
  • 使单边尺寸低于 16384px,总像素低于 5000 万。
  • 避免使用来源不明或可疑的文件。

仍然失败时: 若文件仍在本地失败,请不要上传至本站。仅记录不敏感的尺寸、格式和文件大小,供上游诊断。

Codex 更新后布局损坏

请先恢复。Dream Skin 面向会变化的桌面渲染器,因此应用更新可能需要上游完成兼容性工作。

请按此顺序检查

  • 运行对应平台的恢复流程。
  • 比较 Codex 更新日期与当前上游发行说明。
  • 查看上游仓库是否已有更新的兼容版本。
  • 只有审阅新脚本和变更后才重新安装。

仍然失败时: 不要将修补 WindowsApps、app.asar、macOS 应用包或签名作为临时解决办法。

诊断报告模板

分享报告前,请移除用户名、API Key、Base URL、令牌、私有项目路径及个人图片。

Platform:
OS version:
Codex version:
Dream Skin commit/version:
Theme:
Install or start command used:
Verification command result:
Expected:
Actual:
Reproduction steps:
Sensitive values removed: yes/no

只分享复现问题所需的最少信息。