macOS · 手动与 Codex 辅助方式
在 macOS 上安装 Codex Dream Skin
开始前
确认本机前提条件
- 已安装官方 Codex Desktop，并至少启动过一次。
- 使用普通 macOS 用户账户，可访问桌面和本地应用支持文件。
- 已安装 Git，可用于克隆官方仓库。
复制限定安全范围的 macOS 提示词
此提示词只使用官方仓库，保护无关配置，将验证设为可选，并要求在最后提供恢复说明。
复制前查看完整提示词
Help me install Codex Dream Skin from the official repository https://github.com/Fei-Away/Codex-Dream-Skin.
No specific theme was selected. After installation, show me the bundled themes and ask before applying one.
Safety requirements:
- Explain each action before running it.
- Use only the official repository scripts and current repository documentation. Do not modify the official app bundle, app.asar, WindowsApps, code signatures, or system security settings.
- Do not read, print, replace, or upload API keys, Base URLs, authentication data, private project paths, images, or unrelated configuration.
- If config.toml is complex or multiline, changes during the operation, or a script refuses it, stop and explain. Never delete or rebuild it.
- If a command no longer matches the current repository documentation, stop and report the mismatch instead of improvising.
- Verification is optional, but offer it after launch and explain what evidence it creates.
- Finish by giving me the exact restore command and log/state location.
macOS workflow:
1. Confirm this is macOS and read README.md, macos/README.md, and the relevant scripts.
2. Confirm official Codex Desktop has launched at least once and ~/.codex/config.toml exists. No global Node.js install is required.
3. Clone the repository using:
git clone https://github.com/Fei-Away/Codex-Dream-Skin.git
cd Codex-Dream-Skin
4. Install using:
cd macos
./scripts/install-dream-skin-macos.sh --no-launch
5. After installation, list the bundled presets and ask which one to apply.
6. Start or customize only through the installed Dream Skin launchers/scripts.
7. Offer the optional verification command:
~/.codex/codex-dream-skin-studio/scripts/verify-dream-skin-macos.sh --reload --screenshot ~/Desktop/dream-skin-verify.png
8. Explain engine path ~/.codex/codex-dream-skin-studio, state/log path ~/Library/Application Support/CodexDreamSkinStudio, and restore with:
~/.codex/codex-dream-skin-studio/scripts/restore-dream-skin-macos.sh --restore-base-theme --restart-codex替代方式 · 手动终端流程
从克隆到恢复，清晰的六个步骤
请以普通用户身份运行命令。检出目录只用于安装；引擎会复制到你账户下的稳定路径。
克隆官方仓库
克隆官方 GitHub 项目并进入仓库。下方的安装步骤会进入 macOS 目录。
macOS
克隆引擎源码
请使用官方项目 URL，并在安装完成前保留检出目录。
git clone https://github.com/Fei-Away/Codex-Dream-Skin.git
cd Codex-Dream-Skin运行安装器
安装器会验证 Codex 已签名的内置 Node，将引擎安装到 ~/.codex/codex-dream-skin-studio，并创建桌面启动器。--no-launch 会将启动保留为单独且可见的决定。
macOS
安装但不启动
请在克隆仓库的根目录运行。该命令安装默认主题，但不会启动 Codex。
cd macos
./scripts/install-dream-skin-macos.sh --no-launch想换用其他内置主题？
安装器默认使用预设主题。可在下方选择任意内置预设，安装完成后复制其切换命令。
macOS
切换到 Midnight Aurora
安装器完成后运行此已安装脚本。你可以随时返回并复制其他预设的命令。
~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh \
--id preset-midnight-aurora选择预设主题或自己的图片
全新安装会写入内置预设。导入图片时，请使用不含 UI 的 16:9 JPG、PNG、HEIC、TIFF 或 WebP。建议源文件为 2560 × 1440，并保持在上游限制内。
macOS
打开本地自定义
图片分析仅在本地 Codex 渲染器中进行，会调整焦点、安全区和配色，不会上传图片。
~/.codex/codex-dream-skin-studio/scripts/customize-theme-macos.sh启动带主题的 Codex
在桌面打开 Codex Dream Skin。安装器还会创建 Customize、Verify 和 Restore 启动器。SwiftBar 控件是可选项，完整安装并不依赖它。
验证并保留证据
可选使用 Dream Skin 不要求验证。需要确认注入状态，或为故障排查和验证记录保存截图时再运行。
macOS
可选可选验证
重新加载注入并将截图保存到桌面。分享前请审阅截图并移除敏感内容。
~/.codex/codex-dream-skin-studio/scripts/verify-dream-skin-macos.sh --reload --screenshot ~/Desktop/dream-skin-verify.png恢复原始外观
使用桌面的 Restore 启动器，或运行恢复命令。恢复会结束当前皮肤流程，并回到已保存的基础外观。
macOS
恢复并重启 Codex
开始安装前，请确保该命令随时可用。
~/.codex/codex-dream-skin-studio/scripts/restore-dream-skin-macos.sh --restore-base-theme --restart-codex