zhijian-skills 之 codex-theme-studio：设计、应用并一键回滚 macOS Codex 可逆皮肤完整指南-育师

【免费下载链接】zhijian-skills

Canonical source and governance toolkit for Zhijian AI public Agent Skills

项目地址：https://gitcode.com/gh_mirrors/zh/zhijian-skills

codex-theme-studio是 zhijian-skills 中一款面向 macOS Codex Desktop 的可逆皮肤（主题）工具：它帮你设计、应用、验证并一键回滚 Codex 自定义皮肤，全程不修改官方应用包、不动app.asar、不破坏代码签名。对喜欢折腾桌面工具外观、又担心"改坏装不回去"的 macOS 用户来说，这是一套带完整恢复链路的换肤方案。

一、codex-theme-studio 能做什么 🎨

核心能力来自 SKILL.md：

设计：把颜色、字体、本地图片、圆角、密度和品牌规范编译成一套可移植主题，先校验、不安装、不重启 Codex；
应用：安全预检 → 安装运行时 → 导入或创建主题，重启运行中的 Codex 必须取得你的明确授权；
验证/修复：运行确定性测试、Doctor 和实时 Verify，只修复有证据支撑的选择器或布局问题；
暂停/恢复：暂停可移除当前样式但保留 Codex 进程；恢复则连同受管调试会话一起清理，回到官方外观。

主题变量均经过约束校验（颜色、UI/代码字体、字重、本地位图、圆角、密度、选中态），不执行任意用户 JavaScript，也不会用截图覆盖真实界面。

二、工作原理：回环注入，不改官方应用包 🔒

传统"改主题"往往是直接修改 Electron 应用的app.asar——风险高、易被更新覆盖，还破坏签名。codex-theme-studio 采用另一条路线：

只通过本机回环（127.0.0.1）Chrome DevTools Protocol向已验证的app://Codex 页面注入 CSS 与渲染辅助代码。

这条链路的关键安全设计（见 safety-and-rollback.md）：

层级	说明
基础外观快照	首次安装时对原生主题导出做不可变快照，已有备份绝不静默覆盖
升级前引擎快照	替换前的引擎与活动主题哈希清单
原子部署	新引擎与主题先暂存、校验、再原子替换，失败自动回退
授权闸门	设计、测试、静默安装都不等于允许重启 Codex；常驻续载需单独授权

注入器还会校验官方应用签名、端口归属与图片路径，任何一项不通过都会在注入前中止。

三、快速上手：安装与一键应用步骤 🚀

环境要求：macOS + 官方 Codex Desktop（com.openai.codex），以及 Bash 和 macOS 标准命令行工具。

第 1 步：安装 Skill

npx skills add zjp1997720/zhijian-skills \ -g -a codex --skill codex-theme-studio --copy -y

第 2 步：用自然语言驱动，例如：

使用 $codex-theme-studio 为官方 macOS Codex 设计一套暖纸主题。 先生成并验证主题，不要重启 Codex。

第 3 步（手动党）：构建并干检主题，完整命令清单见 operator-runbook.md：

node <skill-dir>/scripts/injector.mjs --check-payload --theme-dir <theme-dir> bash <skill-dir>/tests/run-tests.sh

第 4 步：默认只安装、不启动

bash <skill-dir>/scripts/install-dream-skin-macos.sh --no-launch

运行时安装在~/.codex/codex-theme-studio，恢复状态存放在~/Library/Application Support/CodexThemeStudio（仅属主可读）。只有当你明确授权重启后，才会执行start-dream-skin-macos.sh --prompt-restart。

四、两套内置预设：graphite-paper 与 zhijian-ai 📦

预设策略见 preset-policy.md：

graphite-paper：中性无品牌默认预设，系统字体 + 抽象工作流线条插画，适合不想引入任何品牌元素的用户；
zhijian-ai：智见 AI 暖纸预设，思源宋体字栈、暖纸色板，搭配"控制杆启动"横幅插画，单独授权使用、不会混入通用默认主题。

先查看预设清单，再"只导入、不应用"：

./scripts/list-presets.mjs ./scripts/import-preset-macos.sh --id graphite-paper --no-apply

想要自己的图片？把明确提供的图片交给customize-theme-macos.sh即可，永远不会覆盖 Skill 自带资产；需要新建位图时可调用 Codex 内置$imagegen（规则见 imagegen-assets.md）。

五、一键回滚：暂停、恢复与版本回退 🔄

这是本 Skill 最让人安心的部分——每一条恢复命令都有明确入口：

# 只移除注入样式，Codex 尽量保持运行 bash ~/.codex/codex-theme-studio/scripts/pause-dream-skin-macos.sh # 移除实时注入并重启官方外观 bash ~/.codex/codex-theme-studio/scripts/restore-dream-skin-macos.sh \ --restore-base-theme --restart-codex # 恢复最近一次升级前的引擎与活动主题 bash ~/.codex/codex-theme-studio/scripts/restore-version-macos.sh

回滚边界非常克制：只动本项目的运行时、状态、启动器与受管回环会话，绝不删除任务、对话、项目或无关配置，也绝不修改官方.app、app.asar与签名。