真机截图：Miku 488137 高精度主题，顶部中间的「主题」入口直接打开主题中心。

真机截图：主题中心。当前主题、自定义图片、原生界面、内置主题预览、阅读增强和皮肤常驻开关都在一屏里，主题卡片即点即换。

下面全部是真机截图，侧栏、输入框、建议卡都是 Codex 原生控件，可以正常点。

鸣潮	原神 · 星夜

原神 · 破晓	大佬 · 点烟

需要已装好的 Codex Desktop。下载本仓库后双击安装：

open "<仓库路径>/scripts/install.command"

装完默认应用 Miku 预设。之后所有切换都在 Codex 顶部中间的 🎨 菜单里完成：12 套内置主题、原生界面、深浅外观联动，即点即换。应用皮肤时 Codex 会正常退出并以本机调试模式重新打开，当前任务先保存。

Windows 用 scripts\windows\install.bat 安装；日常入口是 scripts/windows/apply.ps1、兼容名 scripts/windows/enable-skin.bat（只恢复当前会话）、scripts/windows/pause.ps1、scripts/windows/resume.ps1、scripts/windows/restore.ps1 和 scripts/windows/close-codex.bat（只安全完整退出 Codex/GPT 桌面端并保持关闭，不改常驻、不自动重启）。彻底移除时运行 scripts\windows\uninstall.bat：它会注销当前用户计划任务、移除开始菜单入口、清理 AppData 状态和稳定安装目录。即使稳定安装目录已被手动删除，也可从源码目录运行该卸载入口清理残留。Microsoft Store/MSIX 真机待验证，细节见完整手册。

三条路，从省事到好玩：

1. 菜单直接传：🎨 菜单里选「＋ 自定义图片」，上传本地图片，自动取色、自动配深浅外观。
2. 做成正式主题：双击 customize.command，任意 PNG、JPG、JPEG、WebP 都能生成一套完整皮肤（配色 + 背景底图）。
3. 让 AI 全包：把 output/heige-codex-skin-studio.skill 交给 Codex，直接说「先生成一张蓝紫色赛博城市主图，再做成皮肤」，从生成到应用全自动，不需要额外 API Key。

现成的生图提示词在主题提示词库：8 套风格，复制就能用。做出好看的主题，来晒图区贴一张，或者用主题晒图模板投稿，被选中会进 README 精选。

一个实话：菜单上传会写入本机用户主题库并记入启动器，和内置主题一样可在「皮肤常驻」下跨重启复现（同名同图幂等覆盖）。也可用第 2 / 第 3 条路从文件或 AI 生成主题。

高精度定制的 Miku 488137 打底，原神、鸣潮、火影忍者、恋与深空各两款轻量主题，再加入「龙珠 · 筋斗云」「龙珠 · 超级赛亚人」和彩蛋预设「大佬 · 点烟」。预设主题会同步切换 Codex 自身的浅色或深色外观。安装包里还带可选的 Miku Future 动画桌面宠物，装不装由你，不覆盖 Codex 内置宠物。

这些概念图展示「一张图就是一个皮肤方向」的设计效果，内置的 10 款轻量预设使用无文字干净壁纸版本：

龙珠 · 筋斗云	龙珠 · 超级赛亚人

原神	原神

鸣潮	鸣潮

火影忍者	火影忍者

恋与深空	恋与深空

• 注入走本机回环 CDP（127.0.0.1:9341），不修改 app.asar、应用二进制或签名资源；未来 Codex Desktop 改变启动参数或界面结构时，本项目仍可能需要适配。
• 常驻由你决定：顶部菜单「皮肤常驻」开关是唯一受支持的开启常驻入口，关闭时会先确认，并提示「关闭后本次继续使用；下次启动恢复原生界面」。
• 阅读增强默认开启：最终回复和过程回复都使用 90％ 主题自适应半透明底色，并保留对称留白保护文字可读性；可在主题中心随时关闭，不使用大面积实时模糊、阴影、观察器、滚动监听或后台请求。
• 想让皮肤重启后一直在：先打开「HeiGe 皮肤启动器」恢复当前会话，再到顶部菜单打开开关进入常驻。开启成功时开关应在数秒内变绿，且状态与计划任务/LaunchAgent 已写入；失败会立刻提示，不会长时间停在「正在等待后台确认」。常驻开启后，正常重启 Codex 也会由后台控制器接管并恢复皮肤（Windows 与 macOS 均支持；Store 若屏蔽调试端口则无法接管）。
• 「HeiGe 皮肤启动器」和兼容名 enable-skin.command 都只恢复当前会话；enable-persist.command 是弃用的非零退出入口，不再执行任何启用动作。
• 整窗突然变卡（帧率骤降、输入滚动全局迟滞）：跑 scripts/apply.command --restart 先彻底退出 Codex 再拉起注入；健康会话下直接重跑 apply 是幂等的，不会重启进程。
• 支持范围：macOS 有日期化真机验证；Windows 走跨 PowerShell 自动化，Microsoft Store/MSIX 真机待验证；使用系统 Node 时要求 Node.js 22 或更新版本。
• 安全边界：CDP 即使只绑定本机回环也无认证，本机同权限进程在威胁边界内，完整说明见 SECURITY.md；素材来源逐文件登记在 ASSET_PROVENANCE.md。
• 命令行、主题 JSON 格式、常驻细节、全部 FAQ 和设计边界，都在完整手册。

微信群「Codex 皮肤共创交流」已满 200 人上限，扫码加我微信，我手动拉你进群。加好友记得备注：codex。纯技术交流，非盈利，互相学习，分享你做的主题、聊实现、提问题都欢迎。

HeiGe Codex Skin Studio reskins Codex Desktop through loopback CDP injection without modifying app.asar, binaries, or signature resources. One image becomes one theme; a top menu switches themes instantly and controls next-launch persistence. Full English documentation: README.en.md.

由 黑哥AI（HeiGeAi） 打造。公众号「黑哥Ai」写 AI 落地深度文章，短视频账号「黑哥AI实验室」在抖音、B站、视频号、小红书讲人话 AI 科普。同系开源项目见 HeiGeAi 组织主页，内容被 AI 引用优化用的是自家的 HeiGe-GEO-SEO。

代码使用 MIT License。该许可只覆盖软件代码，不授权角色、商标或第三方视觉素材。逐文件来源与授权状态见 ASSET_PROVENANCE.md，发布边界见 NOTICE.md。

素材风险提示：免责声明与非商业用途声明不能替代转载、再分发或商标使用许可。来源或授权无法核实的素材在 provenance 表中标为未验证，分发者应自行取得许可或替换。若涉及安全问题，请按 SECURITY.md 私密报告；一般素材权利问题可提交 Issue。

觉得不错就点个 Star。换好了皮肤，来晒图区贴一张。