Vibe MG Video
制作面向普通观众的知识科普、科学解释与概念可视化短片。目标是让画面解释知识，而不是把讲稿排成一组会动的页面。
何时使用
当用户要用程序化动画制作知识短片、科学解释或概念可视化视频时使用。用户只给主题和文字风格，或给主题与参考图片，也足以开始。把自然语言补充要求作为约束；不要强制用户填写技术配置表。
默认决策
- 先根据主题、受众和平台判断内容范围与时长；信息量合适时，可从约 60–120 秒、16:9、1080p、30 fps 起步，再按需要调整。它们是默认值，不是硬性规格。
- 从用户语言推断成片语言；选择适合信息量的叙事和镜头数。优先旁白讲因果、画面表现变化，配准确同步的字幕；如果环境、授权或用户偏好不支持配音，就采用文字叙事并明确交付状态。
- 视觉风格从主题和参考中提炼；颜色、字体、材质、构图、镜头语言均须按项目配置。不要继承示例模板的配色作为默认风格。
- Remotion 适合 React 驱动的二维排版、SVG 和图表动画；若目标主要依赖实拍、复杂三维或其他工具，应选择更合适的实现，必要时混合工作流。
- 对未提供的可逆创作选择自主决定。付费服务、外部账号操作、未明确许可的配乐/图片/字体再分发等，先取得所需授权；没有授权时继续不依赖该素材的工作并说明限制。
制作流程
按依赖关系推进，阶段可迭代，但先有证据与叙事设计，再批量编码：
- 研究与范围：将主题拆成观众真正需要理解的主张。检索并阅读优先级高的原始论文、官方技术资料或权威机构来源；建立“主张—证据—适用范围—不确定性—可用措辞”记录。来源冲突或证据不足时保留不确定性，不编数据、不补造引语。
- 故事与脚本：确定受众、核心问题、最重要的解释和情绪弧线。写自然可讲的旁白，再用试读或实际音频校时；不要把研究摘要逐条念出，也不要靠长停顿凑时长。无配音时写能独立讲清逻辑的屏幕叙事文案。
- 分镜与设计：将每段话转成可观察的画面变化，定义镜头目的、信息层级、动作阶段、景别和出入场接力。视觉参考只提炼设计特征，不复制截图里的 UI、水印或无关内容。
- 实现：先配置风格和唯一时间轴，再实现可复用图形与场景。使用帧确定的动画；为每个镜头安排进入、承载知识的动作、可读停留和离场。用实际渲染逐段校正。
- 音频、字幕与交付：旁白、音乐、音效、屏幕标题和辅助字幕分层管理，基于实际音频时长同步。素材许可和音轨状态要清楚；不可把无声或缺资产版本标成完整有声成片。
- 质检与迭代：运行时间轴、类型和渲染检查；抽取关键帧并亲自查看联系表，正常速度观看完整预览。把问题写成具体修复项，修复后重新渲染并验证交付文件。
遇到对应工作时按需读取：
- 研究/事实：
references/research-and-fact-check.md - 叙事/旁白：
references/story-and-script.md - 分镜/动效：
references/storyboard-and-motion.md - 美术/参考图：
references/visual-design.md - Remotion/模板/时间轴：
references/remotion-engineering.md - 配音/音乐/字幕：
references/audio-post-production.md - 自动与人工审核：
references/quality-review.md - 逆向审计与复用边界：
references/production-lessons.md
工程与内容约束
- 时间轴只有一个权威来源。建议用毫秒描述镜头和字幕时间，在 Remotion 边界按项目 FPS 转帧，并验证总时长、镜头边界、重叠和 cue 范围。
- 用
useCurrentFrame()、useVideoConfig()、interpolate()/spring()等帧驱动 API；禁止墙上时钟、setTimeout、自主 CSS 循环和未设种子的随机动效。 - 共享原语与主题场景分层；避免把几十个主题专属镜头塞入一个巨型条件组件。不要把模板的示例主题、字体和调色板当成成片规范。
- 图形必须说明关系、过程、对比或尺度。转场优先接续有语义联系的形状或运动；避免连续同构图、仅替换标题的卡片轮播、无意义粒子和装饰性数据。
- 区分事实、推论、类比与不确定性。示意图不冒充真实内部结构；统计数字必须同时呈现研究任务和适用范围；不把模型行为归因于未经证明的意图。
- 关键字幕在实际分辨率下可读，不与主体冲突；主叙事字幕和画面标题是不同层级，避免逐句重复堆字。
模板与交付
当使用 Remotion 且项目没有可复用架构时，复制 assets/remotion-template/ 到用户项目或工作目录，再按主题改写数据与组件。模板是可运行起点，不是固定内容或固定视觉风格；不要覆盖用户已有文件。
根据请求交付可编辑工程、文档和实际渲染的视频。至少保留来源/事实记录、脚本、分镜、风格说明、渲染参数和质检结果。测试或渲染只报告实际执行结果；交付前用 FFprobe 检查容器、时长、分辨率、帧率、编码和音轨，并查看真实视频画面。具体审核见 references/quality-review.md。