# Codex 一键换肤教程

拿到安装包后，按照下面的步骤操作，通常 3 分钟内就能完成换肤。

当前教程适用版本：`Codex5 Pro+ 3.15.0`

> 目前仅支持 Windows 10/11 版 Codex，macOS 暂不支持。

## 换肤前准备

开始前请确认：

1. 已安装 Microsoft Store 官方 Codex。
2. 至少正常打开过一次 Codex。
3. 已下载 `Codex5-for-Codex-Windows-3.15.0.zip`。
4. 准备好一张自己喜欢的图片。

支持 PNG、JPG/JPEG 和 WebP 图片，单张图片不能超过 16 MB。建议使用主体清楚、画质较高
的图片；横图建议不低于 `1920 x 1080`，竖图也可以自动适配。

## 第一步：解压安装包

在下载目录找到：

```text
Codex5-for-Codex-Windows-3.15.0.zip
```

右键压缩包，选择 **全部解压**。

不要直接在 ZIP 压缩包预览窗口中运行安装程序，否则可能出现文件不完整或安装失败。

## 第二步：安装换肤工具

打开解压后的文件夹，双击：

```text
Install Codex5.cmd
```

如果 Windows 显示安全提示，请先确认文件是从购买页面下载的原始文件，然后选择
**更多信息** 和 **仍要运行**。

安装期间不要关闭命令窗口。安装完成后会自动打开 Codex。

首次安装时，如果 Codex 原本已经打开，可能会自动关闭并重新打开一次。这是为了加载
换肤入口，不会删除 Codex 里的任务和项目。

## 第三步：打开主题工作室

Codex 打开后，在顶部 **帮助** 菜单后面找到：

```text
Pro+
```

依次点击：

```text
Pro+ -> 主题工作室
```

进入主题工作室后，就可以上传图片生成皮肤。

## 第四步：上传图片

点击 **选择图片**，也可以直接把图片拖入上传区域。

工具会在本机处理图片，并自动生成适合 Codex 的主题，包括：

- 首页背景与图片构图
- 顶部菜单和侧栏颜色
- 四个首页功能按钮
- 内容面板和输入框样式
- 浅色、深色和强调色
- 任务页面的背景效果

图片只在当前电脑本地处理，不会因为制作皮肤而上传到其他图片处理服务。

## 第五步：调整皮肤效果

图片处理完成后，可以按自己的喜好调整：

### 界面明暗

- **自动**：根据图片亮度自动选择。
- **浅色**：使用浅色面板和深色文字。
- **深色**：使用深色面板和浅色文字。

### 背景强度

- **鲜明**：图片更突出。
- **均衡**：兼顾图片和文字可读性。
- **柔和**：降低图片干扰，更适合长时间使用。

### 任务页背景

- **沉浸**：任务页面继续显示融合背景。
- **横幅**：只在任务页面上方保留图片效果。
- **关闭**：任务页面不显示图片，只保留主题配色。

还可以修改主题名称，方便以后导出和备份。

## 第六步：一键应用皮肤

设置完成后，点击：

```text
应用并查看
```

系统会返回 Codex 新任务首页，直接显示最终换肤效果。

> 点击前请先处理输入框里尚未发送的文字，避免切换到新任务首页时丢失草稿。

以后正常关闭 Codex、重新打开 Codex 或重启电脑，已经应用的皮肤都会保留，不需要重复
上传图片。

## 导出皮肤文件

需要保存当前皮肤时，在主题工作室点击 **导出主题包**。

系统会下载一个类似下面的文件：

```text
我的主题.codex5-skin.json
```

主题包包含处理后的背景、配色和布局参数。当前版本没有面向普通用户的导入按钮，因此请
同时保留原图片。不要随意公开包含私人图片的主题包。

## 恢复 Codex 原版外观

进入：

```text
Pro+ -> 主题工作室
```

点击 **恢复 Codex 官方外观**，即可取消当前皮肤并恢复官方界面。

## 可选：切换简体中文

主题工作室顶部提供：

```text
官方界面 / 简体中文
```

选择 **简体中文** 会立即生效，不需要重启 Codex。它只处理固定界面文字，不会修改
聊天内容、代码、文件内容和用户输入。

## 安装后没有看到 Pro+

依次尝试下面的方法：

1. 等待 10 秒，换肤工具可能仍在连接 Codex。
2. 检查 `Pro+` 是否位于顶部 **帮助** 菜单后面。
3. 完全关闭 Codex，再双击桌面的 `Codex5` 快捷方式。
4. 从开始菜单打开 `Codex5 -> Check Codex5` 检查运行状态。

第一次通过普通 Codex 图标启动时，工具可能自动重开 Codex 一次。之后 `Pro+` 会自动
恢复，不需要重新安装。

## 上传图片后没有变化

1. 确认已经点击 **应用并查看**。
2. 切换到 Codex 的新任务首页查看完整效果。
3. 检查“任务页背景”是否被设置成了 **关闭**。
4. 尝试换一张更清晰、主体更明确的图片。
5. 仍无变化时，关闭 Codex 后通过桌面的 `Codex5` 快捷方式重新打开。

## 安装程序无法运行

请确认已经完整解压 ZIP，不要在压缩包内部直接运行 `.cmd` 文件。

部分企业电脑会禁止 PowerShell 脚本或拦截未签名程序，这种情况需要联系电脑管理员允许
安装包运行。

## 更新换肤工具

拿到新版本安装包后：

1. 下载并完整解压新版 ZIP。
2. 双击 `Update Codex5 Live.cmd`。

正常情况下，在线更新不会关闭 Codex，只会更新换肤工具和后台组件。

## 卸载

从 Windows 开始菜单打开：

```text
Codex5 -> Uninstall Codex5
```

卸载只删除换肤工具、快捷方式和本地皮肤，不会卸载官方 Codex，也不会删除任务和项目。

## 图片版权提醒

个人使用也建议选择本人创作、明确允许使用或已经获得授权的图片。为他人安装、公开分享
或商用时，应确认拥有图片的复制和改编权限。

## 反馈问题

反馈时请提供：

1. Windows 版本。
2. Codex 版本。
3. 换肤工具版本。
4. 问题截图。
5. `Check Codex5` 显示的状态。

截图前请检查是否包含账号、密码、访问令牌或其他私人信息。