动态图形
一个视频就是一张HTML页面,其每一个像素都是时间 t 的纯函数,在无头 Chromium 中逐帧渲染,并由 ffmpeg 编码。标准是高级动态设计师的作品集,绝非幻灯片。
1. 选择格式
| 请求 | 阅读 |
|---|---|
| 发布、推广、广告、功能片、真实产品的应用预告片 | formats/launch-video.md |
| 短视频、Reels、TikTok、竖屏解说或故事 | formats/shorts.md |
遵循格式文件中的简介、内容步骤和节奏结构。它会引导回到这里进行构建。在编写合成之前,还要阅读 references/pitfalls.md。
每次运行都是全新的创意。 每个视频都有自己独特的想法、脚本和外观。当用户要求不查看过去作品时,请保持工作区中之前的视频和合成文件未被打开。
2. 工作文件夹
在用户指定的位置(默认为当前目录)创建 <slug>-<YYYYMMDD>/:
brief.md 格式简介表中的参数
beats.md 节拍表(时间、文案、素材、动作、过渡、强调点、节奏卡点)
assets/ 截屏、图片、字体、音频
assets/manifest.md 每个素材文件一行:来源、许可证或“从 <表面> 捕获”、显示内容
motion.html 合成文件
motion.json {"size": [W, H], "fps": 60, "duration": 30, "stills": [节拍时间点], "captions": []}
engine/ 从此技能复制 engine/
out/ 单帧图片、渲染结果、联系表
每个文件夹只设置一次引擎:
cp -R <this-skill>/engine engine && (cd engine && npm install && npx playwright install chromium)
3. 合成
motion.html 加载 engine/runtime.css 和 engine/runtime.js,构建其DOM,注册场景,然后调用 MG.ready()。
| 辅助函数 | 用途 |
|---|---|
MG.scene(start, end, fn, el) | fn(local, t, dur) 在 start <= t < end 期间运行;el 在外部隐藏。每次调用时设置所有动画属性。 |
MG.always(fn) | 每帧运行:背景、颗粒、进度条。 |
MG.prog(t, a, b, ease) | 缓动的0..1进度。缓动函数:MG.ease.*(linear、in/out/inOut Quad、Cubic、Quart、Expo、inBack、outBack、outElastic、outBounce)或任意函数。 |
MG.tween(t, [[t0, v0], [t1, v1, ease], …]) | 关键帧;值可以是数组。 |
MG.spring(t, {stiffness, damping}) | 物理模拟0 → 1运动,带有超调。 |
| `MG.split(el, "grapheme" | "word")` |
MG.set(el, {x, y, s, sx, sy, r, o, blur, ...css}) | 每帧对每个元素调用一次。 |
MG.clip(videoEl, start, rate) | 从 start 开始逐帧精确播放屏幕录制。 |
MG.rng(seed), MG.noise(x, seed) | 确定性随机数和抖动。 |
MG.fmt(n, {decimals}) | 用于计数器的区域设置数字格式化。 |
MG.captions() | 在底部UI区块上方绘制 motion.json 中的字幕。 |
确定性:渲染逻辑中不使用 Date、performance.now()、requestAnimationFrame 或 Math.random。允许使用 CSS @keyframes;运行时会在 t 处暂停它们,因此使用 animation-delay 控制时间。仅使用 manifest 中列出的字体和图片。
预览一帧:open "motion.html?w=1920&h=1080&t=3.2&guides=1"(guides 显示安全区)。实时:?play=1。字幕仅在渲染时显示。
4. 工艺标准
- 第0帧已经开始运动。 不要从黑场淡入,不要有logo开场。
- 每0.8–2秒内有实质变化:布局、缩放、颜色、数字或镜头。
- 入场使用弹簧或 ease-out-expo 并带有轻微超调;30–60毫秒错开;只有计数器使用线性运动。
- 仅在快速移动时使用运动模糊;静态镜头使用缓慢推近(缩放1→1.04);2–3个深度层上实现视差。
- 一种背景风格、一种文字颜色、一种强调色。添加颗粒或渐变噪点,使纯色填充在上传后不会出现色带。
- 文案在屏幕上停留足够长时间以供阅读两次;关键文字保持在安全区内。
- 节奏与声音对齐:每次变化配合一个风声、打击声或音乐拍点。
5. 渲染
node engine/render.mjs --html motion.html --config motion.json --stills <t1,t2,...> --stills-dir out/stills
node engine/render.mjs --html motion.html --config motion.json --out out/video.mp4 --workers 4
先在单帧图片上确定布局:每个节拍点一张、每个补间内部一张、每个弹簧超调峰值一张。每次只运行一次完整渲染(在1080p60下4个worker,约25秒视频耗时10分钟)。
6. 音频
仅使用 manifest 中列出且许可证允许使用的音乐和音效,或用户提供的文件。如果没有,则输出无声视频并说明。混音提示,然后封装:
ffmpeg -i music.wav -i whoosh.wav -filter_complex \
"[0]volume=-16dB[m];[1]adelay=1200|1200,volume=-8dB[a];[m][a]amix=inputs=2:normalize=0[out]" -map "[out]" out/mix.wav
ffmpeg -i out/video.mp4 -i out/mix.wav -map 0:v -map 1:a -c:v copy \
-af "loudnorm=I=-14:TP=-1.5:LRA=11" -c:a aac -b:a 256k -shortest -movflags +faststart out/final.mp4
ffmpeg -i out/final.mp4 -af ebur128=peak=true -f null - 2>&1 | grep -E "^ +(I|Peak):"
目标约-14 LUFS集成响度,真峰值低于-1 dBFS。音效约-6至-14 dB,音乐-14至-18 dB。有屏幕文字的背景下使用纯音乐。
7. QA检查
- 使用
ffprobe检查时长、尺寸和帧率是否与简介匹配。 - 联系表:
ffmpeg -i out/final.mp4 -vf "fps=2,scale=360:-1,tile=10x6" -frames:v 1 out/contact.png。查看联系表以及每个节拍变化点的全尺寸帧(ffmpeg -ss <t> -i out/final.mp4 -frames:v 1 out/check-<t>.png)。 - 每帧检查:边缘无裁剪、无空白或半透帧、无残留参考线、无错别字或占位符文本、无任何超过2秒的静态内容。
- 格式文件自身的检查。
修复并重新渲染,直到所有检查通过。将任何新经验添加到技能中的 references/pitfalls.md,格式为 日期 · 视频 · 经验教训。
交付
报告最终的MP4路径、长度、尺寸和帧率、内容说明、音频状态(包括需要的署名),以及重新渲染命令。保留工作文件夹。仅在用户要求时上传或发布。