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