Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Codex Dream Skin:Codex App 换肤 Skill 与自定义主题工具

Codex Dream Skin 是一个免费开源的 Codex App 换肤 Skill。它可以为 Codex Desktop 安装可交互的背景皮肤:macOS 支持本地图片、CDN Banner 和主题库,Windows 支持本地图片与托盘切换;两个平台都支持运行验证和恢复官方外观。

Skill CI macOS Windows License

macOS 第一次使用:复制后选择主题

不要下载 ZIP,不要打开终端,不要自己退出或重新打开 Codex。

把下面整段复制给 Codex:

请安装或覆盖更新这个 GitHub 仓库里的 codex-dream-skin Skill:
https://github.com/aithink001/Codex-Dream-Skin-Themes/tree/main/skills/codex-dream-skin

安装后请完整读取新版 SKILL.md,并按 Ordinary-user path 操作。

如果我还没有指定主题,只问我选择哪一种:
1. 世界杯主题
2. 使用我自己的图片

我选世界杯主题时,直接执行一键安装流程;我选自己的图片时,等我上传图片或粘贴 HTTPS 图片地址后,再执行自定义图片一键安装流程。

除一次“安装主题”确认弹窗外,不要让我运行任何命令,不要让我手动退出或重新打开 Codex。请自动完成安装、一次受控重启、主题应用和 Verify;只有 Verify 真正通过后才能告诉我成功。

接下来只需要:

  1. 回复 “1” 使用世界杯主题,或回复 “2” 后发送自己的图片。
  2. 看到系统弹窗后,点击安装。
  3. 等待 Codex 自动重新打开,不要手动操作。

两种方式都会自动使用适合背景图片的沉浸式深色外观,不受用户当前浅色或深色设置影响,也不会出现整层发白的背景。

看到选择的背景,并且 Codex 确认 Verify 通过,才算安装完成。如果没有变化,不要再次重启,只需要对 Codex 说:

检查 Dream Skin 主题安装结果并自动诊断,不要重启 Codex,也不要让我运行命令。

主题选择与一键安装目前用于 macOS。Windows 用户请看Windows 简单用法

原生侧栏、项目选择、建议卡片、任务内容和输入框仍然可以正常点击与输入;主题图片只用于 Banner 和装饰背景,不会把一张假界面截图盖在 Codex 上。

没有合适的背景图?打开 Codex Dream Skin Banner 在线生成器

粉系定制 Codex Dream Skin 完整界面效果

第一次使用 · 其他主题 · 功能对比 · 效果预览 · 验证与恢复 · 常见问题

Codex Dream Skin 下载与安装

推荐:让 Codex 自动安装

直接使用本文最上方的主题选择提示词。Codex 会安装或更新 Skill,再根据你的选择自动完成主题应用和验证。

高级用户:手动安装 Skill

如果你熟悉终端,也可以手动安装:

git clone --depth 1 https://github.com/aithink001/Codex-Dream-Skin-Themes.git
mkdir -p ~/.codex/skills
cp -R Codex-Dream-Skin-Themes/skills/codex-dream-skin ~/.codex/skills/

安装后可以通过 $codex-dream-skin 使用主题定制、切换、验证和恢复功能。

如何给 Codex 更换自定义主题

macOS:使用本地图片或 CDN Banner

准备一张横向图片,建议宽度不低于 2000px。可以直接把本地图片路径或 HTTPS CDN 地址交给 Skill:

使用 $codex-dream-skin,把这张图片设置为我的 Codex 主题:
https://cdn.example.com/my-codex-banner.png

主题名称叫「Purple Night」。应用完成后运行 Verify 并保存验证截图。

还可以继续告诉 Codex:

使用 $codex-dream-skin 列出我保存的主题,并切换到「Purple Night」。

macOS 支持:

  • 本地 PNG、JPEG、HEIC、TIFF、WebP;
  • HTTPS CDN 图片;
  • 主题名称、标语、引用文字和强调色;
  • 保存多套主题并快速切换;
  • SwiftBar 菜单栏控制;
  • 暂停皮肤、重新应用、验证截图和完整恢复。

Windows:使用本地图片和托盘主题控制

Windows 会先安装一套可用的内置主题,并提供系统托盘控制器:

使用 $codex-dream-skin 在 Windows Codex App 中安装主题,完成后运行 Verify。

安装后,在系统托盘的 Codex Dream Skin 菜单中选择“更换背景图”,即可使用本地 PNG、JPEG 或 WebP。托盘还支持保存当前主题、切换已保存主题、暂停/继续、重新应用和完整恢复。

支持哪些系统和功能

功能 macOS Windows
安装 Codex Dream Skin
保留原生侧栏、任务和输入框
自定义本地图片
使用 HTTPS CDN Banner 需先下载到本地
保存和切换多套主题
SwiftBar 菜单栏控制
系统托盘控制
自定义调试端口
Verify 实时验证
输出验证截图
恢复 Codex 官方外观
构建可分发 ZIP

完整命令和高级选项见 codex-dream-skin/SKILL.md

Codex Dream Skin 效果预览

下面的图片适合用来选择配色、构图和氛围。最终主题会保留 Codex 原生控件,实际效果以 Verify 截图为准。

