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