Codex Skin Studio 是一款 Windows Codex 换肤工具,可以把图片或 GIF 设置为 Codex 壁纸,并实时调整配色、透明度、模糊和布局。它同时提供壁纸库、自动轮播、系统托盘和官方界面恢复功能。
- 支持 PNG、JPEG、WebP 和 GIF,动画 GIF 会在 Codex 中持续播放。
- 无需刷新即可切换壁纸,并使用交叉淡入完成平滑过渡。
- 自动分析壁纸颜色,在浅色和深色界面之间选择更清晰的文字配色。
- 可手动切换浅色或深色模式,并实时调整强调色。
- 独立控制壁纸亮度、壁纸蒙版、左侧栏背景和内容面板透明度。
- 支持覆盖、完整显示和拉伸,以及水平、垂直焦点定位。
- 支持单张壁纸、文件夹壁纸库和 GIF 轮播。
- 提供顺序循环、完整洗牌、上一张、下一张和暂停功能。
- 主窗口关闭后可留在系统托盘继续轮播。
- 支持隐藏当前主题、重新应用主题和恢复官方 Codex。
- Windows 10 22H2 或 Windows 11
- x64 处理器
- 当前用户已安装 Microsoft Store 版
OpenAI.Codex
Codex Skin Studio 以自包含单文件 EXE 发布,普通用户不需要另外安装 .NET、Node.js 或第三方运行环境。
- 从 Releases 下载
CodexSkinStudio-win-x64.exe。 - 将 EXE 放到具有写入权限的文件夹并启动。
- 选择一张图片,或者选择一个壁纸文件夹。
- 点击“启动换肤模式”;如果 Codex 已经普通启动,按提示重启到换肤模式。
- 状态显示“换肤模式就绪”后点击“应用主题”。
- 在“外观调整”中修改模式、透明度、模糊、焦点和配色,设置会实时同步到 Codex。
更完整的操作说明见 docs/USAGE.md。
壁纸目录支持以下模式:
- 手动:只通过上一张和下一张切换。
- 顺序循环:按自然文件名顺序播放,例如
2.jpg会排在10.jpg前。 - 随机洗牌:每轮中的每张壁纸只出现一次,下一轮再重新洗牌。
轮播间隔可设置为 10 秒至 24 小时。电脑从睡眠恢复后只前进到合理的下一张,不会连续补播错过的项目。
软件数据保存在 EXE 同目录的 data 文件夹:
CodexSkinStudio.exe
data/
├── settings.json
├── session.json
├── library/
├── themes/
├── cache/
├── logs/
└── diagnostics/
- 只移动 EXE 时,新位置会创建一套新配置。
- 同时移动 EXE 和
data文件夹时,原有设置会一起保留。 - 软件目录可以位于任意可写磁盘和文件夹,支持中文与空格路径。
- 外部壁纸保持只读引用,不会修改原图片。
Codex Skin Studio 会查找当前用户安装的 Microsoft Store Codex,并在用户确认后启动仅监听 127.0.0.1 的调试会话。主题通过运行时 CSS 和背景层应用,不会改写 Codex 安装包、可执行文件或用户配置。
使用“恢复原版”时,工具会移除当前主题、关闭受验证的换肤会话,并重新打开官方 Codex。直接关闭 Codex 后再从普通入口启动,也会回到官方界面。
- 不读取对话正文、输入框内容、Cookie、LocalStorage、Token 或认证文件。
- 不提供网络服务、远程控制接口或遥测。
- 壁纸数据通过本机调试连接直接发送,不启动本地图片服务器。
- 只连接通过包身份、进程路径、回环端口、Browser ID 和 Codex 页面标记验证的目标。
- Codex 版本发生结构变化且兼容检查失败时,会停止应用并撤销本次主题。
需要 Windows x64 和 .NET 8 SDK:
git clone https://github.com/silver-zzZ/CodexSkinStudio.git
cd CodexSkinStudio
dotnet restore .\CodexSkinStudio.sln
dotnet test .\CodexSkinStudio.sln -c Release --no-restore
dotnet publish .\CodexSkinStudio.App\CodexSkinStudio.App.csproj `
-c Release -r win-x64 --self-contained true `
-p:PublishSingleFile=true `
-p:PublishTrimmed=false `
-p:IncludeNativeLibrariesForSelfExtract=true `
-o .\artifacts\publish\win-x64输出文件:
artifacts/publish/win-x64/CodexSkinStudio.exe
Codex Skin Studio 使用 MIT License。第三方组件和参考项目说明见 THIRD-PARTY-NOTICES.txt。
本项目参考了 Fei-Away/Codex-Dream-Skin 的本机 CDP 换肤思路,并以 C# 重新实现 Windows 控制器、会话验证、主题管理和轮播功能。
Codex Skin Studio 是独立开发的第三方项目,与 OpenAI 无隶属、认可或赞助关系。


