System goal
为什么要单独做生成引擎 V2
第一层：后端要先稳定，接口、静态资源、草稿导出和健康检查都得能跑。
第二层：前端不能只做参数面板，还要把工作流、资源和预览收起来。
第三层：草稿模板、工作流配置和生成素材要有可复用的文件组织方式。
第四层：输出不能只是一张图或一段视频，而要能回到剪映草稿和后续上架流程。
流程图
生成引擎 V2 流程图
把 V1 的脚本能力变成页面工作台和批量制作链路。
01｜输入Input
项目字段 / 模板 / 素材配置
↓
02｜工作台Process
Vue 页面 / FastAPI / 工作流配置
↓
03｜合成Process
资源目录 / 草稿模板 / 时间轴
↓
04｜输出Output
草稿 ZIP / 预览视频 / 线上演示入口
流程快照
生成引擎 V2做什么
我的职责
我负责把草稿助手做成工作台
把生成、草稿、资源和时间轴合成串成一条能跑的工程链，而不是单个脚本。
解决问题
解决的是工程闭环
同一套输入能进模板、进资源目录、进草稿、进视频合成，也能进后台和前端工作台。
关键词
关键词直接说出来
FastAPI、Vue 3 + Vite、管理后台、模板化草稿、工作流配置、资源管理、时间轴合成。
Repository facts
仓库里已经有这些硬东西
backend
FastAPI 主入口、路由、编排器、生成服务、静态文件挂载。
frontend
Vue 3 + Vite 的工作台页面、路由、状态和编辑视图。
video-platform-admin
管理后台入口，说明这不是单点工具，而是有管理层的系统。
workflows / templates
`workflows.json`、`template_configs.json`、`templates/jianying_template`。
Core flow
核心流程不是“生成很多东西”，而是“只填一次，后面自动串起来”
生成引擎 V2把输入、模板、素材、草稿、时间轴和导出放在同一条链路里，用户看到的是工作台，底层跑的是一套可复用的生成闭环。
流程重点
字段一次录入
模板和工作流自动选配
素材、草稿、视频一起出
结果可回到后台和导出目录
01
基础字段
文本、项目名、模式、用户草稿路径和配置先统一进来。
02
工作流与模板
`workflows.json`、`template_configs.json` 和草稿模板一起选配。
03
素材生成
图片、音频、视频、封面和中间资源按目录分类落盘。
04
草稿输出
生成 `Drafts`、`generated_drafts` 和可下载的 ZIP 包。
05
时间轴合成
`/api/v1/timeline/compose-video` 把分镜合成最终 mp4。
Module breakdown
模块拆解要讲成一张系统图
这一版最能打的不是某个页面，而是模块之间的关系：接口、前端、管理后台、模板、资源、草稿和视频合成全部能互相呼应。
证据路径
backend/app/main.py
backend/app/routes.py
backend/app/core/orchestrator.py
frontend/src/*
video-platform-admin
后端入口
`main.py` 挂载静态资源、注册路由和健康检查。
路由层
`routes.py` 负责生成、草稿、时间轴合成、测试服务器。
编排器
`orchestrator.py` 串起文本、图片、音频、草稿和 ZIP。
前端工作台
`frontend/src` 里有编辑器、配置、时间轴和路由结构。
资源目录
`generated_images`、`generated_audio`、`generated_videos`、`generated_drafts`。
模板与配置
`templates/jianying_template`、`workflows.json`、`template_configs.json`。
技术栈
生成引擎 V2完整技术栈
后端
FastAPI、Uvicorn、Pydantic Settings、python-multipart。
前端
Vue 3、Vite、TypeScript、Pinia、Axios、Naive UI。
媒体处理
MoviePy、Pillow、OpenCV、ImageIO、Pydub、SoundFile、NumPy。
闭环能力
草稿导出、资源管理、时间轴合成、浏览器插件和后台管理。
证据区
证据区要让人看见这套系统真的能跑
这里放视频、图片和关键路径，不是为了装饰，而是为了让人一眼确认：生成引擎 V2不是概念图，而是有实际文件、实际目录和实际输出的工程仓库。
关键引用
POST /api/v1/generate/full
POST /api/v1/timeline/compose-video
GET /api/v1/timeline/download/{filename}
POST /api/v1/test-servers
仓库来源
仓库来源：E:\xinde\jianyingqhqh - 副本 (6)
证据清单
backend / frontend / video-platform-admin
generated_images / generated_audio / generated_videos / generated_drafts
templates/jianying_template / workflows.json / template_configs.json
Takeaway
生成引擎 V2的价值不在单个输出，而在把输入、生成、草稿、合成和管理串成一套能反复复用的工程闭环。