feat: 添加图像编辑工具

- 基于火山云SeedEdit 3.0 API的智能图像编辑工具
- 支持单张图片编辑和批量处理功能
- 提供丰富的预设提示词和参数配置
- 实现任务管理和进度监控
- 集成到便捷工具系统

功能特性:
- 单张图片编辑:选择图片、输入提示词、实时编辑
- 批量处理:文件夹批量处理、进度监控、结果统计
- 参数配置:引导强度、随机种子、水印设置等
- 预设提示词:风格转换、场景变换、色彩调整、特效处理
- 任务管理:状态监控、历史记录、清理功能

技术实现:
- Rust后端:图像编辑服务、API调用、错误处理
- React前端:响应式界面、实时更新、用户体验优化
- 类型安全:完整的TypeScript类型定义
- 模块化设计:可扩展的架构和组件复用
This commit is contained in:
2025-07-31 15:28:29 +08:00
parent ff5cccfb05
commit 05d9709420
12 changed files with 2428 additions and 2 deletions

View File

@@ -0,0 +1,170 @@
# 图像编辑工具使用指南
## 功能概述
图像编辑工具是基于火山云SeedEdit 3.0 API开发的智能图像编辑工具支持通过自然语言提示词对图像进行编辑和变换。
## 主要功能
### 1. 单张图片编辑
- 选择输入图片(支持 JPG、JPEG、PNG 格式)
- 输入编辑提示词
- 设置输出路径
- 配置编辑参数
- 实时查看编辑结果
### 2. 批量图片处理
- 选择包含图片的输入文件夹
- 选择输出文件夹
- 输入统一的编辑提示词
- 批量处理多张图片
- 实时监控处理进度
### 3. 参数配置
- **引导强度 (Guidance Scale)**: 控制提示词对生成结果的影响程度 (1.0-10.0)
- **随机种子 (Seed)**: 控制生成结果的随机性,相同种子产生相同结果
- **水印设置**: 是否在生成图片上添加"AI生成"水印
- **响应格式**: URL链接或Base64编码
- **尺寸设置**: 自适应尺寸
## 使用步骤
### 配置API密钥
1. 点击页面右上角的"配置"按钮
2. 输入火山云API密钥
3. 点击"保存配置"
### 单张图片编辑
1. 切换到"单张编辑"标签页
2. 点击"选择图片"按钮,选择要编辑的图片
3. 点击"选择路径"按钮,设置输出路径
4. 在提示词输入框中输入编辑指令,例如:
- "改成爱心形状的泡泡"
- "转换为水彩画风格"
- "改为春天的樱花背景"
5. 根据需要调整右侧的参数配置
6. 点击"开始编辑"按钮
7. 等待处理完成,查看结果
### 批量图片处理
1. 切换到"批量处理"标签页
2. 点击"选择输入文件夹",选择包含图片的文件夹
3. 点击"选择输出文件夹",设置处理结果的保存位置
4. 输入批量编辑的提示词
5. 调整参数配置
6. 点击"开始批量处理"
7. 实时查看处理进度和结果统计
## 预设提示词
工具提供了多种分类的预设提示词,方便快速使用:
### 风格转换
- 转换为水彩画风格
- 转换为油画风格
- 转换为卡通动漫风格
- 转换为素描风格
- 转换为复古胶片风格
### 场景变换
- 改为春天的樱花背景
- 改为夏日海滩背景
- 改为秋天的枫叶背景
- 改为冬日雪景背景
- 改为城市夜景背景
### 色彩调整
- 增强色彩饱和度
- 转换为黑白照片
- 增加暖色调
- 增加冷色调
- 提高亮度和对比度
### 特效处理
- 添加光晕效果
- 添加雨滴效果
- 添加阳光透射效果
- 添加星空效果
- 添加梦幻光斑效果
## 任务管理
### 查看任务状态
1. 点击"任务管理"按钮
2. 查看所有单个任务和批量任务的状态
3. 监控任务进度和结果
### 任务状态说明
- **等待中**: 任务已创建,等待处理
- **处理中**: 任务正在执行
- **已完成**: 任务成功完成
- **失败**: 任务执行失败
- **已取消**: 任务被用户取消
### 任务操作
- **刷新**: 更新任务列表状态
- **清理已完成**: 删除已完成和失败的任务记录
## 技术规格
### 支持的图片格式
- JPEG (.jpg, .jpeg)
- PNG (.png)
### 图片要求
- 宽高比: 1/3 到 3 之间
- 最小尺寸: 宽高均大于14像素
- 最大文件大小: 10MB
### API配置
- API地址: https://ark.cn-beijing.volces.com/api/v3/images/generations
- 模型ID: doubao-seededit-3-0-i2i-250628
- 超时时间: 120秒
- 最大重试次数: 3次
## 注意事项
1. **API密钥安全**: 请妥善保管您的火山云API密钥不要泄露给他人
2. **网络连接**: 确保网络连接稳定,图像编辑需要上传和下载数据
3. **文件路径**: 确保输出路径有写入权限
4. **批量处理**: 批量处理大量图片时请耐心等待,避免中途关闭应用
5. **费用控制**: 图像编辑会消耗API调用次数请注意控制使用量
## 故障排除
### 常见问题
**Q: 提示"API密钥未设置"**
A: 请先在配置页面设置有效的火山云API密钥
**Q: 图片编辑失败**
A: 检查图片格式是否支持,文件大小是否超限,网络连接是否正常
**Q: 批量处理中断**
A: 检查输入文件夹是否包含有效图片,输出文件夹是否有写入权限
**Q: 处理速度慢**
A: 图像编辑需要AI模型处理请耐心等待。可以尝试降低图片分辨率或减少批量数量
### 错误代码说明
- 网络错误: 检查网络连接
- 认证失败: 检查API密钥是否正确
- 参数错误: 检查输入参数是否符合要求
- 服务器错误: 稍后重试或联系技术支持
## 更新日志
### v1.0.0 (2024-01-31)
- 初始版本发布
- 支持单张图片编辑
- 支持批量图片处理
- 提供预设提示词
- 实现任务管理功能
- 集成火山云SeedEdit 3.0 API
## 技术支持
如遇到问题或需要技术支持,请联系开发团队或查看项目文档。