# 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 错误率
队列积压
```