| name | space-video-broll |
| description | 动效导演 + B-roll 生成器。从一段文字/脚本/视频，一次性产出 30 秒以上的动效 B-roll 视频（HTML→确定性 MP4）。不做 PPT 式翻页，从「视觉隐喻 + 运动」出发；内置多种设计风格（暗色 SaaS 魔术、黑白打字机、暖色编辑、极简白、蓝图网格）；产出一律不用 emoji，用排版/几何/SVG 线性图标。当用户说「做 B-roll」「做个动效视频」「motion 开场」「文字动画」「概念动画」「HTML 转视频」「这段配个画面」「30秒 broll」时触发。 |
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 驱动、相同输入相同输出
