Codex Dream Skin 使用教程

在 macOS 安装 Codex Dream Skin

安装 Codex Dream Skin，切换图片型主题，验证真实 Codex 界面，并保留可用的恢复路径。

简短答案

在 macOS 上，Dream Skin 把程序文件安装到 ~/.codex，把主题和日志保存在 Library/Application Support。它通过仅限本机的连接打开签名有效的 Codex 官方应用，不会修改 Codex 应用包或 app.asar。

只从 Fei-Away/Codex-Dream-Skin 项目主页获取文件。运行安装器前，先阅读当前安装说明、许可证和素材声明。

预期结果：安装前能确认项目作者、macOS 目录、安装命令和恢复命令。

失败时：如果文件来自未知镜像或缺少恢复命令，就停止执行。

从下载的项目文件夹进入 macos，运行不自动启动的安装命令。它会创建桌面快捷方式，并把程序文件复制到 ~/.codex/codex-dream-skin-studio。

cd macos
./scripts/install-dream-skin-macos.sh --no-launch

预期结果：命令报告安装成功，并创建启动、定制、验证和恢复快捷方式；主题和日志位于 ~/Library/Application Support/CodexDreamSkinStudio。

失败时：官方应用、签名、自带 Node.js、配置或必需文件检查失败时不要绕过。确认 Codex 官方应用已安装并至少打开过一次。

内置和下载的主题包都放在 ~/Library/Application Support/CodexDreamSkinStudio/themes/<theme-id>。同一文件夹内必须保留 theme.json 和它引用的图片，切换时使用文件夹 ID，而不是任意路径。

~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh \
  --id <theme-id>

预期结果：主题包被暂存为当前主题；获得重启授权后 Codex 启动，同一张背景图持续显示在原生控件后方。

失败时：主题被拒绝时，检查 theme.json 是否有效、图片路径是否为相对路径、图片是否留在主题包内，以及尺寸是否符合 Codex Dream Skin 项目说明。

运行项目附带的检查并保存截图。它会确认 Dream Skin 已连接到 Codex、原生侧栏和输入框仍在，并且装饰层不会拦截点击；之后还要手动检查首页和一个普通任务。

~/.codex/codex-dream-skin-studio/scripts/verify-dream-skin-macos.sh \
  --reload --screenshot "$HOME/Desktop/codex-dream-skin-verify.png"

预期结果：检查成功完成；侧栏、菜单、滚动、输入、Diff 颜色、焦点和窗口缩放均可用，没有横向溢出。

失败时：只看到壁纸不算通过。先恢复，再查看 ~/Library/Application Support/CodexDreamSkinStudio 下的错误日志，确认普通 Codex 正常后再试。

使用结束、Codex 更新前或主题检查失败时，都运行已安装的恢复命令。它会恢复原来的外观、关闭 Dream Skin，并按正常方式重启 Codex。

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

预期结果：Codex 以官方外观重新打开，Dream Skin 不再运行。

失败时：恢复拒绝继续时保留本地文件和日志，不要删除备份或结束身份不明的程序；按排错教程保存准确错误并在 GitHub 项目反馈。

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