www
3.4 KiB
3.4 KiB
AGENTS.md
项目说明
本项目是 AI 漫剧 / AI 写真视频生成平台，包含两套业务系统：
- 系统 A：原创小说 / 上传小说 -> 韩漫 / 漫剧生成系统
- 系统 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，后续再接真实模型
强制开发规则
- 不允许一次性开发完整系统。
- 每次只完成一个明确阶段。
- 每个阶段完成后必须等待人工审核。
- 不允许擅自修改 docs 目录。
- 不允许把真实 API Key 写进代码。
- 所有密钥必须放在 .env。
- 所有 AI Provider 必须先实现 mock。
- 不允许把 OpenAI 或任何模型写死在业务逻辑里。
- 图片、视频、TTS、文本、审核都必须走 Provider 抽象层。
- 所有生成任务必须进入任务队列。
- 所有任务必须有状态、重试次数、错误信息、成本记录。
- 所有用户上传小说和素材默认私有。
- 上传小说必须有版权确认记录。
- 公开案例必须有单独授权记录。
- 角色一致性、剧情记忆、分镜确认、任务恢复是系统 A 的核心，不允许省略。
- 每个阶段必须更新 CODEX_PROGRESS.md。
- 每个阶段必须说明：完成了什么、改了哪些文件、如何测试、下一步是什么。
- 如果发现文档冲突，先停下来汇报，不要擅自决定。
- 开发前先查看 Git 状态。
- 开发后运行 lint/typecheck/test，失败必须说明原因。
MVP 完成标准
系统 A MVP 必须实现：
- 用户注册登录。
- 创建小说漫剧项目。
- AI 原创小说 mock 流程。
- 上传小说解析流程。
- 版权确认流程。
- 故事圣经。
- 角色圣经。
- 角色锚点图 mock。
- 分集计划。
- 单集脚本。
- 分镜脚本。
- AI Provider mock。
- BullMQ 任务队列。
- 图片生成 mock。
- TTS / 字幕 mock。
- FFmpeg 视频合成。
- 后台项目管理。
- 后台任务管理。
- 用户端查看进度和下载成品。
- 任务失败可重试。
最终目标
完整落地目标是：
AI 原创小说 -> 生成 3 集基础漫剧 MP4 上传小说 -> 生成 1-3 集基础漫剧 MP4 后台可查看项目、角色、分镜、任务、成本、审核 任务失败可恢复 系统后续可扩展到 20-100 集长篇连载