www
1.7 KiB
Executable File
1.7 KiB
Executable File
15_任务队列_错误重试_稳定性设计
1. 队列列表
novel_queue
parse_queue
story_queue
character_queue
episode_queue
script_queue
storyboard_queue
image_queue
audio_queue
subtitle_queue
video_queue
qc_queue
review_queue
analytics_queue
2. 任务状态
pending
running
success
failed
retrying
cancelled
manual_required
skipped
3. 幂等设计
幂等 key：
project_id + episode_id + shot_id + task_type + input_hash
重复提交时：
已有成功结果 → 返回结果
任务运行中 → 返回任务状态
失败可重试 → 按规则重试
4. 重试规则
文本任务：2 次
图片任务：3 次
视频合成：2 次
TTS：2 次
质检：1 次
连续失败进入：
manual_required
5. 失败处理
失败必须记录：
错误码
错误信息
输入参数
Provider 响应
重试次数
是否扣额度
是否可恢复
6. 队列隔离
图片生成和视频合成不能共用队列，避免视频任务堵塞所有任务。
7. 并发限制
每用户同时 1-2 个正式项目
每项目图片并发 3-5
每 Provider 独立限流
视频合成单独限流
8. 服务器重启恢复
系统启动后扫描：
running 超时任务
retrying 超时任务
video_rendering 中断任务
处理：
重新入队
标记失败
转人工
9. 成本安全
系统错误导致的重试不重复扣用户额度。
用户主动重生、主动大改，需要扣额度或重新计费。
10. 队列监控
后台显示：
等待任务数
运行任务数
失败任务数
平均耗时
Provider 错误率
队列积压