Codex Skin

一个原生 macOS SwiftUI 外观管理器，用可视化方式管理 Codex Dream Skin Studio 的主题。

Codex Skin 是面向 Codex 用户的开源社区工具，不隶属于 OpenAI。它基于本地 codex-dream-skin-manager Skill 和 Dream Skin Studio 引擎开发，并参考了 Fei-Away/Codex-Dream-Skin 的外观定制方向。

产品结构

壁纸、侧栏样式和完整主题可以独立管理，也可以自由组合：

这个项目不复制 Dream Skin 的 CDP 注入器，也不修改官方 Codex.app。它直接调用已经安装的 Skill 引擎：

• 导入壁纸：load-image-theme-macos.sh
• 切换主题：switch-theme-macos.sh
• 启动或重新应用：start-dream-skin-macos.sh
• 验证当前状态：verify-dream-skin-macos.sh
• 恢复官方外观：restore-dream-skin-macos.sh

Codex 联动 Skill

项目内的 Skill/SKILL.md 是 Codex 联动入口。它会指导 Codex 使用内置 imagegen 生成壁纸，再调用 manager-bridge.sh 导入、应用和验证主题，不需要 API Key。

安装 Skill：

./scripts/install-skill.sh

安装后，Codex 会识别：~/.codex/skills/codex-dream-skin-manager/SKILL.md

Bridge 会写入同一个 Dream Skin 主题库，管理器 App 每 3 秒自动刷新，因此 Codex 生成并导入主题后，App 会自动显示新主题。Bridge 会自动把 theme.json 的显示 ID 解析到实际主题目录，避免自定义主题切换时出现 Theme not found。

运行条件

• macOS 13 或更高版本
• Swift 5.9 或更高版本
• 已安装 /Users/<用户名>/.codex/codex-dream-skin-studio

构建

swift build -c release

运行

swift run

打包为 macOS App

./scripts/package-app.sh
open "dist/Codex Skin.app"

输出位置：dist/Codex Skin.app

打包脚本会自动寻找本机的 Developer ID Application 证书并签名；也可以通过 CODEX_SKIN_SIGNING_IDENTITY 指定证书。当前采用 Developer ID 直接分发，不需要在 App Store Connect 创建商店记录。若以后要上架 Mac App Store，还需要单独配置 Bundle ID、App Store Connect 应用记录、Distribution provisioning profile 和 notarization/API 凭据。

管理器读取：

• 主题库：~/Library/Application Support/CodexDreamSkinStudio/themes
• 当前主题：~/Library/Application Support/CodexDreamSkinStudio/theme

当前版本已包含 Finder 导入、主题管理主流程和 .app 打包入口。后续可继续加入 Finder 拖拽导入、主题编辑器和菜单栏常驻。

Windows 版本路线见 docs/windows-build-and-remote-workflow.md。本机 SSH 配置中的 Windows 主机使用 windows-pc 别名，文档不会暴露地址、私钥或认证内容。

开源说明

• 本仓库代码采用 MIT License。
• Dream Skin Studio、Codex 客户端和相关 Skill 可能有各自的许可证与使用条件。
• 本工具不会修改或重新打包官方 Codex.app，也不会上传用户的主题、宠物资源、密钥或本地配置。