清单叠加
屏幕录制在左侧,清单在右侧。每个项目在对应步骤在屏幕上发生的瞬间打勾。最后一个勾选完成后,影片在完全勾选的清单上停留片刻。
输入
| 输入 | 说明 |
|---|---|
| 录制 | 一个本地视频文件,理想宽高比为16:9。无音频也可。 |
| 步骤 | 3到7项:{ "label": "...", "at": <录制中的秒数> }。标签为简短的祈使短语(约2-4个词)。 |
| 标题 | 一行文本。说明结果(例如“5步将技能添加到您的代理中”)。 |
| 副标题 | 可选,一行文本。 |
| 调色板 | 可选,十六进制颜色覆盖:bg, surface, panel, ink, muted, accent, border, accentInk。默认深色主题配橙色强调色。确保 accentInk 在 accent 上足够深以便阅读。 |
如果用户未提供时间戳,则对录制进行逐帧分析(使用 ffmpeg 每1-2秒提取帧,观察它们),并选择每个步骤明显完成或正在进行的第一个帧。请勿猜测。
工作流程
- 加载
/hyperframes、/hyperframes-core、/hyperframes-cli以获取项目合约。 - 编写
spec.json:{ "title": "...", "subtitle": "...", "palette": { "accent": "#ff6b2b" }, "steps": [ { "label": "打开应用", "at": 1.5 }, { "label": "搜索", "at": 7.9 } ] } - 将合成生成到项目目录中:
node <skill>/scripts/create.mjs spec.json <recording.mp4> <project-dir> [--hold 2.2]它会复制录制文件,提取最后一帧(以便录制结束后画面保持静止),并写入适应录制尺寸的index.html。总时长 = 录制时长 + 停留时间(默认2.2秒)。 npx --yes hyperframes check必须通过,错误和警告均为0。- 进行验证(见下文),然后渲染:
npx --yes hyperframes render --workers 2 --quality delivery --output final.mp4。
时间规则
- 勾选必须在步骤发生的那一刻,绝不提前。填充和勾选的绘制从
t = at开始;绘制在大约0.3秒后完成。在at之前,项目不得显示为已勾选状。 - 时间戳为录制时间,录制从合成时间0开始,因此
at直接使用。如果裁剪录制,则每个at也相应偏移。 - 在上一勾选完成后不久,下一个项目上可以显示“下一项”轮廓。它仅为轮廓,不填充,也不显示勾选。
- 勾选之间至少间隔1.5秒,以便每个勾选可被感知。如果两个步骤过于接近,请合并它们。
- 最后一个勾选应至少在录制结束前1.5秒处放置,或者通过
--hold增加停留时间,使完成的清单至少可见2秒。 - 计数器(
n / N)、进度条和帧环脉冲均基于相同的at值,因此保持同步。
布局(16:9 录制)
1920x1080 画布,56像素边距。标题和副标题位于顶部;录制帧作为主要部分,宽约1250像素(约占宽度的65%),清单面板为其右侧的一列,宽520像素,与帧同高,项目均匀等分高度。这确保录制中的UI文本可读。请勿将帧宽缩小到1100像素以下;对于更高比例的画面,生成器会按宽高比缩放帧。非16:9录制:检查帧是否仍在标题下方适合,或者先裁剪录制。
标签在32像素字号下最多换行两行;请保持在约26个字符以内。
验证
在渲染的 final.mp4 上执行以下操作,而不仅仅在快照上:
- 对每个步骤,提取
at前0.08秒和一帧,以及at后0.45秒的一帧:ffmpeg -ss <t> -i final.mp4 -frames:v 1 f.png - 检查这些帧。之前:项目未勾选,计数器为 i-1。之后:项目已填充并带有勾选,计数器为 i,进度条已前进。
- 在最终停留期间提取一帧(约在结束前0.2秒):所有项目均已勾选,计数器显示
N / N,进度条已满。 - 检查录制中的文本是否清晰可读,没有标签被裁剪。如有问题,修正
spec.json或调色板并重新生成。 - 使用
ffprobe检查文件:1920x1080,h264,时长 = 录制时长 + 停留时间。
交付
报告 final.mp4 的路径、时长以及使用的步骤时间戳。保留项目目录(index.html、assets/、spec.json),以便稍后可以使用不同的标签或调色板重新生成影片。如果用户希望在 Studio 中编辑,先打开 npx hyperframes preview。