HyperFrames 制作
实现已批准的剧本。如果没有剧本,请停止并运行 motion-storyboard。
选择渲染器
| 情况 | 渲染器 |
|---|---|
| 新作品默认;具备 HTML/CSS/GSAP 技能;需要注册块 | HyperFrames(npx hyperframes …) |
| 项目已使用 Remotion | 继续使用 Remotion;相同确定性规则适用 |
产品仓库已有自己的工作室(seek(t) + Playwright + FFmpeg) | 使用该工作室;不要引入第二个 |
| 纯剪辑现有素材 | 跳过此技能 → video-edit-qc |
安装 HyperFrames CLI 或添加注册块(npx hyperframes add …)会安装第三方代码:先与用户确认,并在 package.json 中固定版本。不要自行运行技能的自更新命令(npx hyperframes skills update、npx skills add …)。
合成契约(HyperFrames)
- 独立根元素:
<div data-composition-id="main" data-width="1920" data-height="1080" data-duration="24">直接放在<body>中,尺寸为width/height: 100%——不要在根元素上硬编码像素大小。子合成(通过data-composition-src加载)将其根包裹在<template>中,并将<style>/<script>保留在其中。 - 每个合成一个暂停的时间线:
window.__timelines["<composition-id>"] = gsap.timeline({ paused: true }),在构建完成后注册(可以在document.fonts.ready内部构建)。渲染长度来自根元素的data-duration。 - 定时剪辑:带有
class="clip"和data-start/data-duration的元素由运行时显示和隐藏。永远不要在.clip上设置display、visibility或autoAlpha的动画;对子元素进行动画处理。 - 变换:永远不要将 CSS 初始
transform与 GSAP 修补同一属性;使用gsap.fromTo。使用 flex/inset 居中,不要在被移动的节点上使用translate(-50%,-50%)。 - 媒体:每个
<audio>都有id(否则渲染将无声);媒体上不要有crossorigin;不要在<video>和祖先上同时设置data-start。 - 字体:每个命名的
font-family都有一个指向本地文件的@font-face。 - 确定性:无墙钟时间读取、未播种的
Math.random、渲染时的网络请求、输入状态或无限重复(repeat: -1)。需要随机性时使用播种的 PRNG。 - ID:在整个页面中唯一;子合成 ID 前加上合成 ID。
构建顺序
npx hyperframes init(确认后)或打开现有项目。- 编写设计规格(
frame.md/design.md):标记、字体比例、网格、安全区域、每个宽高比。先制作静止帧——每个节拍必须能作为静态图正常工作。 - 按剧本顺序逐个场景构建;根据转换图(
motion-choreography)实现接缝,先实现载体。 - 从
voice-video-sync放置音频:音乐背景、配音、音效,带有来自时间线文件的 ID 和开始时间——不要手写猜测。 - 保持文本清晰:移动容器,不移动字形;文本上不要使用
will-change。
验证
按以下顺序运行,在继续之前修复:
npx hyperframes lint # 契约错误;lint 错误会禁用布局/对比度审核
npx hyperframes check # 布局、溢出、对比度
npx hyperframes snapshot # 供审查的静态帧;与剧本节拍比较
npx hyperframes preview # 供用户预览本地
然后本地渲染:npx hyperframes render --quality <draft|high>。先以草稿模式(≤30 秒窗口或低质量)供用户批准,然后才是最终版本。
面向外部的命令——publish、cloud、lambda、cloudrun、feedback、auth 和遥测设置——会上传数据或更改账户。仅在用户要求时运行它们。
自定义 seek(t) 管道(不使用 HyperFrames 时)
composition(t) → Playwright page.evaluate(seek, t) → 等待字体/图像 → 截图
→ 每输出帧 N 个子帧 → ffmpeg tmix(运动模糊)→ x264/x265 → 混音音频
- 60 fps × 4 个子帧,快门 0.5,是一个好的默认值;如果数字变化帧上的模糊损害可读性,则移除模糊。
- 主编码(存档和重新编辑源):
-c:v libx264 -pix_fmt yuv420p -crf 16 -preset slow,AAC 320 kbps。平台交付编码在video-edit-qc中派生。 - 两次渲染同一时间戳必须产生相同像素;在 3 个随机帧上测试。
交接
将渲染结果以及静态帧/联系表交付给 video-edit-qc。当安装了 HyperFrames 技能(hyperframes-core、hyperframes-animation、hyperframes-creative、hyperframes-cli)时,使用它们来获取精确的标志、适配器(Lottie、Three.js 等)和注册块名称。