# right-code-image-gen-skill

**Repository Path**: ashenfirst/right-code-image-gen-skill

## Basic Information

- **Project Name**: right-code-image-gen-skill
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-11
- **Last Updated**: 2026-07-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Right Code 生图 Skill

这是一个面向 Codex App 的统一生图 skill，默认使用 Right Code 最新异步画图接口：

```text
POST https://www.right.codes/draw/v1/images/generations
GET  https://www.right.codes/v1/tasks/{task_id}
```

提交请求固定带 `"async": true`，取得 `task_id` 后轮询任务查询接口。也可以通过 `--api-mode gemini` 使用 Gemini `generateContent` 兼容接口。

安装后，普通“生图、画图、生成图片、批量生成图片、参考图生成”等请求都可以统一走 `right-code-imagegen`，不依赖 Codex App 内置的 `image_gen` 工具。

## Skill 路径

```text
skills/right-code-imagegen
```

该路径是发布到 Git 仓库后给 Codex App 安装器使用的路径。

## 安装到 Codex App

仓库推送到 GitHub 后，可以让 Codex 使用 `skill-installer` 从仓库安装：

```text
repo: <owner>/<repo>
path: skills/right-code-imagegen
```

等价的安装器命令形式：

```powershell
python <CODEX_HOME>\skills\.system\skill-installer\scripts\install-skill-from-github.py `
  --repo <owner>/<repo> `
  --path skills/right-code-imagegen
```

安装完成后重启 Codex App，让新 skill 被加载。

## 本地开发安装

开发时也可以把 skill 目录复制到 Codex 的全局 skills 目录：

```powershell
$dest = Join-Path $env:USERPROFILE ".codex\skills\right-code-imagegen"
Copy-Item ".\skills\right-code-imagegen" $dest -Recurse
```

如果目标目录已存在，先确认里面没有需要保留的改动，再删除或覆盖。

## API Key

运行时从环境变量读取 Key，优先级：

1. `RIGHT_CODE_API_KEY`
2. `RCODE_API_KEY`

PowerShell 示例：

```powershell
$env:RIGHT_CODE_API_KEY="sk-..."
```

不要把完整 Key 写入仓库、README、prompt 或聊天记录。

## 直接调用脚本

```powershell
python .\skills\right-code-imagegen\scripts\right_code_image_gen.py `
  --prompt "未来城市夜景，电影感灯光，无文字无水印" `
  --size 16:9 `
  --out-dir .\output\imagegen
```

脚本默认提交 Images 异步任务，持续查询同一个 `task_id`，完成后提取图片 URL 或 base64，下载到 `output/imagegen/`，并输出任务号、进度、URL、保存路径和 usage 信息。

生成游戏素材、图标、贴图、角色、道具、粒子特效、UI 元素等资产类图片时，建议在提示词中明确加入“透明背景、PNG、主体完整、无背景底板、无投影、无文字无水印”，减少后期抠图成本。

最新接口通过任务查询响应里的 `status` 和 `progress` 返回进度。只要状态为 `queued`、`processing` 或 `in_progress`，脚本就继续查询同一个任务，不会重新提交。默认最多等待 10 分钟（`--timeout 600`），超时后可使用返回的任务号继续查询：

```powershell
python .\skills\right-code-imagegen\scripts\right_code_image_gen.py `
  --task-id task_0123456789abcdef0123456789abcdef
```

Images 模式的 `--size` 会作为正式 `size` 参数发送，支持比例或像素串；Gemini 模式会把它作为 `aspectRatio`。`--image-size` 支持 `1K`、`2K`、`4K`。仍建议下载后检查实际像素尺寸，因为上游模型可能按自身支持档位输出。

## 文件结构

```text
skills/right-code-imagegen/
├── SKILL.md
├── agents/
│   └── openai.yaml
├── references/
│   └── api.md
└── scripts/
    └── right_code_image_gen.py
```