在批量生成文章和图片的过程中，可能遇到 API 超时、任务中断、图片失败或队列积压。GaaaiPost 提供维护管理和运行日志，用于恢复任务和排查问题。
一、进入维护管理
登录 WordPress 后台，进入：
GaaaiPost → 维护管理
维护页面集中管理：
- 文章任务队列
- 图片任务队列
- AI 生成图片
- 超时任务恢复
- 已有图片批量处理
- 卸载清理设置
二、图片队列暂停与恢复
当图片 API 额度不足、图片服务异常或暂时不需要处理图片时，可以暂停图片队列。
暂停后：
- 文章正文任务仍可继续处理。
- 图片任务会保留在队列中。
- 恢复队列后可继续执行。
三、恢复生成中任务
服务器中断或 PHP 进程异常时，任务可能长时间停留在“生成中”。
插件会根据任务锁超时设置自动恢复，也可以在维护页面手动执行恢复操作。
恢复前建议先确认没有正在运行的生成进程，避免同一个任务被重复处理。
四、清理图片队列
清理图片队列通常会将待处理任务改为跳过状态，并不会直接删除已经存在的媒体库图片。
重新入队时，可以选择：
- 保留已有 AI 图片。
- 保留手动指定图片。
- 只重新匹配缺失或需要处理的图片。
五、删除未关联 AI 图片
维护页面可以检查未关联的 AI 图片。
插件会检测图片是否仍被以下位置使用：
- 文章特色图
- 文章正文
- 系列总目录
- 任务图片 ID
- 系列图片设置
只有确认没有关联的图片，才适合删除。
执行删除前，建议备份 WordPress uploads 目录。
六、批量压缩已有 AI 图片
修改图片压缩参数后，可以对已有 AI 图片重新处理。
建议每次处理较少数量，例如 20 至 50 张，并观察服务器 CPU、内存和磁盘占用。
需要重新从第一张开始处理时，可勾选“从头开始”。
七、进入运行日志
进入：
GaaaiPost → 运行日志
日志记录文章生成、图片处理、Cron 运行和任务异常等信息。
八、按系列筛选日志
当网站中存在多个系列时，可以输入系列 ID，只查看对应系列的日志。
这样可以快速定位某一批文章失败的具体原因。
九、常见错误及处理方法
API 密钥无效
重新检查 API Key，确认没有多余空格，并在服务商后台确认密钥仍处于启用状态。
模型不存在
检查模型名称是否与服务商文档完全一致。
额度不足
为 API 账户充值或更换其他接口。图片队列可先暂停，避免重复请求。
请求超时
进入发布设置，适当增加文章或图片超时时间，同时降低每次 Cron 处理数量。
文章内容过短
检查正文提示词和模型输出限制，必要时在提示词中增加最低字数和内容结构要求。
图片生成成功但没有显示
检查图片任务状态、系列图片设置、特色图开关和正文插图开关，并确认服务器能够下载远程图片。
任务一直处于待生成
检查 WP-Cron 是否启用，或通过手动执行功能测试任务。访问量较低的网站建议配置 Cron URL。
十、日志清理
日志页面支持按保留天数清理历史记录。
例如设置保留 30 天，可以删除更早的运行日志，避免数据库长期积累大量记录。
排查问题期间不要急于清理日志，应在确认问题已经解决后再执行。
十一、卸载清理设置
维护页面可以设置卸载插件时是否删除插件数据表和设置。
如果只是暂时停用插件，建议不要开启卸载清理。
只有确定不再使用插件，并已经备份重要数据时，才建议删除全部插件数据。
十二、日常维护建议
- 定期查看失败任务和运行日志。
- 批量生成前检查 API 余额。
- 不要一次处理过多文章或图片。
- 定期备份数据库和 uploads 目录。
- 正式升级前先在测试环境检查。
- 长期不用的日志和未关联图片可适当清理。
总结
出现任务失败时，应先查看运行日志，再根据错误调整 API、超时、任务数量或图片设置。不要在原因尚未确认时反复批量重试。