在使用 Windows 版 Codex 的过程中，我逐渐产生了一个想法：能不能给它换一张自己喜欢的背景图，同时让侧边栏、主内容区和输入区域带有适当的透明效果？

最初我只想解决背景和透明度两个问题，但真正动手后发现，一套能够长期使用的皮肤远不只是“往页面里加几行 CSS”。输入框必须固定在底部，长对话不能被遮挡，切换页面时不能突然出现白色不透明区域，关闭窗口后托盘还要能够正常管理进程，并且必须随时可以恢复原版。

于是，这个简单想法逐渐变成了一个独立的 Windows 工具：**GlassGPT Studio**。

> 配图 1：GlassGPT Studio 软件主界面
![image.png](https://developer.qcloudimg.com/http-save/yehe-1355401/f2b12d200b0d97882737339549c21f84.png)
## 我为什么要做这个项目

最直接的方案是修改 Codex 安装目录或替换程序资源，但这样做存在几个明显问题：Codex 更新后修改可能失效，恢复原版比较麻烦，操作不当还可能损坏安装文件。

项目早期调研阶段，我阅读了 DreamSkin.cc 的主题创作说明，以及 Codex Dream Skin 开源项目的公开资料。DreamSkin 对社区主题、运行时换肤和安全边界的探索为本项目提供了有价值的参考。感谢 DreamSkin 社区及其开源项目带来的启发。

所以我从一开始就确定了三个原则：不修改 Codex 安装目录，任何时候都能恢复原版。

GlassGPT Studio 最终采用运行时注入方案。它只在 Codex 启动期间应用背景和样式，用户点击“恢复原版”后，程序会结束当前皮肤会话，并立即以原版模式重新打开 Codex。

## 目前实现的功能

| 功能 | 说明 |
| --- | --- |
| 背景库 | 添加、预览、切换和删除多张本地背景 |
| 图片格式 | 支持 PNG、JPG/JPEG 和 BMP |
| 透明度 | 可在 20% 到 100% 之间调节 |
| 显示方式 | 支持“铺满裁切”和“完整显示” |
| 一键启动 | 在管理器中直接启动 Codex 并应用皮肤 |
| 中文启动 | 可强制使用 `zh-CN` 启动 Codex |
| 登录自启动 | 登录 Windows 后自动启动皮肤 |
| 托盘管理 | 启动、显示、恢复或完全退出 Codex |
| 恢复原版 | 自动关闭皮肤模式并以原版重新打开 |
| 单实例运行 | 重复打开管理器时复用已有实例 |

> 配图 2：应用背景与透明效果后的 Codex 界面
> ![image.png](https://developer.qcloudimg.com/http-save/yehe-1355401/f5f04aa62a9a052ef8ab33a02d3fe8b5.png)

## 为什么选择 C# 和 WinForms

这个工具只服务于 Windows 桌面环境，需要处理托盘、注册表启动项、进程枚举、窗口句柄和应用激活。相比引入更重的桌面框架，C# 和 WinForms 已经能够覆盖全部需求。

项目使用 C# 5 和 .NET Framework，核心可以分为四层：WinForms 负责设置界面和背景预览；进程管理层负责识别、启动和关闭 Codex；CDP 层负责连接 Codex 页面；样式层根据背景、显示方式和透明度生成运行时 CSS。

这种结构的好处是每一层职责比较清晰。界面不需要了解 WebSocket 细节，样式生成器也不需要操作 Windows 进程。

## 通过本机 CDP 连接 Codex

GlassGPT Studio 使用 Chrome DevTools Protocol，也就是 CDP，与 Codex 的页面建立连接。启动皮肤模式时，程序会寻找一个可用端口，并把调试服务限制在本机回环地址：

```csharp
string arguments =
    "--remote-debugging-address=127.0.0.1 " +
    "--remote-debugging-port=" + debugPort;
```

随后，程序通过 `http://127.0.0.1:<端口>/json/list` 获取页面目标，再通过 WebSocket 执行样式注入和状态检查。调试端口不会主动监听局域网地址。

强制中文也是在启动阶段完成的。启用选项后，程序会附加 `--lang=zh-CN`，并等待简体中文资源加载完成。如果 Codex 已经运行，管理器会先请求确认，再按原来的皮肤或原版模式重启。

## 背景并不是简单地设置一个路径

CDP 注入的页面不能直接依赖任意本地文件路径，因此程序会读取背景内容，并生成 Base64 Data URL：

```csharp
byte[] bytes = File.ReadAllBytes(backgroundPath);
string dataUrl = "data:" + mimeType +
    ";base64," + Convert.ToBase64String(bytes);
```

导入背景时，GlassGPT Studio 会校验图片格式和尺寸，再根据 SHA-256 内容哈希保存到 `data` 目录。重复导入相同图片时会复用已有文件，删除托管背景也不会影响用户原来的图片。

透明度同样不能直接作用于整个页面。如果给父节点设置 `opacity`，文字、按钮和图标也会一起变淡。我的处理方式是保留组件自身的透明度，只替换主要表面的背景颜色，让文字和交互元素继续保持原来的清晰度。

## 真正费时间的是把细节做稳定

**固定输入框。** 输入框固定到底部后会脱离正常文档流，如果没有补偿滚动空间，长对话最后一段内容可能被遮挡。我最终保留固定输入体验，同时检查顶部、中部和真实对话尾部的布局位置。

**页面过渡。** 新对话、已安排任务和插件页面使用了不同的背景层。最开始只处理主聊天页面，就会在切换时出现白色区域。后续改为针对具体画布和过渡层做透明处理，不改变元素尺寸、定位和点击行为。

**主内容区黑角。** 主区域左上角原本带有圆角，背景露出后会形成一块黑色缺口。修复时只调整皮肤模式下的主容器边角，没有改变原版布局。

**多余窗口。** Electron 进程可能拥有多个顶层窗口。如果简单恢复所有大型窗口，就会额外显示一个无标题黑色窗口。现在程序会读取窗口类，只恢复真正的 `Chrome_WidgetWin_1` 主窗口。

**托盘与退出。** 关闭设置窗口不等于退出管理器，退出管理器也不等于关闭 Codex。因此托盘中分别提供“完全退出 Codex”和“退出 GlassGPT Studio”，避免进程仍在运行却找不到操作入口。

为了防止重复托盘图标，程序还使用命名互斥量保证单实例运行。再次打开 EXE 时，新进程只负责通知已有实例显示设置窗口。

> 配图 3：GlassGPT Studio 系统托盘菜单
> ![84cf00b914ba62c5a527f4a81a799fbd.jpg](https://developer.qcloudimg.com/http-save/yehe-1355401/1f931aa3a63050bfe9bc3dc6a9f27fee.jpg)

## 安全边界和恢复机制

GlassGPT Studio 不会替换 `app.asar`，也不会写入 Codex 的安装清单或 WindowsApps 安装目录。设置和背景都保存在程序旁边的 `data` 目录，自启动也只写入当前 Windows 用户的启动项。

启动皮肤后，管理器会定时检查 Codex 的进程状态和注入结果。如果页面重新加载，会尝试重新应用当前皮肤；如果注入失败，则尝试恢复原版，避免 Codex 停留在不完整状态。

需要注意的是，皮肤仍然依赖 Codex 当前的页面结构。Codex 更新后，如果 DOM 或样式类发生较大变化，项目也需要跟进适配。目前主要面向 Windows 商店版 Codex。

## 如何使用和构建

从 GitHub 克隆项目后，可以按照 README 中的 PowerShell 命令，使用系统自带的 .NET Framework C# 编译器生成 `GlassGPT Studio.exe`。运行时需要让 EXE 与 `data` 目录保持在同一位置。

基本操作很简单：选择或添加背景，调节透明度和显示方式，设置是否强制简体中文，然后点击“启动 Codex”。不想继续使用皮肤时，点击“恢复原版”即可。

项目已使用 MIT License 开源：

[https://github.com/Yue-Zeyi/GlassGPT-Studio](https://github.com/Yue-Zeyi/GlassGPT-Studio)

## 写在最后

这个项目让我体会最深的一点是：实现一个视觉效果并不难，难的是让它不破坏原有功能，并且在启动、关闭、更新、异常和恢复等状态下都保持可控。

GlassGPT Studio 仍然有继续完善的空间，例如提高不同 Codex 版本的兼容性、优化分发方式和增加配置迁移能力。希望这个项目既能给需要个性化界面的用户提供一个可直接使用的工具，也能给研究 WinForms、CDP 和 Electron 桌面应用运行时定制的开发者提供一些参考。

在使用 Windows 版 Codex 的过程中，我逐渐产生了一个想法：能不能给它换一张自己喜欢的背景图，同时让侧边栏、主内容区和输入区域带有适当的透明效果？

不修改安装文件，我用 C# + CDP 做了一个 Codex 皮肤管理器：GlassGPT Studio

一个适用于 Windows 版 Codex 的本地背景与透明度管理器。

编程语言

开发工具

客户端

GlassGPTStudio为Windows版Codex提供运行时皮肤定制，不修改安装目录。支持背景图、透明度调节、强制中文、托盘管理及一键恢复原版，通过CDP注入样式，确保长对话固定输入框与页面切换稳定，兼容商店版Codex，完全开源。

代码解释

编译器

WebSocket

Windows

容器

GitHub

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

不修改安装文件，我用 C# + CDP 做了一个 Codex 皮肤管理器：GlassGPT Studio-腾讯云开发者社区-腾讯云

不修改安装文件，我用 C# + CDP 做了一个 Codex 皮肤管理器：GlassGPT Studio

不修改安装文件，我用 C# + CDP 做了一个 Codex 皮肤管理器：GlassGPT Studio

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