Initial AI manga platform

AGENTS.md

@@ -0,0 +1,100 @@
+# AGENTS.md
+
+## 项目说明
+
+本项目是 AI 漫剧 / AI 写真视频生成平台，包含两套业务系统：
+
+1. 系统 A：原创小说 / 上传小说 -> 韩漫 / 漫剧生成系统
+2. 系统 B：真人照片 -> 多人生主题写真 / 婚礼 / 纪念视频生成系统
+
+当前优先开发系统 A。
+
+## 当前开发基线
+
+系统 A 开发基线：
+
+- docs/system_a/00_上下文难点清单_已接入设计.md
+- docs/system_a/01_系统A总需求文档_v2_生产级基线.md
+- docs/system_a/02_业务流程_状态流转_权限设计.md
+- docs/system_a/03_功能清单_页面清单.md
+- docs/system_a/04_技术架构设计_模块拆分.md
+- docs/system_a/05_数据库表结构设计.md
+- docs/system_a/06_API接口设计文档.md
+- docs/system_a/09_AI生成流水线_Provider抽象设计.md
+- docs/system_a/11_角色一致性专项设计.md
+- docs/system_a/12_长篇连载记忆_剧情一致性专项设计.md
+- docs/system_a/14_分镜镜头_视频合成_特效设计.md
+- docs/system_a/15_任务队列_错误重试_稳定性设计.md
+- docs/system_a/20_测试用例_验收标准.md
+- docs/system_a/21_Codex开发任务拆解文档.md
+
+系统 B 暂时只做架构预留，不先开发完整业务。
+
+## 技术栈约定
+
+- 后端：Node.js + NestJS
+- 数据库：MySQL 8
+- 队列：Redis + BullMQ
+- 对象存储：MinIO
+- 用户端：uni-app
+- 后台端：Geeker-Admin
+- 视频合成：FFmpeg
+- AI Provider：必须抽象，先 mock，后续再接真实模型
+
+## 强制开发规则
+
+1. 不允许一次性开发完整系统。
+2. 每次只完成一个明确阶段。
+3. 每个阶段完成后必须等待人工审核。
+4. 不允许擅自修改 docs 目录。
+5. 不允许把真实 API Key 写进代码。
+6. 所有密钥必须放在 .env。
+7. 所有 AI Provider 必须先实现 mock。
+8. 不允许把 OpenAI 或任何模型写死在业务逻辑里。
+9. 图片、视频、TTS、文本、审核都必须走 Provider 抽象层。
+10. 所有生成任务必须进入任务队列。
+11. 所有任务必须有状态、重试次数、错误信息、成本记录。
+12. 所有用户上传小说和素材默认私有。
+13. 上传小说必须有版权确认记录。
+14. 公开案例必须有单独授权记录。
+15. 角色一致性、剧情记忆、分镜确认、任务恢复是系统 A 的核心，不允许省略。
+16. 每个阶段必须更新 CODEX_PROGRESS.md。
+17. 每个阶段必须说明：完成了什么、改了哪些文件、如何测试、下一步是什么。
+18. 如果发现文档冲突，先停下来汇报，不要擅自决定。
+19. 开发前先查看 Git 状态。
+20. 开发后运行 lint/typecheck/test，失败必须说明原因。
+
+## MVP 完成标准
+
+系统 A MVP 必须实现：
+
+1. 用户注册登录。
+2. 创建小说漫剧项目。
+3. AI 原创小说 mock 流程。
+4. 上传小说解析流程。
+5. 版权确认流程。
+6. 故事圣经。
+7. 角色圣经。
+8. 角色锚点图 mock。
+9. 分集计划。
+10. 单集脚本。
+11. 分镜脚本。
+12. AI Provider mock。
+13. BullMQ 任务队列。
+14. 图片生成 mock。
+15. TTS / 字幕 mock。
+16. FFmpeg 视频合成。
+17. 后台项目管理。
+18. 后台任务管理。
+19. 用户端查看进度和下载成品。
+20. 任务失败可重试。
+
+## 最终目标
+
+完整落地目标是：
+
+AI 原创小说 -> 生成 3 集基础漫剧 MP4
+上传小说 -> 生成 1-3 集基础漫剧 MP4
+后台可查看项目、角色、分镜、任务、成本、审核
+任务失败可恢复
+系统后续可扩展到 20-100 集长篇连载