内容
# 代码种子图像桥
使用没有内置图像支持的模型（例如通过CC Switch的DeepSeek）时的图像生成和识别。将图像请求通过本地MCP服务器路由到火山引擎ARK（Seedream + Seed）。带有图像剥离器代理，透明地处理粘贴/上传的图像。
## 快速开始
### 1. 启动CC Switch
[CC Switch](https://github.com/farion1231/cc-switch)必须在端口15721上运行。
### 2. 启动图像桥
```powershell
# Windows
.\start.ps1
```
```bash
# macOS / Linux
./start.sh
```
这会自动安装插件（如果需要），更新`config.toml`，并启动图像剥离器代理。保持此终端打开。
### 3. 重启Codex
关闭并重新打开Codex。插件将注册自己，MCP服务器将启动，图像生成/识别工具将可用。
剥离器必须在您想要粘贴图像或使用img2img时运行。要停止，请按Ctrl+C。Codex仍将使用文本转图像功能，无需剥离器。
## 工作原理
```
您粘贴图像或输入提示
│
▼
Codex Desktop
│
▼
图像剥离器（端口11435） ── 保存粘贴的图像，剥离base64
│
▼
CC Switch（端口15721） ── 路由到DeepSeek
│
▼ （DeepSeek需要图像生成/识别）
MCP服务器（seed-image-bridge）
│
├── 生成图像 ──► Seedream API（文本转图像 / img2img）
└── 识别图像 ──► Seed API（图像理解）
```
| 场景 | 行为 |
|----------|-----------|
| 文本转图像（"画一只猫"） | 剥离器传递 → DeepSeek → MCP `生成图像` |
| img2img（粘贴 + "使其成为动漫风格"） | 剥离器保存图像 → DeepSeek → MCP `生成图像（提示，路径）` |
| 图像问题（粘贴 + "这是什么？"） | 剥离器保存图像 → DeepSeek → MCP `识别图像` |
安装和启动脚本自动处理`config.toml`：插件注册，MCP服务器注册和环境变量转发。
## 要求
- Python 3.10+
- `pip install openai httpx mcp requests`
- [CC Switch](https://github.com/Elluifi/cc-switch) 在端口15721上运行
- 来自[火山引擎](https://console.volcengine.com/ark/)的ARK API密钥
## 环境
| 变量 | 是否必需 | 默认值 | 描述 |
|----------|----------|---------|-------------|
| `ARK_API_KEY` | 是 | — | 火山引擎ARK API密钥 |
| `ARK_BASE_URL` | 否 | `https://ark.cn-beijing.volces.com/api/v3` | ARK API基础地址 |
| `ARK_SEEDREAM_MODEL` | 否 | `doubao-seedream-4-5-251128` | 生成模型 |
| `ARK_SEED_MODEL` | 否 | `doubao-seed-2-0-pro-260215` | 视觉模型 |
## 文件
| 文件 | 用途 |
|------|---------|
| `start.ps1` / `start.sh` | 入口点 — 自动安装 + 启动剥离器 |
| `stripper.py` | 图像剥离器代理 |
| `scripts/mcp_server.py` | MCP服务器（生成图像 + 识别图像） |
| `scripts/install.ps1` / `install.sh` | 插件 + 技能 + 市场安装程序 |
| `skills/seed-image.md` | Codex技能说明 |
| `.codex-plugin/plugin.json` | 插件清单 |
| `.mcp.json` | MCP服务器配置模板 |
## 手动安装
如果您更喜欢在不启动剥离器的情况下安装：
```powershell
.\scripts\install.ps1
```
```bash
./scripts/install.sh
```
这将安装插件，在市场中注册它，并配置`config.toml`。在需要时单独启动剥离器，运行`python stripper.py`。
