本页面向只想使用主题的普通用户。不要 clone 仓库，也不需要安装 Node.js、Homebrew 或运行 shell 命令。
先安装官方 ChatGPT / Codex 桌面应用，至少启动一次后退出，让它创建本机配置文件。
- 在 GitHub 的 Releases 下载最新的
CodexDreamSkin-vX.Y.Z.dmg。SHA256SUMS.txt是可选的完整性校验文件。 - 双击 DMG，把 Codex Dream Skin.app 拖到 Applications（应用程序）。
- 第一次打开时，macOS 可能提示应用来自无法验证的开发者。这是因为公开发行包目前没有 Apple Developer ID 签名，不代表安装包需要执行脚本。
- 如果提示框没有“打开”，点击“完成”，然后打开 系统设置 → 隐私与安全性。在“安全性”区域 找到“Codex Dream Skin 已被阻止使用”一行，点击 仍要打开，输入登录密码并确认。
- 应用启动后会在用户目录部署或升级主题引擎。若 Codex 正在运行，按提示先退出，再从菜单选择 “安装 / 升级引擎”。 完成后，菜单栏右上角会出现 Dream Skin 图标。
放行只需要在 macOS 的图形界面完成；本项目不会要求普通用户执行 xattr、关闭 Gatekeeper，
或修改官方 Codex/ChatGPT 应用。
菜单栏图标提供启动、暂停、恢复、换图、导入主题 ZIP 和已保存主题等操作。主题状态和用户图片保存在：
~/Library/Application Support/CodexDreamSkinStudio
引擎本身位于 ~/.codex/codex-dream-skin-studio。它通过本机回环 CDP 工作，不修改官方 .app、
app.asar 或代码签名。
下载到 .zip 主题包后，选择“导入主题 ZIP…”。只接受普通 .zip，不接受 .dreamskin。正式 Studio
包包含 manifest.json、非空 theme.json、非空 theme.css、恰好一张 background.webp|jpg|png，并可选带
LICENSE.txt、manifest.sig；这些文件可直接位于根目录或只包一层主题目录。导入器会核对平台、最低
客户端版本以及清单中每个负载文件的大小和 SHA-256。theme.css 会在本机导入和应用时复验，通过后只
作用于注册部件；预留签名当前不验证。本地简化包也必须恰好包含 theme.json、theme.css 与引用图片。
导入只加入主题库，不会自动应用。ZIP 最大 32 MiB、最多 32 个条目、解压后最多 64 MiB；链接、路径
穿越、嵌套压缩包及不符合主题/图片约束的内容会在写入前被拒绝。
手动方式：从菜单选择“打开主题文件夹”，把已经解压且直接包含 theme.json、theme.css 与背景图的完整目录放入
~/Library/Application Support/CodexDreamSkinStudio/themes/，再重新打开菜单。不要只移动图片，
也不要让目录里再套一层主题目录。手动目录不经过 ZIP 导入器的归档校验，请只移动可信内容。
安装支持一键换肤的客户端版本后，DreamSkin.cc 只会在已经审核并通过新版主题包校验的主题上显示
“一键应用到客户端”。点击后，macOS 会把 dreamskin:// 请求交给 Codex Dream Skin.app；客户端会先显示
主题名称、作者、包大小和 SHA-256 摘要，只有你明确确认后才继续。
一键换肤开始前，当前皮肤必须已处于可验证的 Skin ON 状态，且“已选主题”和“已应用主题”一致；否则客户端会 在下载前停止并提示先从菜单栏应用当前皮肤，避免失败回滚恢复成并非点击前真正显示的状态。
客户端不会使用网页提供的下载地址。它只连接固定的 DreamSkin.cc 官方 API，拒绝重定向，并重新核对审核状态、 一键兼容标记、下载字节数、SHA-256、ZIP/manifest、背景图和 Safe CSS。全部通过后才导入、切换并等待真实 Codex/ChatGPT 界面报告目标主题已经渲染。第一次切换前，客户端还会用刚保存的回滚快照核对当前 renderer 的 主题 ID 与完整 revision；核对失败时不会执行任何主题切换。新主题启动或渲染失败时，客户端会尝试恢复换肤前的 精确主题，只有可见验证通过才报告已恢复。
若自动恢复本身也无法验证，客户端会报告当前状态未确认，并优先把旧主题快照移入私有的 recovery/ 目录。
如果提升目录失败但原事务目录中的快照仍可确认存在，客户端会停止清理该事务目录并显示其实际路径；启动时的
陈旧目录清理也会跳过含受约束回滚快照目录的事务。若两处都无法确认，提示会明确说明没有可承诺的恢复快照，而不会
声称一定可以恢复。快照存在不等于已经恢复，失败的新主题可能仍保留在“已保存主题”中，方便排查或稍后手动重试。
旧主题若缺少新版要求的 theme.css，仍可在网站预览或下载，但不会显示一键换肤按钮。浏览器本身无法确认
桌面端最后是否应用成功，请以客户端的完成或回滚提示为准。
更新是覆盖安装，不是重新配置：
- 从 Releases 下载新的 DMG。
- 退出 Dream Skin 菜单栏应用，并按提示关闭 Codex。
- 打开新 DMG，把新应用拖入 Applications，并选择替换。
- 再次打开应用；现有主题、图片和状态会保留。
通常同一台 Mac 在第一次允许后不会每次启动都询问。但每个新下载的、未签名的应用副本都可能 再次触发 Gatekeeper；这是 macOS 按文件和来源作出的安全判断，项目无法保证所有系统版本都只 提示一次。若出现提示，重复上面的“隐私与安全性 → 仍要打开”即可，不需要重新安装引擎。
菜单栏会每 24 小时在后台静默访问一次 GitHub Releases（启动后约 15 秒先查一次）， 发现新版本时推送一条系统通知并在菜单里显示「🆕 发现新版本」；「维护」子菜单里的 「立即检查更新」可随时手动触发。两种方式都只做检查和跳转下载页，不会静默下载或 替换应用。
先从菜单栏选择“恢复原状并卸载”，让 Codex 恢复官方外观并关闭 CDP 会话；然后把
/Applications/Codex Dream Skin.app 移到废纸篓。若要删除用户主题和图片，再手动删除
~/Library/Application Support/CodexDreamSkinStudio；这一步不可恢复，建议先备份自定义图片。
确认你打开的是 /Applications/Codex Dream Skin.app，并先实际双击一次使 macOS 记录拦截结果。
“仍要打开”按钮通常只在尝试启动后的一段时间内显示；仍没有按钮时，再次尝试打开应用，然后重新
进入“隐私与安全性”。不要关闭系统安全功能，也不要从网上复制未经核对的终端命令。
确认旧的 Dream Skin 已退出，再启动 Applications 中的新版本。若 Codex 正在运行，允许应用按 提示重启；主题数据仍在上面的 Application Support 目录中。
开发者和高级用户可参阅 macos/README.md 的仓库安装章节；普通用户应优先
使用 Release DMG。