Skip to content
Back to search

codex-pet-and-imagegen

让 Codex 在不修改原有配置的情况下,通过第三方 OpenAI 兼容中转站、Google Gemini、xAI Grok Imagine 或 Agnes AI 生成图片,并创建可在 Codex Desktop 中使用的动态 Pet。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/xiazhixuan119748-codex-pet-and-imagegen/badge.svg)](/listings/xiazhixuan119748-codex-pet-and-imagegen)

HTML

<a href="/listings/xiazhixuan119748-codex-pet-and-imagegen"><img src="/api/listings/xiazhixuan119748-codex-pet-and-imagegen/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. 克隆仓库

git clone https://github.com/Xiazhixuan119748/hatch-pet-and-imagegen-.git
Set-Location hatch-pet-and-imagegen-

安装前请完全退出 Codex Desktop。

2. 备份官方原始 Skill

本项目会替换 Codex 当前安装的 ImageGen 和 Hatch Pet。建议先保存官方原始版本,以便不再使用本项目的改造版时随时恢复。

在 PowerShell 中执行:

$CodexHome = Join-Path $env:USERPROFILE '.codex'
$SkillHome = Join-Path $CodexHome 'skills'
$BackupRoot = Join-Path $CodexHome ("skill-backups\before-third-party-imagegen-" + (Get-Date -Format 'yyyyMMdd-HHmmss'))

New-Item -ItemType Directory -Force -Path $BackupRoot | Out-Null

$OfficialImageGen = Join-Path $SkillHome '.system\imagegen'
$OfficialHatchPet = Join-Path $SkillHome 'hatch-pet'

if (Test-Path $OfficialImageGen) {
    Copy-Item $OfficialImageGen (Join-Path $BackupRoot 'imagegen') -Recurse -Force
}
if (Test-Path $OfficialHatchPet) {
    Copy-Item $OfficialHatchPet (Join-Path $BackupRoot 'hatch-pet') -Recurse -Force
}

Write-Host "Official Skill backup: $BackupRoot"

记下命令输出的备份目录。备份只需执行一次;不要把备份目录提交到 GitHub。

3. 安装 ImageGen

在 PowerShell 中执行:

New-Item -ItemType Directory -Force -Path "$SkillHome\.system" | Out-Null
Copy-Item '.\.system\imagegen' "$SkillHome\.system" -Recurse -Force

安装后应存在:

%USERPROFILE%\.codex\skills\.system\imagegen\SKILL.md

不要删除 `.system` 中的其他系统 Skill。

4. 安装 Hatch Pet

Copy-Item '.\hatch-pet' $SkillHome -Recurse -Force

安装后应存在:

%USERPROFILE%\.codex\skills\hatch-pet\SKILL.md

注意不要复制成 `hatch-pet\hatch-pet\SKILL.md`。

5. 配置图片 Provider

先把仓库中的脱敏模板复制到 Codex 目录:

Copy-Item '.\imagegen.env' "$CodexHome\imagegen.env"
notepad "$CodexHome\imagegen.env"

只编辑 `%USERPROFILE%\.codex\imagegen.env` 这个副本,填写自己的配置:

IMAGE_PROVIDER=openai
OPENAI_API_KEY=替换为你的API_KEY
# 可选;不填时使用官方 OpenAI 地址
# OPENAI_BASE_URL=https://你的中转站地址/v1
OPENAI_IMAGE_MODEL=gpt-image-2

切换到 Gemini 时改为:

IMAGE_PROVIDER=gemini
GEMINI_API_KEY=替换为你的Gemini_API_KEY
GEMINI_IMAGE_MODEL=gemini-3.1-flash-image
GEMINI_API_MODE=generate-content

切换到 Grok 时改为:

IMAGE_PROVIDER=grok
XAI_API_KEY=替换为你的xAI_API_KEY
XAI_IMAGE_MODEL=grok-imagine-image-quality

切换到 Agnes 时改为:

IMAGE_PROVIDER=agnes
AGNES_API_KEY=替换为你的Agnes_API_KEY
AGNES_IMAGE_MODEL=agnes-image-2.1-flash

配置要求:

