chuanyue98 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 驱动、相同输入相同输出