Skip to content

CC Switch · 技能生图 ☆ ​

先由 CC Switch v4.0.25 选择本站支持技能生图的 Responses 供应商,再通过 fqhx-imagegen v2.0.1 或更新版本生成和编辑图片。

文本主模型与分组

使用 gpt-6.1-sol 等 GPT 文本主模型,并确认所选分组与渠道的 Responses 图片工具权限。技能不要求内置图片工具的远程模型目录、固定 Header 或 image_generation 开关;保留已有个人配置即可。

1. 选择技能生图供应商 ​

先在 FQHX 令牌设置创建或编辑令牌,固定选择有权限的 正价纯pro号池或 plus池。以下以正价纯pro号池为例;再按基础教程添加并切换供应商,名称可填 FQHX · 正价纯pro号池 · 技能生图,API Key 填入该池的令牌。

使用 plus池 时,名称可填 FQHX · plus池 · 技能生图,API Key 填入 plus池 令牌,其余步骤相同,无需换池。 两个池的主模型示例均为 gpt-6.1-sol,地址均为 https://newapi.fq-hx.com/v1。完全退出并重新打开 Codex,避免继续使用旧供应商或旧 profile。

技能读取实际生效的用户级配置,而不是 CC Switch 数据库:当前 provider 的 env_key 优先,其次读取 experimental_bearer_token;未声明 provider API Key 时才按配置读取 auth.json 中的 API Key。保留官方登录不会要求导出账号 OAuth。 显式配置的令牌缺失时会报错,不回退到另一账号。

2. 安装或升级技能 ​

打开技能下载与安装,采用手动复制或“让 Codex 自动安装/升级”提示词。公开清单会指向最新版本,压缩包文件名含版本号;已有用户至少升级至 v2.0.1,以包含 CC Switch 凭据兼容修复。

个人技能目录通常为 %USERPROFILE%\.agents\skills\fqhx-imagegen\;项目技能为 <项目目录>\.agents\skills\fqhx-imagegen\。解压并复制后,文件夹中应直接包含 SKILL.md 与 scripts。

用户级 Codex 配置仍为 %USERPROFILE%\.codex\config.toml;技能目录与配置目录不同。设置 CODEX_HOME 不会自动把 .agents\skills 迁入配置目录。使用 WSL 时在 Linux 执行环境安装技能和 Node.js。

采用手动复制即可在 Codex 中使用;若希望交由 CC Switch 管理,可打开 Skills → 导入本机已有,选中 fqhx-imagegen,在“导入后在这些应用里启用”中勾选 Codex,然后导入。

导入会复制一份到 CC Switch 统一目录,原始文件不会自动移走。确认启用后,将原先手动安装的那份移到技能扫描目录之外作为备份,避免 .agents/skills 与 CC Switch 同步的 .codex/skills 重复。Codex 实际能发现并读取 SKILL.md 才是使用条件。

CC Switch v4.0.25 的 Skills 管理入口与 fqhx-imagegen 示例技能
导入本机技能 · ①选择 fqhx-imagegen,②勾选 Codex,③导入;随后移走重复副本并重启
交由 CC Switch 管理后的升级

这是本地导入的技能,CC Switch 的“检查更新”不等于读取本站 ZIP 版本清单。仍从本站下载新版,核对 VERSION 与 SHA-256,并先备份统一目录。

默认统一副本为 %USERPROFILE%\.cc-switch\skills\fqhx-imagegen\;同步给 Codex 的入口可能位于 %USERPROFILE%\.codex\skills\fqhx-imagegen\。若更改过 CC Switch 数据目录,以实际设置为准。

用新版文件替换统一副本后,在 CC Switch Skills 中重新启用 Codex 以同步,再重启 Codex;不要只更新已停用的原始手动副本。采用自动安装/升级提示词时,补充说明“此技能由 CC Switch 统一管理,请更新统一副本并同步 Codex,避免额外安装第二份”。

3. 在 Codex 中生成图片 ​

进入 Codex 对话框输入,不要粘贴到 PowerShell 或 Bash:

text
$fqhx-imagegen 生成一只可爱猫咪的卡通头像,尺寸 1024x1024,质量 auto,保存到 output/imagegen/cat.png。

技能按当前供应商配置使用 Responses 图片工具。相对输出路径以项目目录为准;已有文件不会覆盖。需切换供应商时,先在 CC Switch 切换,再重启 Codex。

4. 编辑原图并另存 ​

提供实际原图路径,输入 PNG 不超过 50 MiB:

text
$fqhx-imagegen 将 output/imagegen/dog.png 中狗狗的毛色改为绿色,保留表情、构图和背景,使用原图编辑,另存为 output/imagegen/dog-green.png。

明确使用原图还是上一张修改后的图。当前每次输出一张 PNG,不支持蒙版及其他输入格式;实际编辑能力受渠道支持限制。以 Codex 返回的保存路径和实际图片判断成功,不以静态示例或单纯文字确认代替结果。

5. 切换、升级和排错 ​

常见情况
现象处理
保留官方登录后技能提示 OAuth 不支持升级至 v2.0.1 或更新版本,使用本站供应商 API Key;不读取或共享 OAuth
文本正常但技能生图失败核对实际令牌是否固定正价纯pro号池(教程默认)或 plus池,并具有文本模型与 Responses 图片工具权限
CC Switch 已切换,技能却访问旧地址检查旧 profile、CODEX_HOME,以及 FQHX_BASE_URL/FQHX_MODEL 覆盖变量
提示某环境变量不存在当前 provider 仍声明 env_key;按该配置提供变量,或在 CC Switch 编辑供应商统一来源
目录里有技能但 Codex 看不到核对执行环境、扫描目录和 SKILL.md 层级,删除重复安装并重启
使用本地路由或聚合本页仅核对直连;不要把 PROXY_MANAGED 复制成本站真实令牌,不推定本地路由的图片工具兼容

升级保留旧目录备份,核对 VERSION 和下载清单 SHA-256;操作提示词见自动安装/升级。基础请求格式见首页 HTTP 模块。

本站提供 FQHX 接入说明;模型能力与审核规则以上游平台最新规定为准。