最佳实践
[TOC]
# Codex（ChatGPT）Skills 技能包操作指南
## 一、准备工作
### 1. 下载并安装 Codex（ChatGPT）
**软件下载地址：** [https://openai.com/zh-Hans-CN/codex/](https://openai.com/zh-Hans-CN/codex/)
点击下载按钮进行下载：
> **说明：** 下载时间取决于您的网络速度，下载完成后会自动安装，无需人工干预。
本教程基于 Windows 11 环境，软件版本为 26.709.11516。若您的操作系统或软件版本与演示差异较大，请参考官方网站。
安装成功后，软件名称为「ChatGPT」，打开后的界面如下：
---
### 2. 配置 ChatGPT 模型代理
由于国内环境无法直接访问 GPT、Claude 等国外模型，需要通过模型代理网站间接调用。若您已有熟悉的代理网站，可直接使用。以下为推荐的几个代理网站，请自行选择使用，相关风险由您自行承担：
- [https://ctmoai.com/login](https://ctmoai.com/login)
- [https://aicodewith.com/zh/login](https://aicodewith.com/zh/login)
- [https://agentrouter.org/](https://agentrouter.org/)
- [https://www.likeai520.cc/](https://www.likeai520.cc/)
> ⚠️ **风险提示：** 以上网址可能因国内外政策调整导致模型调用异常，甚至无法访问。建议在调用前做好充分测试和调研，充值时采用小金额、多次分批的方式，以降低异常情况带来的损失。
本示例以 [https://ctmoai.com](https://ctmoai.com) 为例，调用该网站支持的最新模型 **GPT-5.5**，演示完整配置过程。
#### 2.1 注册并登录
注册 ctmoai.com 账号并登录：
#### 2.2 充值
#### 2.3 创建 API 密钥
此处已创建一个名为 `show_test` 的密钥：
#### 2.4 查看配置帮助
访问 [https://ctmoai.com/_home/jiaocheng/](https://ctmoai.com/_home/jiaocheng/)，或点击「使用密钥」查看相关说明：
选择路径 **「Codex CLI」 → 「Windows」**，此处展示的信息为实际可用配置，无需过多调整：
#### 2.5 具体配置步骤
**步骤 1：编辑 `config.toml`**
打开文件，路径为 `C:\Users\{您的用户名}\.codex\config.toml`，在文档最前面粘贴以下内容：
```toml
model_provider = "OpenAI"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://ctmoai.com"
wire_api = "responses"
requires_openai_auth = true
[features]
goals = true
```
**步骤 2：编辑 `auth.json`**
打开文件，路径为 `C:\Users\{您的用户名}\.codex\auth.json`。若该文件不存在，请在 `.codex` 文件夹下创建名为 `auth.json` 的文件，并粘贴以下内容：
```json
{
"OPENAI_API_KEY": "sk-a2f......fbb8"
}
```
> 将 `sk-` 开头的字符串替换为您此前创建的 API 密钥。
**步骤 3：登录 ChatGPT**
重启 ChatGPT 软件，点击「使用其他方式登录」，输入 `sk-` 开头的 API 密钥，进入以下界面，按实际情况和操作提示进行选择：
**步骤 4：完成配置**
所有步骤完成后，出现以下界面：
配置界面为中文：
> **注意：** 需退出 ChatGPT 进程后重新启动软件，中文界面方可生效：
---
### 3. 注册 ShowAPI 平台账号
**注册地址：** [https://www.showapi.com/auth/reg](https://www.showapi.com/auth/reg)
> 若您已注册，可跳过此步骤。
---
### 4. 获取 AppKey
**登录地址：** [https://www.showapi.com/auth/login](https://www.showapi.com/auth/login)
登录成功后，按以下路径操作：
**右上角「控制台」 → 左侧菜单「接口使用者」 → 「appKey 管理」**
如下图所示：
您可以根据需要创建独立的应用和 appKey，并设置访问 IP 或接口权限。
点击「查看」按钮，输入注册密码后即可查看并复制 appKey。**该密钥将在后续调用 Skills 时使用，请妥善保存。**
---
## 二、下载技能包
### 1. 进入 Skills 市场
访问 [万维易源平台首页](https://www.showapi.com/)，登录后点击导航栏 **「AI Skills」 → 「Skills 市场」**：
或直接访问：[https://www.showapi.com/ai/skills/market](https://www.showapi.com/ai/skills/market)
Skills 市场界面如下：
---
### 2. 下载 Skill（技能）
在 Skills 市场中浏览并查找您需要的技能：
> **提示：** Skills 市场的内容会动态更新，您看到的界面可能与示例略有不同。
本示例以 **「文创设计」** 技能包为例进行演示（其他技能包的安装步骤相同）。在搜索框中输入「文创设计」，找到对应的 Skill 卡片：
点击卡片后，依次选择：
1. **「Agent 使用与开发集成」**
2. **「Agent 接入」**
3. **「选择客户端下载技能包」**
技能包提供中英文两个版本，部分工具仅支持英文版，请根据实际需求选择。本示例使用中文版，点击 **「CodeX」** 旁的下载图标进行下载。
> **注意：** 请留意技能包的保存路径，后续安装步骤中需要选择该文件。
---
## 三、安装技能包
### 1. 打开软件并切换模型
打开 ChatGPT，参考聊天区域右下角，将模型切换为 **GPT-5.5**：
---
### 2. 导入技能包
ChatGPT 中创建技能包需要用到 GitHub 仓库：
> 若您已将技能包发布到 GitHub，可采用上述方式。本示例采用将技能包放置到指定文件夹的方式进行安装，具体操作如下：
**步骤 1：放置技能包文件**
解压此前下载的技能包，将解压后的文件放置到以下路径：
```
C:\Users\{您的用户名}\.codex\skills
```
如图：
**步骤 2：查看安装情况**
若 Skill 安装成功，可在如下界面中看到新增的「文创设计」技能：
---
## 四、使用技能
### 1. 查阅技能参数
以「文创设计」技能包为例，在线测试地址：
[https://www.showapi.com/ai/skills/6a4c58393c51f2d32d00c4fc?tab=run](https://www.showapi.com/ai/skills/6a4c58393c51f2d32d00c4fc?tab=run)
在线测试界面如下：
该技能包含以下四个参数：
| 参数 | 说明 | 是否必填 |
|------|------|----------|
| **产品图排版** | 生成图片的宫格数量（1~4 宫格） | ✅ 必填 |
| **参考图** | 图片 URL 或 Base64 字符串 | 可选 |
| **产品描述** | 提示词（Prompt） | 可选 |
| **长宽比** | 生成图片的比例，默认 1:1 | 可选 |
> **建议：** 为获得最佳生成效果，提示词中尽量包含以上所有参数，并详细描述各参数对应的内容。
---
### 2. 调用技能的提示词
点击左侧菜单中的 **「新对话」**，在输入框下方选择 **「Skills」**，然后在输入框中输入 `/文创`，选择如图所示的技能包：
输入您的需求（即提示词），建议尽量涵盖测试界面中的所有参数。
**参考示例：**
```
生成一个文化创意的产品宣传图，图片主要描述江浙一带的绸缎文化，图片为四宫格，长宽比为 16:9 横版，产品参考图：https://oss.showapi.com/doc/4826/5/ae919726ce38_1780382555943.jpg
```
该提示词包含以下四个参数信息：
| 序号 | 参数 | 值 |
|------|------|-----|
| 1 | `grid_num` | `4` |
| 2 | `image` | `https://oss.showapi.com/...82555943.jpg` |
| 3 | `prompt` | `生成一个文化创意的产品宣传图，图片主要描述江浙一带的绸缎文化` |
| 4 | `aspect_ratio` | `16:9` |
如上图，填写好提示词后，按 **Enter** 或点击右下角 **发送按钮**，即可开始调用 Skill。
> 若出现下图中的「request timed out」提示，说明密钥配置不正确，或 `C:\Users\{您的用户名}\.codex\config.toml` 文件配置被修改，请重新配置：
**`config.toml` 配置参考（添加红框中的内容）：**
---
### 3. 调用过程及结果
> **重要提示：**
> - 首次调用 Skill 时，需要配置 AppKey。后续调用同一 Skill 时无需重复配置。
> - AppKey 获取地址：[https://www.showapi.com/console#/myApp](https://www.showapi.com/console#/myApp)
> - 调用过程中，系统可能会不定时在提示词输入框或整个窗口界面弹出交互窗口，请根据实际情况进行确认和操作（如网络请求权限确认、文件操作确认、密钥调整、环境变量修改等）。不同 Skill 的交互提示内容各不相同，此处不再逐一展示，请依据提示操作即可。
**联网请求交互，点击「允许一次」：**
**AppKey 设置交互：**
此时已提示缺少 ShowAPI AppKey，系统将准备切换到默认的图像生成 Skill 或模型。请先点击右下角 **执行按钮** 暂停执行，然后输入 AppKey：
**完整的调用过程：**
**最终生成的结果图：**
> 本示例使用 ctmoai.com 提供的模型代理功能，调用模型为 **GPT-5.5**。本次交互过程的花费如下，仅供参考，具体以实际发生为准：
