Compare commits
No commits in common. "cd9b029dfa2597372440037b582a79dde86c05f6" and "e0355d6a7f244fb46312420f5f382455f3c517ae" have entirely different histories.
cd9b029dfa
...
e0355d6a7f
@ -1,175 +1,202 @@
|
|||||||
# oneinai-aimcp - 统一 AI MCP 服务器
|
# ikuncode-aimcp - 统一 AI MCP 服务器
|
||||||
|
|
||||||
**一个二进制，三套 AI 引擎 — Gemini · Codex · Grok**
|
**一个二进制，三套 AI 引擎 — Gemini · Codex · Grok**
|
||||||
|
|
||||||
## 📋 简介
|
📋 简介
|
||||||
|
|
||||||
oneinai-aimcp 是一个用 Rust 编写的统一 MCP 服务器，将 Gemini CLI、Codex CLI 和 Grok Search 整合到单个进程中。配置一次，即可在 Cursor / Windsurf / Claude Desktop 等任意 MCP 客户端中使用全部工具。
|
ikuncode-aimcp 是一个用 Rust 编写的统一 MCP 服务器，将 Gemini CLI、Codex CLI 和 Grok Search 整合到单个进程中。配置一次，即可在 Cursor / Windsurf / Claude Desktop 等任意 MCP 客户端中使用全部工具。
|
||||||
|
|
||||||
## 🔗 相关链接
|
## 🔗 相关链接
|
||||||
|
|
||||||
| 资源 | 地址 |
|
资源| 地址
|
||||||
| --- | --- |
|
---|---
|
||||||
| GitHub 仓库 | [xuxu777xu/oneinai-aimcp](https://github.com/xuxu777xu/oneinai-aimcp) |
|
GitHub 仓库| [xuxu777xu/ikuncode-aimcp](<https://github.com/xuxu777xu/ikuncode-aimcp>)
|
||||||
| oneinai API | <https://api.oneinai.com> |
|
ikun API| [api.ikuncode.cc](<https://api.oneinai.com>)
|
||||||
| oneinai 控制台 | <https://api.oneinai.com/console/token> |
|
|
||||||
|
|
||||||
## ✨ 功能特点
|
## ✨ 功能特点
|
||||||
|
|
||||||
- ✅ **一个二进制，全部工具**：只需配置一个 MCP 服务器，取代三个独立安装
|
* ✅ **一个二进制，全部工具** ：只需配置一个 MCP 服务器，取代三个独立安装
|
||||||
- ✅ **运行时检测**：启动时自动检测可用工具，不可用的工具返回清晰错误信息
|
* ✅ **运行时检测** ：启动时自动检测可用工具，不可用的工具返回清晰错误信息
|
||||||
- ✅ **AdaptiveStdio 传输**：自动检测 JSONL 和 LSP 帧格式，最大化客户端兼容性
|
* ✅ **AdaptiveStdio 传输** ：自动检测 JSONL 和 LSP 帧格式，最大化客户端兼容性
|
||||||
- ✅ **纯 Rust GrokSearch**：零 Python 依赖，通过 Grok API 实现 Web 搜索和内容抓取
|
* ✅ **纯 Rust GrokSearch** ：零 Python 依赖，通过 Grok API 实现 Web 搜索和内容抓取
|
||||||
- ✅ **Gemini 图像生成**：内置 `gemini_image` 工具，支持宽高比和分辨率控制
|
* ✅ **Gemini 图像生成** ：内置 `gemini_image` 工具，支持宽高比和分辨率控制
|
||||||
|
|
||||||
## 🧰 工具列表
|
## 🧰 工具列表
|
||||||
|
|
||||||
| 工具 | 来源 | 描述 |
|
工具| 来源| 描述
|
||||||
| --- | --- | --- |
|
---|---|---
|
||||||
| `gemini` | Gemini CLI | AI 驱动的任务执行，支持会话连续性 |
|
`gemini`| Gemini CLI| AI 驱动的任务执行，支持会话连续性
|
||||||
| `gemini_image` | Gemini CLI | AI 图像生成，使用专用生图模型 |
|
`gemini_image`| Gemini CLI| AI 图像生成，使用专用生图模型
|
||||||
| `codex` | Codex CLI | AI 辅助编码，支持沙箱策略 |
|
`codex`| Codex CLI| AI 辅助编码，支持沙箱策略
|
||||||
| `web_search` | Grok API | Web 搜索，返回结构化 JSON 结果 |
|
`web_search`| Grok API| Web 搜索，返回结构化 JSON 结果
|
||||||
| `web_fetch` | Grok API | 抓取网页内容并转为 Markdown |
|
`web_fetch`| Grok API| 抓取网页内容并转为 Markdown
|
||||||
| `get_config_info` | Grok API | 显示配置信息并测试 API 连接 |
|
`get_config_info`| Grok API| 显示配置信息并测试 API 连接
|
||||||
|
|
||||||
### 相关项目
|
### 相关项目
|
||||||
|
|
||||||
| 项目 | 类型 | 适用场景 |
|
项目| 类型| 适用场景
|
||||||
| --- | --- | --- |
|
---|---|---
|
||||||
| **oneinai-aimcp**（本项目） | MCP Server | 所有 MCP 客户端通用，含 gemini_image 图像生成 |
|
**ikuncode-aimcp** （本项目）| MCP Server| 所有 MCP 客户端通用，含 gemini_image 图像生成
|
||||||
| [oneimage](/skills/oneimage) | Claude Code Skill | Claude Code 专用 — 文生图 / 图生图 / 并发批量生成 |
|
[ikunimage](</skills/ikunimage>)| Claude Code Skill| Claude Code 专用 — 文生图 / 图生图 / 并发批量生成
|
||||||
|
|
||||||
## 🛠️ 安装
|
## 🛠️ 安装
|
||||||
|
|
||||||
### 方式一：下载预编译二进制（推荐）
|
### 方式一：下载预编译二进制（推荐）
|
||||||
|
|
||||||
从 [GitHub Releases](https://github.com/xuxu777xu/oneinai-aimcp/releases) 下载对应平台的二进制文件：
|
从 [GitHub Releases](<https://github.com/xuxu777xu/ikuncode-aimcp/releases>) 下载对应平台的二进制文件：
|
||||||
|
|
||||||
| 平台 | 文件名 |
|
平台| 文件名
|
||||||
| --- | --- |
|
---|---
|
||||||
| Windows x64 | `oneinai-aimcp-x86_64-pc-windows-msvc.exe` |
|
Windows x64| `ikuncode-aimcp-x86_64-pc-windows-msvc.exe`
|
||||||
| macOS Apple Silicon | `oneinai-aimcp-aarch64-apple-darwin` |
|
macOS Apple Silicon| `ikuncode-aimcp-aarch64-apple-darwin`
|
||||||
| macOS Intel | `oneinai-aimcp-x86_64-apple-darwin` |
|
macOS Intel| `ikuncode-aimcp-x86_64-apple-darwin`
|
||||||
| Linux x64 | `oneinai-aimcp-x86_64-unknown-linux-gnu` |
|
Linux x64| `ikuncode-aimcp-x86_64-unknown-linux-gnu`
|
||||||
|
|
||||||
下载后放到 `PATH` 目录中即可使用。macOS / Linux 需要添加执行权限：
|
下载后放到 `PATH` 目录中即可使用。macOS / Linux 需要添加执行权限：
|
||||||
|
|
||||||
```bash
|
bash
|
||||||
chmod +x oneinai-aimcp-*
|
|
||||||
mv oneinai-aimcp-* /usr/local/bin/oneinai-aimcp
|
|
||||||
```
|
chmod +x ikuncode-aimcp-*
|
||||||
|
mv ikuncode-aimcp-* /usr/local/bin/ikuncode-aimcp
|
||||||
|
|
||||||
|
1
|
||||||
|
2
|
||||||
|
|
||||||
### 方式二：npm 安装
|
### 方式二：npm 安装
|
||||||
|
|
||||||
```bash
|
bash
|
||||||
npm install -g oneinai-aimcp
|
|
||||||
```
|
|
||||||
|
npm install -g ikuncode-aimcp
|
||||||
|
|
||||||
|
1
|
||||||
|
|
||||||
### 方式三：cargo 安装
|
### 方式三：cargo 安装
|
||||||
|
|
||||||
```bash
|
bash
|
||||||
cargo install --git https://github.com/xuxu777xu/oneinai-aimcp.git
|
|
||||||
```
|
|
||||||
|
cargo install --git https://github.com/xuxu777xu/ikuncode-aimcp.git
|
||||||
|
|
||||||
|
1
|
||||||
|
|
||||||
### 方式四：从源码编译
|
### 方式四：从源码编译
|
||||||
|
|
||||||
```bash
|
bash
|
||||||
git clone https://github.com/xuxu777xu/oneinai-aimcp.git
|
|
||||||
cd oneinai-aimcp
|
|
||||||
cargo build --release
|
git clone https://github.com/xuxu777xu/ikuncode-aimcp.git
|
||||||
# 二进制文件在 target/release/ 目录下
|
cd ikuncode-aimcp
|
||||||
```
|
cargo build --release
|
||||||
|
# 二进制文件在 target/release/ 目录下
|
||||||
|
|
||||||
|
1
|
||||||
|
2
|
||||||
|
3
|
||||||
|
4
|
||||||
|
|
||||||
## ⚙️ 配置 MCP 客户端
|
## ⚙️ 配置 MCP 客户端
|
||||||
|
|
||||||
在你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）中添加以下配置：
|
在你的 MCP 客户端（如 Claude Desktop、Cursor、Windsurf 等）中添加以下配置：
|
||||||
|
|
||||||
```json
|
json
|
||||||
{
|
|
||||||
|
|
||||||
|
{
|
||||||
"mcpServers": {
|
"mcpServers": {
|
||||||
"oneinai-aimcp": {
|
"ikuncode-aimcp": {
|
||||||
"command": "oneinai-aimcp",
|
"command": "ikuncode-aimcp",
|
||||||
"env": {
|
"env": {
|
||||||
"GEMINI_API_KEY": "你的-gemini-api-key",
|
"GEMINI_API_KEY": "你的-gemini-api-key",
|
||||||
"GROK_API_KEY": "你的-grok-api-key"
|
"GROK_API_KEY": "你的-grok-api-key"
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
```
|
|
||||||
|
|
||||||
> ⚠️ **环境变量说明**
|
1
|
||||||
> - `GEMINI_API_KEY`：用于 Gemini 相关工具（`gemini`、`gemini_image`）
|
2
|
||||||
> - `GROK_API_KEY`：用于 Grok 搜索工具（`web_search`、`web_fetch`）
|
3
|
||||||
> - Codex 工具使用独立配置，请参考 [Codex 部署文档](/deploy/codex)
|
4
|
||||||
|
5
|
||||||
|
6
|
||||||
|
7
|
||||||
|
8
|
||||||
|
9
|
||||||
|
10
|
||||||
|
11
|
||||||
|
|
||||||
|
⚠️ 环境变量说明
|
||||||
|
|
||||||
|
* `GEMINI_API_KEY`：用于 Gemini 相关工具（`gemini`、`gemini_image`）
|
||||||
|
* `GROK_API_KEY`：用于 Grok 搜索工具（`web_search`、`web_fetch`）
|
||||||
|
* Codex 工具使用独立配置，请参考 [Codex 部署文档](</deploy/codex>)
|
||||||
|
|
||||||
## 📖 工具使用说明
|
## 📖 工具使用说明
|
||||||
|
|
||||||
### `gemini` — AI 任务执行
|
### gemini — AI 任务执行
|
||||||
|
|
||||||
| 参数 | 必填 | 类型 | 默认值 | 描述 |
|
参数| 必填| 类型| 默认值| 描述
|
||||||
| --- | --- | --- | --- | --- |
|
---|---|---|---|---
|
||||||
| `PROMPT` | 是 | string | — | 发送给 Gemini 的任务指令 |
|
`PROMPT`| 是| string| —| 发送给 Gemini 的任务指令
|
||||||
| `sandbox` | 否 | bool | `false` | 在沙箱模式下运行 |
|
`sandbox`| 否| bool| false| 在沙箱模式下运行
|
||||||
| `SESSION_ID` | 否 | string | — | 恢复已有会话，用于多轮对话 |
|
`SESSION_ID`| 否| string| —| 恢复已有会话，用于多轮对话
|
||||||
| `model` | 否 | string | — | 模型覆盖 |
|
`model`| 否| string| —| 模型覆盖
|
||||||
| `timeout_secs` | 否 | int | `600` | 超时时间（1–3600 秒） |
|
`timeout_secs`| 否| int| 600| 超时时间（1–3600 秒）
|
||||||
|
|
||||||
### `gemini_image` — 图像生成
|
### gemini_image — 图像生成
|
||||||
|
|
||||||
| 参数 | 必填 | 类型 | 默认值 | 描述 |
|
参数| 必填| 类型| 默认值| 描述
|
||||||
| --- | --- | --- | --- | --- |
|
---|---|---|---|---
|
||||||
| `PROMPT` | 是 | string | — | 图像生成指令 |
|
`PROMPT`| 是| string| —| 图像生成指令
|
||||||
| `model` | 否 | string | — | 模型覆盖 |
|
`model`| 否| string| —| 模型覆盖
|
||||||
| `output_dir` | 否 | string | — | 图片保存目录 |
|
`output_dir`| 否| string| —| 图片保存目录
|
||||||
| `aspect_ratio` | 否 | string | — | 宽高比（1:1 / 16:9 / 9:16 等） |
|
`aspect_ratio`| 否| string| —| 宽高比（1:1 / 16:9 / 9:16 等）
|
||||||
| `image_size` | 否 | string | — | 分辨率（1K / 2K / 4K） |
|
`image_size`| 否| string| —| 分辨率（1K / 2K / 4K）
|
||||||
| `timeout_secs` | 否 | int | `600` | 超时时间（1–3600 秒） |
|
`timeout_secs`| 否| int| 600| 超时时间（1–3600 秒）
|
||||||
|
|
||||||
### `codex` — AI 辅助编码
|
### codex — AI 辅助编码
|
||||||
|
|
||||||
| 参数 | 必填 | 类型 | 默认值 | 描述 |
|
参数| 必填| 类型| 默认值| 描述
|
||||||
| --- | --- | --- | --- | --- |
|
---|---|---|---|---
|
||||||
| `PROMPT` | 是 | string | — | 发送给 Codex 的任务指令 |
|
`PROMPT`| 是| string| —| 发送给 Codex 的任务指令
|
||||||
| `cd` | 是 | string | — | 工作目录路径 |
|
`cd`| 是| string| —| 工作目录路径
|
||||||
| `sandbox` | 否 | string | `read-only` | 沙箱策略 |
|
`sandbox`| 否| string| `read-only`| 沙箱策略
|
||||||
|
|
||||||
### `web_search` — Web 搜索
|
### web_search — Web 搜索
|
||||||
|
|
||||||
| 参数 | 必填 | 类型 | 默认值 | 描述 |
|
参数| 必填| 类型| 默认值| 描述
|
||||||
| --- | --- | --- | --- | --- |
|
---|---|---|---|---
|
||||||
| `query` | 是 | string | — | 自然语言搜索查询 |
|
`query`| 是| string| —| 自然语言搜索查询
|
||||||
| `platform` | 否 | string | — | 聚焦特定平台 |
|
`platform`| 否| string| —| 聚焦特定平台
|
||||||
| `min_results` | 否 | int | `3` | 最少返回结果数 |
|
`min_results`| 否| int| 3| 最少返回结果数
|
||||||
| `max_results` | 否 | int | `10` | 最多返回结果数 |
|
`max_results`| 否| int| 10| 最多返回结果数
|
||||||
|
|
||||||
### `web_fetch` — 网页内容抓取
|
### web_fetch — 网页内容抓取
|
||||||
|
|
||||||
| 参数 | 必填 | 类型 | 默认值 | 描述 |
|
参数| 必填| 类型| 默认值| 描述
|
||||||
| --- | --- | --- | --- | --- |
|
---|---|---|---|---
|
||||||
| `url` | 是 | string | — | 有效的 HTTP/HTTPS 网址 |
|
`url`| 是| string| —| 有效的 HTTP/HTTPS 网址
|
||||||
|
|
||||||
### `get_config_info` — Grok 配置诊断
|
### get_config_info — Grok 配置诊断
|
||||||
|
|
||||||
无参数。返回当前 Grok 配置信息并测试 API 连接。
|
无参数。返回当前 Grok 配置信息并测试 API 连接。
|
||||||
|
|
||||||
## ❓ 常见问题
|
## 常见问题
|
||||||
|
|
||||||
### 安装后命令找不到？
|
### 安装后命令找不到？
|
||||||
|
|
||||||
确认二进制文件已放到 `PATH` 目录中，且有执行权限。可运行 `which oneinai-aimcp`（macOS / Linux）或 `where oneinai-aimcp`（Windows）检查。
|
确认二进制文件已放到 `PATH` 目录中，且有执行权限。可运行 `which ikuncode-aimcp` 检查。
|
||||||
|
|
||||||
### Gemini 工具不可用？
|
### Gemini 工具不可用？
|
||||||
|
|
||||||
- 检查 `GEMINI_API_KEY` 环境变量是否正确设置
|
检查 `GEMINI_API_KEY` 环境变量是否正确设置，以及本地是否安装了 Gemini CLI。
|
||||||
- 确认本地是否已安装 Gemini CLI
|
|
||||||
- 参考 [Gemini CLI 部署文档](/deploy/gemini-cli)
|
|
||||||
|
|
||||||
### Grok 搜索返回错误？
|
### Grok 搜索返回错误？
|
||||||
|
|
||||||
运行 `get_config_info` 工具检查 API 配置和连接状态，确认 `GROK_API_KEY` 有效且账户可用。
|
运行 `get_config_info` 工具检查 API 配置和连接状态。
|
||||||
|
|
||||||
### 更多问题
|
### 更多问题
|
||||||
|
|
||||||
请查看 [FAQ](/support/faq) 或联系[售后支持](/support/after-sales)。
|
请查看 [FAQ](</support/faq>) 或联系[售后支持](</support/after-sales>)。
|
||||||
|
|||||||
@ -1,93 +1,121 @@
|
|||||||
# oneimage - AI 图片生成器
|
# ikunimage - AI 图片生成器
|
||||||
|
|
||||||
**Claude Code Skill — 通过 oneinai API 调用 Gemini 图像模型，支持文生图与图生图**
|
**Claude Code Skill — 通过 ikun API 调用 Gemini 图像模型，支持文生图与图生图**
|
||||||
|
|
||||||
## 📋 简介
|
📋 简介
|
||||||
|
|
||||||
oneimage 是一款 Claude Code Skill 插件，通过 [oneinai API](https://api.oneinai.com) 调用 **NanoBananaPro（Gemini 3 Pro Image Preview）** 模型，在 Claude Code 对话中直接生成高质量图片。支持文生图、图生图编辑、批量并发等多种模式。
|
ikunimage 是一款 Claude Code Skill 插件，通过 [ikun API](<https://api.oneinai.com>) 调用 **NanoBananaPro（Gemini 3 Pro Image Preview）** 模型，在 Claude Code 对话中直接生成高质量图片。支持文生图、图生图编辑、批量并发等多种模式。
|
||||||
|
|
||||||
## 🔗 相关链接
|
## 🔗 相关链接
|
||||||
|
|
||||||
| 资源 | 地址 |
|
资源| 地址
|
||||||
| --- | --- |
|
---|---
|
||||||
| GitHub 仓库 | [deijing/oneimage](https://github.com/deijing/oneimage) |
|
GitHub 仓库| [deijing/ikunimage](<https://github.com/deijing/ikunimage>)
|
||||||
| oneinai API | <https://api.oneinai.com> |
|
ikun API| [api.ikuncode.cc](<https://api.oneinai.com>)
|
||||||
| oneinai 控制台 | <https://api.oneinai.com/console/token> |
|
|
||||||
|
|
||||||
## ✨ 功能特点
|
## ✨ 功能特点
|
||||||
|
|
||||||
- ✅ **文生图**：用自然语言描述场景，AI 生成对应图片
|
* ✅ **文生图** ：用自然语言描述场景，AI 生成对应图片
|
||||||
- ✅ **图生图**：上传本地图片 + 编辑描述，AI 修改生成新图片
|
* ✅ **图生图** ：上传本地图片 + 编辑描述，AI 修改生成新图片
|
||||||
- ✅ **10 种宽高比**：1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9 / 5:4 / 4:5
|
* ✅ **10 种宽高比** ：1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 / 21:9 / 5:4 / 4:5
|
||||||
- ✅ **3 档分辨率**：1K（快速预览）/ 2K（推荐）/ 4K（超高清）
|
* ✅ **3 档分辨率** ：1K（快速预览）/ 2K（推荐）/ 4K（超高清）
|
||||||
- ✅ **文字渲染**：支持在图片中渲染中文文字（招牌、海报、标语等）
|
* ✅ **文字渲染** ：支持在图片中渲染中文文字（招牌、海报、标语等）
|
||||||
- ✅ **并发批量**：多张图片并发生成，大幅缩短总耗时
|
* ✅ **并发批量** ：多张图片并发生成，大幅缩短总耗时
|
||||||
- ✅ **配置文件管理**：API Key 存储在本地配置文件，安全便捷
|
* ✅ **配置文件管理** ：API Key 存储在本地配置文件，安全便捷
|
||||||
|
|
||||||
## 📋 前置要求
|
## 📋 前置要求
|
||||||
|
|
||||||
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI 已安装
|
* [Claude Code](<https://docs.anthropic.com/en/docs/claude-code>) CLI 已安装
|
||||||
- Python 3.10+
|
* Python 3.10+
|
||||||
- oneinai API Key（在 [oneinai 控制台](https://api.oneinai.com/console/token) 创建）
|
* ikun API Key（从 [api.ikuncode.cc](<https://api.oneinai.com>) 获取）
|
||||||
|
|
||||||
## 🛠️ 安装
|
## 🛠️ 安装
|
||||||
|
|
||||||
### 第一步：下载 Skill
|
### 第一步：下载 Skill
|
||||||
|
|
||||||
```bash
|
bash
|
||||||
# 如果目录不存在，先创建
|
|
||||||
mkdir -p ~/.claude/skills
|
|
||||||
|
|
||||||
# 克隆 oneimage 到 skills 目录
|
|
||||||
cd ~/.claude/skills
|
# 如果目录不存在，先创建
|
||||||
git clone https://github.com/deijing/oneimage.git
|
mkdir -p ~/.claude/skills
|
||||||
```
|
|
||||||
|
# 克隆 ikunimage 到 skills 目录
|
||||||
|
cd ~/.claude/skills
|
||||||
|
git clone https://github.com/deijing/ikunimage.git
|
||||||
|
|
||||||
|
1
|
||||||
|
2
|
||||||
|
3
|
||||||
|
4
|
||||||
|
5
|
||||||
|
6
|
||||||
|
|
||||||
安装完成后目录结构如下：
|
安装完成后目录结构如下：
|
||||||
|
|
||||||
```
|
|
||||||
~/.claude/skills/oneimage/
|
~/.claude/skills/ikunimage/
|
||||||
├── SKILL.md # Skill 定义文件
|
├── SKILL.md # Skill 定义文件
|
||||||
├── scripts/
|
├── scripts/
|
||||||
│ ├── generate_oneinai.py # 文生图脚本
|
│ ├── generate_ikun.py # 文生图脚本
|
||||||
│ └── generate_oneinai_edit.py # 图生图脚本
|
│ └── generate_ikun_edit.py # 图生图脚本
|
||||||
└── references/
|
└── references/
|
||||||
└── api-reference.md # API 参考文档
|
└── api-reference.md # API 参考文档
|
||||||
```
|
|
||||||
|
1
|
||||||
|
2
|
||||||
|
3
|
||||||
|
4
|
||||||
|
5
|
||||||
|
6
|
||||||
|
7
|
||||||
|
|
||||||
### 第二步：安装依赖
|
### 第二步：安装依赖
|
||||||
|
|
||||||
```bash
|
bash
|
||||||
pip install httpx
|
|
||||||
```
|
|
||||||
|
pip install httpx
|
||||||
|
|
||||||
|
1
|
||||||
|
|
||||||
### 第三步：配置 API Key
|
### 第三步：配置 API Key
|
||||||
|
|
||||||
三种方式任选其一。
|
三种方式任选其一：
|
||||||
|
|
||||||
**方式 A：交互式配置（推荐）**
|
**方式 A：交互式配置（推荐）**
|
||||||
|
|
||||||
```bash
|
bash
|
||||||
python ~/.claude/skills/oneimage/scripts/generate_oneinai.py --setup
|
|
||||||
```
|
|
||||||
|
|
||||||
按提示输入你的 API Key 即可，配置会保存到 `~/.oneimage/config.json`。
|
|
||||||
|
python ~/.claude/skills/ikunimage/scripts/generate_ikun.py --setup
|
||||||
|
|
||||||
|
1
|
||||||
|
|
||||||
|
按提示输入你的 API Key 即可，配置会保存到 `~/.ikunimage/config.json`。
|
||||||
|
|
||||||
**方式 B：手动创建配置文件**
|
**方式 B：手动创建配置文件**
|
||||||
|
|
||||||
```bash
|
bash
|
||||||
mkdir -p ~/.oneimage
|
|
||||||
echo '{"api_key": "sk-你的key"}' > ~/.oneimage/config.json
|
|
||||||
```
|
mkdir -p ~/.ikunimage
|
||||||
|
echo '{"api_key": "sk-你的key"}' > ~/.ikunimage/config.json
|
||||||
|
|
||||||
|
1
|
||||||
|
2
|
||||||
|
|
||||||
**方式 C：环境变量**
|
**方式 C：环境变量**
|
||||||
|
|
||||||
```bash
|
bash
|
||||||
export ONEINAI_API_KEY="sk-你的key"
|
|
||||||
```
|
|
||||||
|
|
||||||
> 💡 **API Key 加载优先级**
|
|
||||||
> `--api-key` 命令行参数 > `ONEINAI_API_KEY` 环境变量 > `~/.oneimage/config.json` 配置文件
|
export IKUN_API_KEY="sk-你的key"
|
||||||
|
|
||||||
|
1
|
||||||
|
|
||||||
|
💡 API Key 加载优先级
|
||||||
|
|
||||||
|
`--api-key` 命令行参数 > `IKUN_API_KEY` 环境变量 > `~/.ikunimage/config.json` 配置文件
|
||||||
|
|
||||||
## 📖 使用方法
|
## 📖 使用方法
|
||||||
|
|
||||||
@ -95,147 +123,181 @@ export ONEINAI_API_KEY="sk-你的key"
|
|||||||
|
|
||||||
安装配置完成后，在 Claude Code 对话中输入：
|
安装配置完成后，在 Claude Code 对话中输入：
|
||||||
|
|
||||||
```
|
|
||||||
/oneimage
|
/ikunimage
|
||||||
```
|
|
||||||
|
1
|
||||||
|
|
||||||
然后描述你想要的图片即可。例如：
|
然后描述你想要的图片即可。例如：
|
||||||
|
|
||||||
- "画一张江南水乡的风景"
|
* "画一张江南水乡的风景"
|
||||||
- "生成一张 4K 超宽屏的故宫雪景"
|
* "生成一张 4K 超宽屏的故宫雪景"
|
||||||
- "批量生成 5 张不同风格的古风人像"
|
* "批量生成 5 张不同风格的古风人像"
|
||||||
|
|
||||||
图生图编辑：
|
图生图编辑：
|
||||||
|
|
||||||
- "编辑 /path/to/photo.jpg，把背景改成竹林"
|
* "编辑 /path/to/photo.jpg，把背景改成竹林"
|
||||||
|
|
||||||
### 独立脚本使用
|
### 独立脚本使用
|
||||||
|
|
||||||
也可以脱离 Claude Code，直接在命令行中调用。
|
也可以脱离 Claude Code，直接在命令行中调用。
|
||||||
|
|
||||||
**文生图**：
|
**文生图** ：
|
||||||
|
|
||||||
```bash
|
bash
|
||||||
python ~/.claude/skills/oneimage/scripts/generate_oneinai.py \
|
|
||||||
-p "一位中国女性，身穿汉服，站在竹林中，晨雾缭绕" \
|
|
||||||
-ar 3:4 \
|
python ~/.claude/skills/ikunimage/scripts/generate_ikun.py \\
|
||||||
-s 2K \
|
-p "一位中国女性，身穿汉服，站在竹林中，晨雾缭绕" \\
|
||||||
|
-ar 3:4 \\
|
||||||
|
-s 2K \\
|
||||||
-o ./output.png
|
-o ./output.png
|
||||||
```
|
|
||||||
|
|
||||||
**图生图**：
|
1
|
||||||
|
2
|
||||||
|
3
|
||||||
|
4
|
||||||
|
5
|
||||||
|
|
||||||
```bash
|
**图生图** ：
|
||||||
python ~/.claude/skills/oneimage/scripts/generate_oneinai_edit.py \
|
|
||||||
-i ./photo.jpg \
|
bash
|
||||||
-p "将背景改为雪景，保持人物不变" \
|
|
||||||
-ar 3:4 \
|
|
||||||
|
python ~/.claude/skills/ikunimage/scripts/generate_ikun_edit.py \\
|
||||||
|
-i ./photo.jpg \\
|
||||||
|
-p "将背景改为雪景，保持人物不变" \\
|
||||||
|
-ar 3:4 \\
|
||||||
-o ./edited.png
|
-o ./edited.png
|
||||||
```
|
|
||||||
|
|
||||||
**批量生成**：
|
1
|
||||||
|
2
|
||||||
|
3
|
||||||
|
4
|
||||||
|
5
|
||||||
|
|
||||||
```bash
|
**批量生成** ：
|
||||||
# 准备任务文件 tasks.json
|
|
||||||
cat > tasks.json << 'EOF'
|
bash
|
||||||
[
|
|
||||||
|
|
||||||
|
# 准备任务文件 tasks.json
|
||||||
|
cat > tasks.json << 'EOF'
|
||||||
|
[
|
||||||
{"prompt": "描述1", "aspect_ratio": "3:4", "size": "2K", "output": "./out1.png"},
|
{"prompt": "描述1", "aspect_ratio": "3:4", "size": "2K", "output": "./out1.png"},
|
||||||
{"prompt": "描述2", "aspect_ratio": "16:9", "size": "1K", "output": "./out2.png"}
|
{"prompt": "描述2", "aspect_ratio": "16:9", "size": "1K", "output": "./out2.png"}
|
||||||
]
|
]
|
||||||
EOF
|
EOF
|
||||||
|
|
||||||
# 执行批量生成
|
# 执行批量生成
|
||||||
python ~/.claude/skills/oneimage/scripts/generate_oneinai.py \
|
python ~/.claude/skills/ikunimage/scripts/generate_ikun.py \\
|
||||||
--batch tasks.json \
|
--batch tasks.json \\
|
||||||
--workers 2
|
--workers 2
|
||||||
```
|
|
||||||
|
1
|
||||||
|
2
|
||||||
|
3
|
||||||
|
4
|
||||||
|
5
|
||||||
|
6
|
||||||
|
7
|
||||||
|
8
|
||||||
|
9
|
||||||
|
10
|
||||||
|
11
|
||||||
|
12
|
||||||
|
|
||||||
## 📐 参数速查
|
## 📐 参数速查
|
||||||
|
|
||||||
### 文生图（`generate_oneinai.py`）
|
### 文生图 (generate_ikun.py)
|
||||||
|
|
||||||
| 参数 | 简写 | 说明 | 默认值 |
|
参数| 简写| 说明| 默认值
|
||||||
| --- | --- | --- | --- |
|
---|---|---|---
|
||||||
| `--setup` | | 交互式配置 API Key | |
|
`--setup`| | 交互式配置 API Key|
|
||||||
| `--api-key` | | 指定 API Key | 从配置加载 |
|
`--api-key`| | 指定 API Key| 从配置加载
|
||||||
| `--prompt` | `-p` | 图片描述（必填） | |
|
`--prompt`| `-p`| 图片描述（必填）|
|
||||||
| `--aspect-ratio` | `-ar` | 宽高比 | `1:1` |
|
`--aspect-ratio`| `-ar`| 宽高比| `1:1`
|
||||||
| `--size` | `-s` | 分辨率（1K/2K/4K） | `2K` |
|
`--size`| `-s`| 分辨率（1K/2K/4K）| `2K`
|
||||||
| `--output` | `-o` | 输出路径 | `output.png` |
|
`--output`| `-o`| 输出路径| `output.png`
|
||||||
| `--batch` | `-b` | 批量任务 JSON 文件 | |
|
`--batch`| `-b`| 批量任务 JSON 文件|
|
||||||
| `--workers` | `-w` | 并发数 | 自动（默认 2） |
|
`--workers`| `-w`| 并发数| 自动（默认 2）
|
||||||
| `--retry` | `-r` | 重试次数（0-10） | `3` |
|
`--retry`| `-r`| 重试次数（0-10）| `3`
|
||||||
|
|
||||||
### 图生图（`generate_oneinai_edit.py`）
|
### 图生图 (generate_ikun_edit.py)
|
||||||
|
|
||||||
| 参数 | 简写 | 说明 | 默认值 |
|
参数| 简写| 说明| 默认值
|
||||||
| --- | --- | --- | --- |
|
---|---|---|---
|
||||||
| `--setup` | | 交互式配置 API Key | |
|
`--setup`| | 交互式配置 API Key|
|
||||||
| `--api-key` | | 指定 API Key | 从配置加载 |
|
`--api-key`| | 指定 API Key| 从配置加载
|
||||||
| `--input` | `-i` | 输入图片路径（必填） | |
|
`--input`| `-i`| 输入图片路径（必填）|
|
||||||
| `--prompt` | `-p` | 编辑描述（必填） | |
|
`--prompt`| `-p`| 编辑描述（必填）|
|
||||||
| `--aspect-ratio` | `-ar` | 输出宽高比 | `1:1` |
|
`--aspect-ratio`| `-ar`| 输出宽高比| `1:1`
|
||||||
| `--output` | `-o` | 输出路径 | `output.png` |
|
`--output`| `-o`| 输出路径| `output.png`
|
||||||
| `--batch` | `-b` | 批量任务 JSON 文件 | |
|
`--batch`| `-b`| 批量任务 JSON 文件|
|
||||||
| `--workers` | `-w` | 并发数 | 自动（默认 2） |
|
`--workers`| `-w`| 并发数| 自动（默认 2）
|
||||||
| `--retry` | `-r` | 重试次数（0-10） | `3` |
|
`--retry`| `-r`| 重试次数（0-10）| `3`
|
||||||
|
|
||||||
> ⚠️ **互斥参数**
|
⚠️ 互斥参数
|
||||||
> `--prompt` 和 `--batch` 互斥，单图模式和批量模式必须二选一。
|
|
||||||
|
`--prompt` 和 `--batch` 互斥，单图模式和批量模式必须二选一。
|
||||||
|
|
||||||
## 📊 分辨率参考
|
## 📊 分辨率参考
|
||||||
|
|
||||||
### 1K（快速预览）
|
### 1K（快速预览）
|
||||||
|
|
||||||
| 宽高比 | 分辨率 |
|
宽高比| 分辨率
|
||||||
| --- | --- |
|
---|---
|
||||||
| 1:1 | 1024×1024 |
|
1:1| 1024×1024
|
||||||
| 16:9 | 1376×768 |
|
16:9| 1376×768
|
||||||
| 9:16 | 768×1376 |
|
9:16| 768×1376
|
||||||
| 4:3 | 1200×896 |
|
4:3| 1200×896
|
||||||
| 3:4 | 896×1200 |
|
3:4| 896×1200
|
||||||
|
|
||||||
### 2K（推荐）
|
### 2K（推荐）
|
||||||
|
|
||||||
| 宽高比 | 分辨率 |
|
宽高比| 分辨率
|
||||||
| --- | --- |
|
---|---
|
||||||
| 1:1 | 2048×2048 |
|
1:1| 2048×2048
|
||||||
| 16:9 | 2752×1536 |
|
16:9| 2752×1536
|
||||||
| 9:16 | 1536×2752 |
|
9:16| 1536×2752
|
||||||
| 4:3 | 2400×1792 |
|
4:3| 2400×1792
|
||||||
| 3:4 | 1792×2400 |
|
3:4| 1792×2400
|
||||||
|
|
||||||
### 4K（超高清）
|
### 4K（超高清）
|
||||||
|
|
||||||
| 宽高比 | 分辨率 |
|
宽高比| 分辨率
|
||||||
| --- | --- |
|
---|---
|
||||||
| 1:1 | 4096×4096 |
|
1:1| 4096×4096
|
||||||
| 16:9 | 5504×3072 |
|
16:9| 5504×3072
|
||||||
| 9:16 | 3072×5504 |
|
9:16| 3072×5504
|
||||||
| 4:3 | 4800×3584 |
|
4:3| 4800×3584
|
||||||
| 3:4 | 3584×4800 |
|
3:4| 3584×4800
|
||||||
|
|
||||||
## 🖼️ 图生图支持格式
|
## 🖼️ 图生图支持格式
|
||||||
|
|
||||||
| 格式 | 支持 | 备注 |
|
格式| 支持| 备注
|
||||||
| --- | --- | --- |
|
---|---|---
|
||||||
| JPG / JPEG | ✅ | 推荐 |
|
JPG / JPEG| ✅| 推荐
|
||||||
| PNG | ✅ | 推荐 |
|
PNG| ✅| 推荐
|
||||||
| WebP | ✅ | |
|
WebP| ✅|
|
||||||
| GIF | ✅ | 仅使用第一帧 |
|
GIF| ✅| 仅使用第一帧
|
||||||
|
|
||||||
> 💡 **建议**
|
💡 建议
|
||||||
> 图片大小推荐小于 4MB，过大可能导致上传变慢或超时。
|
|
||||||
|
|
||||||
## ❓ 常见问题
|
图片大小推荐 < 4MB，过大可能导致上传变慢或超时。
|
||||||
|
|
||||||
### 提示「未找到 API Key」？
|
## 常见问题
|
||||||
|
|
||||||
|
### 提示 "未找到 API Key"？
|
||||||
|
|
||||||
运行交互式配置命令：
|
运行交互式配置命令：
|
||||||
|
|
||||||
```bash
|
bash
|
||||||
python ~/.claude/skills/oneimage/scripts/generate_oneinai.py --setup
|
|
||||||
```
|
|
||||||
|
python ~/.claude/skills/ikunimage/scripts/generate_ikun.py --setup
|
||||||
|
|
||||||
|
1
|
||||||
|
|
||||||
### 请求超时？
|
### 请求超时？
|
||||||
|
|
||||||
@ -247,4 +309,4 @@ python ~/.claude/skills/oneimage/scripts/generate_oneinai.py --setup
|
|||||||
|
|
||||||
### 更多问题
|
### 更多问题
|
||||||
|
|
||||||
请查看 [FAQ](/support/faq) 或联系[售后支持](/support/after-sales)。
|
请查看 [FAQ](</support/faq>) 或联系[售后支持](</support/after-sales>)。
|
||||||
|
|||||||
@ -17,7 +17,13 @@
|
|||||||
* 获取最新消息
|
* 获取最新消息
|
||||||
* 与其他用户交流
|
* 与其他用户交流
|
||||||
|
|
||||||
|
### QQ 群
|
||||||
|
|
||||||
|
* **QQ 群号** ：请扫描下方二维码加入
|
||||||
|
|
||||||
|
### 扫码加群
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
## 服务时间
|
## 服务时间
|
||||||
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user