粉系定制 Codex Dream Skin 主题效果
Pink Custom · 粉系定制
财神打工版 Codex Dream Skin 主题效果
God of Wealth · 财神打工版
红白科幻 Codex App 自定义主题效果
Red-White Sci-Fi · 红白科幻
清透定制 Codex App 换肤效果
Clear Custom · 清透定制
灵感小宇宙 Codex 换肤主题效果
Inspiration Universe · 灵感小宇宙
紫夜限定 Codex Dream Skin 背景主题
Purple Night · 紫夜限定
虚拟歌姬未来 Codex 自定义主题效果
Miku Future · 虚拟歌姬未来
舞台黑金 Codex App 主题效果
Stage Black-Gold · 舞台黑金

选择一个风格并生成自己的 Codex Dream Skin Banner

Codex 换肤是怎样工作的

Skill 会启动官方 Codex Desktop,并通过只监听 127.0.0.1 的 Chromium DevTools Protocol 注入主题 CSS 和装饰层。它不会修改、替换或重新签名官方应用文件。

Codex Dream Skin Skill
        ↓
启动官方 Codex + 本机回环 CDP
        ↓
注入主题 CSS、Banner 和装饰背景
        ↓
原生侧栏、项目、任务和输入框保持可交互

运行时固定到已检查的提交 a1c48b3a84cc64532196e624fdf33ee1277cb018,下载后会再次核对 Git commit。主题运行期间,请避免运行来路不明的本机程序;不再使用时可以随时运行 Restore 关闭主题和调试会话。

如何验证主题已经生效

发送下面的提示词:

使用 $codex-dream-skin 验证当前主题,并保存一张验证截图。

Verify 会检查:

  • 主题 CSS 和注入标记是否存在;
  • 原生侧栏与输入框是否仍然可见;
  • 首页 Banner、建议卡和项目选择是否正常;
  • 是否出现横向溢出或装饰层遮挡点击;
  • 页面重新加载后主题是否可以重新应用。

只有 Verify 通过,才表示当前 Codex Dream Skin 已正常运行。

如何卸载或恢复 Codex 官方外观

发送:

使用 $codex-dream-skin 恢复 Codex 官方外观,并关闭主题调试会话。

恢复功能会移除主题 CSS 和装饰层,并恢复安装前保存的外观设置。macOS 还可以删除桌面启动器,Windows 可以选择恢复完整的安装前配置备份。

常见问题

Codex Dream Skin 是官方功能吗?

不是。这是面向 Codex Desktop 的非官方开源换肤工具,与 OpenAI 没有隶属、认可或赞助关系。

它会修改 Codex.app 或 app.asar 吗?

不会。主题通过本机回环 CDP 运行,不会修改 .appapp.asarWindowsApps 或官方代码签名。

Codex Dream Skin 支持 Windows 吗?

支持。Windows 可以通过系统托盘选择本地图片、保存和切换主题、暂停或重新应用皮肤,也可以运行 Verify、保存验证截图并恢复官方外观。

可以使用自己生成的图片吗?

可以。macOS 支持本地图片和 HTTPS CDN 地址;Windows 支持从系统托盘选择本地 PNG、JPEG 或 WebP。建议使用横向构图,并让左侧保持简洁,以免影响原生标题和控件的可读性。

出现 Explicit theme directory is missing theme.json 怎么办?

这是早期版本的首次安装初始化错误,当前版本已修复。请更新或重新复制 codex-dream-skin Skill,关闭 Codex 后重新运行安装;新版本会自动创建默认主题,不需要手动清理缓存或编写 theme.json

Codex 更新后主题失效怎么办?

重新运行安装、启动和 Verify。Codex 更新可能改变界面结构,因此每次更新后都建议重新验证。

为什么手动重启后没有变化?

普通方式重新打开 Codex 不会携带主题所需的启动参数。不要反复手动重启;使用 Skill 的一键安装流程,让它自动完成一次受控重启、应用和验证。

为什么世界杯背景像蒙了一层白色?

这是旧版世界杯主题跟随 Codex 浅色外观造成的。请覆盖更新本仓库中的 Skill,再按页面顶部的一键安装提示操作;新版会自动使用适合该图片的深色外观,不需要修改系统设置。

图片会保存在 GitHub 仓库里吗?

不会。展示图片全部通过 HTTPS CDN 加载,仓库不提交 JPG、PNG、WebP 等图片二进制。

项目文件

开源许可与商标

仓库代码与文本采用 MIT License。外部 CDN 图片不随仓库许可证自动授权。Codex、OpenAI 以及相关商标归各自权利人所有;人物、角色或商标素材用于公开再分发或商业项目时,请自行确认相应授权。


English: Open-source Codex Dream Skin Skill for Codex Desktop themes on macOS and Windows. Install a reversible skin, use custom images on both platforms, verify the live native interface, and restore the official appearance at any time.

About

Codex Dream Skin 开源换肤 Skill:支持 macOS/Windows Codex App 主题安装、自定义 Banner、主题切换、实时验证与一键恢复。Open-source Codex desktop theme tool.

Topics

Resources

Contributing

Stars

36 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages