外观
Codex 图片生成:技能方式
本站推荐使用技能生图。下载技能后手动复制到指定目录,在 Codex 对话框中生成图片,或上传本地 PNG 并说明需要修改的内容。
本教程的准备条件
电脑安装 Node.js 22 或更高版本,并已完成 Codex 基础配置。所选分组与渠道须具备 Responses 的 image_generation 工具权限。
1. 确认令牌与模型
在 FQHX 令牌设置固定选择有权限的 正价纯pro号池或 plus池,二者均支持技能生图。本教程以正价纯pro号池为例;使用 plus池 时填写自己的 plus池 令牌,无需换池。
使用 gpt-6.1-sol 等 GPT 文本主模型,不要把 Codex 的 model 改成 gpt-image-*。如果令牌限制了模型,需放行所选文本模型。
技能自动复用现有 Codex 配置与可读取的 API Key。每次生成会消耗额度,以后台记录为准。
支持分组与自动选组
技能生图支持 正价纯pro号池 和 plus池,默认推荐前者。它通过 GPT 文本主模型调用 Responses 的图片工具,不等同于直接调用独立 Images 接口。default 不列为本教程的技能生图支持分组。建议固定分组,避免 auto 路由到仅有文本能力的池;文本调用成功不能证明图片工具可用。
2. 安装或升级技能
当前版本:v2.0.1 · 更新日期:2026-11-12
下载 fqhx-imagegen-skill-v2.0.1.zip
解压后打开根目录的 VERSION 文件,可核对版本号。更新时先备份原技能文件夹,再复制新版并重启 Codex。
版本更新记录
| 版本 | 日期 | 更新内容 |
|---|---|---|
| v2.0.1 | 2026-11-12 | 兼容 CC Switch v4.0.25 保留官方登录时的供应商 API Key 读取 显式环境变量与内联令牌优先,缺失时不回退到其他账号 补充凭据不泄露、认证文件不改写与本地生成回归检查 |
| v2.0.0 | 2026-11-12 | 统一技能说明、界面名称和日志为 FQHX,清理旧版脚本 技能专用覆盖变量改为 FQHX_BASE_URL、FQHX_MODEL 和 FQHX_API_KEY_ENV 保留 Codex 配置自动读取、文生图及 PNG 原图编辑 |
| v1.0.0 | 2026-11-12 | 支持文生图及 PNG 原图编辑,编辑结果另存,不覆盖原图 新增包内 VERSION 和带版本号的下载文件 |
方式一:手动下载并安装
v2.0.0 将技能专用覆盖变量统一为 FQHX_BASE_URL、FQHX_MODEL 和 FQHX_API_KEY_ENV。只有手动设置过技能覆盖变量的用户需要按新名称迁移;自动读取已有 Codex 配置及令牌变量名称的方式保持一致。
下载并解压上方技能包,将整个 fqhx-imagegen 文件夹放入以下位置,保留 SKILL.md、VERSION、scripts/ 和 scripts/vendor/,不要再套一层同名目录。
用户级技能目录:%USERPROFILE%\.agents\skills\fqhx-imagegen\。
例如:C:\Users\Alice\.agents\skills\fqhx-imagegen\SKILL.md。
只在某个项目使用时,放在 <项目目录>\.agents\skills\fqhx-imagegen\。这与保存 Codex 配置的 %USERPROFILE%\.codex\ 是不同目录。
在文件资源管理器地址栏粘贴 %USERPROFILE%\.agents\skills。目录不存在时,逐层新建 .agents 和 skills,将解压得到的 fqhx-imagegen 文件夹复制进去。打开文件夹后应直接看到 SKILL.md 和 scripts 文件夹。
用户级技能目录:~/.agents/skills/fqhx-imagegen/。
macOS 示例:/Users/alice/.agents/skills/fqhx-imagegen/SKILL.md;Linux 示例:/home/alice/.agents/skills/fqhx-imagegen/SKILL.md。
只在某个项目使用时,放在 <项目目录>/.agents/skills/fqhx-imagegen/。这与保存 Codex 配置的 ~/.codex/ 是不同目录。
macOS 在 Finder 的“前往文件夹”中粘贴 ~/.agents/skills;Linux 在文件管理器中打开主目录并显示隐藏文件。缺少目录时逐层新建,再把整个 fqhx-imagegen 文件夹复制进去,确认其中直接包含 SKILL.md 和 scripts。
安装后在 Codex 对话框输入 /skills,确认列表中出现 fqhx-imagegen;未出现时重启 Codex。技能安装位置不随 CODEX_HOME 改到配置目录;读取配置时会遵循 CODEX_HOME。
方式二:让 Codex 自动安装或升级
将下面的提示词复制到 Codex 对话框。同一段提示词适用于首次安装和后续升级,会读取本站最新版本清单,无需手工修改版本号。Codex 需要能够联网并写入本机技能目录;在 WSL、容器或远程主机中使用时,安装到实际运行 Codex 的环境。
复制安装/升级提示词
text
请帮我安装或升级 fqhx-imagegen 技能,仅处理这个技能。
官方版本清单:
https://docs-ai.fq-hx.com/downloads/fqhx-imagegen-releases.json
请按以下要求执行:
1. 读取清单中的 latest,在 releases 中找到对应版本,取得 download、sha256 和更新说明。download 为相对路径时,使用清单所在站点拼接;仅从该站点的 HTTPS 地址下载安装包。
2. 检查当前 Codex 的执行环境及已加载的 fqhx-imagegen 路径。已有安装时优先在实际使用的原路径升级,识别符号链接,避免再安装一个同名副本。首次安装使用用户级目录:Windows 为 %USERPROFILE%\.agents\skills\fqhx-imagegen,macOS/Linux 为 ~/.agents/skills/fqhx-imagegen。若发现旧版位于 .codex/skills 且当前仍在使用,更新该已有路径。仅在多个副本无法判断使用哪个时,列出路径并询问我。
3. 读取已安装技能根目录的 VERSION,按主版本、次版本、修订版的数值比较。已是最新版且文件与目标包一致时跳过;本地版本更高时不要自动降级。没有 VERSION 的旧安装按未编号旧版处理;相同版本但文件不一致时说明差异,备份后修复。
4. 在临时目录下载并核对压缩包 SHA-256。解压前检查路径不越界,确认包内只有 fqhx-imagegen 根目录;检查 VERSION 与清单一致,且包含 SKILL.md、agents、scripts 及 scripts/vendor 必需文件。任一检查失败就停止,保留现有安装。
5. 升级前完整备份旧技能目录,备份名包含旧版本和时间,备份放在技能扫描目录之外,避免旧副本重复加载。记录本地自定义改动并保留在备份中,再以完整新版目录替换;替换失败时恢复原目录。
6. 不修改 Codex 的 config.toml、auth.json、API Key、环境变量、其他技能或项目文件;不要读取、输出或上传任何密钥。检查 Node.js 22 或更高版本,缺少运行环境时说明,不自行改动全局环境。
7. 只运行 --help 等离线检查并核对 VERSION,不发起生图、编辑或其他付费 API 请求。
8. 完成后告诉我旧版本与新版本、实际安装路径、备份路径和检查结果。提醒我在 /skills 中确认技能;未显示新版时重启 Codex。已是最新版时会跳过重复安装;升级前保留备份。版本号相同但文件被本地修改时,Codex 会先说明差异并备份,再修复为发布包中的完整版本。此过程只安装技能,不自动生成图片。
3. 在 Codex 中生成图片
先完成Codex 基础配置。使用 CC Switch v4.0.25 时,按CC Switch 技能生图教程选择供应商,并安装 v2.0.1 或更新版本。按该配置,技能会读取 FQHX_API_KEY;如果原有 provider 的 env_key 使用其他变量名,也会按原名读取,无需重命名。Windows 推荐按用户环境变量说明保存令牌并重开 Codex。若使用了单独的命名配置,在提示词中说明使用哪个 profile;技能不会自动获知会话中的临时模型或配置切换。
然后在 Codex 对话框输入:
text
$fqhx-imagegen 生成一只可爱猫咪的卡通头像,尺寸 1024x1024,质量 auto,保存到 output/imagegen/cat.png4. 编辑已有 PNG 图片
将需要编辑的原图放到项目中,或在 Codex 对话中提供该图片并明确原图路径。输入必须为不超过 50 MiB 的 PNG。例如:
text
$fqhx-imagegen 将 output/imagegen/dog.png 中狗狗的毛色改为绿色,保留表情、构图和背景,使用原图编辑,另存为 output/imagegen/dog-green.png技能会上传指定原图,使用 Responses 的图片工具编辑,再保存为新的 PNG。请明确指出使用原图还是上一次修改后的版本,并说明需要保留的内容;不要把要保留的原图作为输出文件。
已有安装需要重新下载上方技能包,先备份,再用新版文件夹更新,完成后重启 Codex。旧版不支持原图输入;新版暂不支持蒙版或其他输入图片格式。编辑能力仍取决于当前渠道对图片输入与工具编辑的支持。
5. 查看并保存结果
相对路径以项目工作目录为准,已有文件不会覆盖。文生图和原图编辑每次均输出一张 PNG。请求尺寸不保证等于实际返回尺寸,请查看 Codex 返回的保存路径和实际图片。
配置来源与执行环境
该技能不复用 ChatGPT OAuth、系统钥匙串或命令动态获取的凭据;遇到缺少密钥时,按提示让实际执行进程读取本站 API Key,不要把 auth.json 或真实令牌放进技能目录或发给他人。
在 WSL、容器或远程主机运行时,技能、Node.js、Codex 配置和令牌应位于实际执行 Codex 的环境中。
使用遇到问题时展开
| 现象 | 检查项 |
|---|---|
| 技能列表中没有 fqhx-imagegen | 检查复制目录是否正确,文件夹里是否直接包含 SKILL.md,再重启 Codex |
| 提示缺少令牌 | 是否完成基础配置;Windows 修改用户变量后需重开 Codex |
| 文本正常但生图失败 | 确认固定正价纯pro号池(教程默认)或 plus池,核对文本模型权限和 Responses 图片工具支持 |
| 找不到图片 | 查看 Codex 返回的实际路径;下一次明确指定完整文件名 |
基础接口排查使用首页 HTTP 验证模块。
官方资料:技能目录与调用。