用途:为 macOS 上官方 Codex Desktop 设计、安装、切换、验证、修复、暂停或还原可逆主题,把视觉方向、品牌系统或用户提供的图片转成主题,注入方式为仅限回环的 Chrome DevTools。
模式:Design 只准备并校验可移植主题目录,不安装、不重启;Apply 先做安全预检,再安装运行时并导入或创建主题,重启运行中的 Codex 前必须获得明确授权;Verify/repair 复现受影响路由,跑确定性测试、Doctor 与实时 Verify,只修复有证据支持的选器或布局问题;Pause 移除当前样式;Restore 同时停止受管 CDP 会话并恢复官方外观。
使用方式:先读 capability-boundary.md 确认官方 macOS 主机、授权边界与排除目标;设计工作读 design-workflow.md、theme-schema.md、preset-policy.md,改布局再读 compatibility-policy.md;运行 ./tests/run-tests.sh 并先修复失败;纯设计用 ./scripts/injector.mjs --check-payload --theme-dir <theme-directory> 校验;安装读 safety-and-rollback.md 后运行 ./scripts/install-dream-skin-macos.sh --no-launch;内置预设用 ./scripts/list-presets.mjs 列出,再用 ./scripts/import-preset-macos.sh --id <preset-id> --no-apply 导入;用户素材用 ./scripts/customize-theme-macos.sh,不得覆盖内置资产;仅在明确授权后运行 scripts/start-dream-skin-macos.sh --prompt-restart 重启,常驻管理需另行授权。验证按 verification-contract.md 覆盖首页、任务页、New Task 过渡、普通窗口与全屏,检查截图重叠、溢出、对比度、裁切与原生控件缺失。
限制:仅支持官方 macOS 版 Codex Desktop;不适用于 Windows、Linux、ChatGPT 网页、非官方 Codex 包、ZCode、豆包办公、其他 Electron 应用、模型、账号、权限、对话内容、任意用户 JavaScript、替换真实 UI 的截图覆盖、未签名应用改动、关闭签名校验、未授权持久化或未授权重启。回滚仅限本项目的运行时、状态、启动器与受管回环 CDP 会话,不删除任务、对话、项目或无关配置,也不改官方 .app、app.asar、代码签名或 macOS 安全设置。发布、升级或第三方交付前需读 trust-baseline.md;缺失的实时、视口、主机或未来版本证据应显式标注为缺失,不得声称通用或跨版本兼容。输入图片、字体、主题 JSON、截图均按文件型夹具处理,只读用户明确提供的文件,不搜索个人目录、不上传、不写入本地绝对路径到可分发的主题中。