GaaaiPress 支持批量处理历史文章和媒体文件，包括远程图片本地化、批量设置特色图、AI 特色图生成、历史图片压缩、WebP 转换、正文地址替换和缩略图重建。
为了避免服务器超时，插件采用队列任务方式分批处理，更适合图片数量多、文章数量多的网站。
一、进入批量处理页面
进入 WordPress 后台：
GaaaiPress → 批量处理
在该页面可以执行多种批量任务。
二、支持的批量任务
| 批量任务 | 说明 |
| 批量下载正文远程图片 | 将历史文章中的外链图片下载到本地 |
| 批量设置特色图 | 使用文章正文第一张图设置特色图 |
| 批量生成 AI 特色图 | 为文章批量生成 AI 封面图 |
| 批量压缩历史媒体 | 对媒体库已有图片进行压缩 |
| 批量历史图片转 WebP | 将已有图片转换为 WebP |
| 批量替换正文 WebP 地址 | 将正文旧图片地址替换为 WebP 地址 |
| 批量重建缩略图 | 重新生成 WordPress 缩略图 |
三、什么是队列任务？
队列任务是指插件先将需要处理的数据加入任务队列，然后每次只处理一部分。
这样可以避免：
- 一次性处理太多导致超时
- 服务器内存不足
- 批量任务中断
- 后台页面卡死
- AI 请求过于集中
对于大站来说，队列方式更稳定。
四、设置每轮执行数量
GaaaiPress 支持设置每轮执行条数。
建议：
| 网站情况 | 推荐每轮数量 |
| 普通虚拟主机 | 5-10 |
| 云服务器 | 10-30 |
| 图片非常大 | 3-10 |
| AI 特色图 | 建议少量执行 |
如果服务器配置较低，建议把数量设置小一点。
五、从上次位置继续
批量任务支持从上次处理位置继续。
例如，你有 6000 篇文章，第一次处理到第 500 篇，下次可以继续从后面处理，不需要重新开始。
如果希望重新扫描全部内容，可以选择：
从头开始
六、批量处理推荐顺序
老网站建议按以下顺序处理：
- 备份数据库和 uploads 目录
- 批量下载正文远程图片
- 批量设置特色图
- 批量压缩历史媒体
- 批量历史图片转 WebP
- 批量替换正文 WebP 地址
- 检查前台显示
- 清理已转换原图
- 如有需要，重建缩略图
七、队列状态说明
队列任务通常有以下状态：
| 状态 | 说明 |
| 待处理 | 已加入队列，等待执行 |
| 处理中 | 当前正在执行 |
| 已完成 | 任务执行成功 |
| 失败 | 执行失败，可重试 |
八、失败任务如何处理？
如果任务失败，可以先查看失败原因，再点击：
重试失败任务
常见失败原因包括：
- 图片文件不存在
- 图片格式异常
- 目录不可写
- 远程图片无法访问
- WebP 生成失败
- AI 接口请求失败
- 服务器超时
九、队列卡住怎么办？
如果队列长期处于处理中，可以使用：
重置处理中为待处理
这样可以将卡住的任务重新放回队列等待执行。
如果确认不需要继续处理，也可以清空处理中任务。
十、是否可以关闭页面？
部分队列任务需要后台页面或定时任务触发。建议批量处理时保持后台页面打开，并观察任务执行状态。
如果任务量很大，建议分批处理，不要一次性加入过多任务。
十一、批量处理前注意事项
批量操作前建议：
- 备份数据库
- 备份 uploads 文件夹
- 先测试少量文章
- 避开网站访问高峰
- 每轮数量不要设置过大
- 处理后检查前台图片显示
十二、适合批量处理的场景
- 老网站图片整理
- 外链图片转本地
- 历史媒体压缩
- 全站 WebP 转换
- 文章批量补特色图
- 更换主题后重建缩略图
- 媒体库空间优化
总结
GaaaiPress 批量处理和队列任务功能，适合文章数量多、图片数量多的 WordPress 网站。
通过分批执行、失败重试和队列维护，可以更稳定地完成历史图片优化和内容整理工作。