Codex Dream Skin 使用教程

Codex 皮肤不生效：安全排错指南

按安全顺序定位安装、启动、验证、可读性、更新和恢复问题。

简短答案

先恢复并确认普通 Codex 正常，再判断问题属于安装、启动、主题文件、可读性、应用更新还是恢复，只修改真正出错的部分。

恢复 Dream Skin，并按官方方式启动应用。没有 Dream Skin 时首页、任务或输入框仍失败，说明问题不在主题设置。

预期结果：再次尝试主题前，普通 Codex 已经可以正常使用。

失败时：官方应用本身有问题时，不要继续修改 theme.json 或 Dream Skin 文件。

macOS 检查官方应用是否至少打开过一次，以及 ~/.codex/config.toml 是否存在；Windows 检查 Node 22+ 和当前用户的 Store 应用。

# macOS
test -f "$HOME/.codex/config.toml" && echo "Codex config found"

# Windows PowerShell
node --version
Get-AppxPackage -Name OpenAI.Codex

预期结果：平台所需条件齐全，而且没有绕过签名、应用来源或程序身份检查。

失败时：改用官方应用来源或受支持的 Node.js，不要让命令指向任意可执行文件。

使用项目附带的检查，不凭外观猜测。查看错误指出的日志；Dream Skin 无法确认当前 Codex 进程或主题文件时，先恢复再重试。

预期结果：检查确认主题已连接到 Codex、原生控件仍在，并且装饰层不会拦截点击。

失败时：打开的进程无法确认时，换端口或只关闭你能够识别的进程。

这通常是构图或主题设置问题。先增加表面不透明度或压暗程度，把图片焦点移出阅读栏，并测试首页和任务页，不要先修改 Dream Skin 程序。

预期结果：文字、警告、Diff 颜色、菜单、焦点环和输入框都能在背景上清晰辨认。

失败时：不要为了突出图片而隐藏原生控件或禁用点击。

先恢复 Codex 官方外观并验证更新后的应用，再从 GitHub 项目更新 Codex Dream Skin、重新运行安装器，最后再次验证。应用更新可能改变主题的连接位置。

预期结果：Codex Dream Skin 能针对当前 Codex 官方版本通过验证。

失败时：不要把旧的修改版应用或旧可执行文件覆盖到更新后的官方安装。

保留本地文件、日志和外观备份，记录准确错误、平台、Codex 版本和复现步骤。在 GitHub 提交问题前移除 API Key、token、auth.json 和私人对话。

预期结果：Issue 有可复现信息但不包含秘密，也没有破坏恢复数据。

失败时：不要把删除应用数据、配置备份或未知进程当作第一步。

应用到本地前，先预览素材和界面可读性。