- 只校验 `IMAGE_PROVIDER` 当前选择的 Provider;不会要求同时配置四套凭证,也不会自动回退到其他 Provider。 - `IMAGE_PROVIDER=openai` 时只要求 `OPENAI_API_KEY`;未配置 `OPENAI_BASE_URL` 时使用官方 `https://api.openai.com/v1`。 - 配置 `OPENAI_BASE_URL` 时应填写 OpenAI SDK 兼容基础地址,通常以 `/v1` 结尾。 - 不要填写完整的 `/images/generations` 接口路径。 - `OPENAI_IMAGE_MODEL` 必须是 `gpt-image-*` 模型,例如 `gpt-image-2`。 - 请确认中转站实际支持所填写的图片模型和 Images API。 - `IMAGE_PROVIDER=gemini` 时只要求 `GEMINI_API_KEY`;未配置 `GEMINI_BASE_URL` 时使用 Google 官方地址。 - `GEMINI_API_MODE` 默认为兼容中转站的旧版 `generate-content`;需要新版 Interactions API 时设置为 `interactions`。 - Gemini 推荐 `gemini-3.1-flash-image`。Lite 模型仅适合 1K 草稿,不建议用于完整 Pet。 - `IMAGE_PROVIDER=grok` 时只要求 `XAI_API_KEY`;未配置 `XAI_BASE_URL` 时使用 `https://api.x.ai/v1`。 - Grok 推荐 `grok-imagine-image-quality`。生成兼容 OpenAI SDK,但编辑必须使用 xAI JSON 接口,最多 3 张参考图。 - `IMAGE_PROVIDER=agnes` 时只要求 `AGNES_API_KEY`;未配置 Base URL 时使用 `https://apihub.agnes-ai.com/v1`。 - Agnes 推荐 `agnes-image-2.1-flash`。编辑仍调用 `/images/generations`,图片和 `response_format` 必须放在 `extra_body`,不能直接复用标准 OpenAI edit。

用于 Hatch Pet 时还需注意:

- Gemini 最宽支持 `21:9`,推荐 `gemini-3.1-flash-image`;Hatch Pet 会保留精确帧数要求,并通过后续提取与 QA 拒绝不合格行图。 - Grok 最宽支持 `20:9`,单次编辑最多接收 3 张参考图;Hatch Pet 会确定性合并超出的参考资料,同时保留布局参考。 - Agnes 最宽使用 `21:9`,本地最多接收 16 张有序参考图。 - 非 OpenAI Provider 的 API 请求成功不等于 Pet 行图合格;所有 Provider 仍须通过相同的帧数、角色一致性、方向语义、透明背景和 Atlas 校验。

完成后重新启动 Codex Desktop,使 Skill 被重新加载。

恢复官方原始 Skill

不再使用本项目的改造版时,先完全退出 Codex Desktop,再运行下面的 PowerShell。把第一行替换为安装前记录的实际备份目录:

$BackupRoot = 'C:\Users\你的用户名\.codex\skill-backups\before-third-party-imagegen-YYYYMMDD-HHMMSS'
$CodexHome = Join-Path $env:USERPROFILE '.codex'
$SkillHome = Join-Path $CodexHome 'skills'

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

