429 lines
8.3 KiB
Markdown
429 lines
8.3 KiB
Markdown
# 🧪 API 配置功能测试指南
|
||
|
||
## 📋 测试前准备
|
||
|
||
### **1. 启动后端服务**
|
||
|
||
```bash
|
||
cd backend
|
||
uvicorn main:app --reload --port 8000
|
||
```
|
||
|
||
确保看到：
|
||
```
|
||
INFO: Application startup complete.
|
||
INFO: Uvicorn running on http://127.0.0.1:8000
|
||
```
|
||
|
||
---
|
||
|
||
### **2. （可选）启动 ComfyUI**
|
||
|
||
如果要测试 ComfyUI 连接：
|
||
|
||
```bash
|
||
# 本地运行
|
||
python comfyui/main.py --listen 0.0.0.0 --port 8188
|
||
|
||
# 或 Docker
|
||
docker-compose up -d comfyui
|
||
```
|
||
|
||
---
|
||
|
||
## 🚀 运行测试
|
||
|
||
### **方法 1: 使用 Python 脚本（推荐）**
|
||
|
||
```bash
|
||
# 在项目根目录运行
|
||
python test_api_config.py
|
||
```
|
||
|
||
**预期输出**：
|
||
```
|
||
============================================================
|
||
ComfyUI API 配置测试
|
||
============================================================
|
||
|
||
============================================================
|
||
测试 1: 列出工作流
|
||
============================================================
|
||
|
||
✅ 成功获取 1 个工作流
|
||
|
||
📄 default_txt2img.json
|
||
节点数: 7, 大小: 1234 bytes
|
||
|
||
...
|
||
|
||
============================================================
|
||
测试总结
|
||
============================================================
|
||
|
||
✅ 通过 - 列出工作流
|
||
✅ 通过 - 获取工作流详情
|
||
✅ 通过 - 上传工作流
|
||
✅ 通过 - 删除工作流
|
||
✅ 通过 - 测试 ComfyUI 连接
|
||
✅ 通过 - 测试云端 API 连接
|
||
|
||
总计: 6/6 通过
|
||
|
||
🎉 所有测试通过！
|
||
```
|
||
|
||
---
|
||
|
||
### **方法 2: 使用 cURL 手动测试**
|
||
|
||
#### **测试 1: 列出工作流**
|
||
|
||
```bash
|
||
curl http://localhost:8000/api/api-config/comfyui/workflows | jq
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
[
|
||
{
|
||
"filename": "default_txt2img.json",
|
||
"name": "default_txt2img",
|
||
"nodes_count": 7,
|
||
"size": 1234
|
||
}
|
||
]
|
||
```
|
||
|
||
---
|
||
|
||
#### **测试 2: 获取工作流详情**
|
||
|
||
```bash
|
||
curl http://localhost:8000/api/api-config/comfyui/workflows/default_txt2img.json | jq
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"3": {
|
||
"inputs": {...},
|
||
"class_type": "KSampler",
|
||
"_meta": {"title": "K采样器"}
|
||
},
|
||
...
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
#### **测试 3: 上传工作流**
|
||
|
||
创建一个测试文件 `test_workflow.json`：
|
||
|
||
```bash
|
||
cat > test_workflow.json << 'EOF'
|
||
{
|
||
"3": {
|
||
"inputs": {
|
||
"seed": 42,
|
||
"steps": 20,
|
||
"cfg": 8,
|
||
"sampler_name": "euler",
|
||
"scheduler": "normal",
|
||
"denoise": 1,
|
||
"model": ["4", 0],
|
||
"positive": ["6", 0],
|
||
"negative": ["7", 0],
|
||
"latent_image": ["5", 0]
|
||
},
|
||
"class_type": "KSampler"
|
||
},
|
||
"4": {
|
||
"inputs": {"ckpt_name": "test.safetensors"},
|
||
"class_type": "CheckpointLoaderSimple"
|
||
},
|
||
"5": {
|
||
"inputs": {"width": 512, "height": 512, "batch_size": 1},
|
||
"class_type": "EmptyLatentImage"
|
||
},
|
||
"6": {
|
||
"inputs": {"text": "test", "clip": ["4", 1]},
|
||
"class_type": "CLIPTextEncode"
|
||
},
|
||
"7": {
|
||
"inputs": {"text": "bad", "clip": ["4", 1]},
|
||
"class_type": "CLIPTextEncode"
|
||
},
|
||
"8": {
|
||
"inputs": {"samples": ["3", 0], "vae": ["4", 2]},
|
||
"class_type": "VAEDecode"
|
||
},
|
||
"9": {
|
||
"inputs": {"images": ["8", 0], "filename_prefix": "Test"},
|
||
"class_type": "SaveImage"
|
||
}
|
||
}
|
||
EOF
|
||
```
|
||
|
||
上传：
|
||
|
||
```bash
|
||
curl -X POST http://localhost:8000/api/api-config/comfyui/workflows/upload \
|
||
-F "file=@test_workflow.json" | jq
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"message": "Workflow uploaded successfully",
|
||
"filename": "test_workflow.json",
|
||
"size": 1234
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
#### **测试 4: 删除工作流**
|
||
|
||
```bash
|
||
curl -X DELETE http://localhost:8000/api/api-config/comfyui/workflows/test_workflow.json | jq
|
||
```
|
||
|
||
**预期响应**：
|
||
```json
|
||
{
|
||
"message": "Workflow 'test_workflow.json' deleted successfully"
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
#### **测试 5: 测试 ComfyUI 连接**
|
||
|
||
```bash
|
||
curl -X POST http://localhost:8000/api/api-config/test-comfyui-connection \
|
||
-H "Content-Type: application/json" \
|
||
-d '{"apiUrl": "http://localhost:8188"}' | jq
|
||
```
|
||
|
||
**如果 ComfyUI 正在运行**：
|
||
```json
|
||
{
|
||
"success": true,
|
||
"message": "连接成功",
|
||
"stats": {
|
||
"vram_total": 25769803776,
|
||
"vram_free": 24696061952,
|
||
"torch_version": "2.1.0+cu121",
|
||
"device": "cuda"
|
||
}
|
||
}
|
||
```
|
||
|
||
**如果 ComfyUI 未运行**：
|
||
```json
|
||
{
|
||
"success": false,
|
||
"message": "无法连接到 ComfyUI，请检查地址和端口"
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
#### **测试 6: 测试云端 API 连接**
|
||
|
||
```bash
|
||
curl -X POST http://localhost:8000/api/api-config/test-cloud-connection \
|
||
-H "Content-Type: application/json" \
|
||
-d '{
|
||
"provider": "dall-e",
|
||
"apiKey": "sk-your-api-key-here",
|
||
"model": "dall-e-3"
|
||
}' | jq
|
||
```
|
||
|
||
**预期响应**（如果 API Key 有效）：
|
||
```json
|
||
{
|
||
"success": true,
|
||
"message": "连接成功，模型 dall-e-3 可用"
|
||
}
|
||
```
|
||
|
||
---
|
||
|
||
## ✅ 测试检查清单
|
||
|
||
### **后端 API**
|
||
- [ ] 列出工作流返回正确的列表
|
||
- [ ] 获取工作流详情返回完整的 JSON
|
||
- [ ] 上传工作流成功保存文件
|
||
- [ ] 上传的工作流可以通过列表看到
|
||
- [ ] 删除工作流成功移除文件
|
||
- [ ] 默认工作流不可删除（返回 403）
|
||
- [ ] ComfyUI 连接测试正确检测状态
|
||
- [ ] 云端 API 连接测试验证 Key
|
||
|
||
### **前端 UI**
|
||
- [ ] 可以切换到"🎨 生图"标签
|
||
- [ ] 模式切换卡片正常显示
|
||
- [ ] 点击"本地 ComfyUI"显示本地配置
|
||
- [ ] 点击"在线 API"显示云端配置
|
||
- [ ] 表单输入正常工作
|
||
- [ ] 工作流管理器显示默认工作流
|
||
- [ ] 可以上传工作流文件
|
||
- [ ] 可以删除工作流（非默认）
|
||
- [ ] 测试连接按钮正常工作
|
||
- [ ] 保存配置功能正常
|
||
|
||
### **响应式设计**
|
||
- [ ] 大屏幕（>768px）双列布局
|
||
- [ ] 小屏幕（<768px）单列布局
|
||
- [ ] 无页面级滚动条
|
||
- [ ] 侧边栏可独立滚动
|
||
- [ ] 无横向滚动
|
||
|
||
---
|
||
|
||
## 🐛 常见问题
|
||
|
||
### **Q1: 测试脚本提示"Connection refused"**
|
||
|
||
**原因**：后端服务未启动
|
||
|
||
**解决**：
|
||
```bash
|
||
cd backend
|
||
uvicorn main:app --reload --port 8000
|
||
```
|
||
|
||
---
|
||
|
||
### **Q2: 上传工作流提示"Invalid ComfyUI workflow"**
|
||
|
||
**原因**：JSON 格式不正确或缺少必要节点
|
||
|
||
**解决**：
|
||
- 确保包含 `KSampler` 节点
|
||
- 使用 ComfyUI 的 "Save (API Format)" 导出
|
||
- 检查 JSON 语法是否正确
|
||
|
||
---
|
||
|
||
### **Q3: 删除工作流提示"Cannot delete default workflow"**
|
||
|
||
**这是正常的**！默认工作流受保护，不可删除。
|
||
|
||
要测试删除功能，请先上传一个自定义工作流，然后删除它。
|
||
|
||
---
|
||
|
||
### **Q4: ComfyUI 连接测试失败**
|
||
|
||
**可能原因**：
|
||
1. ComfyUI 未启动
|
||
2. 地址或端口错误
|
||
3. Docker 网络问题
|
||
|
||
**解决**：
|
||
```bash
|
||
# 检查 ComfyUI 是否运行
|
||
curl http://localhost:8188/system_stats
|
||
|
||
# Docker 环境下
|
||
docker ps | grep comfyui
|
||
docker logs comfyui
|
||
```
|
||
|
||
---
|
||
|
||
## 📊 测试结果解读
|
||
|
||
### **全部通过** ✅
|
||
```
|
||
总计: 6/6 通过
|
||
🎉 所有测试通过！
|
||
```
|
||
→ API 配置功能完全正常，可以开始使用
|
||
|
||
### **部分失败** ⚠️
|
||
```
|
||
总计: 4/6 通过
|
||
⚠️ 2 个测试失败，请检查日志
|
||
```
|
||
→ 查看失败的测试项，根据错误信息排查
|
||
|
||
### **全部失败** ❌
|
||
```
|
||
总计: 0/6 通过
|
||
```
|
||
→ 检查后端服务是否正常运行
|
||
→ 检查端口是否正确（8000）
|
||
→ 查看后端日志
|
||
|
||
---
|
||
|
||
## 🎯 下一步
|
||
|
||
测试通过后，你可以：
|
||
|
||
1. **启动前端**
|
||
```bash
|
||
cd frontend
|
||
npm run dev
|
||
```
|
||
|
||
2. **访问应用**
|
||
- 打开浏览器访问 `http://localhost:5173`
|
||
- 进入 API 配置页面
|
||
- 配置你的生图服务
|
||
|
||
3. **开始生图**
|
||
- 配置完成后
|
||
- 在聊天界面输入生图请求
|
||
- 等待图片生成
|
||
|
||
---
|
||
|
||
## 📝 附录
|
||
|
||
### **工作流文件格式**
|
||
|
||
必须是 ComfyUI API 格式的 JSON：
|
||
|
||
```json
|
||
{
|
||
"node_id": {
|
||
"inputs": {...},
|
||
"class_type": "NodeType",
|
||
"_meta": {"title": "Display Name"}
|
||
}
|
||
}
|
||
```
|
||
|
||
### **必需的节点类型**
|
||
|
||
- `KSampler` - 采样器（必需）
|
||
- `CheckpointLoaderSimple` - 模型加载器
|
||
- `EmptyLatentImage` - 潜变量图像
|
||
- `CLIPTextEncode` - 文本编码器（正向和负向）
|
||
- `VAEDecode` - VAE 解码器
|
||
- `SaveImage` - 保存图像
|
||
|
||
### **API 端点列表**
|
||
|
||
| 方法 | 路径 | 说明 |
|
||
|------|------|------|
|
||
| GET | `/api/api-config/comfyui/workflows` | 列出工作流 |
|
||
| POST | `/api/api-config/comfyui/workflows/upload` | 上传工作流 |
|
||
| DELETE | `/api/api-config/comfyui/workflows/{filename}` | 删除工作流 |
|
||
| GET | `/api/api-config/comfyui/workflows/{filename}` | 获取工作流详情 |
|
||
| POST | `/api/api-config/test-comfyui-connection` | 测试 ComfyUI |
|
||
| POST | `/api/api-config/test-cloud-connection` | 测试云端 API |
|
||
|
||
---
|
||
|
||
**祝测试顺利！** 🎉
|