哈喽,大家好,我是阿星👋🏻。

最近我给官方 Codex 做了几套皮肤,效果就像 QQ 皮肤:

不改变功能,只改变界面。

如果你和我一样是胡彦斌的粉丝,就可以直接换成胡彦斌主题👌

目前项目

已经开源:

https://github.com/seeyouintokyo/codexskin

workbuddy的员工还闲着干啥,赶紧去做皮肤呀,我都愿意买!!!

codexskin  为官方 Codex Desktop 加载可切换皮肤。它不会安装另一套 Codex,也不会修改、复制或重新打包官方 APP。

当前支持 macOS,包含深海蓝、玫瑰粉和奶油淡黄三套主题。

(一开始我们只改了颜色,结果只是底色变了。后来补上页面识别、图片加载和自动重新应用,完整主题才稳定显示)

效果:

工作原理

其实这个项目主要就是对CDP的应用,所谓CDP全称ChromeDevToolsProtocol(Chrome开发者工具协议)。它是一套让代码远程操控Chrome的低层协议——Playwright、Puppeteer这些测试工具底层都靠它。原理如下⬇️

  1. 1.查找 Bundle ID 为 com.openai.codex 的官方应用。
  2. 2.校验应用、Team ID、代码签名和内置 Node.js。
  3. 3.直接启动官方可执行文件,并将 CDP 绑定到 127.0.0.1
  4. 4.确认监听端口属于 Codex 进程,只接受 app:// Codex Shell 目标。
  5. 5.注入主题,并在页面重载、路由变化和 DOM 重建后重新同步。

恢复脚本会停止注入器,并清理样式节点、主题变量、首页标记和装饰层。官方应用文件始终不被修改。

安装与启动

  

# 安装皮肤脚本,并在桌面创建 4 个 .command 快捷方式
./scripts/install-macos-skin.sh

# 重新打开官方 Codex 主 APP,并加载当前主题
~/.codex/codex-deep-terminal/scripts/start-macos-skin.sh --restart-existing

# 检查当前皮肤是否正常
~/.codex/codex-deep-terminal/scripts/verify-macos-skin.sh

第一次开启皮肤时,也可以双击桌面的 Codex Deep Terminal.command。它只是脚本快捷方式,会重新打开官方 Codex 主 APP 并加载皮肤。

主题选择 

双击桌面的 Codex Deep Terminal - Theme.command,或执行:

  

# 切换为深海蓝
~/.codex/codex-deep-terminal/scripts/switch-theme-macos.sh blue

# 切换为玫瑰粉
~/.codex/codex-deep-terminal/scripts/switch-theme-macos.sh pink

# 切换为奶油淡黄
~/.codex/codex-deep-terminal/scripts/switch-theme-macos.sh yellow

恢复官方界面

双击桌面的 Codex Deep Terminal - Restore.command,或执行:

  

# 停止注入器,并移除当前会话中的全部皮肤内容
~/.codex/codex-deep-terminal/scripts/restore-macos-skin.sh

项目结构

  

scripts/   安装、启动、注入、验证与恢复
skin/      公共 CSS、Hero 图片与主题清单
tests/     安全边界和运行时契约
themes/    Codex 官方主题分享字符串

index.html 和 styles.css 提供匿名效果预览,不参与 Codex 运行时注入。

测试

  

# 运行运行时契约和安全边界测试
node --test tests/runtime.test.mjs

# 校验 Codex 官方主题分享字符串
node scripts/validate-themes.mjs themes/deep-terminal-dark.txt themes/deep-terminal-light.txt

总结起来一张图就是👇

以上就是 codexskin   的安装、切换和恢复方法。

你也可以按照这个原理写一个哦,很简单,把这篇文章发给codex即可。

我是阿星

更多AI应用

我们下期再见👋🏻

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