remotion-组件构建器
执行者。读取所有其他输出,写入 TSX。
触发器
remotion-orchestrator计划的第四波。- 用户请求“为 {topic} 构建一个组件”,且品牌和故事板信息已知。
输入
全部来自同一任务中先前技能的输出:
BrandConfig(来自src/brands/{slug}.ts)—— 运行时与行为:语音、画外音、动效、受众、渠道、禁用词{slug}.design.md(通过src/brands/loadDesign.ts中的loadDesign(slug)加载)—— 视觉令牌:颜色、排版、间距、组件、布局、高度感- 故事板 JSON(来自
remotion-screen-storyteller) - 布局规范(来自
remotion-designer)—— 通过名称引用 design.md 中的令牌 - 动效块(
BrandConfig的一部分) - 渠道规范/宽高比(来自
remotion-marketing-strategist)
详见 src/brands/CONTRACT.md,了解 BrandConfig 和 design.md 之间的完整所有权边界。
方法
- 定位组件 ——
src/compositions/{Name}.tsx是否存在?- 如果存在 → 原地打补丁(保留现有 API)。
- 如果不存在 → 使用
Explainer.tsx作为模板创建新文件。
- 编写导入 ——
import { brands } from '../brands'用于运行时,import { loadDesign, colour, spacing, componentRecipe, typography } from '../design'用于视觉令牌,以及来自../motion的动效辅助函数。 - 定义 Schema —— 为匹配故事板形状的属性创建
z.object。 - 组合场景 —— 每个故事板场景对应一个
<Sequence>。每个场景组件读取cfg = brands[props.brand](用于动效/语音/画外音)和tokens = loadDesign(props.brand)(用于颜色/排版/间距/组件配方),然后进行组合。使用componentRecipe(tokens, 'cta-primary')获取一个完全解析的、CSS 就绪的对象,而不是内联十六进制颜色值。 - 音频 —— 如果场景设置了路径,则为每个场景添加
<Audio src={staticFile(scene.voiceoverAudioPath)} />。 - 在 Root 中注册 —— 在
src/Root.tsx中添加或更新<Composition id="{Name}" ... />。durationInFrames = sum(scene.durationSec) * fps。 - 文件整洁 —— 组件文件不超过 500 行。如果超过此限制,将场景提取到
src/compositions/{Name}/scenes/*.tsx。 - 类型检查 —— 运行
npx tsc --noEmit。如果报错,修复并重试一次。
输出
编辑后的文件:
src/compositions/{Name}.tsx(或场景子文件)src/Root.tsx(注册条目)
给 remotion-orchestrator 的状态报告:
{ "composition": "Explainer", "filesChanged": [...], "tscPassed": true, "ready": true }
边界
- 永远不要内联品牌值(十六进制颜色代码、字体名称、间距字面量)—— 始终从
tokens(视觉)或cfg(运行时)读取。关于哪一方拥有什么,请参阅CONTRACT.md。 - 永远不要在不将故事板场景持续时间总和乘以 fps 的情况下设置
durationInFrames。 - 永远不要对不存在的资源路径使用
staticFile()—— 在构建时大声失败,而不是在渲染时无声失败。 - 永远不要绕过
signatureEntry()来处理入场动效 —— 保持动效语言一致性。 - 永远不要在
BrandConfig.ts和{slug}.design.md之间重复令牌。如果值存在于.design.md中,那么.ts绝不能再次声明它。
复用的模块
src/compositions/Explainer.tsx—— 规范模板src/motion/index.ts——signatureEntry,brandFadeIn,staggerStartsrc/colour/index.ts——readableOn,brandGradient,contrastsrc/design/index.ts——loadDesign,colour,spacing,typography,componentRecipe,resolveTokensrc/brands/loadDesign.ts—— 用于{slug}.design.md的类型化加载器src/brands/CONTRACT.md——BrandConfig↔design.md所有权边界
移交给
remotion-render-pipeline 进行实际渲染。