企业官网建设流程全解析

LumenX Studio 是一个 AI 短漫剧一站式生产平台，其中的"一键合成导出"功能可以让新手不用手动剪辑，就把分镜生成的多段 AI 视频按顺序拼接成一支完整成片，并借助 FFmpeg 自动完成 BGM 混音与 MP4 导出。本文带你走通从装配时间线到最终下载的完整流程。

为什么需要"一键合成"？

在 LumenX 的生产链路中（剧本 → 美术指导 → 资产 → 分镜 → 动态演绎 → 装配 → 配音 → 导出），前几步会为每个分镜生成多个候选视频片段。传统做法需要把这些片段导入专业剪辑软件逐段拼接，而 LumenX 把最后这步封装成了一条流水线：你在界面里"挑片 + 混音 + 点合成"，底层由 FFmpeg 完成所有拼接与编码工作。

装配（Assembly）页面：左侧是装配时间线，右侧是候选片段（Variants）面板，底部显示合成结果与 Download MP4 按钮

第一步：准备好待装配的素材

进入 Studio 主流程后，先完成两个前置步骤：

• 分镜（Storyboard）：基于剧本生成结构化分镜脚本，确定每个镜头的画面描述与对白；
• 动态演绎（Motion）：为每个分镜调用 I2V / R2V 模型批量"抽卡"，一个镜头通常生成 2~4 个候选视频。

动态演绎页面：每个分镜的候选片段以网格展示，右侧可配置模型、时长、分辨率与批量数量

只有当"每个分镜都至少有一个已完成的视频"时，后面的一步合成才有意义——这也是界面顶部会用"11/11 frames ready"这类计数提示你的原因。

第二步：在装配时间线上挑选最佳片段

点击左侧导航进入6. Assembly（装配）页面，界面分为三个标签页：Takes（挑片）/ Mix（混音）/ Export（导出），对应文件 VideoAssembly.tsx。

Takes 阶段的操作很简单：

1. 主区域按分镜顺序列出所有镜头，每行显示当前选中视频的预览、对白文案与时长；
2. 点击某一行，右侧 Variants 面板会列出该镜头的所有候选片段；
3. 逐个播放对比，点击"Select This Variant"即可锁定该镜头的成片版本。

时间线底部实时显示"已就绪 x / 总镜头数"，全部变绿后即可进入下一步。前端选择逻辑见 VideoAssembly.tsx 的 handleSelectVideo，对应的时间线组件为 Timeline.tsx。

💡 小提示：如果某个镜头做过智能配音，系统会优先使用已叠加 TTS 音轨的 dubbed 版本，保证对白与口型同步。

第三步：Mix 阶段配置 BGM 与音量

Mix 阶段负责背景音乐与音轨平衡：

• 从内置 BGM 预设库中选择背景音乐；
• 用滑杆调整对白（dialogue）与背景乐（bgm）的相对音量，默认配置为dialogue: 100 / bgm: 35 / sfx: 60。

这一步是可选的——不配 BGM 也能正常合成，只是成片没有背景音乐。

第四步：一键触发 FFmpeg 合成导出

切到Export 阶段，点击Merge & Proceed按钮，前端会调用后端接口 POST /projects/{script_id}/merge，核心执行逻辑位于 pipeline.py 的 merge_videos 方法。整个过程只需一次点击，完成后页面会展示"Merged Video Ready"预览卡片，点击Download MP4即可保存为{项目名}_{id}.mp4文件。

FFmpeg 在背后做了什么？

虽然用户无感知，但理解原理能帮你排查问题：

完整的 FFmpeg 参数见 pipeline.py 命令构造段，BGM 混音逻辑见 _maybe_apply_bgm_mux。成片保存在本地output/video/目录，并通过/files/videos/路由对外提供预览与下载。

此外还有一个轻量导出接口 POST /projects/{script_id}/export：如果项目已合成过会直接返回成片地址，未合成则自动触发同一条流水线，适合脚本化批量导出场景。

常见问题排查

1. 提示"FFmpeg is required"合成依赖 FFmpeg，但未检测到可用版本。系统会按"内置捆绑版 → 系统 PATH → Windows 常见安装路径"的顺序查找（见 system_check.py 的 get_ffmpeg_path）。按平台安装即可：

# macOS brew install ffmpeg # Ubuntu/Debian sudo apt-get update && sudo apt-get install ffmpeg # Fedora sudo dnf install ffmpeg

安装后重启应用。

2. 合成超时（FFmpeg timed out）重编码设置了 10 分钟超时，通常是片段数量多、分辨率高导致。可尝试降低动态演绎阶段的分辨率（如 720p）或分批合成。

3. 提示"No videos selected to merge"仍有分镜未选择视频。回到 Takes 阶段检查哪些镜头还标着红色"noVideos"，补齐后再合成。

写在最后

LumenX 用"挑片 → 混音 → 一键合成"三步，把过去需要剪辑软件的收尾工作压缩成了一次点击。整条链路从分镜生成到 FFmpeg 拼接全部在平台内闭环，新手也能快速产出可发布的短漫剧成片。想深入探索，可以从以下资料入手：

• 用户手册：USER_MANUAL.md
• 项目总览与架构图：README.md
• 合成核心源码：src/apps/comic_gen/pipeline.py
• 合成接口定义：src/apps/comic_gen/api.py
• 前端装配页面：frontend/src/components/modules/VideoAssembly.tsx