first commit

README.md

@@ -0,0 +1,96 @@
+# image-gen-custom-project
+
+这是一个面向 Codex 的本地技能包仓库，核心内容是 `image-gen-custom`：它通过兼容 OpenAI 的 Images API 生成图片，并把结果稳定地保存为本地 `PNG`、`JPEG`、`GIF` 或 `WebP` 文件。
+
+## 仓库内容
+
+```text
+skill/image-gen-custom/
+├─ SKILL.md
+├─ agents/openai.yaml
+└─ scripts/
+   ├─ configure.ps1 / configure.sh
+   ├─ generate-image.ps1 / generate-image.sh
+   ├─ install-skill.ps1 / install-skill.sh
+   └─ 其他辅助脚本
+```
+
+## 主要能力
+
+- 支持自定义 OpenAI-compatible API base URL
+- 支持指定模型、尺寸、质量和输出路径
+- 自动校验返回内容是否为有效图片
+- 以原子写入方式保存输出文件
+- Windows 上使用 DPAPI 保存密钥，macOS/Linux 使用系统 keyring
+
+## 安装
+
+在对应平台运行安装脚本：
+
+```powershell
+skill\image-gen-custom\scripts\install-skill.ps1
+```
+
+```bash
+bash skill/image-gen-custom/scripts/install-skill.sh
+```
+
+如需覆盖已有安装，可加 `-Force` 或 `--force`。
+
+## 配置
+
+首次使用前先配置 API 基础地址和密钥：
+
+```powershell
+skill\image-gen-custom\scripts\configure.ps1
+```
+
+```bash
+bash skill/image-gen-custom/scripts/configure.sh
+```
+
+也可以临时使用环境变量：
+
+- `OPENAI_API_KEY`
+- `OPENAI_BASE_URL`
+
+## 生成图片
+
+Windows：
+
+```powershell
+skill\image-gen-custom\scripts\generate-image.ps1 `
+  -Prompt "A concise prompt..." `
+  -Out "outputs\generated-image.png" `
+  -Size "1024x1024" `
+  -Quality "low" `
+  -Force
+```
+
+macOS / Linux：
+
+```bash
+bash skill/image-gen-custom/scripts/generate-image.sh \
+  --prompt "A concise prompt..." \
+  --out outputs/generated-image.png \
+  --size 1024x1024 \
+  --quality low \
+  --force
+```
+
+默认模型是 `gpt-image-2`，可通过 `-Model` / `--model` 覆盖。
+
+## 运行时说明
+
+- 图片 API 支持 `b64_json` 或图片 URL 返回
+- URL 下载上限为 50 MB
+- 输出会先写入临时文件，再替换到目标路径
+- 可通过 `CODEX_IMAGEGEN_VENV` 指定私有虚拟环境位置
+- 可通过 `CODEX_IMAGEGEN_PYTHON` 指定用于引导环境的 Python
+
+## 安全提示
+
+- 不要把密钥写进脚本、提交记录或这个 README
+- Windows 密钥保存到 DPAPI 保护的本地文件
+- 其他平台保存到系统 keyring
+