内容
# Flux Schnell
一个基于Cloudflare Worker与AI绑定的文生图应用。支持WebUI界面和Cursor编辑器集成。
## 快速开始
1. 双击运行`start-flux-schnell.bat`
2. 根据需要选择以下选项之一：
- 选项1：直接启动WebUI (如果您已有Worker URL)
- 选项2：部署Worker并获取URL，然后启动WebUI
- 选项3：从最近部署中自动提取Worker URL
- 选项4：启动CF-FLUX-MCP，用于Cursor编辑器集成（已完成）
3. 如果选择部署Worker，系统会打开浏览器，请登录您的Cloudflare账户并授权
4. 部署完成后，请复制显示的Worker URL
5. 根据您选择的使用方式继续操作：
- WebUI：在界面中输入Worker URL，点击"保存并继续"按钮开始使用
- Cursor：按照提示配置MCP程序
## 目录结构
- `cf-flux-schnell/` - Cloudflare Worker源代码
- `weiui/` - 图形用户界面
- `CF-FLUX-MCP/` - Cursor编辑器集成代码（已完成）
- `*.bat` - 各种帮助脚本
## 特性
- 基于Cloudflare Workers AI的高质量文生图
- 双重使用方式：
- 响应式现代化WebUI界面
- Cursor编辑器直接集成
- 支持多种语言（英文、简体中文、繁体中文、俄语、阿拉伯语、法语、德语、西班牙语）
- 可调整生成步数，平衡质量与速度
- 生成历史记录与快速重用
- 便捷的图像下载功能
- 全自动部署与配置
## 部署说明
本应用使用Cloudflare Worker提供AI文生图服务，需要您拥有Cloudflare账户（免费）。
### 部署方式
1. **交互式浏览器认证(推荐)**:
- 运行`start-flux-schnell.bat`并选择选项2
- 系统会打开浏览器让您登录Cloudflare账户
- 部署完成后会自动保存Worker URL
- 无需手动获取API Token
2. **手动部署**:
- 进入`cf-flux-schnell`目录
- 运行`npm install`
- 运行`npx wrangler deploy`
- 运行`save-worker-url.bat`保存获取的URL
## 使用方式
### 1. WebUI界面
直接通过图形界面使用，支持：
- 可视化的提示词输入
- 图像预览
- 历史记录管理
- 多语言切换
### 2. Cursor编辑器集成
1. 启动MCP服务：
- 运行`start-flux-schnell.bat`选择选项4
- 系统会自动启动MCP服务
2. 配置Cursor：
- 打开Cursor设置
- 选择"Copilot设置"
- 进入"MCP程序"选项卡
- 添加新程序：
- 命令：`node 完整路径\CF-FLUX-MCP\simple-server-final.js`
- 名称：CF-FLUX-MCP
- 描述：Flux图像生成
3. 在编辑器中使用：
```
/generate-flux-image prompt="您想生成的图像描述" model="@cf/black-forest-labs/flux-2-klein-4b" width=1024 height=1024 steps=4
```
参数说明：
- `prompt`：图像描述（必填）
- `model`：模型 id（可选，默认 `@cf/black-forest-labs/flux-2-klein-4b`），可选值：
- `@cf/black-forest-labs/flux-2-klein-4b`（蒸馏轻量版，1-8 步，默认 4）
- `@cf/black-forest-labs/flux-2-klein-9b`（蒸馏均衡版，1-8 步，默认 4）
- `@cf/black-forest-labs/flux-2-dev`（完整 Dev 版本，1-50 步，默认 25）
- `width`：图像宽度（可选，默认 1024，范围 256-2048，建议为 32 的倍数）
- `height`：图像高度（可选，默认 1024，范围 256-2048，建议为 32 的倍数）
- `steps`：生成步数（可选）。klein 系列支持 1-8，flux-2-dev 支持 1-50；缺省时由 Worker 按所选模型自动补默认值
## API说明
Worker部署后将提供文生图API，可通过以下方式调用：
```
POST https://your-worker-url.workers.dev
Headers:
Content-Type: application/json
Authorization: Bearer Hsue8p20snchw734ambncMD
Body:
{
"prompt": "您想生成的图像描述",
"model": "@cf/black-forest-labs/flux-2-klein-4b",
"width": 1024,
"height": 1024,
"steps": 4
}
```
可用的 FLUX.2 模型及推荐步数范围：
- `@cf/black-forest-labs/flux-2-klein-4b`：蒸馏轻量版，速度最快，步数 1-8（默认 4）
- `@cf/black-forest-labs/flux-2-klein-9b`：蒸馏均衡版，质量与速度兼顾，步数 1-8（默认 4）
- `@cf/black-forest-labs/flux-2-dev`：完整 Dev 版本，质量最高，步数 1-50（默认 25）
`model`、`width`、`height`、`steps` 均为可选参数；省略时由 Worker 使用上述默认值。三个 FLUX.2 模型均运行在 Cloudflare Workers AI，并共用同一份每日 10,000 Neurons 的免费额度。
## 多语言支持
本应用WebUI界面支持以下语言：
- 英文 (English)
- 简体中文
- 繁体中文
- 俄语 (Русский)
- 阿拉伯语 (العربية)
- 法语 (Français)
- 德语 (Deutsch)
- 西班牙语 (Español)
语言会自动根据浏览器设置检测，也可以通过界面右上角的语言选择器手动切换。
## 故障排除
### WebUI相关
- **部署失败**: 确保您登录了正确的Cloudflare账户，并拥有部署Worker的权限
- **不显示Worker URL**: 部署成功后，URL会在命令行中显示；您也可以在Cloudflare仪表板的Workers页面找到URL
- **WebUI无法启动**: 检查是否已安装Node.js，并尝试重新安装依赖（`cd weiui && npm install`）
- **URL保存后不生效**: 尝试重置配置并重新输入URL，确保点击"保存并继续"按钮
### Cursor集成相关
- **找不到Worker URL**: 确保`worker_url.txt`文件存在并包含正确的URL
- **MCP连接失败**: 检查Cursor设置中的命令路径是否正确，现在应使用`simple-server-final.js`
- **图像生成失败**: 确保提示词不包含特殊字符，步数在所选模型的有效范围内（klein 系列 1-8，flux-2-dev 1-50）
- **中文提示词处理**: 系统现已内置简单的中英文转换能力，但复杂的中文可能需要您手动输入英文提示词
## 获取帮助
如需更多帮助，请参考`获取Worker URL指南.md`文档，或访问[Cloudflare Workers文档](https://developers.cloudflare.com/workers/)。
## 特别感谢
感谢Cloudflare提供AI服务，让大家能够体验文生图的魅力。
MCP 市场