Motion Render Pro
样式规则: 在你写的任何内容(回复、规格说明、字幕、文件)中,绝对不要使用 em 破折号或 en 破折号。请改用逗号、冒号、句号、括号或普通的连字符。
针对 Claude 在代码中构建的动态视频的工作室级渲染标准。默认的 Claude 动画(CSS 过渡、线性/缓动、不透明度淡入淡出、无模糊)看起来像一个网站。这些规则使其看起来像一部电影。
请用用户的语言回复。此技能是渲染层。场景规划请使用 motion-story-director,音频请使用 motion-sound-design,如需复制参考视频请使用 motion-reverse-engineer。
0. 本技能中的文件
| 文件 | 何时使用它 |
|---|---|
scripts/engine.mjs | 每次渲染:确定性帧、子帧运动模糊、缓动、关键帧、节拍网格、摄像机平滑、打字效果、发光、遮罩文本、ffmpeg 输出 |
assets/scene-template.mjs | 开始一个新的场景文件时 |
assets/DESIGN.template.md | 开始项目的 DESIGN.md 时 |
设置(每个项目一次)
- 创建一个项目文件夹并将引擎复制进去:
mkdir -p motion-tools && cp <此技能路径>/scripts/engine.mjs motion-tools/。它必须位于项目内部,以便 Node 能找到项目的node_modules。不要编辑副本;场景代码放在其自己的文件中。 cd进入项目,运行npm init -y && npm i @napi-rs/canvas(预构建,无系统依赖)。ffmpeg 必须存在(which ffmpeg)才能使用render();在没有 ffmpeg 的情况下still()也能工作。- 将
assets/DESIGN.template.md复制到DESIGN.md并填充它(调色板十六进制值、字体、主要对象、运动词汇表、禁用列表),并创建CLAUDE.md,其中包含一行指向它的内容,以便外观在多个会话中保持一致。 - 字体:使用
@napi-rs/canvas的GlobalFonts.registerFromPath(path, family)注册真实字体(可通过 npm 的@fontsource/*包下载 Google Fonts.ttf文件,或询问用户)。在最终输出中,切勿依赖默认的衬线/无衬线字体。
如果在存在 Motion/Design 工件类型的聊天环境中运行,并且用户没有要求 MP4 文件,那么这些工件类型可能是更好的交付方式;此技能适用于代码渲染的 MP4。
1. 六项不可妥协的规则
- 每一帧都是时间的纯函数。 仅使用
draw(ctx, t)。没有定时器,没有Math.random()(请使用rng(seed)),帧之间不携带状态。这使得渲染可重复、帧级精确且支持模糊。 - 真正的运动模糊。 每个输出帧 = 在快门开启时间内(默认 180° =
shutter: 0.5)的 N 个子帧的平均值。正常运动使用 8 个子帧,快速运动使用 16-32 个;subframes可以作为t的函数,这样只有快速部分才需要付出代价。每个子帧评估的液体/形状边缘在静止时保持清晰。 - 对象或文本上无淡入淡出。 物体通过从其原因移动、缩放,压缩成一个点,从线条遮罩中滚出(
maskedText),被形状揭示,或从边缘离开来进入和退出。仅允许对光(发光、光晕、辉光)以及规格明确要求的情况下使用不透明度。 - 仅使用命名缓动。 对于任何可见事物,切勿使用线性缓动(恒定旋转除外)。请从下方词汇表中选取并命名到计划中。
- 摄像机从不停滞,也从不抖动。 全局摄像机 = 关键帧的
smoothPath()(高斯 sigma ≈ 0.16 秒,≤ 25 像素/帧);强调效果存在于物体内部,而非摄像机的突然移动中。 - 在动画化之前批准静态帧。 在关键时刻使用
still()渲染 2-4 个关键帧,展示它们,得到肯定答复,然后再渲染运动。渲染后,再次提取相同的时间戳作为校验点。
2. 缓动词汇表(全部位于 E 中)
| 名称 | 用途 | 感觉 |
|---|---|---|
E.start | 开始移动的物体 | 在第一个移动帧上跳跃约 35%,长制动 |
E.drop = bezier(.42,0,.25,1) | 下落、爬行、移动 | 加速,峰值 7-8%/帧,约 15 帧制动 |
E.camera = bezier(.42,0,.36,1) | 镜头之间的摄像机移动 | 在事件发生时或之前完成 |
E.spread | 扩散、填充、扩张 | 加速到全速,+10% 超调,回弹 |
E.push | 列表、堆叠、传送带 | 速度 20u(1-u)³;重叠推动使列表永不停止 |
E.spring(t, z, w) | UI 元素着陆 | 小超调(z 0.6-0.8) |
E.critical(t, w) | 标志、硬币、高级揭示 | 临界阻尼,无超调 |
E.sine | 呼吸、摇摆、循环 | 对称缓入缓出 |
pop(t, t0, fps, 1.18) | 徽章、图标、勾选标记 | 2-3 帧达到 115-120%,7 帧内稳定,无弹跳 |
持续时间:大多数进/出动作为 7-12 帧(30 fps 下为 0.23-0.4 秒)。没有事物在一帧内出现或消失。
3. 按风格划分的物理效果(切勿混合)
- UI / 图形风格: 弹出、超调,着陆时挤压 10-15%,弹簧,液体粘性球体,光晕绽放。
- 写实 / 3D 风格: 真实重力(y = ½gt²),每次接触 = 冲击 + 一个小反弹,无挤压,无事物从零缩放,无滑动滚动,纸张带空气阻力(飘动、滑动,永不漂浮)。在 Blender 中,使用刚体/布料模拟或根据这些公式设置关键帧;使用 Cycles 加降噪器渲染,180° 快门运动模糊,f/2.8 风格的景深聚焦于引导对象。
4. 光照、发光和文字排版
- 发光 = 使用
glow()(globalCompositeOperation 'lighter')的叠加光晕,范围约至 2.1 R(1.2 R 处强度减半,2 R 处消失)。在白色背景上,叠加光会消失;请在物体背面绘制一个大的饱和柔和光点。 - 只有光才是透明的。高光位于左上角,光泽物体有微弱菲涅耳边缘光。
- 文字排版:最多 2 个字体族;较重/紧缩的无衬线体或斜体衬线体用于主要词汇,干净的无衬线体用于辅助文字。大数字字间距要紧密。iOS/系统 UI 从不打字;它整体滑入或滚入。
- 打字效果:
typing()提供每个字母的抖动(平均值的 0.55-1.45 倍,空格后更长),每个字母在 2 帧内从其遮罩升起;光标在最后一个字母后实心显示 0.35 秒,然后柔和闪烁(caret())。新字母可以用强调色出现,并在约 6 个字符后冷却为白色。 - 数字里程表:数字在硬遮罩下的轮子上滚动,每帧 ≤ 0.5 个数字,个位数字最后落地。
5. 构图规则
- 除非另有说明,否则为 1080×1920 垂直构图;保持文本/图标距离边缘 ≥ 75 像素(或 0.11 宽度);Instagram UI 区域:顶部约 250 像素,底部约 420 像素,右侧约 120 像素。
- 主要元素在画面中要大;边缘裁剪是好的。2-3 层深度,带视差和散焦。
- 将组相对于画面居中,并且各元素之间也相互居中。
- 禁用列表(默认的 AI 俗套):表情符号、通用粒子、脉冲环、虚线、轮廓图标、发明标志、无处不在的通用“科技”发光、绘制的人物/面孔。仅允许规格要求的内容。
- 循环:当要求时,最后一帧必须等于第 0 帧(使用 motion-reverse-engineer 的
analyze验证 → 首帧/尾帧相似度 > 0.95)。
6. 工作流程
- 获取或编写带时序的规格说明 (motion-story-director)。
- 将
assets/scene-template.mjs复制到scene.mjs并在此基础上构建:常量(W, H, FPS, D, 调色板),grid(bpm),摄像机smoothPath,每个场景一个函数,一个按时间调度并处理过渡重叠的draw(ctx,t)。 - 在关键时刻使用
still()(使用模板运行node scene.mjs --stills)→ 展示 → 批准。 - 草稿渲染:半分辨率,
subframes: 1,preset: 'ultrafast'以检查时序。 - 最终版:全分辨率,子帧 8(快速部分 16-32),crf 16-18,
preset: 'veryfast'(仅在要求最佳质量时使用 'slow')。 - 使用 motion-sound-design 混合音频并复用。
- 校验点:在计划的时间戳提取帧,并与静态帧/参考帧进行比较。将 MP4 发送给用户。
渲染成本指南(1080×1920,Node,单核):简单 2D 每子帧约 0.05-0.15 秒。15 秒 × 30 fps × 8 子帧 ≈ 3600 子帧 ≈ 3-9 分钟。在渲染时间超过 15 分钟前警告用户;使用 from/to 帧范围选项分段渲染,并在需要时使用 ffmpeg 拼接。
7. 最小场景模板
assets/scene-template.mjs:包含一个背景、一个使用 E.camera 缓动的摄像机推进、一个在第 1 拍弹出并使用 E.drop 缓动移动且带有发光效果的图标。运行 node scene.mjs --stills 写入校验帧,运行 node scene.mjs 会渲染出 out.mp4,在快速移动期间使用 16 个子帧,其他部分使用 8 个。