Studio Margin for Codex

一套面向 macOS Codex 桌面端的暖色编辑部风格主题：纸张色界面、私人工作室式首页、生成式主视觉，以及跨重启自动恢复。

非 OpenAI 官方项目。Codex 和 OpenAI 是其各自所有者的商标。

特点

• 暖纸色界面，统一首页、任务页、工具页和设置页的颜色系统
• 首页使用 AI 生图主视觉；默认是钴蓝拱门与朱红纸带版本
• 不修改、不替换、不重签 ChatGPT.app 或 app.asar
• CDP 仅监听 127.0.0.1
• 用户退出 Codex 后不会强制重开；下次手动启动时自动恢复主题
• 自带验证、截图和完整卸载脚本

环境要求

• macOS
• 官方 Codex 桌面应用，位于 /Applications/ChatGPT.app 或 ~/Applications/ChatGPT.app
• Node.js 22 或更高版本
• 系统自带的 curl、launchctl、plutil 和 osascript

安装

mkdir -p ~/.codex/skills
git clone https://github.com/Stephen-creater/studio-margin-codex-theme.git \
  ~/.codex/skills/studio-margin-codex-theme

cd ~/.codex/skills/studio-margin-codex-theme
./scripts/start-studio-margin.sh --restart-existing

第一次应用时 Codex 会短暂重启。安装脚本会创建用户级 LaunchAgent：

~/Library/LaunchAgents/com.studiomargin.apply.plist

它不会让 Codex 永远保持打开。用户退出后 supervisor 会等待；当用户再次正常打开 Codex 时，它会将该实例重启一次为仅回环可调试模式，然后重新注入主题。

验证

./scripts/verify-studio-margin.sh \
  --screenshot /tmp/studio-margin-preview.png

验证器会检查主题版本、样式标记、首页主视觉、侧栏、输入框和横向溢出。

卸载

./scripts/restore-studio-margin.sh

卸载会停止 LaunchAgent 并移除当前页面中的主题，不会删除任务、账号、项目或 Codex 配置。

更换主视觉

四个 AI 生图候选保存在 assets/hero-options：

A · Editorial muse	B · Cinematic editor

C · Surreal atelier（默认）	D · Private creator

切换方式：

cp assets/hero-options/option-d-private-creator.png \
  assets/studio-margin-hero.png

随后增加 themes/studio-margin.json 中的 version，再运行安装脚本。

所有艺术和装饰图像都应由图像生成模型制作，或由使用者明确提供。CSS 只负责排版、裁切、颜色、字体、可读性和交互状态。

工作原理

1. start-studio-margin.sh 安装用户级 LaunchAgent。
2. supervisor-studio-margin.sh 只在用户打开 Codex 后确保它运行在 127.0.0.1:9335。
3. injector.mjs 通过本地 Chromium DevTools Protocol 注入 CSS 和本地图片。
4. watcher 在页面重载或新 renderer 出现时重新注入。

运行时状态和日志位于：

~/Library/Application Support/StudioMarginCodex/

安全与限制

• 无 sudo、无远程字体、无遥测、无外部数据上传
• 不读取 SSH、云服务、浏览器 Cookie 或 Codex 对话内容
• 只连接 127.0.0.1 上的本机 CDP
• 会启动和结束 Codex 进程，以确保启动参数正确
• Codex DOM 选择器可能随应用更新变化；升级 Codex 后建议重新运行验证
• 若端口 9335 被其他程序占用，supervisor 会停止重启并写入错误日志

这是一个会管理用户级 LaunchAgent 与应用进程的工具，安装前请阅读 scripts 中的源码。

License

Apache License 2.0。除非文件另有说明，仓库内附带的 AI 生成图像资产也按同一许可证分发。参见 LICENSE 和 NOTICE。

Acknowledgements

项目从 CodeDrobe/codex-skill 的开源思路出发，在此基础上重新设计了视觉系统、生成式主视觉、跨页面样式与 macOS 重启持久化流程。