# provider-imagegen-distribution

**Repository Path**: leapai/provider-imagegen-distribution

## Basic Information

- **Project Name**: provider-imagegen-distribution
- **Description**: 跃数生图plugins
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-31
- **Last Updated**: 2026-09-01

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Provider ImageGen for Codex

Provider ImageGen 是一个可安装的 Codex 插件。它通过 Leap Number AI 生成图片，使用者的 API Key 保存在自己的电脑上；Cloudflare Worker 只在当前 HTTPS 请求中接收并转发密钥，不持久化密钥。

当前版本：`2.0.1`

## 一键安装

### 命令行安装

确保已经安装 Node.js 18 或更高版本，并且终端中可以运行 `node --version`。然后执行：

```powershell
codex plugin marketplace add https://gitee.com/leapai/provider-imagegen-distribution.git
codex plugin add provider-imagegen@leap-number-ai
```

安装完成后，完全退出并重新打开 Codex Desktop，再新建任务。仅新建任务而不重启 Desktop，可能仍会使用旧的插件进程。

### Codex Desktop 安装

1. 打开 Plugins。
2. 选择 Add Marketplace。
3. 输入 `https://gitee.com/leapai/provider-imagegen-distribution.git`。
4. 在 `Leap Number AI Plugins` 中安装 `Provider ImageGen`。
5. 完全退出并重新打开 Codex Desktop，然后新建任务。

## 使用

在 Codex Desktop 中选择 `@Provider ImageGen`，然后直接描述图片：

```text
生成一张雨后竹林里的熊猫插画
```

在支持技能调用的 Codex 环境中也可以使用：

```text
$provider-imagegen 生成一张雨后竹林里的熊猫插画
```

第一次生成时，插件会打开仅本机可访问的设置页面。页面提供按钮，可在外部浏览器一键打开 `https://ys666.site/keys`；请在那里创建生图密钥，再参照页面内的提示截图，把 API Key 复制到下方输入框。不要把密钥粘贴到聊天中，保存后插件会自动复用本机密钥。

图片生成成功后会同时：

- 在 Codex 页面中展示图片；
- 保存到本机 Codex 输出目录；
- 返回图片的绝对文件路径。

默认输出目录：

```text
~/.codex/outputs/provider-imagegen/YYYY-MM-DD/
```

Windows 通常位于：

```text
%USERPROFILE%\.codex\outputs\provider-imagegen\YYYY-MM-DD\
```

## API Key 与隐私

密钥默认保存到：

```text
~/.codex/credentials/provider-imagegen.json
```

- API Key 不包含在插件或仓库中。
- API Key 不会进入聊天内容或模型提示词。
- 本地 MCP 只把密钥发送到固定地址 `https://image-mcp.opusrouter.fun/mcp`。
- Worker 只把生成请求转发到 `https://ys666.site/v1/images/generations`，不会持久化 API Key。
- 只有用户明确要求时，插件才会替换或删除本机密钥。

## 更新

仓库发布新版本后执行：

```powershell
codex plugin marketplace upgrade leap-number-ai
codex plugin add provider-imagegen@leap-number-ai
```

更新后完全退出并重新打开 Codex Desktop，再新建任务。

## 当前能力

- 支持新的位图图片生成。
- 支持 PNG、JPEG 和 WebP 返回结果落盘。
- 支持一次生成多张图片。
- 当前版本不支持编辑已有图片。
- 超时后不会自动重新提交生成请求，避免重复计费。

## 常见问题

### 提示生成服务未加载

先运行 `node --version`，确认 Node.js 18+ 可用；然后完全退出并重新打开 Codex Desktop。

### 提示画好了，但页面没有图片

请更新到 `2.0.1` 或更高版本并重启 Codex。新版会自动保存本地文件，并返回用于页面展示的图片路径。

### 如何更换 API Key

在 Codex 中明确要求 Provider ImageGen 更换本机 API Key。插件不会在未授权时覆盖现有密钥。

## 仓库结构

```text
.
|-- .agents/plugins/marketplace.json
|-- plugins/provider-imagegen/
|   |-- .codex-plugin/plugin.json
|   |-- .mcp.json
|   |-- mcp/server.mjs
|   |-- skills/provider-imagegen/
|   `-- assets/
|-- LICENSE
`-- README.md
```

必须保留 `.agents`、`.codex-plugin` 和 `.mcp.json`。缺少这些文件时，Codex 无法发现插件或启动本地 MCP。

## 许可证

Apache License 2.0，详见 [LICENSE](LICENSE)。