Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions ASSET_PROVENANCE.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,7 @@
| `themes/dragonball-super-saiyan/hero.webp` | 龙珠超级赛亚人主题主视觉 | 项目所有者于 2026-07-18 提供生成 PNG,并明确要求制作预设后公开发布;仓库保存压缩 WebP | 画面含第三方角色形象,项目未取得可独立核验的第三方授权文件 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的原创角色素材 |
| `themes/genshin-dawn/hero.webp` | Genshin Dawn 主题主视觉 | 来源证据缺失,授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
| `themes/genshin-night/hero.webp` | Genshin Night 主题主视觉 | 来源证据缺失,授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
| `themes/caishen-lite-readable/hero.webp` | 财神浅色可读版主题主视觉 | ChannelerH 提供的原创公开 Codex 主题素材,源自 Codex Skin Gallery 的 `Caishen Lite Readable` 横幅;SHA-256 `f4ea1a8385df0bf78e0979aa4a3c30792135630b80a69707f2387531146c5f0c`;不含私有 Codex 截图、工作区名称、第三方品牌或受保护角色 | 提交者确认可随本项目公开再分发 | 项目所有者确认公开发布 | 保留来源哈希;如需商业授权证明可替换为权利记录更完整的素材 |
| `themes/miku-488137/hero.webp` | Miku 主题主视觉 | 来源证据缺失,授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
| `themes/miku-488137/logo.webp` | Miku 主题 Logo | 来源证据缺失,授权未验证 | 未知 | 项目所有者确认公开发布 | 后续补充标识来源或替换 |
| `themes/miku-488137/polaroid.webp` | Miku 主题拍立得装饰 | 来源证据缺失,授权未验证 | 未知 | 项目所有者确认公开发布 | 后续可替换为权利记录更完整的素材 |
Expand Down
2 changes: 1 addition & 1 deletion README.en.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ A local skin switcher for OpenAI Codex Desktop. It injects themes at runtime thr
- **One-click switching**: a 🎨 menu appears at the top of Codex; every installed theme and the native UI switch instantly, with light/dark appearance synced automatically.
- **One image, one theme**: any PNG, JPG, JPEG, or WebP becomes a full skin (palette + backdrop).
- **AI-generated themes**: hand `output/heige-codex-skin-studio.skill` to Codex and say "generate a cyberpunk hero image, then turn it into a skin". No extra API key needed.
- **12 built-in presets**: the high-detail `Miku 488137`, two lightweight themes each for Genshin Impact, Wuthering Waves, Naruto, and Love and Deepspace, two new Dragon Ball themes, plus one easter-egg preset.
- **13 built-in presets**: the high-detail `Miku 488137`, two lightweight themes each for Genshin Impact, Wuthering Waves, Naruto, and Love and Deepspace, two Dragon Ball themes, one bright readable Caishen theme, plus one easter-egg preset.
- **Optional pet**: the package ships an independent `Miku Future` animated desktop pet. Installing it is your call.
- **User-controlled persistence**: the top-menu switch is the only supported way to enable next-launch persistence. Turning it off keeps the current session skinned and restores the native UI on the next launch.
- **Readability by default**: final and in-progress assistant responses use one consistent 90% theme-aware surface with balanced inset spacing. The Theme Center switch can turn it off, and the implementation avoids live blur, shadows, observers, scroll listeners, and background requests.
Expand Down
16 changes: 10 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,27 +46,31 @@
open "<仓库路径>/scripts/install.command"
```

装完默认应用 Miku 预设。之后所有切换都在 Codex 顶部中间的 🎨 菜单里完成:12 套内置主题、原生界面、深浅外观联动,即点即换。应用皮肤时 Codex 会正常退出并以本机调试模式重新打开,当前任务先保存。
装完默认应用 Miku 预设。之后所有切换都在 Codex 顶部中间的 🎨 菜单里完成:13 套内置主题、原生界面、深浅外观联动,即点即换。应用皮肤时 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 真机待验证,细节见[完整手册](docs/manual.md)。

## 用一张图做你自己的主题

三条路,从省事到好玩:

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

现成的生图提示词在[主题提示词库](docs/theme-prompts.md):8 套风格,复制就能用。做出好看的主题,来[晒图区](https://github.com/HeiGeAi/heige-codex-skin-studio/discussions)贴一张,或者用[主题晒图模板](https://github.com/HeiGeAi/heige-codex-skin-studio/issues/new/choose)投稿,被选中会进 README 精选。

一个实话:菜单上传会写入本机用户主题库并记入启动器,和内置主题一样可在「皮肤常驻」下跨重启复现(同名同图幂等覆盖)。也可用第 2 / 第 3 条路从文件或 AI 生成主题
一个实话:自定义图片只是一个本地快捷槽,不是可分发的正式主题,也不改写最近正式主题;renderer 本地存储可在自动补针或常驻启动时继续显示它。需要分发或长期管理时,用第 2 / 第 3 条路生成正式主题

## 内置 12 套主题
## 内置 13 套主题

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

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

| 财神浅色可读版 | 大佬 · 点烟 |
| --- | --- |
| ![财神浅色可读版主题主视觉](themes/caishen-lite-readable/hero.webp) | ![大佬点烟彩蛋主题主视觉](themes/dalao-dianyan/hero.webp) |

| 龙珠 · 筋斗云 | 龙珠 · 超级赛亚人 |
| --- | --- |
Expand Down
8 changes: 4 additions & 4 deletions docs/manual.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
一个效率优先的 Codex Desktop 换肤工具。它通过本机回环 CDP 把主题实时注入 Codex 界面,不修改 `app.asar`、应用二进制或签名资源。未来 Codex Desktop 若改变启动参数、renderer 结构或界面选择器,本项目仍可能需要适配。

- **一键切换**:应用皮肤后 Codex 顶部中间出现 🎨 菜单,所有已装主题和原生界面即点即换。预设主题会同步切换 Codex 自身的浅色或深色外观,不再需要进入设置手动搭配。嫌按钮碍眼?菜单底部「隐藏此按钮」把它收成一颗半透明小圆点,点圆点即恢复。
- **自定义上传**:菜单里选「+ 自定义图片」直接上传本地图片,自动按图片风格取色(主色、辅色、面板底色、文字色),并根据图片亮度同步 Codex 深浅外观。上传成功后写入本机用户主题库(`%APPDATA%\\HeiGeCodexSkinStudio\\themes` / macOS Application Support),并记入启动器 `selectedThemeId` / `lastNonNativeThemeId`,与内置主题一样可在「皮肤常驻」开启时跨重启复现。再次上传会生成新正式主题(同名同图则幂等覆盖);「我的主题」中的 × 可删除磁盘主题。旧版仅存在于 renderer localStorage 的 `custom-upload` 快捷槽仍可在原生态下兼容显示,但新上传不再以该槽为权威存储
- **自定义上传**:菜单里选「+ 自定义图片」直接上传本地图片,自动按图片风格取色(主色、辅色、面板底色、文字色),并根据图片亮度同步 Codex 深浅外观。它只是单个本地快捷槽,适合快速试色;再次上传会覆盖,行尾 × 可删除。它不是可分发的正式主题,也不改写最近正式主题;renderer 本地存储可在自动补针或常驻启动时继续显示它,清除本地数据后会丢失。需要分发或长期管理时,用 `customize.command` 或 `create` 生成正式主题
- **一张图片就是一个主题**:任意 PNG、JPG、JPEG、WebP 直接生成皮肤(配色 + 背景底图)。
- **AI 生成主题**:把 Skill 交给 Codex,让它先用生图能力产出主图,再自动做成皮肤,无需额外 API Key。
- **自带可选 Pet**:安装包内附独立的 `Miku Future` 动画桌面宠物,包含待机、奔跑、挥手、跳跃、等待、审查等动作,不覆盖 Codex 内置宠物,也不会在只安装皮肤时强制启用。
Expand All @@ -20,12 +20,12 @@
| 适用应用 | OpenAI Codex Desktop(ChatGPT 桌面端) |
| 支持平台 | macOS 自动化与真机验证;Windows 跨 PowerShell 自动化,Microsoft Store/MSIX 真机待验证 |
| 注入方式 | Chrome DevTools Protocol,调试端口仅绑定本机回环 `127.0.0.1:9341` |
| 内置主题 | 10 个(1 个高精度 Miku 488137 + 8 个游戏轻量主题 + 1 个彩蛋「大佬 · 点烟」) |
| 内置主题 | 13 个(1 个高精度 Miku 488137 + 8 个游戏轻量主题 + 2 个龙珠主题 + 1 个财神浅色可读版 + 1 个彩蛋「大佬 · 点烟」) |
| 运行时依赖 | 不安装 npm 运行时依赖;优先使用可信的 Codex 内置 Node,使用系统 Node 时要求 Node.js 22 或更新版本 |
| 开发依赖 | `happy-dom` 与 `yazl` 均锁定精确版本,只用于测试与确定性打包 |
| 自动化验证 | Node、macOS、Windows、安装包与文档门禁,不在文档中写死易过期的测试数量 |
| 协议 | 代码 MIT,角色素材权利归各自权利人 |
| 最近更新 | 2026-07-18 |
| 最近更新 | 2026-07-21 |

## 版本与更新检查

Expand Down Expand Up @@ -188,7 +188,7 @@ node src/cli.mjs doctor

### 怎么用自己的图片做主题?

三条路:顶部中间的 🎨 菜单选「+ 自定义图片」直接上传(自动按图片取色);双击 `customize.command` 走图形界面;或用命令行 `node src/cli.mjs create --image 图片路径 --name 主题名`。
三条路:顶部中间的 🎨 菜单选「+ 自定义图片」直接上传(自动按图片取色,作为本地快捷槽快速试色);双击 `customize.command` 走图形界面;或用命令行 `node src/cli.mjs create --image 图片路径 --name 主题名`。

### 自定义图片的文字或底色有色差、看不清怎么办?

Expand Down
2 changes: 1 addition & 1 deletion docs/release/2026-07-16-audit-hardening-disposition.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

本分支的最终交付门槛是:本地完整验证通过,macOS 当前机器实测通过,Windows 自动化证据通过,200-agent 专家复审无未处置的 P0/P1,确定性安装包与本文摘要一致,并且新建 Draft PR 后 GitHub Actions 全部通过。

<!-- heige-package-sha256 --> Package SHA-256: 5eb80c34c02c47240372353abe709b4b3ddff269e2e37427396ed6b8ea848a51
<!-- heige-package-sha256 --> Package SHA-256: d596b3d75dcafd9ded85efbf61d0d2e07558fb0bf1021d8d37820fbe28ac7903

## 已确认的产品边界

Expand Down
16 changes: 10 additions & 6 deletions llms-full.txt
Original file line number Diff line number Diff line change
Expand Up @@ -77,27 +77,31 @@
open "<仓库路径>/scripts/install.command"
```

