# 21_Codex开发任务拆解文档

## 1. Codex 开发规则

```text
每次只完成一个任务
完成后等待人工审核
不得一次性开发整个系统
不得擅自删除 docs
不得把真实 API Key 写入代码
所有 AI Provider 先 mock
所有状态必须写入数据库
所有任务必须支持失败记录
```

---

## 2. 推荐项目结构

```text
ai-manga-system-a/
├── docs/
├── backend/
├── admin/
├── user-app/
├── workers/
├── deploy/
└── README.md
```

---

## 3. 任务 01：读取文档并输出计划

要求：

```text
只读 docs
不写代码
输出开发理解
输出 MVP 范围
输出目录结构
输出疑问
```

---

## 4. 任务 02：初始化项目骨架

```text
创建 monorepo
初始化 backend
初始化 admin
初始化 user-app
创建 workers
创建 deploy
创建 .env.example
```

---

## 5. 任务 03：数据库 schema

按 `05_数据库表结构设计.md` 创建表。

验收：

```text
迁移可执行
索引存在
基础表可写入
```

---

## 6. 任务 04：认证和用户

```text
注册
登录
JWT
用户信息
权限守卫
```

---

## 7. 任务 05：文件上传和资产

```text
MinIO
小说文件上传
图片/视频资产表
私有访问
```

---

## 8. 任务 06：项目创建流程

```text
创建项目
选择输入模式
选择题材
保存目标集数
状态流转
```

---

## 9. 任务 07：上传小说解析

```text
txt/docx/md解析
章节识别
文本清洗
章节保存
```

---

## 10. 任务 08：AI 原创小说 Mock

```text
Mock 故事创意
Mock 大纲
Mock 章节
Mock 自检
```

---

## 11. 任务 09：故事圣经模块

```text
生成
编辑
确认
版本管理
```

---

## 12. 任务 10：角色圣经和锚点图

```text
角色提取
角色编辑
角色图生成任务
锚点图选择
角色锁定
```

---

## 13. 任务 11：长篇记忆模块

```text
plot_memories
plot_threads
character_memories
continuity_checks
```

---

## 14. 任务 12：分集计划

```text
生成分集
编辑分集
确认分集
```

---

## 15. 任务 13：脚本和分镜

```text
生成单集脚本
生成分镜
编辑镜头
Prompt生成
```

---

## 16. 任务 14：BullMQ 队列

```text
任务创建
任务状态
重试
幂等key
失败记录
```

---

## 17. 任务 15：AI Provider 抽象

```text
TextProvider
ImageProvider
VoiceProvider
VideoProvider
ModerationProvider
Mock实现
```

---

## 18. 任务 16：图片生成

```text
角色图
分镜预览图
正式图
质检记录
```

---

## 19. 任务 17：TTS 字幕 FFmpeg

```text
生成旁白
生成SRT
图片转视频
字幕/BGM合成
导出MP4
```

---

## 20. 任务 18：后台管理

```text
项目管理
小说管理
角色管理
分镜管理
任务管理
审核管理
模板管理
成本日志
```

---

## 21. 任务 19：uni-app 用户端

```text
首页
创建项目
AI原创设置
上传小说
版权确认
故事圣经
角色库
分集
分镜
进度
成品
```

---

## 22. 任务 20：订单额度

```text
套餐
订单
额度冻结
额度扣减
成本日志
```

---

## 23. 任务 21：内容审核

```text
版权确认
文本审核
图片审核
视频审核
公开案例授权
```

---

## 24. 任务 22：真实 AI Provider 接入

在所有 mock 流程跑通后再接入真实模型。

---

## 25. 任务 23：MVP 验收

必须完成：

```text
AI原创小说生成3集MP4
上传小说生成1集MP4
后台可重试失败任务
用户可下载成品
```