核心用法
Motion Video Maker 是一套基于 Node.js 的讲解动画视频生成系统，采用「movie.json 为中心」的可编辑工作流。用户输入文案或 Markdown 后，系统将其拆分为 4-8 个讲述节拍（scene），每个 scene 映射为包含 narration、durationMs、elements 的结构化配置。通过 sync_timings.js 自动根据解说文本推导动画节奏，生成 preview.html 进行 Web 预览，经自然语言迭代调整后，在用户显式确认后方可导出 MP4。
核心命令链路：初始化项目 → 同步 timing → 生成预览 → 自然语言编辑 → （可选）TTS 配置与合成 → 确认导出。关键脚本包括 build_project.js（一键校验、同步、预览）、export_video.js（浏览器逐帧截图 + ffmpeg 合成）。
显著优点
1. 可维护性优先：以 movie.json 为唯一事实来源，拒绝「一次性 HTML」模式，支持后续改文案、调节奏、换模板而不必重做。
2. 智能节奏同步： narration 驱动的 timing 推导，自动匹配朗读时长与动画缓冲，避免凭感觉分配时间。
3. 严格确认机制：模板选择、音色确认、视频导出均需用户明确授权，降低误操作与预期落差风险。
4. 跨平台 TTS 兜底：本机 system fallback 同时兼容 macOS (say) 与 Windows (PowerShell TTS)，无云端密钥时仍可工作流运转。
5. 模块化架构：模板（风格）、theme（配色）、TTS provider 解耦配置，支持渐进式细化而非一次性堆砌选项。
潜在缺点与局限性
1. 依赖外部二进制：需自行安装 Node.js、ffmpeg，首次导出前需下载 Chromium（Playwright），冷启动成本较高。
2. MVP 阶段功能边界：当前重点支持无音轨讲解动画，旁白、BGM、字幕烧录等需后续扩展；部分 TTS provider 可能未完全适配。
3. 1280×720 固定画布：预览与导出分辨率锁定，暂不支持竖版或 4K 等自定义尺寸。
4. 人工介入节点密集：严格的确认流程虽降低风险，但也增加了交互轮次，对追求「一键成片」的用户可能显得繁琐。
5. 动画复杂度天花板：定位为「讲解动画」而非「全功能 AE 替代」，复杂 kinetic typography 或粒子效果需手动突破模板限制。
适合人群
- 知识博主、产品运营：需批量生产结构化口播配套动画，且要求后续可修改文案复用。
- 企业内部培训：需将 SOP、产品更新转为步骤演示视频，强调品牌配色一致与迭代效率。
- 技术内容创作者：偏好 JSON/代码级控制，愿意用结构化编辑换取版本管理与协作能力。
- 不适合：追求「输入文案即出片」零配置体验的用户，或需要复杂 3D/粒子特效的专业视频制作。
常规风险
- 导出意外：虽有
--confirm-export强制确认，但用户若在 CI/CD 中脚本化调用可能绕过人工检查，导致非预期资源消耗。 - TTS 成本与合规：云端 TTS（MiniMax、Azure 等）需用户自备 API key，存在密钥泄露、用量超额及语音合成内容合规风险。
- ffmpeg/浏览器版本差异：不同平台 ffmpeg 编译选项或 Playwright Chromium 版本可能导致导出帧率、色彩空间不一致。
- JSON 结构漂移：手动编辑
movie.json时若绕过validate_movie.js，可能生成预览正常但导出失败的边缘 case。