Readme.md · README · 427 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Codex Third-Party ImageGen & Hatch Pet
  2. 让 Codex 在不修改原有配置的情况下,通过第三方 OpenAI 兼容中转站、Google Gemini、xAI Grok Imagine 或 Agnes AI 生成图片,并创建可在 Codex Desktop 中使用的动态 Pet。
  3. 本项目包含两个 Codex Skill:
  4. - **ImageGen**:从独立的 `imagegen.env` 读取图片接口地址、API Key 和模型,不覆盖 Codex 原有配置。
  5. - **Hatch Pet**:根据文字描述、参考图或品牌特征,生成、校验并打包 Codex v2 动态 Pet。
  6. > [!IMPORTANT]
  7. > 仓库中的 `imagegen.env` 仅为脱敏模板。请勿将真实 API Key 提交到 GitHub。
  8. ## 更新内容(2026-07-20)
  9. - OpenAI 模式不再强制要求 `OPENAI_BASE_URL`;未配置时使用官方 `https://api.openai.com/v1`,仍可按需填写兼容中转站地址。
  10. - OpenAI、Gemini、Grok 和 Agnes 命令新增显式 `--aspect-ratio W:H` 校验,要求 `--size` 与目标宽高比精确匹配,并在交付前验证实际图片尺寸。
  11. - OpenAI CLI 为输出文件增加生成锁和冲突保护,避免长请求超时后被重复提交或覆盖同一路径。
  12. - OpenAI 批任务改为单次请求、无自动重试,并记录每个任务的状态与汇总;部分成功时会保留并交付已验证的图片。
  13. - 发布范围仅保留两个 Skill 的运行文件、参考资料、许可证、安装文档和脱敏配置模板,不包含测试目录、Python 缓存或本地代理配置。
  14. ## 相对官方 Skill 的改造内容
  15. 本项目不是官方 Skill 的原样镜像,而是在官方 ImageGen 与 Hatch Pet 基础上的第三方 Provider 适配版。主要改动如下:
  16. - ImageGen 新增 `IMAGE_PROVIDER` 路由,支持 OpenAI/OpenAI 兼容接口、Google Gemini、xAI Grok Imagine 和 Agnes AI。
  17. - 只要 `%USERPROFILE%\.codex\imagegen.env` 存在,普通生图和编辑请求会默认使用其中选择的 Provider;无需在每次提示中指定配置文件。
  18. - Gemini 支持 Generate Content 与 Interactions 两种 API 格式、多参考图编辑以及批量任务。
  19. - Grok 使用 xAI JSON 接口完成生成和编辑,并支持 Files API;Hatch Pet 会在参考图超过 3 张时确定性整理输入。
  20. - Agnes 使用其 Provider 专用 JSON 请求格式,支持 Image 2.0/2.1、文生图、多图编辑及批量任务。
  21. - Hatch Pet 可通过上述任一 Provider 生成视觉素材,并保留完整的 v2 Atlas 组装、方向语义、透明背景和最终 QA 流程。
  22. - 配置 wrapper 只向子进程传递当前 Provider 的环境变量,不会把其他 Provider 的凭证混入请求环境,也不会在配置错误时静默切换 Provider。
  23. > [!NOTE]
  24. > Provider 的尺寸、宽高比、参考图数量和透明背景能力不同。API 请求成功不代表 Pet 行图一定合格,Hatch Pet 仍会执行统一的帧数、身份一致性、方向和 Atlas 校验。
  25. 安装本项目会覆盖当前安装的同名 Skill。建议按照下方步骤先备份官方原始 ImageGen 与 Hatch Pet;不再使用改造版时,可恢复备份或重新安装官方 Skill。
  26. ## 功能特点
  27. ### 使用 OpenAI、Gemini、Grok 或 Agnes 生图
  28. ImageGen 通过独立包装器读取:
  29. ```text
  30. %USERPROFILE%\.codex\imagegen.env
  31. ```
  32. 通过 `IMAGE_PROVIDER` 选择 Provider。OpenAI 或兼容中转站配置:
  33. ```dotenv
  34. IMAGE_PROVIDER=openai
  35. OPENAI_API_KEY=你的API_KEY
  36. # 可选;不填时使用官方 OpenAI 地址
  37. # OPENAI_BASE_URL=https://你的中转站地址/v1
  38. OPENAI_IMAGE_MODEL=gpt-image-2
  39. ```
  40. Google Gemini 配置:
  41. ```dotenv
  42. IMAGE_PROVIDER=gemini
  43. GEMINI_API_KEY=你的Gemini_API_KEY
  44. GEMINI_IMAGE_MODEL=gemini-3.1-flash-image
  45. GEMINI_API_MODE=generate-content
  46. # GEMINI_BASE_URL=https://可选的Gemini中转站地址
  47. ```
  48. xAI Grok Imagine 配置:
  49. ```dotenv
  50. IMAGE_PROVIDER=grok
  51. XAI_API_KEY=你的xAI_API_KEY
  52. XAI_IMAGE_MODEL=grok-imagine-image-quality
  53. # XAI_BASE_URL=https://api.x.ai/v1
  54. ```
  55. Agnes AI 配置:
  56. ```dotenv
  57. IMAGE_PROVIDER=agnes
  58. AGNES_API_KEY=你的Agnes_API_KEY
  59. AGNES_IMAGE_MODEL=agnes-image-2.1-flash
  60. # AGNES_BASE_URL=https://apihub.agnes-ai.com/v1
  61. ```
  62. 未设置 `IMAGE_PROVIDER` 时默认使用 `openai`,兼容原配置。包装器只把当前 Provider 所需配置传给图片生成子进程,不会把另一 Provider 的凭据混入环境。
  63. 支持的主要图片任务包括:
  64. - 文生图
  65. - 图片编辑与参考图生成
  66. - 多张图片或多版本生成
  67. - 透明背景素材处理
  68. - 网站、游戏、产品图和 Sprite 等项目资源生成
  69. ### 创建 Codex Pet
  70. Hatch Pet 可以根据以下内容创建 Codex v2 动态 Pet:
  71. - 文字描述
  72. - 人物或角色参考图
  73. - 品牌、产品或公司特征
  74. - 已有 Pet 或 Sprite Atlas
  75. Hatch Pet 与 ImageGen 共用 `%USERPROFILE%\.codex\imagegen.env`,并自动使用 `IMAGE_PROVIDER` 当前选择的 OpenAI、Gemini、Grok 或 Agnes。无需为 Hatch Pet 单独配置 OpenAI 凭证;只需提供所选 Provider 对应的凭证。
  76. 生成流程包括基础形象、标准动画、16 个观察方向、透明背景处理、Atlas 校验和最终打包。最终 Pet 使用 `spriteVersionNumber: 2`,Atlas 规格为 `8 x 11`,包含 9 行标准动画和 2 行观察方向动画。
  77. ## 项目结构
  78. ```text
  79. .
  80. |-- .system/
  81. | `-- imagegen/ # 修改后的 ImageGen Skill
  82. | |-- SKILL.md
  83. | |-- scripts/
  84. | `-- references/
  85. |-- hatch-pet/ # Codex Pet 创建与校验 Skill
  86. | |-- SKILL.md
  87. | |-- scripts/
  88. | `-- references/
  89. |-- imagegen.env # 已脱敏的配置模板
  90. |-- .gitignore
  91. `-- Readme.md
  92. ```
  93. ## 环境要求
  94. - Codex Desktop
  95. - Windows 11,或其他受 Codex Desktop 支持的系统
  96. - Python 3.10 或更高版本
  97. - 可访问的 OpenAI Images API 兼容中转站、Google Gemini API、xAI Imagine API 或 Agnes AI API
  98. - 对应 Provider 支持所配置的图片模型
  99. 真实生成图片时可能需要安装:
  100. ```powershell
  101. py -m pip install --upgrade openai google-genai httpx pillow
  102. ```
  103. Dry-run 配置测试不联网,也不要求安装对应 Provider SDK 或 HTTP 客户端。
  104. ## 安装
  105. ### 1. 克隆仓库
  106. ```powershell
  107. git clone https://github.com/Xiazhixuan119748/hatch-pet-and-imagegen-.git
  108. Set-Location hatch-pet-and-imagegen-
  109. ```
  110. 安装前请完全退出 Codex Desktop。
  111. ### 2. 备份官方原始 Skill
  112. 本项目会替换 Codex 当前安装的 ImageGen 和 Hatch Pet。建议先保存官方原始版本,以便不再使用本项目的改造版时随时恢复。
  113. 在 PowerShell 中执行:
  114. ```powershell
  115. $CodexHome = Join-Path $env:USERPROFILE '.codex'
  116. $SkillHome = Join-Path $CodexHome 'skills'
  117. $BackupRoot = Join-Path $CodexHome ("skill-backups\before-third-party-imagegen-" + (Get-Date -Format 'yyyyMMdd-HHmmss'))
  118. New-Item -ItemType Directory -Force -Path $BackupRoot | Out-Null
  119. $OfficialImageGen = Join-Path $SkillHome '.system\imagegen'
  120. $OfficialHatchPet = Join-Path $SkillHome 'hatch-pet'
  121. if (Test-Path $OfficialImageGen) {
  122. Copy-Item $OfficialImageGen (Join-Path $BackupRoot 'imagegen') -Recurse -Force
  123. }
  124. if (Test-Path $OfficialHatchPet) {
  125. Copy-Item $OfficialHatchPet (Join-Path $BackupRoot 'hatch-pet') -Recurse -Force
  126. }
  127. Write-Host "Official Skill backup: $BackupRoot"
  128. ```
  129. 记下命令输出的备份目录。备份只需执行一次;不要把备份目录提交到 GitHub。
  130. ### 3. 安装 ImageGen
  131. 在 PowerShell 中执行:
  132. ```powershell
  133. New-Item -ItemType Directory -Force -Path "$SkillHome\.system" | Out-Null
  134. Copy-Item '.\.system\imagegen' "$SkillHome\.system" -Recurse -Force
  135. ```
  136. 安装后应存在:
  137. ```text
  138. %USERPROFILE%\.codex\skills\.system\imagegen\SKILL.md
  139. ```
  140. 不要删除 `.system` 中的其他系统 Skill。
  141. ### 4. 安装 Hatch Pet
  142. ```powershell
  143. Copy-Item '.\hatch-pet' $SkillHome -Recurse -Force
  144. ```
  145. 安装后应存在:
  146. ```text
  147. %USERPROFILE%\.codex\skills\hatch-pet\SKILL.md
  148. ```
  149. 注意不要复制成 `hatch-pet\hatch-pet\SKILL.md`。
  150. ### 5. 配置图片 Provider
  151. 先把仓库中的脱敏模板复制到 Codex 目录:
  152. ```powershell
  153. Copy-Item '.\imagegen.env' "$CodexHome\imagegen.env"
  154. notepad "$CodexHome\imagegen.env"
  155. ```
  156. 只编辑 `%USERPROFILE%\.codex\imagegen.env` 这个副本,填写自己的配置:
  157. ```dotenv
  158. IMAGE_PROVIDER=openai
  159. OPENAI_API_KEY=替换为你的API_KEY
  160. # 可选;不填时使用官方 OpenAI 地址
  161. # OPENAI_BASE_URL=https://你的中转站地址/v1
  162. OPENAI_IMAGE_MODEL=gpt-image-2
  163. ```
  164. 切换到 Gemini 时改为:
  165. ```dotenv
  166. IMAGE_PROVIDER=gemini
  167. GEMINI_API_KEY=替换为你的Gemini_API_KEY
  168. GEMINI_IMAGE_MODEL=gemini-3.1-flash-image
  169. GEMINI_API_MODE=generate-content
  170. ```
  171. 切换到 Grok 时改为:
  172. ```dotenv
  173. IMAGE_PROVIDER=grok
  174. XAI_API_KEY=替换为你的xAI_API_KEY
  175. XAI_IMAGE_MODEL=grok-imagine-image-quality
  176. ```
  177. 切换到 Agnes 时改为:
  178. ```dotenv
  179. IMAGE_PROVIDER=agnes
  180. AGNES_API_KEY=替换为你的Agnes_API_KEY
  181. AGNES_IMAGE_MODEL=agnes-image-2.1-flash
  182. ```
  183. 配置要求:
  184. - 只校验 `IMAGE_PROVIDER` 当前选择的 Provider;不会要求同时配置四套凭证,也不会自动回退到其他 Provider。
  185. - `IMAGE_PROVIDER=openai` 时只要求 `OPENAI_API_KEY`;未配置 `OPENAI_BASE_URL` 时使用官方 `https://api.openai.com/v1`。
  186. - 配置 `OPENAI_BASE_URL` 时应填写 OpenAI SDK 兼容基础地址,通常以 `/v1` 结尾。
  187. - 不要填写完整的 `/images/generations` 接口路径。
  188. - `OPENAI_IMAGE_MODEL` 必须是 `gpt-image-*` 模型,例如 `gpt-image-2`。
  189. - 请确认中转站实际支持所填写的图片模型和 Images API。
  190. - `IMAGE_PROVIDER=gemini` 时只要求 `GEMINI_API_KEY`;未配置 `GEMINI_BASE_URL` 时使用 Google 官方地址。
  191. - `GEMINI_API_MODE` 默认为兼容中转站的旧版 `generate-content`;需要新版 Interactions API 时设置为 `interactions`。
  192. - Gemini 推荐 `gemini-3.1-flash-image`。Lite 模型仅适合 1K 草稿,不建议用于完整 Pet。
  193. - `IMAGE_PROVIDER=grok` 时只要求 `XAI_API_KEY`;未配置 `XAI_BASE_URL` 时使用 `https://api.x.ai/v1`。
  194. - Grok 推荐 `grok-imagine-image-quality`。生成兼容 OpenAI SDK,但编辑必须使用 xAI JSON 接口,最多 3 张参考图。
  195. - `IMAGE_PROVIDER=agnes` 时只要求 `AGNES_API_KEY`;未配置 Base URL 时使用 `https://apihub.agnes-ai.com/v1`。
  196. - Agnes 推荐 `agnes-image-2.1-flash`。编辑仍调用 `/images/generations`,图片和 `response_format` 必须放在 `extra_body`,不能直接复用标准 OpenAI edit。
  197. 用于 Hatch Pet 时还需注意:
  198. - Gemini 最宽支持 `21:9`,推荐 `gemini-3.1-flash-image`;Hatch Pet 会保留精确帧数要求,并通过后续提取与 QA 拒绝不合格行图。
  199. - Grok 最宽支持 `20:9`,单次编辑最多接收 3 张参考图;Hatch Pet 会确定性合并超出的参考资料,同时保留布局参考。
  200. - Agnes 最宽使用 `21:9`,本地最多接收 16 张有序参考图。
  201. - 非 OpenAI Provider 的 API 请求成功不等于 Pet 行图合格;所有 Provider 仍须通过相同的帧数、角色一致性、方向语义、透明背景和 Atlas 校验。
  202. 完成后重新启动 Codex Desktop,使 Skill 被重新加载。
  203. ### 恢复官方原始 Skill
  204. 不再使用本项目的改造版时,先完全退出 Codex Desktop,再运行下面的 PowerShell。把第一行替换为安装前记录的实际备份目录:
  205. ```powershell
  206. $BackupRoot = 'C:\Users\你的用户名\.codex\skill-backups\before-third-party-imagegen-YYYYMMDD-HHMMSS'
  207. $CodexHome = Join-Path $env:USERPROFILE '.codex'
  208. $SkillHome = Join-Path $CodexHome 'skills'
  209. $DisabledRoot = Join-Path $CodexHome ("skill-backups\disabled-third-party-imagegen-" + (Get-Date -Format 'yyyyMMdd-HHmmss'))
  210. New-Item -ItemType Directory -Force -Path $DisabledRoot | Out-Null
  211. $InstalledImageGen = Join-Path $SkillHome '.system\imagegen'
  212. $InstalledHatchPet = Join-Path $SkillHome 'hatch-pet'
  213. if (Test-Path $InstalledImageGen) {
  214. Move-Item $InstalledImageGen (Join-Path $DisabledRoot 'imagegen')
  215. }
  216. if (Test-Path $InstalledHatchPet) {
  217. Move-Item $InstalledHatchPet (Join-Path $DisabledRoot 'hatch-pet')
  218. }
  219. if (Test-Path (Join-Path $BackupRoot 'imagegen')) {
  220. Copy-Item (Join-Path $BackupRoot 'imagegen') (Join-Path $SkillHome '.system') -Recurse -Force
  221. }
  222. if (Test-Path (Join-Path $BackupRoot 'hatch-pet')) {
  223. Copy-Item (Join-Path $BackupRoot 'hatch-pet') $SkillHome -Recurse -Force
  224. }
  225. Write-Host "Modified Skill backup: $DisabledRoot"
  226. ```
  227. 此恢复流程会先保存当前改造版,再复制回原始版本,不会直接删除任一版本。恢复后重新启动 Codex Desktop。如果安装前某个官方 Skill 不存在,对应备份也不会存在,恢复时会跳过它。
  228. ## 验证配置
  229. 在 PowerShell 中运行 dry-run:
  230. ```powershell
  231. $Imagegen = Join-Path $env:USERPROFILE '.codex\skills\.system\imagegen\scripts\image_gen_with_codex_env.py'
  232. py $Imagegen generate `
  233. --prompt 'configuration test' `
  234. --dry-run `
  235. --out "$env:TEMP\imagegen-dry-run.png"
  236. ```
  237. 成功时会显示配置文件路径和所选 Provider。输出中的模型应与当前 Provider 的 `*_IMAGE_MODEL` 一致。Dry-run 不会请求图片 API、不会生成图片,也不会产生图片费用。
  238. ## 使用方法
  239. ### 通过已配置 Provider 生成图片
  240. 在 Codex 中输入类似提示:
  241. ```text
  242. 使用 $imagegen 生成一张赛博朋克城市夜景。
  243. ```
  244. 只要 `%USERPROFILE%\.codex\imagegen.env` 存在,ImageGen 就会默认读取该配置并调用 `IMAGE_PROVIDER` 所选的 Provider,不需要在每次提示中重复指定配置文件。配置文件不存在时才使用 Codex 内置图片生成。真实生成会产生相应接口费用。
  245. ### 创建 Codex Pet
  246. 在 Codex 中输入:
  247. ```text
  248. 使用 $hatch-pet 创建一个蓝白配色、3D 玩具风格的机器人 Pet。
  249. ```
  250. 也可以附加参考图:
  251. ```text
  252. 使用 $hatch-pet,根据这张参考图创建一个 Codex v2 动态 Pet,保持角色的颜色和主要特征。
  253. ```
  254. Hatch Pet 会自动读取 `imagegen.env` 中的 `IMAGE_PROVIDER`,调用对应的 OpenAI、Gemini、Grok 或 Agnes 生成实现。完整 Pet 需要生成多组动画图片,所需时间和接口费用明显高于单张图片生成。
  255. ## Windows 10 用户提醒
  256. > [!WARNING]
  257. > Codex Desktop 在 Windows 10 上可能显示需要修复 workspace dependency,但安装会失败,因为 Windows 10 当前不受支持。
  258. 相关问题与解决进展请查看 OpenAI Codex 官方 Issue:
  259. **[Codex Desktop shows workspace dependency repair on Windows 10, but install fails because Windows 10 is unsupported](https://github.com/openai/codex/issues/19811)**
  260. 如果你在 Windows 10 上遇到 workspace dependency repair、依赖安装失败或运行时不可用等问题,请前往该 Issue 查看讨论和对应解决方法。该问题来自 Codex Desktop 的系统支持限制,并非本项目的 ImageGen 或 Hatch Pet 配置错误。
  261. ## 常见问题
  262. ### Codex 没有识别 Skill
  263. 完全退出并重新启动 Codex Desktop,然后检查以下路径:
  264. ```text
  265. %USERPROFILE%\.codex\skills\.system\imagegen\SKILL.md
  266. %USERPROFILE%\.codex\skills\hatch-pet\SKILL.md
  267. ```
  268. ### 找不到 imagegen.env
  269. 确认配置文件位于:
  270. ```text
  271. %USERPROFILE%\.codex\imagegen.env
  272. ```
  273. 不要把它放进 `skills`、`imagegen` 或 `hatch-pet` 文件夹。还需确认文件名不是 `imagegen.env.txt`。
  274. ### 提示缺少 Provider 配置
  275. OpenAI 模式检查 `OPENAI_API_KEY`;未填写 `OPENAI_BASE_URL` 时使用官方地址。Gemini 模式检查 `GEMINI_API_KEY`;Grok 模式检查 `XAI_API_KEY`;Agnes 模式检查 `AGNES_API_KEY`。同时检查 `IMAGE_PROVIDER` 拼写、等号右侧内容以及文件路径。
  276. ### 返回 401 或鉴权失败
  277. API Key 可能无效、过期,或者中转站不接受该 Key。请在中转站后台确认密钥权限。
  278. ### 返回 404 或接口路径错误
  279. 确认 `OPENAI_BASE_URL` 是 OpenAI SDK 兼容基础地址。通常应包含 `/v1`,但不应包含完整的 `/images/generations` 路径。
  280. ### 提示模型名称错误
  281. OpenAI 模式使用 `gpt-image-*`;Gemini 模式使用受支持的 `gemini-*-image`;Grok 模式使用 `grok-imagine-image-quality`;Agnes 模式使用 `agnes-image-2.0-flash` 或 `agnes-image-2.1-flash`。对应服务必须支持所配置模型。
  282. ### 提示缺少 Python 模块
  283. 执行:
  284. ```powershell
  285. py -m pip install --upgrade openai google-genai httpx pillow
  286. ```
  287. 依赖必须安装到实际运行图片脚本的 Python 环境。如果安装后仍提示缺包,请根据报错中的 Python 路径使用对应解释器执行 `-m pip install`。
  288. ## 安全说明
  289. - 仓库中的 `imagegen.env` 是脱敏模板,不包含可用凭据。
  290. - 请在复制后的 `%USERPROFILE%\.codex\imagegen.env` 中填写真实密钥。
  291. - 不要把真实 API Key 写回仓库中的模板文件。
  292. - 不要在 GitHub、截图、终端日志或聊天记录中展示真实 API Key。
  293. - 如果密钥曾被公开,请立即在中转站后台撤销并重新生成。
  294. - 包装器不会打印 API Key,也不会把凭据作为命令行参数传递。
  295. ## License
  296. ImageGen 和 Hatch Pet 目录中的内容分别遵循各自 `LICENSE.txt` 中的许可条款。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.