装完默认应用 Miku 预设。之后所有切换都在 Codex 顶部中间的 🎨 菜单里完成:12 套内置主题、原生界面、深浅外观联动,即点即换。应用皮肤时 Codex 会正常退出并以本机调试模式重新打开,当前任务先保存。
装完默认应用 Miku 预设。之后所有切换都在 Codex 顶部中间的 🎨 菜单里完成:13 套内置主题、原生界面、深浅外观联动,即点即换。应用皮肤时 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 真机待验证,细节见[完整手册](docs/manual.md)。

## 用一张图做你自己的主题

三条路,从省事到好玩:

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

现成的生图提示词在[主题提示词库](docs/theme-prompts.md):8 套风格,复制就能用。做出好看的主题,来[晒图区](https://github.com/HeiGeAi/heige-codex-skin-studio/discussions)贴一张,或者用[主题晒图模板](https://github.com/HeiGeAi/heige-codex-skin-studio/issues/new/choose)投稿,被选中会进 README 精选。

一个实话:「自定义图片」是单个本地快捷槽,再次上传会覆盖;它不是可分发的正式主题,也不会改写启动器记录的最近正式主题。renderer 本地存储可在自动补针或常驻启动时继续显示该快捷图,清除本地数据后会丢失。想要能保存、能切换的主题,走第 2 或第 3 条路
一个实话:自定义图片只是一个本地快捷槽,不是可分发的正式主题,也不改写最近正式主题;renderer 本地存储可在自动补针或常驻启动时继续显示它。需要分发或长期管理时,用第 2 / 第 3 条路生成正式主题

## 内置 12 套主题
## 内置 13 套主题

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

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

| 财神浅色可读版 | 大佬 · 点烟 |
| --- | --- |
| ![财神浅色可读版主题主视觉](themes/caishen-lite-readable/hero.webp) | ![大佬点烟彩蛋主题主视觉](themes/dalao-dianyan/hero.webp) |

| 龙珠 · 筋斗云 | 龙珠 · 超级赛亚人 |
| --- | --- |
Expand Down
Binary file modified output/heige-codex-skin-studio.skill
Binary file not shown.
2 changes: 1 addition & 1 deletion skill/heige-codex-skin-studio/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,7 +18,7 @@

Windows 的生命周期操作必须从 `scripts\windows` 下对应的 `.ps1` 或 `.bat` 进入。不要直接运行 Node CLI 代替 Windows Store/MSIX 激活或重启流程;如果直接调用遇到需要启动或重启,CLI 会安全拒绝并提示正确入口。需要完整退出 Codex/GPT 桌面端并保持关闭时,使用 `scripts\windows\close-codex.bat`(仅在用户明确允许关闭时调用;用户说“不要关闭”时不得擅自执行)。彻底移除使用 `scripts\windows\uninstall.ps1` 或 `scripts\windows\uninstall.bat`,它会清理当前用户计划任务、开始菜单、AppData 状态、残留控制器进程和稳定安装目录;安装目录被手动删除后,也可从源码目录运行该入口清理残留。

Skill 保留 12 个内置预设,默认是 `miku-488137`。切换预设会同步 Codex 深浅外观,顶部「自定义图片」也会按画面亮度自动判断外观。自定义图片只是一个本地快捷槽,可上传、覆盖或删除;它不是可分发的正式主题,也不改写启动器记录的最近正式主题。renderer 本地存储可在自动补针或常驻启动时继续显示它,清除本地数据后会丢失。需要正式主题时使用 `create`,再把返回的 `id` 传给 macOS 或 Windows 的 `apply` 入口。`pause` 暂停当前会话,`resume` 只恢复同一进程,`restore` 关闭常驻并还原;Windows `close-codex` 只完整退出桌面端并保持关闭;Windows `uninstall` 会完整删除安装与状态。发布包内自带可选的 `Miku Future` 动画 Pet,仅当用户明确要求时才调用统一 `install-pet` 入口。
Skill 保留 13 个内置预设,默认是 `miku-488137`,并包含 `caishen-lite-readable` 财神浅色可读版。切换预设会同步 Codex 深浅外观,顶部「自定义图片」也会按画面亮度自动判断外观。自定义图片只是一个本地快捷槽,可上传、覆盖或删除;它不是可分发的正式主题,也不改写启动器记录的最近正式主题。renderer 本地存储可在自动补针或常驻启动时继续显示它,清除本地数据后会丢失。需要正式主题时使用 `create`,再把返回的 `id` 传给 macOS 或 Windows 的 `apply` 入口。`pause` 暂停当前会话,`resume` 只恢复同一进程,`restore` 关闭常驻并还原;Windows `close-codex` 只完整退出桌面端并保持关闭;Windows `uninstall` 会完整删除安装与状态。发布包内自带可选的 `Miku Future` 动画 Pet,仅当用户明确要求时才调用统一 `install-pet` 入口。

主题中心的「阅读增强」默认开启,为最终回复和过程回复增加统一的 90% 主题自适应半透明阅读底与对称留白;用户可随时关闭。它只使用 renderer 本地偏好和现有窗口同步,不改变常驻状态,也不增加模糊、阴影、观察器、滚动监听或后台请求。

Expand Down
Loading