一键提示短片 (one-prompt-reel)
这部影片的主张是:“无论你在哪里输入,效果都一样。”证明方式就是重复。一个字符串,四个看似无关的界面,然后是一连串它产生的输出,最后再次显示这个字符串。
输入
| 输入 | 必需 | 备注 |
|---|---|---|
prompt | 是 | 确切的命令或句子。50个字符以内效果最佳;它会被输入四次,外加在结尾处再输入一次。 |
reel 图像 | 是 | 16-24个真实输出:截图、产品画面、从先前渲染中提取的静态图。仅限使用你自己的素材。 |
| 品牌名称、标语、URL | 是 | 用于结尾卡片。 |
| 标志 | 否 | 带透明通道的方形PNG。省略则使用纯文字结尾。 |
| 音乐 | 否 | 你拥有商业使用许可的音轨。如果不确定许可条款,请使用静音。 |
工作流程
- 搭建项目。 创建一个项目文件夹,将
template/复制进去(包含index.html和assets/gsap.min.js),并将展示图像放入assets/reel/目录。然后运行:npx --yes hyperframes check - 填写 CONFIG 块,位于
index.html中<script>的顶部。所有项目特定的配置都在这里:prompt、bpm、reel文件列表、brand、tagline、url、logo。除非以下规则强制要求,否则不要重构其余部分。 - 选择剪辑网格。
- 无音乐: 保持
cuts: null。剪辑点由bpm和reelPattern决定(默认:8个一拍剪辑,接着16个半拍剪辑,在120 BPM下 = 4 秒 + 4 秒)。每个界面持续surfaceBeats拍,因此整个影片保持在网格上。 - 有音乐: 将音轨添加为
<audio id="music" data-timeline-role="music" src="assets/music.mp3" data-start="0" data-duration="24" data-track-index="5">,运行npx hyperframes beats,打开beats/assets/music.mp3.json,并复制CONFIG.cuts中在展示开始或之后的节拍时间(以秒为单位)(多一个条目标记最后一个剪辑的结束,即关闭画面开始的时间)。设置bpm为音轨的节奏,以便输入部分也能对齐。如果节拍密度大于0.2秒,则每隔一个取一次。在最后一秒将音乐淡出(/hyperframes-audio)。
- 无音乐: 保持
- 渲染前检查。 运行
npx --yes hyperframes snapshot --at 1.8,4.3,6.8,9.2,11,15,20,23并打开生成的PNG文件。检查每个界面输入中、一个展示剪辑和结尾画面。 - 渲染。 运行
npx --yes hyperframes render --workers 2 -o final.mp4。 - 从MP4中提取4-6帧(每个界面一帧,一个展示剪辑,结尾画面),使用 ffmpeg 并检查它们。如果任何内容被裁剪、不可读或空白,则修复并重新渲染。
影片结构(默认24秒)
| 时间 | 节拍 |
|---|---|
| 0-10 秒 | 四个界面,每个持续2.5秒。从右侧滑入,输入大约1.5秒,按下 ENTER,从左侧滑出。一个小标签标明界面名称及其位置(1/4)。 |
| 10-18 秒 | 带白色闪白效果的硬切。24张全屏输出图像,每张缓慢推近。命令显示在左下角的圆角胶囊中,贯穿整个展示过程;右下角有一个计数器。 |
| 18-24 秒 | 深色结尾画面:标志、名称、标语、命令在带有余烬边缘的圆角胶囊中再次输入一次、URL、单次发光脉冲。 |
保证效果的规则
- 四个界面必须在轮廓上不同,而不仅仅是颜色。 宽而低、高而窄、浮动在渐变之上、带有侧边树的深色界面。如果你需要眯着眼才能区分其中两个,重新设计一个。使用纯HTML和CSS构建它们;切勿模仿任何真实产品的边框、标志或配色方案。
- 相同字符串,相同输入速度。 每个界面在相同持续时间内输入完全相同的
prompt。这种一致性是关键。 - 使用时间线补间(tween)进行输入,而不是计时器。作用于
{n}计数器的补间,其onUpdate回调用于切片字符串,这种方式是安全的,可以随意定位时间线;而setInterval则不行。 - 使用
tl.set在半拍循环上闪烁光标,不要使用 CSS 动画或repeat: -1。 - 在网格上剪辑。 每个界面的边界、剪辑点和结尾画面的进入点都必须落在节拍上,无论网格是基于音乐还是纯节奏。偏离网格的剪辑是看起来最不专业的。
- 加速一次。 先慢速剪辑,然后半长度剪辑。不要重复加速。
- 展示图像是证据。 真实的输出,而非装饰。优先使用1920x1080的静态图像;缩放不规则的尺寸时使用
object-fit: cover。相邻图像交替使用深色和浅色背景,以便每次剪辑都能产生视觉变化。 - 不使用第三方素材。 不要使用任何你不能分发的标志、其他产品的UI截图、库存视频或字体。字体:明确指定一种字体家族(等宽字体使用
"JetBrains Mono",CLI 本身会处理这个问题);通用等宽字体栈ui-monospace在测试中会导致比例显示问题。 - 确保字幕可读。 检查对比度;
hyperframes check会强制要求文本达到 WCAG AA 标准,因此标签需要在米色背景上使用中等深度的墨水颜色。 - 静音是可以接受的。 不要添加许可不明的音乐;带有非商业条款的 AI 生成音轨不得使用。
- 保持闪白补间的
immediateRender: false,否则版面审计会在 t=0 时看到一个白色覆盖层。
验证
npx --yes hyperframes check必须以“检查通过(Check passed)”结束(包括代码检查、布局、对比度)。- 快照帧显示所有四个界面在退出前都已完全输入完毕,没有标签覆盖界面,没有空或半加载的展示图像。
ffprobe报告分辨率1920x1080,编码h264,时长在20-30秒窗口内。
交付物
将 final.mp4 放在项目文件夹(index.html, assets/)旁边。如果仓库的约定要求简短说明,请列出:提示词、节奏或节拍来源、展示图像来源、音乐许可(或“静音”)和渲染命令。提及 Studio(npx hyperframes preview)可以重新调整任何内容的时序。
详见 references/surfaces.md 了解四个界面的规格,以及 references/grid.md 了解时序计算。