---
name: img-mage
slug: img-mage
displayName: Img Mage - 图片法师
description: 百度AI驱动的全能图片处理工具。支持AI修图（去背景、增强、去雾、上色）、基础编辑（裁剪、缩放、旋转）、图片合成（叠加、文字水印、拼接）、格式转换与批量处理。当用户需要修图、p图、图片处理、编辑图片、去背景、图片增强、压缩图片、加水印、批量处理图片时使用。
version: 1.0.0
---

# Img Mage - 百度AI图片处理专家

一个集成百度AI图像处理能力的全能图片编辑 Agent。覆盖从基础编辑到AI增强的完整图片处理需求。

## 使用流程

### 第一步：识别用户意图

根据用户输入判断需要哪种处理类型：

| 触发词 | 对应功能 |
|--------|---------|
| "去背景"、"抠图"、"去底"、"换背景" | AI 背景去除 |
| "增强"、"清晰"、"去雾"、"去噪" | AI 图像增强 |
| "上色"、"着色"、"彩色化" | AI 黑白图像上色 |
| "去模糊"、"清晰化"、"修复" | AI 图像去模糊 |
| "裁剪"、"裁切"、"crop" | 基础裁剪 |
| "缩放"、"resize"、"改尺寸"、"改大小" | 尺寸调整 |
| "旋转"、"翻转"、"转90度" | 旋转/翻转 |
| "水印"、"打水印"、"加水印" | 文字/图片水印 |
| "合成"、"叠加"、"合并"、"拼接" | 图片合成 |
| "转换"、"转格式"、"jpg转png" | 格式转换 |
| "压缩"、"减小"、"优化大小" | 图片压缩 |
| "批量"、"多张"、"多个文件" | 批量处理 |

### 第二步：收集参数

根据功能类型，收集必要参数：

#### AI 功能（调用百度 API）
- **去背景**: 输入图片路径，选择返回类型（透明底/白底/原图背景）
- **图像增强**: 输入图片路径
- **去模糊**: 输入图片路径
- **上色**: 输入图片路径（黑白图片）
- **风格转换**: 输入图片路径，选择风格

#### 基础编辑（本地处理）
- **裁剪**: 输入路径、裁剪区域 (x, y, width, height)
- **缩放**: 输入路径、目标尺寸或比例
- **旋转**: 输入路径、角度、是否自动裁剪
- **翻转**: 输入路径、方向（水平/垂直）

#### 合成操作
- **水印**: 原图路径、水印内容（文字或图片）、位置、透明度
- **叠加**: 底图路径、上层图片路径、位置、透明度模式
- **拼接**: 多张图片路径、方向（水平/垂直）、间距

#### 格式与批量
- **格式转换**: 输入路径、目标格式、质量参数
- **压缩**: 输入路径、目标大小或质量百分比
- **批量处理**: 批量文件夹、处理规则

### 第三步：执行处理

根据功能类型调用对应脚本：

```python
# AI 功能示例（去背景）
python3 scripts/img_mage_api.py --action remove-bg --input photo.jpg --output result.png

# 基础编辑示例（缩放）
python3 scripts/img_mage_utils.py --action resize --input photo.jpg --output resized.jpg --width 800

# 格式转换示例
python3 scripts/img_mage_utils.py --action convert --input photo.jpg --output photo.webp --quality 90

# 批量处理示例
python3 scripts/img_mage_utils.py --action batch --input ./images/ --output ./output/ --task resize --width 800 --height 600
```

### 第四步：返回结果

处理完成后，返回处理后的图片路径和简要说明处理效果。

## 支持的图片格式

- **输入**: JPG、JPEG、PNG、BMP、WebP、TIFF、AVIF
- **输出**: JPG、PNG、WebP、BMP、TIFF、AVIF

## Baidu AI API 配置

使用前需要在环境变量中配置百度 AI 的认证信息：

```
export BAIDU_APP_ID="your_app_id"
export BAIDU_API_KEY="your_api_key"
export BAIDU_SECRET_KEY="your_secret_key"
```

或传入脚本参数：
```bash
python3 scripts/img_mage_api.py ... --app-id xxx --api-key xxx --secret-key xxx
```

## 注意事项

1. **API 限额**: 百度 AI 图片处理 API 有免费调用额度，超出需付费
2. **图片大小**: 建议单张图片不超过 10MB，过大可能超时
3. **支持网络图片**: 可直接传入 URL 进行处理，无需先下载
4. **批量处理建议**: 批量处理大量图片时，建议先做小规模测试
5. **输出覆盖**: 输出路径已存在文件会被覆盖，建议使用不同的输出文件名

---

*Generated by Skill Craftsmen | Powered by Baidu AI*