space-video-broll · 动效导演

从一段文字/脚本/视频，产出一条能当视频看、不像 PPT 的动效 B-roll（默认 30 秒以上，一次成片）。

核心信条：从运动出发，不从页面出发

不要从「一页一页卡片」开始。先给内容找一个能动起来的视觉隐喻：

河流 / 网络 / 分支树 / 轨道 / 流水线 / 蜂群 / 坍缩 / 压缩 / 扫描 / 交接 / 增长循环 / 地图路径 / 堆栈 / 波形 / 时钟 / 透镜 / 机器

文字是锚点，不是主角。一个 beat 如果要靠读一大段字才成立，就把它改成运动、结构、符号或图形。

输入：文字 或 视频

• 文字/脚本：直接抽 beats。
• 视频/逐字稿：先读内容（space-video-topic 的逐字稿），抽出讲了哪几件事 → beats。
• 缺参数不追问，除非答案会改变产出路线。默认竖屏 720×896 或按 space-video-edit 配置，默认 30–40 秒。

工作流

1. 运动论点（一句话）

写死这一句再往下：

这条视频靠「<视觉隐喻>」从<起始状态>变成<结束状态>，来证明<核心主张>。

找不到能动的隐喻，就停下来先发明一个，别开始排场景。

2. Beat 图（连续时间轴，不是页）

排一条连续时间轴，每个 beat 写清：

字段	说明
time	起止秒
job	钩子 / 揭示 / 对比 / 机制 / 结果 / 证明 / 收尾
mover	这个 beat 里承载运动的主对象
change	屏幕上物理上发生了什么变化
camera	推/拉/摇/视差/环绕/裁切/稳定
text	标题/标签/计数/字幕/无
asset	代码SVG/生成图/截图/图标/无

3. Anti-PPT 质量门（硬性）

• ≥80% 的 beat 必须有「淡入/滑入」以外的可见状态变化（生长、聚合、坍缩、路径绘制、替换、变形、点亮）。
• 不满足就退回重排——宁可少几个 beat，也不要一堆卡片轮流淡入。
• 主对象在它最显眼的那帧要足够大，不能像远处的小道具。

4. 选风格（见 references/design-styles.md）

内置风格，按内容/平台选一个，或用户指定：

风格	适合	关键词
dark-saas	AI/产品/SaaS 演示	黑色星场、底部紫光、大字动态排版、青→品红 CTA
bw-typewriter	观点/开场/悬念	纯黑白、大字逐字出现、打字节奏
warm-editorial	小红书/生活/自媒体	暖粉底、圆角、红色强调
minimal-light	教程/干货/极简	白底、细线、单一强调色
blueprint-grid	技术/架构/流程	深色网格、节点连线、扫描感

5. 无 Emoji 铁律

产出一律不用 emoji。 需要图标时用：几何形状、数字、SVG 线性图标（自己画 path）、纯文字 chip。emoji 在渲染里字重/对齐不可控，且廉价。

6. 渲染（一次成 30 秒+ 单片）

用自带渲染器把一个多场景 HTML 渲成一条完整 MP4：

node scripts/render.mjs <composition.html> <out.mp4> [fps=30]

• HTML 用 scripts/timeline.js 组织多个场景：每个场景声明 start/dur 和 update(lt, p)，seek(t) 自动分发。
• HTML 暴露 window.DURATION(秒) 和 window.seek(t)（纯函数、不依赖时钟，保证确定性）。
• 30 秒 = 900 帧，渲染放后台跑。示例见 scripts/example-composition.html。

时长预设（参考 rn 系列）

预设	时长	beat 数
sting	8–12s	3–4
standard	30–40s	6–8
extended	50–70s	9–12

默认 standard。

交接

• 上游：space-video-script 的 beats/画面需求，或用户一段文字/一条视频
• 下游：04_broll/<名字>.mp4 → space-video-edit 合成，或直接单发

编排（复用已有能力）

• 有 hyperframes CLI → 走 hyperframes / hyperframes-cli / hyperframes-media
• 已有 Remotion 工程 → 走 remotion-video / remotion-to-hyperframes
• 复杂动画写法 → 走 gsap / animejs / css-animations / waapi / three / lottie
• 参考片复刻 + QC → 见 references/replica-and-qc.md

核心原则

• 运动优先：先找会动的隐喻，再排场景
• Anti-PPT：≥80% beat 有真实状态变化，否则重排
• 无 emoji：SVG 线性图标 / 几何 / 数字 / 文字
• 一次成片：默认 30 秒+ 连续多场景，不是零散小片
• 确定性：seek 驱动、相同输入相同输出