Skip to content

nexu-io/open-design / skills/huashu-art-motion

huashu-art-motion

Verified

辅助艺术动画与解说任务:35 种艺术风格配方、9 种解说语法、分镜与确定性 Canvas 绘制工具。按宿主时间轴实现,素材与导出使用宿主能力。

FileKindSize
LICENSEother1.1 KB
SKILL.mdskill md5.5 KB
SOURCES.mdmarkdown1.0 KB
references/art-styles-1.mdmarkdown93.8 KB
references/art-styles-2.mdmarkdown52.8 KB
references/canvas-helpers.mdmarkdown81.9 KB
references/craft-workflow.mdmarkdown56.8 KB
references/explainer-grammars.mdmarkdown127.4 KB
references/index.mdmarkdown3.0 KB
references/license.mdmarkdown1.1 KB

references/explainer-grammars.md

View on GitHub
# 九种解说动画语法

> 上游工艺参考。原作者的样片耗时、质量指标与实验结论不是 Open Design 的验收结果。文中的上游工程路径和渲染命令用于解释原实现,不是本包可执行入口;实际工具、品牌和交付约定以 SKILL.md 为准。无需复现作者的画面、角色、字体或独立制作流程。


---

<a id="t1_3b1b"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/动画语法/t1_3b1b.md

# t1_3b1b · 3Blue1Brown 式数学/概念可视化

> 一句话语法:**黑底上只放「正在讲的那一个东西」,用平滑形变(Transform)把上一个概念直接变成下一个,颜色=概念的名字,全片几乎不切。**
>
> 示范片:`scripts/engine/demos/t1_3b1b/`(渲染 `render.py --film demos/t1_3b1b`)(8s,3 镜头)· 总览 `assets/动画语法/t1_3b1b_总览.jpg` · 代码 `scripts/engine/demos/t1_3b1b/`

## 起手必查

1. **每个镜头写出「谁变成谁」。** 上一个对象和下一个对象各是什么(方格 → 圆、一条曲线 → 另一条、像素 → 神经元)。写不出变形对象的那一句,不用 t1,换 y5 或 y3。
2. **第一帧就是对象。** 坐标系、方格、曲线先出来,标题和公式后到;不要第 0 秒先 Write 一行标题。
3. **数屏上的字。** 同一时刻屏上要点不超过 2 条;第三条出来前,前面的要么变成图、要么收走。要点一条条 Write 成列表,就是黑底的 PPT。
4. **颜色表先写好。** 每个概念一个颜色,公式里的符号和画面里的对象同色;全片语义色不超过 4 种。
5. **wait 时静止。** 不加匀速慢推、呼吸、漂浮;镜头只在要看下一个对象时动,动完就停(见 ③「相机」)。

## ① 适用场景

- **用**:讲一个机制「怎么一步步变成另一个东西」——神经网络前向传播、注意力、矩阵变换、梯度下降、概率分布、算法流程。口播是「我们把这张图压平成一列」「每个像素乘上一个权重」这种**动作型句子**时最合适:每句话对应一次 Transform。
- **用**:观众需要「看见数学」——公式里的符号与画面里的物体一一对应(公式的 W 是蓝色,连线也是蓝色)。
- **别用**:产品发布、情绪/品牌片(黑底白线太冷、太慢);数据真实走势(那是 t3 的活);口播是观点、故事、金句时(没有可以「变形」的对象,硬上只剩装饰)。8 秒以内的快剪也不合适——3b1b 的原生节奏是一个动画 1–3 秒+停 1 秒(见⑤),压到 8 秒 3 个镜头已经是上限。

## ② 画面构成

| 项 | 取值 | 依据 |
|---|---|---|
| 背景 | **纯黑 #000000** | Grant 自己的 `custom_config.yml`。网上流传的「深海军蓝 #0E1525」是营销博客的说法,不是原作 |
| 饱和度 | 色值照 manim 常量,再整体 **×1.5 饱和**(`DG.saturate`) | Grant 导出时 ffmpeg `saturation=1.5`;照原值用会发灰 |
| 主色(原值→×1.5 后) | BLUE_C `#58C4DD` · RED_C `#FC6255` · YELLOW `#FFFF00`(3b1b 版是纯黄,不是 CE 的奶黄 `#F7D96F`)· TEAL_C `#5CD0B3` · GREEN_C `#83C167` · GREY_A–E `#DDD/#BBB/#888/#444/#222` | 3b1b/manim `default_config.yml` |
| 颜色编码 | 一个颜色只代表一个概念,全片不换:本片 **黄=激活/信号,蓝=正权重,红=负权重**,公式里的 `a` 是黄、`W`/`w` 是蓝 | 3b1b nn 第二集 part2.py:正权重 BLUE、负权重 RED |
| 线宽 | 默认描边 4(1080p 约 4px);坐标/网络连线 2;网格主线 2、细分线 1 且不透明度 0.25 | manimlib `coordinate_systems.py` |
| 单位 | 画面高 = 8 个 manim 单位 → **1 单位 = 135px**(`DG.U`) | manim 默认 frame_height=8 |
| 神经元 | 白描边 2px;**填充不透明度 = 激活值**;半径 0.15 单位(≈20px),同层间距 0.25 单位;每层最多画 16 个,其余用 ⋮+大括号 | `_2017/nn/part1.py` |
| 连线 | 从圆周到圆周;线宽 `3·(|w|/max)³`(本片 `0.6+3.2·|w|³` px),正蓝负红 | part2.py |
| 字体 | 公式 **Computer Modern**(CMU Serif,本工程 `CMU-rm/CMU-it`);中文配思源宋体(与 CM 同为衬线、笔画对比接近) | custom_config:Text 字体 "CMU Serif" |
| 构图 | 一屏一个主体,居中或左右对称;标题/公式固定在上方 1/8(y≈110–150),不随相机动 | — |
| 形状语言 | 圆、方格、直线、大括号、箭头;**几乎不用发光**——「发光感」来自纯黑底上的高饱和细线,不是 bloom | 原作观察;需要强调时用 Indicate 染黄,不加光晕 |

## ③ 运动轨迹

- **缓动**:默认 `smooth = 6t⁵−15t⁴+10t³`(3b1b 版,两端速度和加速度都为 0;CE 版是 sigmoid,`MO.smoothCE`)。**几乎所有动画都用它**;linear 只给 Write、匀速旋转、ShowPassingFlash 的推进。`there_and_back` 给 Indicate,`rush_into/rush_from` 给「冲进/冲出」。
- **默认时长**:Animation run_time=1s,wait=1s。2023–24 年源码统计:显式 run_time 最常见 2s(481 次)>3s(333)>1s(187)>4s(145)。
- **LaggedStart**:默认 lag_ratio 0.05;源码里最常用 0.1。实现:`MO.lagged(i, n, p, r)`(第 i 个占 `[i·r, i·r+1]`,总长 `1+(n−1)r`)。本片 100 个像素→神经元用 0.01(1.1s 走完),160 条连线用 0.006。
- **Write**:linear;<15 个子物件 1s,否则 2s;子物件间 lag = `min(4/(n+1), 0.2)`;每个字「先描轮廓、后填色」(`DG.math`/`DG.write`:lineDash 推进描边 → 后 60% 填色淡入、描边淡出)。
- **Transform**:两个形状重采样成同样点数、**起点对齐**(都从左上方向起、顺时针),逐点直线插值(path_arc=0)+颜色插值。`DG.rectPts/circlePts/morph`。本片:方格→圆(像素→神经元),权重格→飞向一个神经元(加权求和)。
- **入场/出场**:FadeIn/FadeOut 带 shift(本片 24–40px,「从下往上」或「往上淡走」);新层神经元从右侧 24px 淡入;被替换的东西缩成点并入「⋮」。
- **信号**:ShowPassingFlash(time_width 2)——把连线复制一份染黄、线宽 ×1.5,可见段 `[max(0,u−2), min(1,u)]`,u 从 0 到 3(`DG.flash`),按输入行 lag 0.04 错开。
- **相机**:MovingCameraScene 的 frame 动画,镜头动作是事件:停住 → 推到下一个要看的对象 → 停住。推法二选一:3b1b 原生的 smooth 一次推到(约 1s),或快推 0.28 秒推近 18–32% 后停;3D 场景环绕 0.5–3°/s(3b1b 默认 1°/s)只在讲空间关系时用。本片镜头 2 推向输出层(1→1.08)是事件推;镜头 1 绕网格 1→1.025 的匀速慢推是旧做法,新片不照抄。
- **wait 里静止**:原作在 wait 里通常是**静止的**——这是 3b1b 与发布会片最大的不同。不加匀速慢推、呼吸、漂浮来凑运动;动感来自下一次 Transform。

## ④ 转场(常用 4 种)

1. **Transform 接续(不切)**:上一镜末帧=下一镜首帧,靠形变把旧对象变成新对象。本片镜头 1→2:100 个像素方格变成一列输入神经元,镜头 2 首帧与镜头 1 末帧逐像素相同。这是 3b1b 的头号转场,占绝大多数。
2. **镜头穿越(zoom through)**:相机绕一个物体指数推近(`zoom = Z^e`,感知速度恒定),物体圆周变成开口,里面是新画面。`TRANSITIONS.zoomThrough`,参数 `live:true`(旧镜头自己在 lt>时长时继续推相机,矢量重画不糊)、`r0`(物体半径)、`zoom ≥ 1100/r0`(否则开口盖不满屏、最后一帧跳)、`focus`(新画面主体先待在开口正中,e>0.55 才归位)。本片镜头 2→3:先把激活 0.95 的那个隐藏神经元描边染黄(「我们来看这一个」),再推进它 48 倍,0.75s。
3. **FadeOut(shift=UP) + FadeIn(shift=UP)**:换话题时全部往上淡走、新内容从下淡入(`TRANSITIONS.fadeShift`)。
4. **ReplacementTransform 标题/公式**:旧公式的符号移动到新公式里同名符号的位置(TransformMatchingTex,3b1b 版默认 2s);对不上的符号淡出淡入。

## ⑤ 节奏与文字

- **镜头时长**:原作是连续场景,单个动画 1–3s、后面 wait 1s;一个「镜头」(一个概念)常 8–20s。本片 8 秒 3 个镜头(2.6/2.8/2.6s)是**压缩版**,真用在口播里应拉长 2–3 倍。
- **与口播对位**:Grant 的流程是**先排动画、后录口播**("I start by laying out all of the animations… then once I record the voiceover, the actual editing is like a day")。所以对位规则是「一句话=一个动画」:句子说出动作动词时动画开始,句末落定后 wait 约 1s 给观众看。
- **文字**:标题/提问在动作之前 Write 出来(先问后演);公式与画面同时出现、同色;数值(0.95)跟着填充计数,不先于画面出现。中文一屏不超过一行标题+一行注释。
- **FAQ 原则**:"Every movement on the screen should be deliberate, with an identifiable purpose"——没有讲解目的的动作要删。

## ⑥ 代码实现要点

> 收进 skill 后(2026-10-04 v0.4):本卡「新写」里的通用函数已统一进 `scripts/engine/lib/`(名字已换成统一后的 MO / CAM / DG / TY / CH / UI / CL / TOON),示范片自己的代码在 `scripts/engine/demos/t1_3b1b/`。库速查和「怎么为一段口播选语法」见 `references/09-视频动画语法.md`。

- 复用 skill:`engine.js`(时间轴、转场框架、`renderSolo`)、`render.py`、`PAINT.hex/cached`、`U.clamp/lerp/hash`。
- 改了引擎副本两处:段落可写 `dur`(秒);转场可 `punch:0` 关掉拍点镜头冲击(讲解片不要那一下)。
- 新写、现已统一进库 `lib/diagram.js`(`window.DG`;`lerpPts` 改名 `morph`,相机归 `CAM`):色板+`saturate(×1.5)`、`camera/toScreen`、`rectPts/circlePts/lerpPts/shape`(Transform)、`neuron/edgeEnds/edge`、`flash`(ShowPassingFlash)、`indicate`、`circumscribe`、`layout/math/write`(公式排版+Write)、`brace`。
- 新写 `lib/motion.js`(`window.MO`,三种风格共用):`smooth/smoothCE/thereAndBack/rushInto/rushFrom/doubleSmooth`、`lagged`(`count/fmt/tabular` 收进库后在 `TY`)。
- 新写转场(已进 `transitions.js`):`zoomThrough`、`fadeShift`。
- 关键参数:神经元 r=17/22/32px;镜头 3 讲的是**隐藏层**神经元(它的 100 个权重才能画成 10×10 图;输出神经元连的是隐藏层,不是像素——审片抓到的逻辑错);连线 alpha 0.7–0.85;信号黄线 3–4.5px;Write 字号 58(标题)/64(公式)。
- 字体:`scripts/font_subset.py` 按片中用字子集化思源宋(全量 25MB → 300KB);CMU 从 jsDelivr `bitmaks/cm-web-fonts@master/font/Serif/` 取 woff(注意是 `font/` 不是 `fonts/`)。

## ⑦ 代表作品与一手参考

- 代表作:3Blue1Brown《But what is a neural network?》(2017)、《Essence of linear algebra》、2024《Transformers》系列。
- https://github.com/3b1b/videos/blob/master/custom_config.yml (背景 #000、CMU Serif、saturation 1.5)
- https://github.com/3b1b/manim/blob/master/manimlib/default_config.yml (色值)
- https://github.com/3b1b/manim/blob/master/manimlib/utils/rate_functions.py (smooth 等)
- https://github.com/3b1b/manim/blob/master/manimlib/animation/creation.py (Write/ShowCreation 参数)
- https://github.com/3b1b/videos/blob/master/_2017/nn/part1.py 、part2.py (神经元与权重画法)
- https://github.com/ManimCommunity/manim/blob/main/manim/utils/rate_functions.py (CE 版对照)
- https://www.3blue1brown.com/faq ("Avoid pointless animations")
- https://www.dwarkesh.com/p/grant-sanderson (先排动画后录口播)

## ⑧ 最容易做错的 3 件事

1. **把「发光」当成 3b1b 的标志去加 bloom、加深蓝渐变底。** 原作是纯黑底+高饱和细线+×1.5 饱和,几乎没有光晕。加了光晕就成了「科技感 PPT」。
2. **全用 linear 或普通 ease,动画又快又多。** 默认必须是 smooth(五次多项式),一个动画 1–3s 后停 1s;每个动作要对应口播里的一个动词。
3. **颜色编码中途变卦/颜色太多。** 一个颜色=一个概念,公式里的符号和画面里的物体同色;超过 3–4 种语义色观众就记不住。

## qa 数字(skill `scripts/qa.py`,2026-10-04,审片前)

| 镜头 | 运动% | 静止帧对% | 跳变 | 均/峰 ms | 确定性 |
|---|---|---|---|---|---|
| t1_s1 | 1.83 | 17.7 | 0 | 1.5/2.4 | ✓ |
| t1_s2 | 7.1 | 0.0 | 0 | 2.2/3.1 | ✓ |
| t1_s3 | 3.26 | 0.0 | 0 | 1.0/2.2 | ✓ |

## 修订(独立审片 → 改一轮,2026-10-04)

审片 agent 只看成片,t1 提了 2 条 🔴、2 条 🟡:

| 审片意见 | 改法 |
|---|---|
| 🔴 逻辑错:镜头 3 把输出神经元「猫」的权重画成 10×10 像素模板,但输出层连的是隐藏层 | 改成推进**激活 0.95 的隐藏层神经元**(3b1b 原片讲隐藏层就是这样把权重画成图),结论「像猫脸 0.95」与镜头 2 里它的亮度一致;公式 a⁽¹⁾ 本来就指隐藏层,不用改 |
| 🔴 结论没有停留,0.92 在最后 0.1s 才数到;图例提前淡出 | 镜头 3 时间轴整体前移:1.65–2.0s 数到 0.95,Indicate 到 2.3s,**停 0.6s**;图例留到片尾 |
| 🟡 推镜前停留太短、新标题出来时挂着粗连线残影 | 推镜前先描黄目标神经元 0.3s;开口外旧画面改为 p 0.45–0.8 退完;新标题 0.75s 才开始写 |
| 🟡 8 秒塞 5 个概念 | 保持 8 秒(任务要求),卡片⑤写明真用时拉长 2–3 倍 |

另:镜头 1 落定后的神经元改用真圆画(原来是 48 边形),镜头 1 末帧与镜头 2 首帧**逐像素相同**(实测差值 0)。

修订后 qa:

| 镜头 | 运动% | 静止帧对% | 跳变 | 均/峰 ms | 确定性 |
|---|---|---|---|---|---|
| t1_s1 | 1.9 | 15.8 | 0 | 1.6/2.7 | ✓ |
| t1_s2 | 8.41 | 4.2 | 0 | 2.1/2.8 | ✓ |
| t1_s3 | 2.66 | 15.1 | 8 | 0.9/2.0 | ✓ |

t1_s3 的 8 个「跳变」在 lt 1.06–1.23s(像素图整体滑到权重图上)和 1.51–1.54s(100 格收拢)——看过逐帧,是有意的大位移,不是穿帮;15% 静止帧对来自结尾 0.6s 的停留(3b1b 的 wait,有意为之)。

---

<a id="t2_keynote_ui"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/动画语法/t2_keynote_ui.md

# t2_keynote_ui · 发布会式界面与渐变动效

> 一句话语法:**一屏一件事,产品本身(截图、录屏、实物)当主角,名词和数字在口播说到时落定;字收紧,弹簧无回弹或轻回弹。** 光斑渐变底、毛玻璃卡、渐变字、居中模糊浮现、装饰漂浮都是可选包装,慎用(见「起手必查」)。
>
> 示范片:`scripts/engine/demos/t2_keynote_ui/`(渲染 `render.py --film demos/t2_keynote_ui`)(8s,3 镜头)· 总览 `assets/动画语法/t2_keynote_ui_总览.jpg` · 代码 `scripts/engine/demos/t2_keynote_ui/`

## 起手必查

1. **这一套最容易读成 AI 模板。** 光斑渐变底+毛玻璃卡+渐变字+居中从模糊里浮出+卡片漂浮,五样一起上,观众一眼认出是模板。开工前先问:有没有真实的产品截图、录屏、实物照片?有,就让它满幅当主画面并推近到要讲的那一块,光斑和玻璃卡不用;五样包装一支片子最多挑两样。
2. **截图要大。** 有截图的镜头,截图宽度 ≥ 画宽 80%(竖屏 ≥ 90%),再推近到口播正在说的那一块(快推 0.28 秒推近 18–32% 后停)。一张小卡漂在大片光斑上,就是第四种做坏方式「死背景」。参数化片段 t2 默认就是这样:截图满幅铺开(等比不裁,四周垫同图的压暗模糊版),highlight 那一刻快推过去,连着两张截图之间同倍率横移 0.30 秒;旧的玻璃卡要显式写 `data.frame: "glass"`。自己写镜头用 `CAM.track`(脉冲镜头)和 `MD.cover`(满幅+焦点+推近)。
3. **数版式。** 把分镜里每一屏的版式写出来(标题屏、三卡并排、大数字、截图卡),同一种连续出现 ≥2 屏就换一种:截图推近、数字砸入、前后对比。「标题 → 三张功能卡 → 大数字」整片循环,就是翻页 PPT。
4. **落定后停住。** 不加卡片漂浮、不用匀速慢推填停顿;下一个动作放在口播说到名词或数字的那一刻。数字讲的是刚才那张截图里的事(两次计时之比、这一页的结论),number 写 `data.over: true`:镜头拉回整张截图、截图压暗、数字砸在上面,不切到光斑底单独一屏。
5. **配色跟产品走。** 底色和强调色取产品自己的品牌色,不默认紫蓝青光斑;讲坏消息、严肃事件、非发布题材时不用这套深色发布会底。

## ① 适用场景

- **用**:产品/功能发布、版本更新、「三个新功能」、价格与参数公布、开场品牌片、视频里的「这个产品是什么」段落。口播是**名词+数字**(「Plover 2」「延迟 320 毫秒」「100 万 tokens」)时最合适:一句一屏,名词出现时字浮出,数字说到时落定。
- **用**:需要把界面截图讲清楚——截图满幅,推近到要讲的那一块;放进玻璃卡、在 3D 里转正是可选包装,慎用。
- **别用**:讲机制原理(玻璃和光斑不承载逻辑,用 t1);讲数据走势(用 t3);严肃事故/财报坏消息(这套语言自带「好消息」的情绪);内容本身没有一个能放大的「主角」时(只剩空镜光斑);科普、故事、新闻这类非发布题材,别拿这套底当通用模板。

## ② 画面构成

| 项 | 取值 | 依据 |
|---|---|---|
| 底色 | 近黑:本片 `#050508`;Apple `#000/#161617/#1d1d1f`;Linear `#08090a`(上一级 `#0f1011/#141516`,正文 `#f7f8f8`,描边 `#ffffff14`) | 两家官网 CSS 实测 |
| 光斑(可选,慎用) | 4 团径向渐变 screen 叠加 → 1/4 尺寸上模糊 90px → 放大铺满 → 叠 3.5% 静态颗粒防色带。色相走 Stripe 一系:紫 `(150,90,238)`、蓝 `(56,104,255)`、青 `(120,214,255)`、一点暖红 `(255,96,84)`;中心再压一层 38% 黑径向渐变给白字让对比 | Stripe 2021 渐变 `#a960ee #ff333d #90e0ff #ffcb57` |
| 光斑运动(可选) | 每团漂移振幅 90–260px、周期 9.5–13s,**避开 5s 周期**(HIG:避免 ~0.2Hz 持续摆动) | Apple HIG Motion |
| 玻璃卡(可选,慎用) | 背景取样模糊 40px(Apple 导航 `saturate(180%) blur(20px)`,NN/g 说越大越好)+白 7.5% 填充+顶部 14% 白渐变受光带+1.5px 渐变描边(左上亮、右下暗)+大阴影(blur 70–80,y+30–40,α0.5) | apple.com globalheader.css;NN/g Glassmorphism |
| 圆角 | 卡片 36px;**同心圆角**:内部图标底圆角 = 36 − 内边距 14 = 22 | WWDC25「子圆角 = 父圆角 − padding」 |
| 字体 | Inter(SF Pro 最接近的开源字,Linear 用 Inter);中文思源黑。标题 600 字重、**大字号字距收紧 −0.02 ~ −0.03em**(`T2.track`) | Apple 96px −0.015em、Linear 64px −0.022em、OpenAI 64px −0.03em |
| 文字层级 | 白 `#f5f5f7` 主、`rgba(235,235,245,.6)` 次、`#a7a7b4` 眉题(字距 +6px);产品名可用白→淡紫→淡青横向渐变(可选,慎用:渐变字和光斑一起上就是模板) | Apple 官网层级惯例 |
| 构图 | 一屏一个焦点;有截图时截图满幅(宽 ≥80%)并推近到要讲的那块;居中对称的三卡并排(等宽 480、间距 52)只用于没有截图的功能清单;大数字占画面宽 55% 以上 | — |
| 形状语言 | 圆角矩形、胶囊、细线图标(圆头等线宽,SF Symbols 气质,`UI.icon`) | — |

## ③ 运动轨迹

- **弹簧(主力)**:SwiftUI duration+bounce 参数化,`MO.spring(t,{duration,bounce})`:mass=1、stiffness=(2π/d)²、damping=4π(1−bounce)/d → 阻尼比 ζ=1−bounce。**默认 bounce 0**(最通用);0.15 利落几乎不弹(本片卡片入场 d=0.75、气泡 d=0.5);0.3 明显弹;>0.4 对 UI 夸张。`.smooth/.snappy/.bouncy` 都是 d=0.5。
- **曲线(非弹簧)**:apple.com 导航 `.32s cubic-bezier(.4,0,.6,1)`;本片字的浮现用 CSS `ease`=`(.25,.1,.25,1)`(`MO.appleOut`);Linear 主力 ease-out-quad `(.25,.46,.45,.94)` .16s;Stripe 建议 <500ms、`(.2,1,.2,1)`。`MO.bezier(x1,y1,x2,y2)` 通吃。
- **字的入场**(居中模糊浮现是可选做法,慎用;全片每屏都这样浮出就成了模板):模糊 18–26px → 0、上移 16–40px → 0、透明 → 1,0.7–1.0s(`TY.blurIn`)。眉题 → 产品名 → 副标题依次错开 0.2–0.4s。
- **卡片入场**:从下方 170px、绕 Y 轴 ±0.55rad(≈31°,两侧卡朝外)、缩放 0.9 → 弹簧落位;三张错开 0.1s。3D 用 `UI.persp`(竖条切片透视,persp 1800px;Stripe 用 600、Linear 用 1000)。
- **镜头与停顿(脉冲节奏)**:落定后停住,不加装饰漂浮,不用匀速慢推填停顿。镜头动作放在口播说到名词或数字的那一刻:快推 0.28 秒推近 18–32% 后停(推到截图上要讲的那块);同倍率横移 0.30 秒到下一块;数字或大字砸入 0.17 秒(1.55→0.94→1.0);停多久按口播。示范片里的卡片漂浮 7px(`MO.float`)和相机匀速推 1→1.045 是旧做法,新片不照抄。
- **计数**:卡片落定后 0.25s 起 0.9s(同一个数只数一次——展开成全屏后沿用「100万」,不再从 0 重数);`easeOutExpo`(CountUp.js 默认缓动)——最后一位慢慢落定;数字**等宽排布**(`TY.tabular`,Canvas 不能开 tnum,不排会抖)。
- **光扫过**:斜 −20°、宽 110–140px 的亮带 0.8–0.9s 扫过;在文字离屏上用 `source-atop`(只亮在字上),在卡片上用 `lighter`;三张卡按各自屏幕位置算进度 = 同一道光。

## ④ 转场(常用 5 种)

1. **模糊推进(blurPush)**:旧画面缩到 0.92+模糊 24px+淡出,新画面从 1.06 带模糊落到 1.0 清晰,0.55s,`ease`。**底下先垫一层放大 1.08 的重模糊旧画面**,缩小的画面四周才不露黑边。本片镜头 1→2。
2. **共享元素展开(expandRect)**:(新画面第一帧就**不透明**装进卡片——卡片是半透明的,任何溶接都会看到新旧两层字叠在一起)被选中的卡片(先放大到 1.06、两侧卡后退变暗到 45%)从自己的屏幕矩形展开成全屏,圆角 38→0,弹簧 d=0.55 bounce 0;新画面一开始就按卡片大小缩放装在卡里。**选中卡在展开前停止漂浮**,转场才从一个稳定矩形起跳。本片镜头 2→3。
3. **匹配剪辑**:前后两镜同一物体同一位置(产品名 → 卡片标题位置)。
4. **遮罩擦除/光扫切**:一道光扫过时在光带后面换画面。
5. **折射代替淡入淡出**(Liquid Glass):元素出场时逐渐改变折射/模糊强度,而不是直接降透明度(本片字的模糊浮现即此思路)。

## ⑤ 节奏与文字

- **镜头时长**:发布会演讲一屏常 5–8s(Jobs 2007 iPhone 70 秒 9 屏≈7.8s/屏);产品片快剪 1.5–3s。本片 2.6/3.0/2.4s。
- **一屏一件事**:一个名词、一个数字、一张卡。密集段落后放一屏空的给观众喘气(Presentation Zen 说的 counterweight)。
- **与口播对位**:名词说出前 0.2–0.3s 字开始浮现(浮现本身要 0.7s,说到时正好清晰);数字在口播说出数值时**落定**——计数起点 = 说数字时刻 − 计数时长;三卡依次入场对应「第一、第二、第三」。
- **文字**:标题 ≤6 个字或一个产品名;副标题一句话 ≤16 字;卡片:标题 4 字+一行说明+一个大数字+单位(小一号、灰一级)。

## ⑥ 代码实现要点

> 收进 skill 后(2026-10-04 v0.4):本卡「新写」里的通用函数已统一进 `scripts/engine/lib/`(名字已换成统一后的 MO / CAM / DG / TY / CH / UI / CL / TOON),示范片自己的代码在 `scripts/engine/demos/t2_keynote_ui/`。库速查和「怎么为一段口播选语法」见 `references/09-视频动画语法.md`。

- 复用 skill:`engine.js`、`render.py`、`PAINT.cached/hex`、`U.rng`。
- 新写、现已统一进库 `lib/ui.js`(`window.UI`):`mesh`(光斑底)、`grainTex`、`backdrop`(模糊副本,毛玻璃取样)、`shadow`(只画影子)、`glass`(毛玻璃卡)、`sheen`(光扫过,`comp` 可选)、`persp`(绕 Y/X 轴伪 3D)、`icon`、`rr/rrPath`、`scratch`。
- `lib/motion.js`:`spring/smoothSpring/snappy/bouncy`、`bezier/appleOut/emphasized`、`float`;数字与文字在 `lib/typo.js`:`TY.count/tabular`、`TY.blurIn`(实验时叫 MO.textIn)。
- 转场(实验时在 `transitions_info.js`,现已进 `transitions.js`):`blurPush`、`expandRect`。
- 性能:每帧画一次光斑(1/4 尺寸)+一次背景模糊副本,均 40–60ms/帧(qa 带 GPU flush);8 秒 60fps 渲完约 1 分钟。
- 坑(已修进库里):①**blur 会从画布外拉进透明像素**,画进不清空的离屏会逐帧累积,qa 报确定性 ✗——先垫一层不模糊原图;②透视切片相邻重叠 0.75px 在半透明纹理上出一条条纹——切片边界取整像素首尾相接,并先画进离屏再整体按 alpha 贴回;③`UI.sheen` 内部设了合成模式,会盖掉外面设的 `source-atop`,所以做成参数。

## ⑦ 代表作品与一手参考

- 代表作:Apple iPhone/Apple Intelligence 发布片与 apple.com 产品页;OpenAI GPT-4o / o 系列发布视频;Linear 官网与 Linear Release 视频;Stripe 2020–21 官网渐变。
- https://developer.apple.com/videos/play/wwdc2023/10158/ (Animate with springs:duration/bounce)
- https://developer.apple.com/videos/play/wwdc2018/803/ (Designing Fluid Interfaces:从 100% 阻尼起步)
- https://developer.apple.com/videos/play/wwdc2025/219/ (Meet Liquid Glass)
- https://developer.apple.com/design/human-interface-guidelines/materials 、/motion 、/typography
- https://www.nngroup.com/articles/glassmorphism/
- https://web.archive.org/web/20211015000000/https://stripe.com/ (渐变色值)
- https://stripe.com/blog/connect-front-end-experience (<500ms、曲线)
- https://linear.app/now/how-we-redesigned-the-linear-ui (LCH 色彩、Inter)

## ⑧ 最容易做错的 3 件事

1. **玻璃后面没东西。** 毛玻璃只模糊它后面的内容;深色纯底上的「玻璃」就是一块灰矩形。先画有色彩、有起伏的光斑,再按卡片屏幕位置取样模糊。
2. **弹簧太弹、动作太多。** bounce 默认 0,入场最多 0.15–0.3;>0.4 立刻廉价。一次只动一组东西。
3. **大字没收紧字距、光斑颜色发脏。** 64px 以上 −0.015~−0.03em;光斑每团颜色各占一块(screen 叠加+大模糊),别把多色线性平均成灰紫泥。

## qa 数字(skill `scripts/qa.py`,2026-10-04,审片前)

| 镜头 | 运动% | 静止帧对% | 跳变 | 均/峰 ms | 确定性 |
|---|---|---|---|---|---|
| t2_s1 | 0.58 | 35.4 | 0 | 39.8/51.4 | ✓ |
| t2_s2 | 2.62 | 8.5 | 0 | 60.2/65.0 | ✓ |
| t2_s3 | 1.84 | 9.6 | 0 | 44.3/51.0 | ✓ |

说明:t2_s1 的「静止帧对 35%」来自示范片的光斑漂移和 4.5% 匀速推(旧做法),每帧变化低于 qa 的像素阈值(>12 级),隔 1 秒取两帧(成片 1.6s vs 2.6s)有 26.8% 的像素变化超过 12 级、78% 超过 4 级。静止帧对高低都不说明好坏:脉冲节奏的片子大段停住是对的,匀速慢漂的片子静止帧对很低照样像翻 PPT。

## 修订(独立审片 → 改一轮,2026-10-04)

| 审片意见 | 改法 |
|---|---|
| 🔴 2.55–2.75s、5.6–5.85s 转场四周露黑边 | blurPush / expandRect 底下垫一层放大 1.08、模糊 30px 的旧画面 |
| 🔴 卡片展开时「长期记忆」「100万」两层叠影;展开后又从 0 重数 | 新画面第一帧不透明装进卡片;全屏页沿用「100万 tokens」同一口径,不重数 |
| 🔴 6.95s 计数一帧从 999,023 跳到 1,000,000,「tokens」被挤 | 随上条删掉重复计数;单位按三段实测宽度排版,不再贴字 |
| 🟡 落版只出现 0.4s、y≈1020 出安全区 | 落版 1.2–1.8s 浮现、停 0.6s,y=972;对话面板整体上移 65px |
| ⚪ 卡片「100万」与全屏「1,000,000」口径不一 | 统一为「100万」 |

修订后 qa:

| 镜头 | 运动% | 静止帧对% | 跳变 | 均/峰 ms | 确定性 |
|---|---|---|---|---|---|
| t2_s1 | 0.58 | 35.4 | 0 | 39.5/51.6 | ✓ |
| t2_s2 | 2.62 | 8.5 | 0 | 57.2/59.9 | ✓ |
| t2_s3 | 0.97 | 15.4 | 0 | 43.0/48.7 | ✓ |

(转场冒烟:blurPush 最慢约 137ms/帧,含两次全屏模糊。)

---

<a id="t3_finance_chart"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/动画语法/t3_finance_chart.md

# t3_finance_chart · 财经数据图表动画

> 一句话语法:**先搭坐标系、再让数据「长」出来、最后只标一件事;一个颜色讲主角、其余变灰;数值永远诚实(柱从 0 起、单位和来源写在图上),动画只决定「怎么出现」,不改变「是多少」。**
>
> 示范片:`scripts/engine/demos/t3_finance_chart/`(渲染 `render.py --film demos/t3_finance_chart`)(8s,3 镜头,数据全部虚构,每镜右下角「示意数据」)· 总览 `assets/动画语法/t3_finance_chart_总览.jpg` · 代码 `scripts/engine/demos/t3_finance_chart/`

## 起手必查

1. **每张图先写出它的那「一件事」。** 标题就是这句结论,标注只标它;写不出这一句的图不做,改用一个大数字或换语法。
2. **数字口径能互推。** 标题里的倍数要能从图上的数算出来(a ÷ b 写在标注里);两镜之间的同一个数必须对得上;「涨到」和「涨了」分清。
3. **数据长出的时刻对口播里那个词。** 柱状图写多个 bar cue,各带 `data.index`,让每根柱子在说到它时才长;不要第 0 秒先出标题、再一口气全长完。
4. **落定后停住。** 数字落定后至少停 0.5 秒,不加匀速慢推;要看局部就在口播点到那里时快推 0.28 秒推近 18–32% 后停,或用 `zoomThrough` 推进到那个点。
5. **同一版式不连用 3 张以上。** 细红线+标题+图连续 3 张就是翻报表;中间插一次推进到局部、一个砸入的大数字,或切回真实素材。
6. **图表留在片子的世界里。** 图表镜头的底和前后镜头同色系:深色片写 `theme: "dark"`,或者把片子的底色写进 `safe.fill`(图表底自动跟它,深色换浅字);白底报表只用在本来就是白纸、网页的片子里。更好的是把图表画在片子世界里的物上:`--alpha` 出透明片段,贴到画里的屏幕、黑板、一张纸上。夜景片里突然切一张白底折线图、顶上一行固定标题,审片会说「和全片断开」。

## ① 适用场景

- **用**:营收/利润/用户数的增长、股价走势、市场份额排名变化(bar chart race)、地区对比(地图着色)、某个事件前后的拐点。口播里出现**具体数字、时间、比较**(「五年涨了 8.7 倍」「2023 年 3 月之后」)时。
- **用**:需要「可信」的段落——观众会截图转发、会较真。
- **别用**:只有一个数(直接大字报,用 t2 的计数);数据本身不可靠或你不愿标来源时(宁可不做图);讲原理(用 t1)。

## ② 画面构成

| 项 | 取值 | 依据 |
|---|---|---|
| 底 | 白 `#FFFFFF`(经济学人网页图);或 FT 三文鱼粉 `#FFF1E5`;深色片用 `theme: "dark"`(`#0E1116` 底、浅字、青色主柱) | Economist 2017 图表风格指南;FT o-colors 源码 |
| 版式 | **顶部细红线(8px)+左上红色小旗(96×22)+粗体标题(一句结论)+副标题(指标、单位)+左下来源** | Economist 风格指南版面示例 |
| 主色板 | ECON RED `#E3120B`、蓝 `#006BA2`、青 `#3EBCD2`、绿 `#379A8B`、黄 `#EBB434`、灰 `#758D99`、黑 `#0C0C0C` | Economist 图表色板 |
| 强调法 | **一个颜色讲主角,其余变浅灰**(本片:最后一根柱保持蓝,其余过渡到 `#C6D2D8`) | Datawrapper「用灰压住次要数据」 |
| 网格 | 只有水平网格,细灰(本片 α0.13、1.5px);**只有零基线是黑实线**(3px);y 轴刻度值放右侧网格线上方 | Economist 风格指南 |
| 字体 | 经济学人用 Econ Sans(Cnd);本片用 Roboto Condensed(数字)+思源黑(中文)。标题 700、副标题/轴 400;轴字最小、来源最小最浅(75% 黑) | 同上 |
| 涨跌色 | **中国大陆 A 股:红涨绿跌**(本片);香港与欧美:绿涨红跌。面向中文观众必须在图上写明「红涨绿跌」;色盲友好替代:蓝/橙+▲▼符号 | Jiang 等 2014(JBDM);Bloomberg 终端色盲模式 |
| 线宽 | 主数据线 5px(本片)、均线 4px;标注引线 2px | — |
| 形状语言 | 矩形柱、折线+末端圆点、K 线实体+影线、小圆点+引线标注 | — |

## ③ 运动轨迹

- **顺序(staging)**:版式 0–0.5s → 网格从左往右逐条画出(lag 0.12,easeOutQuint)→ x 轴标签依次淡入上移 → 数据 → 强调色变化 → 标注。每阶段约 0.5–1.3s。Heer & Robertson 2007:复杂变化要分阶段、一律缓入缓出、单步「需要多长就多长」约 1s;先坐标轴后数据是行业惯例(无实证研究,但它让观众先知道「尺子」再看「量」)。
- **柱**:从 0 基线长出,easeOutQuint,依次错开(lag 0.22,共 1.3s);数值标签跟着柱顶走、同步计数(`CH.bars`)。
- **折线**:按 **x(时间)** 推进画出,不按弧长——时间匀速流过,陡峭段自然画得快,读得出「暴涨」;头部 9px 圆点+价格标签跟随(等宽数字);面积渐变 α0.14→0。本片 1.5s,smooth(最后一个价格「落」在点上)。D3 官方示例是 5000ms linear,适合独立图表,视频里压到 1.5–2s。
- **标注**:在线头**经过**事件点的那一刻触发(`tHit` 由缓动反函数算出)——圆点弹出(spring d0.45 bounce0.25)+一圈脉冲 → 0.12s 后引线画出 → 0.3s 后文字淡入。**一镜只标一件事**。
- **K 线**:逐根出现(lag 0.06,0.2–1.3s),实体从开盘价长到收盘价、影线随后展开;成交量柱同步;右上价格跟着「最新出现的那根」滚动,颜色按相对区间起点的涨跌。
- **数字**:count-up 用 easeOutExpo(CountUp.js 默认 2s;视频里 0.9–1.3s);所有滚动数字等宽排布防抖。
- **相机(脉冲节奏)**:图表落定后相机停住,不加匀速慢推;镜头动作放在口播点到某个数据的那一刻:快推 0.28 秒推近 18–32% 后停,或同倍率横移 0.30 秒到下一组数据;推近转场期间相机继续矢量推近(不放大位图)。示范片每镜匀速推 1→1.03 是旧做法,新片不照抄。
- **排名赛跑(本片未用)**:D3 官方 bar chart race 每关键帧 250ms、帧间线性插 10 帧、显示 12 根;换位约 0.5s;名次变化要错开,避免所有柱同时上下乱跳。

## ④ 转场(常用 5 种)

1. **面板横推(slidePush)**:新面板从右推入、旧面板向左推出,中间一道品牌红竖条领路,0.5s,`cubic-bezier(.7,0,.2,1)`。本片镜头 1→2。新面板在推入过程中就开始搭版式(红线生长、标题浮现)。
2. **推进到局部(zoomThrough,live+bScale0)**:相机绕最新数据点推近 6 倍(旧镜头自己矢量重画),新画面(最近 20 日 K 线)从 0.6 倍溶进来,主体(最新一根 K 线)对准推进点。本片镜头 2→3。没有圆形开口时一定要设 `bScale0`,否则新画面会像一张浮在中间的小卡片。
3. **图表间形变(morph)**:同一数据换图形(柱→点→线),先移动到位、再变形(Heer & Robertson:散点→柱先横移再变形;堆叠→分组先改宽再落下)。**不同指标之间不要 morph**(营收柱变成股价线会暗示二者同量纲)。
4. **坐标轴重标**:数据范围变了先变刻度(旧刻度淡出、新刻度淡入),再动数据。
5. **硬切+版式不动**:同一版式换一张图,红线/标题位置不变,只换内容——经济学人视频最常用。

## ⑤ 节奏与文字

- **镜头时长**:一张图 2.5–6s;本片 2.8/2.7/2.5s 是压缩版(真用时一张图配一到两句口播)。叙事结构:铺垫(Establisher)→ 引发 → 高潮(Peak)→ 收束(Amini 等 2015,50 支专业数据视频)。
- **与口播对位**:数字**说出时正好落定**——柱长完、标签停在 107.9 的那一刻对上「一百零七点九亿」;标注在线头经过事件时弹出,对上「2023 年 3 月发布大模型之后」。所以先定口播时间点,再倒推动画起点。
- **文字**:标题写结论(「营收五年涨到原来的近 9 倍」——**「涨到」不是「涨了」**:8.7 倍是涨到原来的 8.7 倍=涨了 7.7 倍,审片抓到过),副标题写指标与单位(「年营收,亿元」);倍数要能从图上数字算出来(107.9÷12.4=8.70);轴不从 0 时写在副标题(「纵轴未从 0 开始」);来源一行左下;虚构数据右下「示意数据」角标每镜都在。

## ⑥ 代码实现要点

> 收进 skill 后(2026-10-04 v0.4):本卡「新写」里的通用函数已统一进 `scripts/engine/lib/`(名字已换成统一后的 MO / CAM / DG / TY / CH / UI / CL / TOON),示范片自己的代码在 `scripts/engine/demos/t3_finance_chart/`。库速查和「怎么为一段口播选语法」见 `references/09-视频动画语法.md`。

- 复用 skill:`engine.js`、`render.py`、`U.rng`(虚构数据全部种子生成,可复现)、`PAINT.hex`。
- 新写 `lib/chart.js`(`window.CH`):`lin`(比例尺,带 `inv`)、`ticks`(1/2/2.5/5×10ᵏ 刻度)、`grid`(网格逐条画出、零线加粗、刻度值右置)、`xLabels`、`bars`(从 0 长出+同步计数+高亮/变灰)、`line`(按 x 推进、头部点、面积)、`yAt`、`candles`(逐根 K 线,涨跌色可配)、`callout`(点→引线→文字)、`tag`(红色小旗)、`demoBadge`(示意数据角标)、`mixHex`。
- `lib/motion.js`:`lagged`、`quintOut/expoOut`(实验时叫 easeOutQuint/easeOutExpo)、`spring`(标注圆点);`TY.count/tabular/fmt`。
- 转场(已进 `transitions.js`):`slidePush`、`zoomThrough`(live、bScale0、focus)。
- 事件触发时刻:`tHit = 起点 + 时长 × smooth⁻¹(事件x占比)`(二分求反函数),标注永远和线头同步,改了线的时长不用手调。

## ⑦ 代表作品与一手参考

- 代表作:The Economist 网页图表与视频;FT 图表;Bloomberg Originals / Quicktake 的数据段;Flourish 的 bar chart race。
- Economist 图表风格指南 2017(镜像):https://sa.ipaa.org.au/wp-content/uploads/2026/02/Economist-CHARTstyleguide_20170505.pdf
- FT 色板源码:https://unpkg.com/@financial-times/o-colors/src/scss/_palette.scss
- Heer & Robertson 2007, Animated Transitions in Statistical Data Graphics:https://idl.cs.washington.edu/files/2007-AnimatedTransitions-InfoVis.pdf
- D3 bar chart race:https://observablehq.com/@d3/bar-chart-race-explained
- Correll 等 2020(截断坐标轴的夸大效应,断轴标记也救不回来):https://arxiv.org/abs/1907.02035
- Datawrapper:柱从零 https://www.datawrapper.de/academy/why-our-column-and-bar-charts-start-at-zero ;双轴 https://www.datawrapper.de/blog/dualaxis ;色盲 https://www.datawrapper.de/blog/colorblindness-part2
- 红涨绿跌的文化差异:https://onlinelibrary.wiley.com/doi/10.1002/bdm.1800
- CountUp.js(easeOutExpo、2s):https://github.com/inorganik/countUp.js

## ⑧ 最容易做错的 3 件事

1. **截断坐标轴。** 柱状图一律从 0;折线和 K 线可以不从 0,但要在图上写明。Tufte 的 Lie Factor(图上效应÷数据效应)超出 0.95–1.05 就算失真。
2. **颜色太多、全部都是主角。** 一个颜色讲故事,其余变灰;红绿含义面向谁要写清(A 股红涨,欧美红跌)。
3. **动画太花读不出数。** 不要弹跳柱、3D 柱、旋转饼图;分阶段、缓入缓出、一步约 1s;数字落定后至少停 0.5s 让人读。

## qa 数字(skill `scripts/qa.py`,2026-10-04,审片前)

| 镜头 | 运动% | 静止帧对% | 跳变 | 均/峰 ms | 确定性 |
|---|---|---|---|---|---|
| t3_s1 | 1.39 | 0.0 | 3 | 1.3/1.9 | ✓ |
| t3_s2 | 2.37 | 4.7 | 0 | 1.9/2.8 | ✓ |
| t3_s3 | 0.96 | 0.0 | 0 | 1.6/2.3 | ✓ |

说明:t3_s1 的 3 个「跳变」在 lt 2.10/2.20/2.27s,正是四根柱同时由蓝变灰(高亮主角)和标注弹出的那几帧——有意的大面积变化,不是穿帮。

## 修订(独立审片 → 改一轮,2026-10-04)

| 审片意见 | 改法 |
|---|---|
| 🔴 标题「涨了近 9 倍」与标注 8.7 倍口径错(应为「涨到」) | 改为「营收五年涨到原来的近 9 倍」;股价页同口径「涨到原来的 7.5 倍」 |
| 🔴 月线终点 ¥268 与日 K 286.40 对不上(推镜推的就是这个点) | 月线末点 = 最新价 286.4,倒数第二个月收盘 = 日 K 起点 242;**两镜之间的数字必须能互相推出来** |
| 🟡 5.6s「¥268」和计数中的价格两个大红数叠影 | 股价头部标签在推进转场开始 0.2s 内收掉 |
| 🟡 「成交量」压 K 线、量柱顶到 240 网格线 | 标签移到右下空处;量柱按最大量归一,留 6px 间隙 |
| 🟡 日 K 页 2 秒读不完 | 删 5 日均线;K 线 1.3s 出完、括注 1.75s 落定、停 0.75s |
| ⚪ 红涨绿跌与品牌红撞色 | 保留(面向 A 股观众),副标题写「红涨绿跌(A 股惯例)」;做海外版换绿涨或蓝/橙 |

修订后 qa:

| 镜头 | 运动% | 静止帧对% | 跳变 | 均/峰 ms | 确定性 |
|---|---|---|---|---|---|
| t3_s1 | 1.44 | 0.0 | 3 | 1.3/1.7 | ✓ |
| t3_s2 | 2.45 | 4.7 | 0 | 1.9/2.6 | ✓ |
| t3_s3 | 0.91 | 0.0 | 0 | 1.7/2.9 | ✓ |

---

<a id="y1_kurzgesagt"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/动画语法/y1_kurzgesagt.md

# Y1 · Kurzgesagt 扁平科普:视频动画语法卡

一句话:把一个抽象概念画成一个具体的物,放进能无限缩放的发光世界里,相机在尺度之间穿行;环境层(星、粒子)可以一直轻轻动,主体和信息在口播节点上发生变化,落定后停住。

示范片:`scripts/engine/demos/y1_kurzgesagt/`(渲染 `render.py --film demos/y1_kurzgesagt`)(8s,3 镜 2 转场),总览:`assets/动画语法/y1_kurzgesagt_总览.jpg`
依据:本风格的调研(调研原文与逐帧数据留在实验归档、没收进 skill,用到的数字已摘进本卡)(2025 两支正片+2014《免疫系统》实测,官方 Skillshare 课逐字稿)。标【实测】【一手】的数字出自那里,标【本片】的是示范片里实际用的参数。

## 起手必查

1. **先写这一段的视觉隐喻:抽象概念画成什么物**(细胞、齿轮、管道、城市、一滴水……)。写不出物的那一句,不要只放一颗发光的球加几个标签胶囊。
2. **示范片和样例里的橙色中心星球是一种画法,不是这个语法的签名。** 中心物按题材换形状和颜色。参数化片段 y1 的中心物由 spec 定:`data.center_style`(颜色、形状、要不要轨道环)或 `data.image`(把一张真实图片裁进中心物),不写就按名字生成一个中性样式,不再是那颗橙色星球。它只会画「中心物+卫星节点」,适合「里面有什么」的分层讲法;题材不是这个结构,就自己写镜头(`demos/y1_kurzgesagt/` 和 `lib/` 的 `CAM`、`TOON`),或换语法。
3. **每句旁白里至少一次状态变化**(弹出、形变、钻入、拉远)。逐句数一遍:连续两句画面没变,就补一个事件,不靠浮动和慢推凑。
4. **主体落定后停住。** 环境层(星闪、粒子漂、远景云)可以一直轻轻动;主体和标签不加浮动、呼吸,不用匀速慢推填停顿。
5. **钻进去之前先停一下。** 尺度转场前让要钻的那个物停 0.3 秒以上、亮起来,观众知道下一步进的是哪一个;缩放用对数插值(`CAM.zlerp`)。

---

## ① 适用场景

**用它:**
- 讲尺度、讲「里面是什么」的内容:从细胞到星系、从一个像素到一个模型,或者「放大看会发现……」。尺度转场是这个风格的标配。
- 讲机制、讲系统:神经网络、免疫系统、能量流。最适合把看不见的过程画成发光的粒子和连线。
- 口播是平稳、娓娓道来的科普腔。Kurzgesagt 约 168 词/分,一个硬切镜头大约配 2 句话【实测】。
- 需要「严肃但可爱」的语气,可以用一个吉祥物或鸟群出来讲笑点。

**别用它:**
- 讲真实人物、真实事件、档案证据:扁平卡通会把可信度冲淡,这种内容用 Y2 拼贴。
- 讲步骤、讲推理链:一步一步写出来更好懂,用 Y3 白板。
- 制作预算很小的时候。这个风格的质量全靠「每一帧都有东西在动」,官方单片要 1200 小时以上【一手】。偷工减料的 Kurzgesagt 看起来就是廉价 PPT。

## ② 画面构成

- **先选年代**。2025 年是深色系:暗像素占 61–68%,饱和度中位 0.84–0.89。2014 年是浅灰白底、低饱和。两者不能混【实测】。示范片前两镜用 2025 深色系,第三镜白天用明亮系,模仿他们「换段落就换一整套色温」的做法。
- **色板**(2025 深色系,实测取色):
  - 底:`#05020F` / `#0E0631` / `#25155E`
  - 次底:`#191670`、`#3826A3`、`#5F58DB`
  - 强调青:`#32BAEE`、`#7DD3DC`
  - 强调橙黄(发光体):`#F48301`、`#E07919`、`#FACC12`,辉光芯 `#F9EF93`
  - 品红:`#BE3A95`、`#C83C7F`
  - 高光与白字:`#E7DFE1`、`#F9FCFB`
  - 规律:一个深底配 2–3 个高饱和强调色,强调色互为对比(橙黄对靛紫、青对品红)【实测+归纳】
  - **上面这套深紫底只是拆解记录,成片不要照抄。** 作者看过多支 AI 做的片子,原话是「我们需要规避下蓝、紫渐变的垃圾配色,这种非常ai slop」;深紫星空底正是这类片子最常见的一眼 AI 味,`deliver.py` 会量蓝紫底并红灯。要深色系就用 `references/色板.md` 的 `ink`(深墨)或 `navy`(海军蓝平涂),保留「一个深底配 2–3 个高饱和强调色」的规律;参数化片段 y1 写 `"theme"` 即可,不写时默认是深墨平涂。
- **形状语言**:
  - 不描边。阴影用同色相深一档的色块,高光是白色椭圆或一条弧线【归纳】。
  - 圆角无处不在。生物是团状有机形,角色头是圆的,四肢是圆头管。
  - 发光体必带径向辉光。暗底存在的意义就是让辉光成立。
- **【本片】双色分面**:`flat(c, path, 本色, 阴影色, 高光色, v, w)`。在形状内部做两次平移:右下留一条阴影带,左上留一条细高光边。v≈(10,12)px,w≈(4,5)px。花叔的每个部件也走这一道,所以他和场景是同一种画法,不像贴上去的。
- **构图**:主体放在画面中部偏下的三分线上,上方留天空给星星和标注。场景分 5–6 层视差:星空 d=0.05、月亮 0.12、远山 0.3、近坡 0.65、主体 1.0、前景叶片 1.5(近景虚、暗)。官方没公开层数,实测是 2–5 层【归纳】。
- **角色**:
  - Kurzgesagt 鸟:蛋形身体,大白眼,小黑瞳偏前,橙色三角喙。翅膀是比身体深一档的叶形,每只鸟换一个颜色【一手+归纳】。
  - 【本片】猫是水滴身体加圆头,三角耳带品红内耳,大白眼;机器人是圆角壳加深色屏幕脸,一只发光镜头眼;花叔用 `HUASHU.build` 的 point 姿势,每个部件都过双色分面。

## ③ 运动轨迹

- **官方缓动**【一手,Skillshare】:
  - 常规动作 50 帧(60fps 下 0.83s)。想利落用 30/20/10 帧,弹出用 5–10 帧。
  - 循环动作用 Easy Ease 33.3%,约等于 `cubic-bezier(.333,0,.667,1)`。
  - 其他动作用 75% influence,约等于 `cubic-bezier(.75,0,.25,1)`:起步很软,中段快,收尾很软。
- **弹出**【实测】:卡片在 0.25s 内长到 90%,第 20 帧过冲到 108%(探测器卡是 114%),约 0.5s 回到 100%。
  - 【本片】识别标签用 `backOut(q, 1.1)`,时长 0.5s。
- **错开**:同类元素错开 10–20 帧,肢体之间错开 3–4 帧,动作之间停 20 帧【一手】。
  - 【本片】标题逐字错开 45ms、单字 0.5s cubicOut。像素猫 144 块按到中心的距离错开 35ms/格,每块 0.5s backOut(1.4) 从四周飞入。神经网络逐层点亮,间隔 0.32s,节点弹一下 0.35s。
- **环境微动与主体停顿**:2025 片里 0.5s 内完全不动的时段只占 0.3%【实测】,动的主要是环境层(星闪、粒子漂、辉光)和正在讲的那件事。
  - 解说类镜头:主体和信息元素落定后静止,动作放在口播节点上(弹出、形变、推进、钻入)。
  - 纯氛围镜头(片头、换段的喘气处)可以保留轻微环境动:星星闪、粒子漂、远景慢慢移。
  - 眨眼 5 帧闭、10 帧开,间隔不规则,**眼睛不缩到 0**【一手】。
  - 【本片】星星 170 颗,各自相位闪烁 1–3.5 rad/s。前景叶片 `blur(7px)` 虚焦,做景深。机器人上下浮 ±12px,喷射光用 23/37Hz 双正弦抖。猫尾两段贝塞尔摆。草叶 2.1 rad/s 摆。萤火粒子在 0.8–1.3 层漂。信号脉冲沿连线持续循环。
- **相机**【实测】:
  - 2025 片里约 1/3 的时间在缩放,平移约 10%,旋转约 5%,拉远多于推进。缩放大多是尺度穿行和揭示,不是填停顿。
  - 新片用脉冲节奏:停住 → 快推 0.28 秒推近 18–32% → 停住;同倍率横移 0.30 秒;砸入 0.17 秒(1.55→0.94→1.0);停多久按口播。尺度穿行另按 ④ 的时长。
  - 【本片】镜 1 用了 2.6s 匀速推 1.00→1.10,是旧做法,新片不照抄。

## ④ 转场(常用 6 种)

1. **推进穿越 → 物体颜色铺满 → 新场景**(尺度转场的标准写法)。
   - 实测:免疫 1:48,约 1.4s,先加速后减速,峰值在中段。
   - 【本片】转场 B:
     - 相机对数插值推进点亮的输出节点(0.45s,cubicIn),直到满屏黄。
     - 在中点 ±3 帧溶到机器人发黄光的眼睛。两边的高光点都在左上,剪点看不出来。
     - 再用 cubicInOut 1.45s 拉远(42→1),落进白天的新色板。
     - 不要用 expoOut:它起步斜率太大,第一帧就跳掉一大半尺度。
2. **钻进物体,物体里是下一个世界**(穿越的变体)。
   - 【本片】转场 A,1.0s:相机按 `bezier(.75,0,.25,1)` 对数推进机器人镜头(1.1→60)。下一镜只露在「镜头圆」里,圆随推进长大到盖满屏幕,圆边有一圈青色光环。下一镜同时从 0.42 倍 expoOut 浮出。
3. **快速拉远揭示**:0.2–2s,起步快、长尾收(实测每 0.2s 缩放 1.074→1.040→…→1.0006)。用来连接微观和宏观。
4. **光或闪光铺满画面**:用画面里的光源做白场,约 0.5s。
5. **扫掠擦除**:物体或光带斜扫过画面,带速度线,约 0.4s。
6. **复制增殖到铺满**:用于「数量多到……」,3–6s。

另外两点【实测】:
- 硬切比例很低,每分钟约 5 个,跟着旁白句首走,比句首早 0–0.2s。
- 其余换画面多数是 0.3–0.6s 的设计转场,每 4.6–6.7s 一次。

## ⑤ 节奏与文字

- **镜头时长**【实测】:
  - 硬切镜头中位 7–9s,均值约 11.5s。
  - 但「视觉单元」每 4.6–6.7s 就换一次,靠设计转场换。
  - 每句旁白里至少有一次状态变化:弹标签、换标注、形变或转场。
- **和口播对齐**:以旁白句子的时间戳为骨架,硬切放在新句首前 0–0.2s【实测】。配乐是成片后再作曲的(Epic Mountain)【一手】。
- **文字**:
  - 标注是先画一条细白引线,再逐字打出文字,约 40 字符/秒;一句旁白对一个标注,停约 3s 后逐字擦掉【实测】。
  - 章节标题卡每 2–3 分钟一张,全屏,逐词出现,背景虚化。
  - 标签胶囊是大圆角,填饱和纯色,里面是粗体无衬线字。
- **【本片】**:
  - 8s 里放 3 镜,是正常节奏的约 3 倍密度,只为在演示里看全语法。真片请按 7–9s 一镜。
  - 标题用 PuHui-Heavy 76px,逐字上浮。
  - 层标签用 PuHui-Medium 40px,配下划线伸出。

## ⑥ 代码实现要点

> 收进 skill 后(2026-10-04 v0.4):本卡「新写」里的通用函数已统一进 `scripts/engine/lib/`(名字已换成统一后的 MO / CAM / DG / TY / CH / UI / CL / TOON),示范片自己的代码在 `scripts/engine/demos/y1_kurzgesagt/`。库速查和「怎么为一段口播选语法」见 `references/09-视频动画语法.md`。

- 复用 skill:
  - `PAINT.cached`、`U.rng`:确定性
  - `RIG.smooth`:把点列平滑成 Path2D,画猫、山、叶片
  - `HUASHU.build/pose/details`:花叔
  - `PAINT.noise`
  - 引擎的段落表、转场接口、离屏 A/B 缓冲
- 新写、现已统一进库(`lib/camera.js` / `motion.js` / `typo.js`):
  - `CAM.at(keys, t)`:关键帧相机,缩放用对数插值。`CAM.zlerp` 让每帧放大同样的倍数,尺度转场才是匀速穿越。新片的停顿和点名用 `CAM.track`(快推 0.28s、横移 0.30s、砸入 0.17s,其余时间停住),参数化片段 y1 的 highlight 就是这么推的。
  - `CAM.anchor`:缩放时让目标点平滑移到画面中心。
  - `MO.bezier(x1,y1,x2,y2)`:把 AE/CSS 的贝塞尔缓动搬进代码,牛顿法求解。
  - `MO.*`:sine、quint、expo、back、elastic 等。
  - `TY.charsIn`:逐字入场。
- 示范片自己的(`demos/y1_kurzgesagt/kurzgesagt.js`;`flat` 已进库为 `TOON.flat`,`layer` 为 `CAM.layer`):
  - `flat()`:双色分面。
  - `layer(c, cam, d, fn)`:视差层。位移按 d 线性,缩放按 `z^d`,深推时远景几乎不动。
  - `Y1.cat`、`Y1.bot`、`Y1.bird`:三个角色。
  - `Y1.lensAt(t)`:给转场 A 用的镜头圆屏幕坐标。
- **关键架构**:
  - 相机只由全片时间决定。转场窗口里,引擎照常把上一镜继续画进 A 缓冲,上一镜自己算「钻进去」的相机。
  - 所以缩放转场永远是矢量重画,不会把 1920 的位图放大 60 倍糊掉。
  - 转场函数(`transitions.js` 的 `lensReveal`、`matchCut`)只负责「A、B 怎么合」。
- 引擎改动(只改本实验的副本):
  - `eras.js` 的任意段可以写 `dur`(秒)。
  - 拍点镜头冲击改成默认关,`transition.punch:true` 才开。解说片不该有卡点顿挫。

## ⑦ 代表作品与一手参考

- 样片:
  - How Are Memories Stored Inside Your Brain?(2025)https://www.youtube.com/watch?v=PqtggjVAi8M
  - Why Humanity Will Never Leave The Solar System(2025)https://www.youtube.com/watch?v=Cyl3X88KEgg
  - The Immune System Explained I(2014)https://www.youtube.com/watch?v=zQGOcOUBi6s
- 官方课(缓动、循环、鸟、角色动法逐字稿):
  - Skillshare《Motion Graphics with Kurzgesagt》Part 1 https://www.skillshare.com/en/classes/motion-graphics-with-kurzgesagt-part-1/631970755
  - Part 3 https://www.skillshare.com/en/classes/motion-graphics-with-kurzgesagt-part-3/140140401
- 官方幕后:
  - 1200 小时一支片:https://www.youtube.com/watch?v=uFk0mgljtns
  - 官方自述:https://kurzgesagt.org/what-we-do?visit=videos
- 配乐:Epic Mountain https://www.epic-mountain.com

## ⑧ 最容易做错的 3 件事

1. **把「一直在动」做成全员呼吸**。实测 2025 片里不动的时段只占 0.3%,但动的是环境层和正在讲的那件事,不是每个元素都在浮。解说镜头:主体落定后静止,动作放在口播节点上;纯氛围镜头保留星闪、粒子漂这类轻微环境动。靠全员浮动、匀速慢推凑出来的运动,读起来还是 PPT。
2. **缩放用线性插值,或者放大位图**。
   - 线性插值的 z 前慢后猛,穿越感会断。要用对数插值。
   - 把上一镜的截图放大 20 倍会糊成马赛克。必须让场景自己在更大的 z 下重画。
3. **配色亮而杂,或者给东西加描边**。
   - 2025 的 Kurzgesagt 是「深底+2–3 个发光强调色」,靠辉光撑画面。
   - 加黑描边或者用中等亮度的底,就会滑向儿童绘本或企业扁平插画。
   - 阴影用同色相深一档,不要用灰。

---

## 审片与修订(独立 agent 只看成片,7/10)

审片意见和这一轮的处理:
- 「猫、草、山丘带描边,像儿童插画」:草叶从线条改成填色细三角;山丘顶部的亮边压到和本色只差一档。
- 「左下角黑块像脏东西」:前景叶片加 `blur(7px)` 做景深,颜色从近黑提到 `#0E0631`。
- 「标题一帧消失」:改成 0.55s sineInOut 淡出。
- 「镜 3 猫从橙变黑没交代」:橙猫留在花叔脚边当「认识的那只」;黑猫上方先出引线和小字「没见过的猫」,再弹识别标签。
- 「7.8s 鸟穿插机器人」:鸟的高度移到 175/225px。
- 「结尾 7.1–8.0 几乎静止」:示范片当时加了 4%/s 慢推。现在的做法:结尾放一个事件(快速拉远看到全貌,或钻进下一层),之后停住。
- 「3.03–3.10s 像素猫被镜头圆裁掉一半」:没改。这是「钻进镜头」揭开过程的正常状态。

## QA(skill `scripts/qa.py`,2026-10-04,修订后终版)

| 镜 | 量的窗口(镜内秒) | 运动面积% 均/峰 | 静止帧对% | 跳变帧 | 每帧耗时 均/峰 ms | 确定性 |
|---|---|---|---|---|---|---|
| y1_s1 | 0.0–2.58 | 1.57 / 2.58 | 0.0 | 0 | 32.9 / 34.6 | ✓ 逐像素一致 |
| y1_s2 | 1–2.68 | 3.36 / 4.42 | 0.0 | 0 | 6.1 / 7.2 | ✓ 逐像素一致 |
| y1_s3 | 0.9–2.68 | 17.94 / 91.88 | 0.0 | 8(1.04–1.28s 连续) | 11.2 / 16.0 | ✓ 逐像素一致 |

转场冒烟(每个转场渲一遍,最慢一帧):y1_s2(k_lens)48.3ms;y1_s3(k_fill)36ms

读法:
- **镜 3 的 8 个跳变帧**落在 1.04–1.28s,是连续一段,正好是「从机器人眼睛里拉出」42 倍→1 倍的中段,整屏都在缩放,所以运动面积峰值 92%。这是设计内的尺度转场,不是单帧穿帮。
  - 第一版用 expoOut,起步斜率太大,第一帧就从 42 倍跳到 15 倍,审片和 qa 都报了。
  - 改成 cubicInOut,峰值落在中段,和实测 Kurzgesagt「穿越式推进」的形状一致。
- **镜 1 每帧 33ms**:前景叶片加了 `filter: blur(7px)` 做景深,比没虚化前的 9ms 慢,仍远低于 150ms 的上限。
- 运动面积 1.6–3.4% 看起来低,因为 Kurzgesagt 的微动是「很多小东西各自动」:星、粒子、尾巴、浮动、脉冲。实测 2025 片里完全不动的时段只占 0.3%,这里三镜的静止帧对都是 0%,对上了;但静止帧对 0% 只说明环境层在动,不说明讲得好,还要看抽帧是不是一页一页在翻。

复跑:`uv run scripts/qa.py --project scripts/engine --film demos/y1_kurzgesagt --out <目录>`(上表是实验时的数字;收进 skill 后的复跑见 09 号的回归表)。

---

<a id="y2_vox"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/动画语法/y2_vox.md

# Y2 · Vox 式拼贴解说:视频动画语法卡

一句话:把论证摆在一张有真实材料的桌面上——剪报、照片、文件,相机像调查记者的眼睛在桌上移动;线和笔一顿一顿地画上去,证据感来自「这些东西是真的被放在这里的」。

示范片:`scripts/engine/demos/y2_vox/`(渲染 `render.py --film demos/y2_vox`)(8s,3 镜 2 转场),总览:`assets/动画语法/y2_vox_总览.jpg`
依据:本风格的调研(调研原文与逐帧数据留在实验归档、没收进 skill,用到的数字已摘进本卡)。样本 5 支:Missing Chapter(2022)、迷幻海报(2019)、Vox Borders(2018)、Johnny Harris(2026),另有 Vox 2026 实拍片作对照。13 段相机运动拟合了缓动,取了色。

## 起手必查

1. **真实材料当主画面。** 截图、原文、照片铺满或接近铺满,推近到要读的那一句;桌面是相机穿行的世界,不是给小图垫的底色。量一下:素材宽不到画宽 60% 的镜头连续超过 2 个,就是「相框版式」。
2. **「滑入→打字标签→红圈」要轮换。** 分镜时列一张揭示动作表:直接在(随切点出现)、推近、横移到下一张、荧光笔扫、红线连、盖章、撕下……同一套揭示序列连用不超过 3 次。证据:一支长片 37 个标签里有 36 次滑入,到中段观众已经能预判下一步。
3. **要读的字放在最上层、最后画,** 不跟所属物件的层级走。照片、夹子、后放上来的卡盖住字,是这个语法最常复发的穿帮。
4. **相机落点按这一刻要读的东西反算**(框住目标再留边),不手填坐标;半截入画的邻卡标签推出画外。
5. **累积桌面每放一张新卡,把同屏的字按阅读顺序连读一遍。** 两张卡的字挨在一起会拼成一句错话(「超过」贴着「收购」),撤卡或把限定词写全。
6. **同一事件的正式动作只演一次。** 全景示意里演过的动作,推近后不再重演,否则读成「又发生了一次」。

---

## ① 适用场景

**用它:**
- 有真实档案、新闻、历史、地图、人物的内容:「这件事是怎么发生的」「谁在什么时候说了什么」。
- 口播是记者式的论证:引用、证据、因果。旁白里有「看这一句」「注意这个数字」,画面就去高亮那一句。
- 引一句原话、一组数字、一个年份,需要观众「亲眼看到出处」的时刻。
- 示范片用 2012 年 Google「认猫」论文的真实数字:1000 台机器、1.6 万个 CPU 核、1000 万张 YouTube 截图、不打标签。出处是 arXiv:1112.6209 与 Google 官方博客。

**别用它:**
- 纯机制、纯概念、没有任何真实材料可贴的内容。硬做会变成「假档案」,用 Y1。
- 推导和步骤:用 Y3。
- 需要大量角色表演的内容:剪纸角色只能一顿一顿地动。

## ② 画面构成

- **三色体系**(Missing Chapter 实测):
  - 近黑底 `#171716`
  - 纸白 `#E0DCDA`–`#EEEDED`
  - 一种红分两档:亮红 `#B65255` 画线,暗红 `#93403C` 填面
  - 荧光黄 `#DACF08`(比 Vox logo 的 `#FFF200` 更暗、更偏橄榄。logo 黄在片中很少大面积用)
  - 旧地图纸 `#E4DCCF`,羊皮纸 `#CFB195`
  - 没有纯白,没有纯黑。
- **【本片】**:
  - 桌面 `#e4ddcf`,平铺纸纹,有纤维和低频明暗。
  - 线索红用 `#b8433f`,比实测略亮,因为 1080p 下要读得清。
  - 荧光 `rgba(218,207,8,.9)`,叠加方式是 multiply。
  - 镜 3 是桌上的一张大黑卡纸 `#1b1b1a`,四边露出桌面。
- **材料**:
  - 照片一律灰度网点(45°),带白边,贴两条半透明胶带。
  - 剪报是撕边、泛黄,宋体标题。
  - 标签是 Borders 式的黑底白字粗体条(「2012 · 谷歌」)。
  - 索引卡是横线纸。
  - 纸纹是**静态**的。实测停留段帧差是 0.0–0.1,没有逐帧颗粒,那是 Johnny Harris 2026 的底片风,不是 Vox。
- **投影很弱**。黑底卡片在 360p 下几乎看不到投影【实测】。【本片】统一 blur 10、偏移 (3,6)、α 0.28。
- **故意不完美**:Vox 美术总监的原话是「You don't want it to look perfect because that might make it look more like an ad than an editorial piece」【一手】。
- **角色**:真人照片剪下来做贴纸,加白边和阴影。【本片】花叔用 `HUASHU.draw`,把剪影向 16 个方向偏移 12px,垫一层纸白当贴纸边。

## ③ 运动轨迹

- **两层帧率(核心)**【实测】:
  - 相机层是 24fps 平滑运动。
  - 元素层(地图色块生长、红线描路、打字、手绘圈、弹入)按 12fps「一拍二」步进。迷幻海报片里 52% 的运动帧有「动-停-动」交替的指纹。
  - 【本片】相机按 60fps 连续算;所有元素都用 `MO.step(t, 12)` 量化后再算进度。qa 量到镜 1 有 16.9% 的静止帧对,就是一拍二的停帧,不是卡顿。
- **相机缓动**【实测 13 段】:
  - 时长中位 1.29s,范围 0.71–1.96s,**没有一段是线性**。
  - 7 段是对称的 easeInOutSine,相当于 AE 默认 Easy Ease,用于长距离「找下一张卡」。
  - 6 段是起步快、长尾落定,贴近 `cubic-bezier(.33,0,.2,1)`,用于「拉出揭示」和「沿线索追过去」。
- **【本片】相机**:
  - 镜 1:荧光笔扫完后,用 1.5s sineInOut 推向那一行(1.14→1.28)。BD 实测扫完常接一次推进。
  - 转场 A:1.1s 长尾 bezier。
  - 转场 B:推进 0.6s sineInOut。
  - 镜 3:拉出 0.85s 长尾 bezier。
  - 示范片镜 1 开场的 0.9s 慢推(1.14→1.165)和镜 3 拉出后的 1%/s 慢推是旧做法,新片不照抄。
- **入场**【实测】:
  - 档案照片和剪报**随切点直接出现**,不弹、不落。
  - 只有沿时间线追踪时,下一张卡会从画外滑入,带 5–15° 倾斜,到位放平,约 0.8s。
  - 【本片】小照片和花叔贴纸用 `slideIn`:0.55s quartOut,从 12° 倾斜放平,12fps 步进。
- **线与笔**【实测】:
  - 红色下划线 0.5–1s 画完。
  - 红色椭圆圈约 1s,一笔,首尾不闭合、略交叉。
  - 荧光条一行 1.5–3s,跟着旁白念词扫。
  - 打字约 13 字/秒,一拍二。
  - 【本片】红圈 0.65s,荧光 0.9s(演示压缩),打字 13 字/秒,红线每根 0.5s、错开 0.15s,计数器 1.4s cubicOut 滚到 10,000,000。
- **停留时相机停住**:实测停留段帧差 0.0–0.1,Vox 的桌面停下来就是停下来。卡片内部有动画(描线、荧光、打字)时相机不动;纯静态图停得久,就在口播节点上推近要读的那一处(快推 0.28 秒推近 18–32% 后停),或同倍率横移 0.30 秒到下一张,不加匀速慢漂。

## ④ 转场(常用 6 种)

1. **硬切**:占绝大多数,切点卡在旁白句读上【实测】。
2. **沿红线平移(时间线追踪)**:相机沿一条红线水平移动,1.3–1.8s,用长尾缓动;下一张卡从右侧斜着滑入放平。
   - 【本片】转场 A:红线从剪报高亮那行连到调查墙的计数标签,相机 1.1s 追过去,带沿速度方向的短运动模糊(7 次叠加,系数 0.6)。
3. **推进进纸或照片 → 直接切成同一张图的高清扫描**:1.0–1.4s,S 型缓动。
   - 【本片】转场 B:推满墙上那张小照片(对数插值到 z≈9.6);硬切成同一张图的大幅扫描(网点从细变粗,读作「换了一张更清楚的」);再接 3。
4. **从单张照片拉出 → 露出整面拼贴**:约 1.0s,起步快、长尾(实测 MC 2:30)。
5. **地图色块生长、路线描线**:2.5–3.5s,一拍二,线头带实心红点。
6. **真手翻页、抽纸**(Missing Chapter 的标志):代码里可以近似成「纸沿弧线滑入,带阴影变化」。

**注意**:「撕纸转场」在 5 支样片里一次都没出现。它是模板网站的常见做法,不是 Vox 语法。本片第一版用了撕纸,看过调研后换掉了。

## ⑤ 节奏与文字

- **镜头时长**【实测,拼贴段】:
  - 分两档:慢档(Missing Chapter)中位 3.3s,约 12 切/分,一张卡停 3–7s,靠卡内的描线和高亮撑场。
  - 快档(迷幻海报 1.8s、Johnny Harris 1.4s)约 25–33 切/分,图几乎不动,靠切换出节奏。
- **和口播对齐**:
  - 荧光条、打字、描线的速度锁在念词速度上,不锁音乐拍点。
  - Johnny Harris 的说法是「Each word must correspond to a movement or action within the animation」,他的脚本分两栏写【一手】。
  - Joss Fong 约每 20s 换一段音乐【一手】。
- **文字**:
  - 人名、地点用衬线小字,白字放在照片下方。
  - 黑底时间线标题逐字打出,13 字/秒,配一条横贯画面的红线。
  - 引文用手写体「墨水洇开」式浮现,约 2s,然后红条逐行跟读【实测】。
  - 【本片】剪报和卡片用 Songti SC,大标签用 PuHui-Heavy,数字用 Anton。

## ⑥ 代码实现要点

> 收进 skill 后(2026-10-04 v0.4):本卡「新写」里的通用函数已统一进 `scripts/engine/lib/`(名字已换成统一后的 MO / CAM / DG / TY / CH / UI / CL / TOON),示范片自己的代码在 `scripts/engine/demos/y2_vox/`。库速查和「怎么为一段口播选语法」见 `references/09-视频动画语法.md`。

- 复用 skill:
  - `PAINT.cached`、`PAINT.scratch`:所有纸片、照片、剪报都一次画成精灵图
  - `PAINT.grain`:静态颗粒
  - `PAINT.noise/fbm`
  - `KIT.densify/resample`:手画圈
  - `HUASHU.build/pose/draw`
  - 引擎转场接口
- 新写、现已统一进库(`lib/collage.js` / `camera.js` / `diagram.js` / `motion.js`):
  - `MO.step(t,12)`:一拍二。
  - `CL.paperTile`:可平铺纸纹,在环面上取样所以无缝,带纤维。
  - `CL.halftone`:灰度转 45° 网点,批成一条 path 一次 fill。
  - `CL.tornEdge`:撕边。
  - `DG.hand / DG.drawPartial / DG.cum`:手画线,按长度描出。
  - `CAM.motionBlur`:沿速度方向叠帧。
  - 新片的真实素材件:`MD.print`(冲印件:白边、旧纸色、投影、胶带,可按焦点裁)、`MD.label`(黑底撕边标签,12fps 打字)、`MD.cover`(满幅铺开+焦点+推近,硬切到实拍时用);镜头用 `CAM.track` 的横移、快推。参数化片段 y2 已经换成这一套:照片占画面八九成,镜头 0.30 秒横移到下一件、highlight 快推 0.28 秒,不慢推。
  - `MO.bezier`:长尾缓动 `(.33,0,.2,1)`。
- 示范片自己的(`demos/y2_vox/vox.js`;`slideIn / highlight / stringPts` 已进库为 `CL.slideIn / CL.highlight / CL.stringPts`):
  - `slideIn`:倾斜滑入放平。
  - `highlight`:荧光毛边带,multiply。
  - `stringPts`:带下垂的红线。
  - `deskCam`:桌面相机关键帧,加末段推进。
- **关键架构**:
  - 镜 1、镜 2 是同一张桌面世界、同一台相机。转场 A 用 `same`(A、B 本来就是同一幅画),平移完全由相机完成。
  - 镜 3 是桌上的大黑卡纸。转场 B 用 `cut`,在推满的那一帧切。
- **性能**:镜 3 每帧 73/89ms(均/峰),花叔贴纸每帧要做 16 次偏移垫边。可以把贴纸边缓存起来,只在 12fps 换姿势时重算。

## ⑦ 代表作品与一手参考

- 样片:
  - Missing Chapter《The case to rename this famous Christmas plant》https://www.youtube.com/watch?v=lLSUjl4WatY
  - 《Where the 1960s "psychedelic" look came from》https://www.youtube.com/watch?v=9vuqI2v2IRs
  - Vox Borders《China is erasing its border with Hong Kong》https://www.youtube.com/watch?v=MQyxG4vTyZ8
  - Johnny Harris《The Internet Didn't Fail. It Was Taken.》https://www.youtube.com/watch?v=0rKDo3hKbVk
- 一手:
  - Vox 美术总监 Joey Sendaydiego 访谈 https://www.storybench.org/how-vox-uses-animation-to-make-complicated-topics-digestible-for-everyone/
  - Joss Fong 访谈 https://www.theopennotebook.com/2020/01/07/videogram-how-a-vox-video-explains-the-science-behind-the-first-photo-of-a-black-hole/
  - Johnny Harris《How I Make My Maps》https://www.youtube.com/watch?v=GsojLuJpe_0
- 二手:PremiumBeat《Replicating Vox motion graphic》https://www.premiumbeat.com/blog/replicating-vox-motion-graphic/
- 示范片事实:
  - Le et al., ICML 2012, arXiv:1112.6209 https://arxiv.org/abs/1112.6209
  - Google 官方博客 2012-06-26 https://blog.google/innovation-and-ai/products/using-large-scale-brain-simulations-for/

## ⑧ 最容易做错的 3 件事

1. **所有东西一起 60fps 丝滑地动**。拼贴的手工感一半来自「相机滑、元素顿」的两层帧率。全部丝滑会像企业宣传片,全部 12fps 又会让相机发晕。
2. **用模板语法冒充 Vox**:撕纸、每张图都弹入落下、纸纹逐帧抖。实测里这些都没出现,Vox 的照片随切点直接在、纸纹是死的、转场多是硬切和推进。花哨的入场越多,越不像「编辑部作品」。
3. **用 Vox logo 黄当大面积底色、颜色铺太多**。片子里的黄是 `#DACF08` 一档的荧光笔,只用来划重点。主体是「黑、纸白、一种红」三色,另加一种强调色就够了。

---

## 审片与修订(独立 agent 只看成片,8/10)

审片意见和这一轮的处理:
- 「镜 3 变纯黑,一张大桌面断了」:改成一张大黑卡纸铺在同一张桌上,四边露出桌面纸纹。仍是 Missing Chapter 的黑底卡片语法,但桌面不断。
- 「0–0.9s 完全静止」:示范片当时加了开场慢推(1.14→1.165)。现在的做法:第一个事件放在 0.3 秒内(照片随切点就在、荧光笔或红线立刻开始),或者开场一次 0.17 秒砸入。
- 「半调糊图铺满全屏太久」:推镜从 0.7s 缩到 0.6s,拉出从 1.0s 缩到 0.85s。拉出起点 z=3.68,让照片在硬切两侧的屏幕宽度一致,并给大图补上同位置的胶带,硬切读作「换成高清扫描」。
- 「空白纸条先出现」:纸条改成倾斜滑入,打字提前到 0.4s。
- 「主角从右边一帧切进来半身」:起点移到屏外 1100px,12fps 的第一步仍在画外。
- 「荧光笔没划完片子就结束」:打字、红圈、荧光整体前移,荧光在 1.8s 划完,之后停 0.3s。
- 「它脑中的『猫』字太小」:提到 40px。
- 「相机全程平滑,一拍二不够」:没改。调研实测 Vox 就是「相机 24fps 平滑、元素 12fps 步进」;把相机也改成步进,会背离实测。

## QA(skill `scripts/qa.py`,修订后终版)

| 镜 | 量的窗口(镜内秒) | 运动面积% 均/峰 | 静止帧对% | 跳变帧 | 每帧耗时 均/峰 ms | 确定性 |
|---|---|---|---|---|---|---|
| y2_s1 | 0.35–2.58 | 11.02 / 16.71 | 3.1 | 0 | 17.4 / 20.3 | ✓ 逐像素一致 |
| y2_s2 | 1.1–3.28 | 16.09 / 76.76 | 3.1 | 16(2.77–3.28s 连续) | 23.4 / 52.2 | ✓ 逐像素一致 |
| y2_s3 | 0.35–2.08 | 7.77 / 37.41 | 0.0 | 14(0.39–0.83s 连续) | 73.3 / 88.5 | ✓ 逐像素一致 |

转场冒烟(每个转场渲一遍,最慢一帧):y2_s2(same)55.2ms;y2_s3(hardcut)43.8ms

读法:
- **镜 2 的跳变**在 2.77–3.28s 连续,是「推进墙上小照片」的 0.6s 推镜,推到 9.6 倍。
- **镜 3 的跳变**在 0.39–0.83s 连续,是硬切后「拉出揭示」的 0.85s 拉镜。
- 两段都是整屏缩放,属于设计内的相机运动。硬切本身落在镜 3 第 0 帧,不在量的窗口里。
- **静止帧对 3.1%**:来自元素层的一拍二(12fps 停帧)。第一版开场相机不动,这个数是 16.9%;审片指出「0–0.9s 完全静止」后加了开场慢推,降到 3.1%。这个数降下来不说明变好:匀速慢推能把静止帧对压得很低,读起来照样像翻 PPT;开场静止的正解是让第一个事件提早发生。
- **镜 3 每帧 73/89ms** 是三片里最重的:花叔贴纸每帧做 16 次偏移垫白边,还要画黑卡纸纹。要提速,可以只在 12fps 换姿势时重算贴纸、其余帧复用。

复跑:`uv run scripts/qa.py --project scripts/engine --film demos/y2_vox --out <目录>`(上表是实验时的数字;收进 skill 后的复跑见 09 号的回归表)。

---

<a id="y3_whiteboard"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/动画语法/y3_whiteboard.md

# Y3 · 白板手绘解说(RSA Animate 型):视频动画语法卡

一句话:讲者说一句,手就在一张大白板上写一句、画一个图;相机跟着论证在板上移动,最后拉远,观众看到整场论证是一张图。

示范片:`scripts/engine/demos/y3_whiteboard/`(渲染 `render.py --film demos/y3_whiteboard`)(8s,3 镜,转场 2 种+收尾拉远),总览:`assets/动画语法/y3_whiteboard_总览.jpg`
依据:本风格的调研(调研原文与逐帧数据留在实验归档、没收进 skill,用到的数字已摘进本卡)。实测了 RSA Animate《Changing Education Paradigms》和 Minute Physics《Why is it Dark at Night?》,还查了 VideoScribe、Doodly 的官方文档和 Andrew Park、Henry Reich 的一手说法。

**先选一种语法,不能混**:
- RSA 型:一整块大白板,相机在板上移动,每分钟 5.3 次。
- Minute Physics 型:一页一张纸,硬切换纸,每分钟 8.1 次,相机不动。
- 本卡和示范片走 RSA 型。Minute Physics 型的要点写在 ④ 和 ⑧ 里。

## 起手必查

1. **画少写多是分镜层的问题,先定视觉隐喻再动笔。** 每块板先写下要画的那个物或笑点,再定写什么字;手写整句不超过一行。数一数:板书和同时刻口播原文重合的字超过一半,就是画少写多,后期补双关、加图标救不回来。
2. **块式模板要轮换。** 「年份 → 物件 → 橙标签」或「圆点 → 一行字 → 一个图标」这类同结构的块,全片连用不超过 3 次;换成对比(左右两幅)、流程(箭头串起来)、放大细节、一整幅大图。
3. **取景不手填相机坐标。** 用本段笔画的外框反算(框住再留边),画框边上被裁成半截的旧字推出画外。
4. **线型从第一笔定死。** 实线=已发生,虚线=计划,点线=跨段引线;板上的东西只能擦掉或留着,不渐隐。
5. **每个物件的造型过一遍「会不会被看成不雅形状」。** 圆头、两侧外翻、圆底的竖长物最容易出事,改成尖头、平底再画。

---

## ① 适用场景

**用它:**
- 论证型内容:演讲、观点、因果链、历史脉络。概念之间有关系、能画成一张地图的内容最合适。Andrew Park 的原话是「把信息摆在空间里,让人看见事物之间的关系」【一手】。
- 一条推理链的短科普,走 Minute Physics 型。
- 口播语速平稳,关键词清楚。RSA 的写字速度大约等于语速,像「字幕被手写出来」【实测】。

**别用它:**
- 需要精确数据图表的内容,手绘误差大。
- 动作和空间关系复杂的内容,白板没有景深。
- 需要情绪强度的内容,单色线稿表达弱。
- 想靠它「提升理解」:Türkay 2016 的实验没发现白板动画比其他形式学得更好。它的价值在吸引注意和陪伴感【二手】。

## ② 画面构成

- **配色**(RSA 实测):
  - 底:纯白 `#FBFBFB`
  - 线:黑 `#0A0503`
  - 唯一强调色:橙,文字 `#EB701F`,填色 `#F3742D`;斜线排出的浅橙面约 `#E9A67C`
  - 橙色约占全部笔迹像素的 22%,只用在关键词和斜线填色上。
  - Minute Physics 则是偏粉的米白纸 `#E7DBE1`,加彩铅浅黄 `#EDE6A2` 和浅蓝 `#B5CBE8`。
- **【本片】**:底 `#FBFBFB`,线 `#0A0503`,强调 `#EF7226`。猫身用 22% 透明度的橙色铺一层。
- **线宽**:RSA 笔画约为画高的 0.6–0.7%,1080p 下约 6–7px;阴影斜线约 0.3%;标题字高约为画高的 5.5%。Minute Physics 的线更粗,约 0.8%【实测】。【本片】线宽 6.5px。
- **构图**:
  - RSA 是「先规划好最终全图,再倒着画」【一手】。
  - 每块画面里有 3–6 个图文组块,画满再移走。
  - 平滑移动一次只移 0.23 个画宽,所以新旧两块大面积重叠,观众始终看得到上一块的边【实测】。
  - 收尾露出的全图是一条很长的横向长卷。
- **字**:RSA 是全大写的手写印刷体(漫画对白体)。【本片】中文用霞鹜文楷(LXGW WenKai),子集化成 woff。
- **手**:
  - 真人右手握黑马克笔,从**右下方**入画,前臂斜向右下,遮住 15–25% 的画面。
  - 不画的时候整只手出画。手在画面里的时间:RSA 49%,Minute Physics 40%【实测】。
  - 【本片】代码画的手:裸前臂带暗面和汗毛,食指压黑马克笔,缩放 0.82,按 7 rad/s 轻轻晃。

## ③ 运动轨迹

- **写字速度**【实测,9 例】:
  - 正文中位约 16 字符/秒。
  - 片头标题慢一半,约 7.5 字符/秒,用来「立题」。
  - 口播约 13 字符/秒,所以写字速度大致等于语速。
  - 【本片】正文 16 字/秒;「猫?」按标题 7.5 字/秒写。
- **画图速度**【实测+归纳】:
  - 小图标 0.5–1s,人物头像约 2s。
  - RSA 新增墨迹的面积中位是每秒 0.25% 画面。
  - 复杂插画不当着镜头画:要么预先画好,相机移过去时露出来;要么整张硬切进来,手只补色。
- **【本片】**:
  - 线条笔速 2600 世界像素/秒,约为 RSA 实拍的 2 倍。8 秒演示片必须压缩,真片请放慢。
  - 笔画时长按长度除以笔速算,每笔至少 0.04s,抬笔间隔 0.02s。
  - 每笔内部用 sineInOut,起笔、收笔慢。
  - 花叔用 0.7s「Reveal」揭开:笔尖在他的关节包围盒里走 8 行之字形,`DG.revealMask` 把走过的地方变成 clip,线稿只在 clip 里露出。
  - 第一版是按部件 `setLineDash` 同时描、笔尖沿关节走,审片判「笔不领线」,所以换了。
  - 汉字没有笔顺数据,每个字用 3 行之字形揭开,笔尖跟着来回,看起来就是在写。
- **加速倍率**:Henry Reich 每秒拍 1 张照片,画画时每张停 2 帧,等效约 12 倍速。RSA 推断 5–8 倍【一手+推断】。
- **「不带手」的弹出**:RSA 有一部分橙色关键词是后期整词弹出的,没有手画(ANAESTHETIC、CREATIVITY)【实测】。【本片】「×1000万张」「是猫!」用 0.3s backOut(2.2) 弹出,手不过去。
- **笔尖路径**:
  - 两笔之间间隔 <0.25s 时,笔尖从上一笔终点沿弧线滑到下一笔起点(sineInOut,抬高 30px)。
  - 间隔更长时,抬手出画:0.35s cubicIn 退到右下屏外。
  - 下一笔开始前 0.3s,从右下 cubicOut 进来。
- **持续运动**:白板片的「活」来自手一直在画。RSA 的画线活动量和说话词密度之间几乎不相关(|r|<0.07):说话停顿时,手也不停【实测】。

## ④ 转场(常用 5 种)

1. **板上平滑移动或推拉**(RSA 主力,41 次)。
   - 1.2–2.4s,**easeInOutSine**:实测速度峰值/均值 1.49,理论 sine 是 1.57。
   - 一次平移约 0.23 画宽,与上一块重叠约 75%。
   - 【本片】转场 B:0.9s sineInOut(4.7→5.6s),斜移约 0.5 画宽,同时推到 1.12 倍。移动开始时手正在画一支橙色连线引向新区域,手领着相机走。
2. **甩镜**:快速摇加运动模糊,约 0.8s,一次移 0.5–1.2 画宽,用来跳到板上很远的区域(RSA 15 次)。
   - 【本片】转场 A:0.8s cubicInOut 横移约一整屏。只在这 0.8s 里沿速度方向叠 9 次做模糊;平滑移动和拉远都保持清楚。
3. **拉远揭示全图**(收尾)。
   - RSA 片尾:灰色铺满 → 0.6s 快速拉远 → 约 9s 横摇扫过长卷 → 再拉远看全图。
   - VideoScribe 默认就勾着「Zoom at end?」【一手】。
   - 【本片】6.85→7.5s sineInOut 拉到 0.45 倍,停 0.5s,同时整板在 0.5s 里铺一层很浅的灰 `#EEEEEC`。
4. **云团或爆炸擦除**:卡通烟团铺满再散开,约 1s(RSA 1 次)。
5. **硬切**:硬切到预先画好的图(RSA 少量);Minute Physics 型的换纸硬切(主力,每分钟 8.1 次);Minute Physics 讲黑夜时整帧反相。

**注意**:「推进到画框或泡泡里」「翻页」在样片里都没出现。本片第一版做了「推进思考泡泡」,看过调研后换成甩镜加平滑移动。

## ⑤ 节奏与文字

- **每块停留**:RSA 两次相机移动之间中位 6.6s(四分位 4.0–13.8s);Minute Physics 每个镜头中位 7.1s【实测】。示范片 8s 放了 3 块,约为真片密度的 2.5 倍。
- **和口播对齐(核心)**【实测】:
  - 开写比对应短语开说晚 0.2–0.8s,中位 +0.5s。
  - 短语说完后 1s 内写完:边说边写,稍微落后,**不抢先**。
  - 例外是视觉铺垫(药瓶、箭头)会提前几秒画好,等台词说到。
  - Minute Physics 是名词一说出来图就落下,中位 +0.3s。
- **转场卡话题,不卡停顿**:新的一块板对应一个新论点【实测+归纳】。
- **音乐**:RSA 在讲话下面**没有音乐**。Minute Physics 全程有音乐垫底,约比人声低 9dB【实测】。
- **工具默认值**:
  - VideoScribe 画完停留默认 0.5s【一手】,相机移动默认 1s【二手】。
  - Doodly 每个素材默认画 3s【一手】。

## ⑥ 代码实现要点

> 收进 skill 后(2026-10-04 v0.4):本卡「新写」里的通用函数已统一进 `scripts/engine/lib/`(名字已换成统一后的 MO / CAM / DG / TY / CH / UI / CL / TOON),示范片自己的代码在 `scripts/engine/demos/y3_whiteboard/`。库速查和「怎么为一段口播选语法」见 `references/09-视频动画语法.md`。

- 复用 skill:
  - `KIT.densify / KIT.resample`:Catmull-Rom 加密后按弧长等距重采样,`DG.hand` 在这之上加低频噪声
  - `PAINT.noise`、`PAINT.cached`
  - `HUASHU.build/pose/details`:花叔线稿
  - 引擎转场接口
- 新写、现已统一进库(`lib/diagram.js` / `camera.js`):
  - `DG.cum / DG.pointAt / DG.drawPartial`:折线按长度描出,返回笔尖位置。
  - `CAM.at`:关键帧相机。
  - `CAM.motionBlur`:运动模糊。
  - `DG.revealMask / DG.zigzag`:之字形揭开遮罩(审片后新加)。
- 示范片自己的(`demos/y3_whiteboard/whiteboard.js`;笔画时间线、笔间滑移、马克笔已进库为 `DG.board` / `B.penAt` / `DG.pen`):
  - **笔画时间线**:`addLine / addText / addPop / addFill` 按顺序排,时长由长度和速度自动算,交付时打印 `Y3.timeline` 核对每块的结束时间。第一版第二块排到了 7.9s,比相机移动晚了 2.5s,靠这个数才发现。
  - `drawStroke`:线、字、弹出、填色、角色五种。字和角色都用之字形遮罩揭开,笔尖坐标直接取遮罩的前沿。
  - `penAt`:笔尖与手的路径,包括笔间滑移、抬手出画、入画。
  - `drawHand`:手和马克笔。
  - 擦痕纹理放在屏幕空间,只跟相机平移、不跟缩放,否则推近 5 倍时会变成大灰斑。
- **关键架构**:三镜画的是同一块白板、同一台相机,转场全是 `same`。「转场」本身就是相机运动,所以白板上的东西在转场里绝不会跳。

## ⑦ 代表作品与一手参考

- 样片:
  - RSA ANIMATE: Changing Education Paradigms https://www.youtube.com/watch?v=zDZFcDGpL4U
  - MinutePhysics: Why is it Dark at Night? https://www.youtube.com/watch?v=gxJ4M7tyLRE
- Andrew Park 访谈(Sketchnote Army 2025)https://sketchnotearmy.com/blog/2025/11/18/andrew-park
- Cognitive Media「毛手」https://www.hairyhand.co/about
- VideoScribe 官方文档:
  - 相机与 Zoom at end https://help.videoscribe.co/knowledge/use-zoom-and-set-the-camera
  - Draw 入场 https://help.videoscribe.co/knowledge/draw
  - 入场动画 https://help.videoscribe.co/knowledge/entrance-animations
- Doodly 默认值 https://support.voomly.com/en/articles/12735753-doodly-how-do-i-customize-video-settings
- 学习效果研究(转引)https://en.wikipedia.org/wiki/Whiteboard_animation

## ⑧ 最容易做错的 3 件事

1. **一块画满才说话,或者说完才画**。白板片的魔力是「说一句写一句」:写字速度等于语速,比口播晚约 0.5s。先画后说会让观众等,先说后画会让画变成多余的复述。复杂插画不要现场画,预先画好,相机移过去露出来。
2. **每次都整屏切到下一块空白**。RSA 的平滑移动只移 0.23 画宽,新旧区域大面积重叠,观众一直知道自己在一张大图的哪里。只在跳到远处时才用 0.8s 甩镜加模糊。收尾一定要拉远看全图,这是这个类型的落点。
3. **颜色多、线太细或太均匀、手一直挂在画面上**。只用黑加一个强调色,线宽约为画高的 0.65%。手只在画的时候入画,画完就从右下退出;强调词可以不带手直接弹出。另外别把 RSA 和 Minute Physics 混用:要么一张大白板加相机移动,要么一页一张纸加硬切。

---

## 审片与修订(独立 agent 只看成片,6/10,三片里最低)

审片意见和这一轮的处理:
- 「笔尖不领着线走,花叔好几笔同时冒出来;字是遮罩擦出来的」:
  - 花叔改成 VideoScribe 的 Reveal 画法:完整线稿藏在下面,笔尖走 8 行之字形,笔过之处揭开,笔尖永远在前沿上。
  - 字改成逐字写:每个字一段时间,笔尖在字框里 3 行之字形来回,遮罩跟着揭开。
  - 新写 `DG.revealMask`(同向绕行的方条并集,nonzero 下重叠不抵消)和 `DG.zigzag`。
- 「甩镜后 0.4s 死区」:第二块提前到 3.12s 开画,手在甩镜收尾时就入画。
- 「截图框线穿过猫头」:每个框先填一层白板色再描边,前框盖住后框的线。
- 「『自己找规律』被上缘切一半」:第三块整体下移 60px。
- 「拉远后灰底和擦痕像脏墙」:灰底减淡到 `#EEEEEC`,擦痕透明度减半。
- 「全景只停 0.15s、三组画没连起来」:
  - 第一块结尾加一支橙箭头指向右边,甩镜有了方向。
  - 第二块结尾画一支橙色连线引向第三块,手领着相机走。
  - 拉远提前到 6.85–7.5s,全景停 0.5s。
- 「手是蓝袖子卡通手」:改成裸前臂,带暗面和汗毛,更接近 RSA 的真人手。仍是代码画的。

## QA(skill `scripts/qa.py`,修订后终版)

| 镜 | 量的窗口(镜内秒) | 运动面积% 均/峰 | 静止帧对% | 跳变帧 | 每帧耗时 均/峰 ms | 确定性 |
|---|---|---|---|---|---|---|
| y3_s1 | 0.35–2.48 | 3.1 / 5.31 | 0.0 | 0 | 6.5 / 6.9 | ✓ 逐像素一致 |
| y3_s2 | 0.8–2.23 | 4.65 / 9.57 | 0.0 | 0 | 6.5 / 7.3 | ✓ 逐像素一致 |
| y3_s3 | 0.85–3.23 | 4.45 / 10.94 | 0.0 | 0 | 8.3 / 9.0 | ✓ 逐像素一致 |

转场冒烟(每个转场渲一遍,最慢一帧):y3_s2(same)46.9ms;y3_s3(same)14ms

读法:
- 白板片三镜都没有跳变:所有「转场」都是同一块板上的相机运动,板上的东西不会跳。
- 运动面积 3–4.7% 主要来自手和正在画的线,相机移动时会更高。
- 每帧不到 10ms,因为全是矢量线条,没有像素级处理。

复跑:`uv run scripts/qa.py --project scripts/engine --film demos/y3_whiteboard --out <目录>`(上表是实验时的数字;收进 skill 后的复跑见 09 号的回归表)。

---

<a id="y4_storytime"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/动画语法/y4_storytime.md

# y4 · 故事型简笔角色动画(YouTube storytime animation)

> 一句话语法:**口播是主角,画面是给口播配的「表情包」——角色在几个姿势之间快切(0.1 秒)然后定住,笑点靠切到反应大特写、并在那一下里闭嘴。**

代表:TheOdd1sOut(James Rallison)、Jaiden Animations、Domics。工具:据 Jaiden 的 FAQ 和二手资料,三人早期都用 Flash / Adobe Animate(这条没拿到一手原文,只作背景)。

---

## ① 适用场景

**用它:**
- 第一人称讲经历、讲翻车、讲「我第一次……」:口播有起承转合、有一个能停顿的笑点。
- 观众要的是「这个人」:创作者的卡通化身每期出现,认的是人设不是画工(Pappis 的类型研究:化身之间「往往只靠发型就能区分」)。
- 预算有限、要稳定周更:一个角色、五六个姿势、三张嘴就能撑满一期。

**别用:**
- 信息密度高的教程、数据讲解 → 用 y5 动态文字或信息图。观众会盯着角色等笑点,记不住数字。
- 没有「我」的内容(行业新闻、产品对比)→ 角色没有立场可表演,就只剩一个会张嘴的贴图。
- 口播本身不好笑、没停顿 → 这个风格把口播放大,不会替口播救场。

## ② 画面构成

**构图**
- 中景(腰以上,头占画高 25–35%)是默认机位,角色居中偏一侧,另一侧留给「他在说的东西」(电脑、对方、物件)。
- 背景只交代「在哪」:一面墙、一张桌、一扇窗,3–5 个大色块。白底或纯色底也完全成立(Pappis:「白底或者一个粗糙的场景草图」)。
- 反应镜头把环境拿掉:脸占满画面(头半径 ≈ 画高 1/3),背景换纯色+暗角。
- 笑点镜头经常反着来:切到**大全景**,人变得很小(「渺小无助」本身就是笑点)。

**配色(示范片实际色值)**

| 部位 | 色值 | 说明 |
|---|---|---|
| 皮肤 | `#FFE2CC` | 浅、近白——TheOdd1sOut 的「棉花糖人」是纯白,Jaiden 偏暖白 |
| 帽子 / 白 T | `#FFFFFF`,帽带 `#E4E4E8` | 白色物件靠黑轮廓立住 |
| 短裤 | `#CDBB97` | |
| 角色线 | `#1B1B1F` | 全片最黑 |
| 墙 / 桌 / 地 | `#DCE9EC` / `#E2C29B` / `#E8DCC8` | 低饱和、高明度:背景永远比角色「轻」 |
| 背景线 | `#5B6470` 3px | 比角色线浅、细一半以上 |
| 反应镜头虚空 | `#3D405B`+径向暗角 | 冷、暗,把注意力全压到脸上 |
| 嘴 / 舌 / 腮红 | `#6E2430` / `#F07B7B` / `rgba(255,140,120,.35)` | 嘴里唯一的饱和色,口型一张一合很显眼 |

**线宽**:角色线 = 头半径 × 0.05(最低 4px)——中景 R=165 → 8px,大特写 R=360 → 12px,全景 R=95 → 6px。线随镜头缩放变粗变细(Flash 默认行为),背景线固定 3px。**角色线 ≥ 背景线 × 2** 是这个风格「人永远跳出来」的根源。

**形状语言**:全圆、全钝。头是略扁的圆(宽 1.0R × 高 0.93R),身体是豆子(宽 1.0R × 高 1.2R),全身 3.2R——**头占身高约 58%**。手臂是一根两端圆头的管子,没有肘、没有手指,手是一个圆。没有直角,除了道具。

**角色画法(花叔 storytime 版)**
- 保留两个标志:**纯白渔夫帽**(帽冠圆角梯形+往下斜的宽帽檐+浅灰帽带)、**圆框黑眼镜**(镜框线是轮廓线的 1.5 倍——眼镜就是这张脸的「眼睛」)。其余从原形象里只留白 T、卡其短裤、黑手表(近侧手腕一小块黑)。
- 眼睛是镜片里的黑点(0.075R),带一个白高光;「死鱼眼」把黑点缩到 0.035R、去高光。
- 表情主要靠**眉毛**(帽檐和镜框之间那条短粗线):抬高=惊、内端抬高=委屈、放平=无语。嘴只有:微笑弧、一字、波浪(担心)、半张、全张五种。
- 鬓角露一点黑发,告诉观众帽子底下是头发不是光头。

## ③ 运动轨迹

**原片实测(本次抓取、480p 转载版、去掉片头片尾各 10 秒;方法:160×90 灰度逐帧差)**

| | TheOdd1sOut「老妈的惩罚」(30fps,475s) | Jaiden Animations「Being Not Straight」(24fps,902s) |
|---|---|---|
| 平均镜头长 ASL | **2.43s**(中位 1.87s,四分位 1.03–3.07s) | **5.73s**(中位 3.21s,四分位 1.67–6.67s) |
| 完全静止的相邻帧 | **70.7%** | 51.2% |
| 静止段时长 | 中位 **0.40s**,p75 0.70s | 中位 0.08s(=一拍二的停顿) |
| 运动段时长 | 中位 **100ms**(3 帧) | 中位 42ms(1 帧) |

读法:TheOdd1sOut 是**快切(0.1s)→ 定住(0.4–0.7s)→ 再快切**,七成时间画面完全不动;Jaiden 是**一拍二持续在动**(12 张/秒),镜头更长。Toon Boom 访谈里 Netflix《Oddballs》的动画监督 Hallis Blaney 说得最准:「TheOdd1sOut 是 pose-to-pose,动画极少……基本是在图片之间切换」,改成剧集时最难的是保住那种 snappiness,避免「太软、太慢」。示范片取两者中间:姿势快切照 TheOdd1sOut,呼吸和口型照 Jaiden。

**示范片参数**

| 运动 | 怎么做 | 数字 |
|---|---|---|
| 角色帧率 | 角色所有运动按 24fps 步进(`MO.step(t,24)`),镜头按 60fps 平滑 | Flash 默认 24 |
| 姿势切换 | 手臂目标点 `expoOut` 插值 | **0.10s**(24fps 下 2–3 帧) |
| 换姿势回弹 | 切换瞬间身体竖向压 7%,Ebberts 弹簧回弹(体积守恒,横向反向) | `settle(dt, -0.07, freq 3.5, decay 9)`,≈0.35s 停稳 |
| 口型 | 读口播 RMS 包络,**每 1/12 秒才允许换一次形**(一拍二);三张嘴 | 包络 <0.06 闭、<0.22 半张、其余全张 |
| 说话点头 | 嘴张开时头下沉 | 0.015R × 口型级数 |
| 呼吸 | 身体竖向缩放 | ±1.2%,周期 1.6s |
| 眨眼 | 固定时刻表,间隔 2.4–3.6s | 闭眼 2 帧@24fps(83ms);「无语」慢眨 3 帧 |
| 眼神 | 指向某物时黑点往那边移 | 0.09R |
| 镜头 | 示范片用了中景、特写、近景慢推和全景慢拉(旧做法);新片优先定住,变化靠硬切、跳近、砸镜 | 示范片:中景 +3.5%/2.0s;特写 +6%/1.2s;全景 0.53→0.50(quintOut);近景 1.90→1.98 |
| 开场 | 镜头 1.04→1.01 落定(0.5s expoOut),代替「第一帧静止」 | |
| 汗滴 | 太阳穴处沿脸侧滑落 | 0.9s,expoOut 混线性 |
| 镜片反光 | 白色斜带扫过两片镜片 | 0.3s |
| 「?」 | 头顶弹出,backOut 过冲 30%,之后 ±3° 晃 | 0.26s |

入场/出场:storytime 几乎没有「入场动画」——角色在镜头切进来的第一帧就已经在位、已经在说话。道具和符号(?!、汗滴、数字)才用弹入(`backOut`,过冲 15–30%)。

## ④ 转场(常用 5 种)

1. **硬切(cut)**——占绝大多数。一句口播一个镜头,口播换句就切。示范片 S3→S4(特写 → 同一房间的大全景)就是硬切,靠景别反差制造笑点。
2. **砸镜 / smash cut 到反应特写**——新画面第一帧就出现,从 1.22 倍以弹簧(freq 3, decay 11)缩回 1,前 2 帧压一层 55% 白闪,配一个低音「噔」。用在「说完一句离谱的话 → 看他的脸」。`TRANSITIONS.smash`。
3. **甩镜 / whip pan**——镜头往「他在看的东西」方向甩,`expoInOut` 0.26s,中段 16 张偏移叠加做横向运动模糊、配 whoosh。用在「我打开电脑 →(屏幕)」这种视线转移。`TRANSITIONS.whip`。
4. **推近 / 跳近(jump-in)**——同一机位直接切到约 2 倍的更近景,不换背景。用在「他重复了一遍」「他意识到了」「包袱那一句」。示范片 S4→S5:全景里说「这些……」,在「贴哪儿」前的换气处硬切到 1.9 倍近景,笑点那张脸才看得清。前提是全景和近景是**同一张世界画布、只换镜头**(`world.js`),否则一跳就穿帮。
5. **过肩 / 主观镜头**——切到他看见的东西(屏幕、手机、对方),前景放一块他的后脑勺。示范片 S2:花叔的背影——白帽+帽带、耳朵、挂在耳朵上的眼镜腿、短黑发、后颈、白 T 领口,屏幕那侧一圈冷色轮廓光(第一版画成纯黑剪影,审片读成「另一个影子人」);前景不跟镜头推,只随呼吸起伏,和屏幕之间有视差,画面立刻「有空间」。

## ⑤ 节奏与文字

- **镜头跟口播句子走,不跟音乐拍子走**:一句 ≈ 一镜。示范片 5 镜平均 1.75s(2.0 / 2.4 / 1.2 / 1.65 / 1.5),落在 TheOdd1sOut 实测的四分位 1.03–3.07s 之内。
- **转场放在两句之间的换气里,字幕和切点同一帧换**:第一版甩镜切在「它一口气」的前两个字上,审片指出「切点落在句子中间」;改成 L1 结束(1.87s)→ 2.0s 甩 → 2.26s 落定 → 2.30s 才开口。
- **反应镜头放在两句之间的沉默里**:示范片 S3 整整 1.3s 没有一句话,只有蟋蟀叫——这一下停顿就是笑点。剪辑上:说完离谱的那句(「三千行」)后**不要马上接下一句**,留 0.8–1.5s 给脸。
- **包袱后定住 ≥0.9s**:「?」7.80s 弹出,片子 8.75s 才结束,音效尾巴自然收完(第一版只留 0.4s,审片:「笑的那一拍被剪掉了」)。
- **字**:YouTube 原生 storytime 不烧字幕(靠 CC),只在画面里写「需要被看见」的字——屏幕上的字、关键数字(示范片「3000 行」用普惠体 Black 230px、`#FFCB6B`、过冲 23% 砸出来)。中文平台需要烧录字幕:白字 50px、黑描边 10px、整句切入切出、不做动画(字幕动起来会和角色抢视线)。
- 画内数字和口播**同一个字**对齐:「三千」那个音节(3.70s)= 3000 砸出 = 低频 thump = 屏幕震(9Hz、0.3s 衰减完)。

## ⑥ 代码实现要点

> 收进 skill 后(2026-10-04 v0.4):本卡「新写」里的通用函数已统一进 `scripts/engine/lib/`(名字已换成统一后的 MO / CAM / DG / TY / CH / UI / CL / TOON),示范片自己的代码在 `scripts/engine/demos/y4_storytime/`。库速查和「怎么为一段口播选语法」见 `references/09-视频动画语法.md`。

- **复用 skill**:引擎(段落表、转场时新旧两段离屏合成、`GLOBAL_OVERLAY`)、`render.py`、`PAINT.cached`(房间背景整张缓存)、`U.rng` 种子随机(代码瀑布的色块布局)。
- **engine 两处改动(已并进 skill 引擎)**:段落表任何段都可以直接写 `dur`(秒),不必凑八分音符——storytime 按口播切,不按节拍;转场可以写 `punch: 0`(或片级 `window.PUNCH = 0`)关掉引擎默认的拍点冲击(storytime 没有拍点)。
- **新写、现已统一进库**(`lib/toon.js` / `typo.js` / `camera.js` / `motion.js`,转场进 `transitions.js`):
  - `TOON.bean(c, {x, y, s, char, pose, expr, mouth, blink, look, squash, bob, tilt, lw})`:正面豆子角色,全部 Path2D 程序化,返回双手和头的坐标(给道具、符号定位)。这套代码画的豆子角色只留给示范片和白模预演:作者看过多个模型做的片子后,判代码画的小人是一眼 AI 味(原话「很多视频里用到的小人和机器人角色都太差了」)。参数化片段 y4 只接受你自己的帧库(`data.character.frames`,AI 生帧,见 10 号和 `references/角色精细度.md`),没有帧库启动就失败。
  - `TOON.POSES`:rest / talk / point / type / shrug / stiff,每个姿势只是两只手相对肩的目标点(单位:头半径)。
  - `TOON.mouth(t)`:读 `window.VO_ENV`(音频脚本导出的 60fps RMS 包络),一拍二量化成 0/1/2。
  - `MO.springHz / settle / backOut / expoOut / step`,`CAM.with`、`CAM.drift`(示范片用过的手持微漂;新片定住就是定住,不加),`TOON.sweat`、`TOON.mark`。
  - 转场 `whip`、`smash`(y5 用的冲进色块转场收进库后改名 `fillZoom`,另有 `bands / push`)。
- **本片 `y4_storytime/story.js`**:`STORY.poseAt(keys, t)`(姿势时间线+换姿势回弹),`blinkAt`、`alive`(点头+呼吸),字幕 overlay。
- **音频(实验归档里的 `build_y4.py`,没收进 skill)**:摆口播、合成音效(whoosh、键盘、bloop、thump、「噔」、蟋蟀、pip、boing),同时导出 `vo_env.js`。口播是 macOS `say` 的 Eddy 占位——**正式片换成真人口播后重新导出包络,口型自动跟上**。
- **同一个房间三种景别**:`y4_storytime/world.js` 把房间画成一张世界画布(x −1000..2900、y −700..1700,静态部分整张缓存),S1(zoom 1.01–1.045)、S4(0.53→0.50)、S5(1.90→1.98)只换 `CAM.with`。全景才看得到的书架、绿植、吊灯本来就在世界里。世界要比最远的镜头大一圈,否则镜头漂移会露黑边(第一版三处黑边全是这个原因)。
- 关键参数:角色 24fps、口型 12 次/秒、换姿势 0.1s+7% 回弹、角色线 0.05R。

## ⑦ 代表作品与一手参考

- TheOdd1sOut 频道:https://www.youtube.com/@theodd1sout ;本次实测的转载「老妈的惩罚」:https://www.bilibili.com/video/BV14s411M7x4
- Jaiden Animations 频道:https://www.youtube.com/@JaidenAnimations ;本次实测「Being Not Straight」转载:https://www.bilibili.com/video/BV1xu411r734
- Domics 频道:https://www.youtube.com/@Domics
- Toon Boom × Atomic Cartoons,《Oddballs》从 YouTube 到剧集(「pose-to-pose,动画极少」「他在 YouTube 上从没做过口型」「太软、太慢」):https://www.toonboom.com/atomic-cartoons-on-bringing-oddballs-from-youtube-to-series
- Konstantinos Pappis, *The Odd Ones Out: The Rise of YouTube Storytime Animation*(Animation Studies,类型史与视觉语法:圆脸化身、白底、无逐帧、更像动态分镜):https://journal.animationstudies.org/article/id/135/
- TheOdd1sOut 维基(「棉花糖人」的说法):https://en.wikipedia.org/wiki/TheOdd1sOut
- Dan Ebberts 惯性回弹表达式(freq 3、decay 5 的出处):http://www.motionscript.com/articles/bounce-and-overshoot.html
- 制作者经验帖「换姿势时加一点 bounce」:https://forum.wickeditor.com/t/whoever-wants-to-make-a-storytime-animation/5940

## ⑧ 最容易做错的 3 件事

1. **把它当「全动画」做,什么都在动。** 这个风格的生命在「快切+定住」:TheOdd1sOut 七成帧完全静止。所有东西都在慢慢飘,反而软、反而没节奏(Oddballs 团队最怕的「too soft, too slow」)。姿势切换要快到 0.1s,然后**真的停住**;持续微动只给呼吸、眨眼、背景小物,幅度 ≤ 1–2%。
2. **背景画得和角色一样精彩。** 背景饱和度、对比、线宽都要比角色低一档(本片背景线 3px 灰 vs 角色 8px 黑)。背景一花,观众的眼睛就离开脸,口播的笑点就丢了。
3. **反应镜头不给沉默。** 说完离谱那句马上接下一句,等于把笑点讲掉了。反应镜头要放在口播的空白里,至少 0.8s。镜头定住,只给一两个小细节(汗滴、慢眨、眉毛一垮);要加强就在包袱那一下跳近一档(硬切到约 2 倍近景)或砸入 0.17 秒,不用匀速慢推去填。

---

## 示范片

- 成片:`scripts/engine/demos/y4_storytime/`(渲染 `render.py --film demos/y4_storytime`)(8.75s,60fps,含临时口播+音效);每镜一帧总览:`assets/动画语法/y4_storytime_总览.jpg`
- 工程:`scripts/engine/demos/y4_storytime/`(`eras.js` 段落表、`story.js`、`world.js` 世界画布、`s1_desk.js / s2_screen.js / s3_react.js / s4_wide.js / s5_close.js`),通用部分在 `scripts/engine/lib/`
- 镜头表:S1 中景对镜头讲(0–2.0s)→ 甩镜 → S2 过肩看屏幕,代码瀑布+「3000行」(2.0–4.4s)→ 砸镜 → S3 反应大特写,沉默(4.4–5.6s)→ 硬切 → S4 同一房间大全景「我问它:这些……」,瞟电脑、指电脑(5.6–7.25s)→ 跳近 → S5 近景摊手「贴哪儿?」+「?」,定住(7.25–8.75s)

## 审片返修(独立 agent 只看成片)

第一版审片「必须改」5 条,全部处理:
1. 三处黑边穿帮(S1 左/上、砸镜回弹缩到 1 以下、S4 镜头下漂)→ 世界画布铺大+`smash` 缩放夹在 ≥1。返修后逐帧扫描四条边:0 帧露黑。
2. 包袱没留气口 → 拆出 S5 跳近镜头,「?」后定住 0.95s。
3. S1 和 S4 不是同一个房间 → 改成同一张世界画布换镜头。
4. 过肩剪影像另一个人 → 画出背面识别点+轮廓光。
5. 甩镜切在句中、第二句字幕晚 → 甩镜挪进换气,字幕跟切点同帧。
「可以更好」处理了 2 条:S3 第二声蟋蟀后 0.15s 眉毛一垮(原来音效在 5.23s、表情在 5.38s 对不上);S4 两段停顿里加「瞟电脑→回看镜头」和说「这些」时指电脑。字幕去掉中英文之间的空格(「让AI帮我」「3000行」)。
没改的:线条是均匀等粗的矢量线、没有手绘抖线——这是 TheOdd1sOut/Jaiden 的 Flash 矢量线本来的样子,保留。

## qa.py 数字(返修后,`uv run scripts/qa.py --project scripts/engine --film demos/y4_storytime`)

| 段 | 运动% | 静止帧对% | 跳变 | 均/峰 ms | 确定性 |
|---|---|---|---|---|---|
| s1_desk | 1.47 | 8.6 | 0 | 9.9/10.4 | ✓ |
| s2_screen | 6.0 | 0.0 | 0 | 1.7/3.8 | ✓ |
| s3_react | 1.73 | 0.0 | 0 | 5.6/6.1 | ✓ |
| s4_wide | 0.77 | 16.2 | 0 | 9.6/9.9 | ✓ |
| s5_close | 3.27 | 3.1 | 0 | 10.9/11.4 | ✓ |

转场冒烟(整帧峰值):whip 47.9ms、smash 10.1ms、cut 15.7 / 20.5ms。第一版 s1、s2、s4 各报 1 个跳变(开场落定、3000 砸出、全景开头的快速拉远),返修后为 0。
读这张表要注意:qa 的经验阈值「静止帧对 >40% 读作卡」**不适用于 storytime**——TheOdd1sOut 原片 70.7% 的相邻帧完全静止,那是风格不是卡顿。本片静止帧对 0–16%,比原片「活」得多,是有意取 Jaiden 式的持续呼吸;想更像 TheOdd1sOut,就把呼吸、点头、背景小循环关掉,只留口型和姿势快切(静止帧对会大幅上升,本次没实测)。

---

<a id="y5_kinetic_type"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/动画语法/y5_kinetic_type.md

# y5 · 动态文字排版 / 信息图动效(kinetic typography)

> 一句话语法:**字就是演员——每个关键词踩一个重音砸进来,主词大到一眼读完,其余的字从「槽」里升起给耳朵对位;画面里永远只有一个焦点,镜头和底纹一直在动,字落定后不动。**

血统:Saul Bass《North by Northwest》(1959)片头被普遍认作第一次在长片里大规模用动态文字;2008 年后 YouTube 上的歌词/台词 kinetic type(After Effects 一代)把它变成解说视频、清单、语录、数据开场的标准语法。

## 起手必查

1. **先确认这段该让字当主角。** 只有清单、金句、数字、章节卡时用;整段超过 30–60 秒全是字,就换语法,或者每 2 页插一页图、证据物(截图、代码卡、聊天气泡)。
2. **数字数。** 主词 ≤4 个字,辅句 ≤14 字;同一时刻只有一个东西在入场。超了就拆页,不缩字号硬塞。
3. **同一页型连续不超过 3 页。** 「大字+辅句+左上标签」连翻 4 页就是幻灯片;中间插一页数字砸入、一页证据物,或一次冲进色块的转场。
4. **每个落点写成拍号或口播里的词。** 不在节拍网格、也不对词的落点,删掉或挪上去。
5. **字落定后不动。** 动感交给拍点微冲、换页、证据物入场,主词不漂、不呼吸。

---

## ① 适用场景

**用它:**
- 解说/清单/「X 个阶段」「3 个理由」类的开场与章节卡:信息是**结构**(几个、哪一个、从什么到什么),不是画面。
- 语录、金句、一句话结论:让观众「看着读」比「听着记」更牢。
- 数字讲解:一个数字一个镜头,数字本身做主角。
- 口播里有明确的重音词(「不是写代码,是**说需求**」)。

**别用:**
- 讲故事、讲情绪起伏 → 没有人脸,观众很难共情(用 y4 角色)。
- 长段解释性口播配满屏字 → 观众只会读不会听,读也跟不上。整片超过 30–60 秒全是动态字会累,用它做开场、章节卡、结论卡就好。
- 字很多的列表(>5 条)→ 改成静态信息图慢慢讲。

## ② 画面构成

**构图**:一屏一个主词。主词左对齐压在画面左侧 1/3–1/2(或镜像到右侧),辅句紧贴主词下方,另一侧放一个「证据物」(代码卡、聊天气泡、清单)。上角放小标签(「阶段 01」)和进度轨。四周至少留 130px 边距。

**字号阶梯(示范片)**:主词 340px(普惠体 115 Black):辅句 96px(105 Heavy):标签 40px(85 Bold,字距 6px)≈ **3.4 : 1 : 0.4**。主词要在 0.3 秒里被读完,所以主词只给 2 个字。

**配色**:每个章节一个整屏底色,换章节=换底色(色彩本身就是章节号)。

| 镜头 | 底色 | 主词 | 强调 |
|---|---|---|---|
| 标题 | 黄 `#FFD23F` | 墨 `#111111` | 珊瑚圆 `#FF5A36` 里的白「3」 |
| 01 补全 | 珊瑚 `#FF5A36` | 白 | 黄荧光笔 `#FFD23F` |
| 02 对话 | 藏青 `#14213D` | 黄 | 黄荧光笔、蓝气泡 `#3A86FF` |
| 03 代理 | 米白 `#F4EFE6` | 墨 | 珊瑚下划线、绿勾 `#2BB673` |

全片 4 个底色 + 墨 + 白,强调色永远只有一个。

**形状语言**:字是最大的形;辅助形状只用圆角矩形(卡片 r=26、气泡 r=30、键帽 r=22)、正圆(数字底)、斜切色块(荧光笔,斜率 0.18)。背景是 64px 间距的点阵(不透明度 6–10%)。不用描边字、不用投影字(唯一的投影是卡片下 8–18% 的偏移阴影)。

## ③ 运动轨迹

**入场(按「重要性」选方式)**

| 元素 | 方式 | 曲线与时长 |
|---|---|---|
| 主词 | **砸**:从 1.7 倍缩到 1,前 0.06s 不透明度 0→1 | 欠阻尼弹簧 `1−e^(−10t)·cos(2π·2.2t)`,过冲约 8%,≈0.35s 停稳 |
| 标题首词 | 砸+旋转回正 −8°→0 | 同上 |
| 辅句、标签 | **槽里升起**:字在基线下的遮罩里从 +1.2 倍字高推到 0 | `expoOut`,0.30–0.35s |
| 数字/图标/气泡/键帽 | **弹入**:0→1 缩放 | `backOut`,s=2.6–3.0(过冲 17–20%),0.30–0.42s |
| 卡片 | **滑入**:从 +700px 或下方 +260px,带 3.4° 旋转回正 | `expoOut` 0.40s |
| 打字 | 按字符截断 | 0.5s 打完 13 个字符(26 字/秒),光标 2Hz 闪 |
| 代码补全 | 灰字**0 帧**闪现(补全本来就是瞬间出现的)→ 按 Tab 变实色 | 键帽按下压 14%,e^(−18t) 回弹 |
| 荧光笔 / 下划线 | 从左往右刷出 | `expoOut` 0.30s,在字出现后 1–3 个八分音符再刷 |
| 关键词放大 | 到强调拍放大到 1.35 倍并钉住,荧光笔跟着放大 | 弹簧 freq 2.5 / decay 9,和配合的动作(按 Tab、打勾)同一拍 |
| 巨型阶段数字 | 900px、透明度 5–13%、压在画右下、从 1.35 倍落到 1 后斜向慢漂 14/10 px/s | 弹簧 freq 2 / decay 8 |
| 打勾 | 勾的笔画按弧长画出,框同时 1→1.25→1 | 0.22s;删除线晚 0.08s 再划 |

**出场**:比入场快、用加速曲线(`expoIn`),时长 0.18s,元素之间错开 0.03s,同时缩到 0.6、下落 60px、变透明。**退场比入场快**——观众的注意力在退场开始前就已经走了。示范片标题段最后一拍:除「3」以外全部退场,只剩下一个要冲进去的形。

**错开(stagger)**:同一行的词错开一个八分音符(120 BPM 下 0.25s);同一组小元素(三个勾)也是一个八分一个。

**持续运动(字落定后不动,动的是别的)**
- 镜头微漂:两路正弦,振幅 5px,周期约 7s / 2.7s;极慢旋转 ±0.5°。
- 拍点微冲:每个四分拍整屏放大 1.2%,`e^(−25t)` 衰减(≈0.12s)——画面跟着鼓「呼吸」。
- 背景点阵斜向平移 36px/s。
- 结尾一拍:镜头拉远 6%(`expoOut` 0.5s),所有东西缩小一点=「收束」。

**原片对照(本次抓取的两支 YouTube 歌词 kinetic type 转载,30fps)**:相邻帧完全静止只占 10.3%(DISCORD)/ 21.2%(Charlie Puth),七八成时间画面在动——和 storytime 的 71% 静止正好相反;大的视觉事件(整屏变化 >1.5% 的峰)平均 0.66s / 0.83s 一个,接近**一拍一个**(两支曲速约 105 / 99 BPM,一拍 0.57 / 0.60s)。示范片的大事件密度是一个八分一个(0.25s),比歌词片密一倍——解说开场可以这么密,长片要放到一拍一个。

## ④ 转场(示范片 3 种+常用 2 种)

1. **穿越放大(zoom through)**:镜头冲进上一屏的某个形(「3」的珊瑚圆),形的颜色=下一屏的底色,冲满屏后下一屏从 1.25 倍落回 1。前 55% 时间 `expoIn` 放大到 30 倍,后 45% `expoOut` 落定。`TRANSITIONS.fillZoom`(实验时叫 zoomThrough,收进库后改名,免得和 3b1b 的镜头穿越撞名),参数 `cx, cy, k, maxZoom, fill`。
2. **色带擦除(bands)**:三条斜切色带(黄→白→藏青)接力从左扫到右,错开 12%,最后一条是新画面的底色,色带后面露出新画面。0.5s `expoInOut`。`TRANSITIONS.bands`。
3. **推(push)**:新旧一起平移,像在一张长画布上滑到下一块。0.35s `expoInOut`。`TRANSITIONS.push`。
4. **遮罩擦出(mask wipe)**:一个形(圆、矩形条、字本身)当遮罩从小长大露出新画面。可用 `skill` 原有的 `iris`。
5. **字变形 / 字当转场**:上一屏的某个字放大成整屏的色块,或者一个字甩出画面带走旧画面。

**对位技巧(本次最值钱的一条)**:引擎里转场从新段的 `t0` 开始,所以要让「新画面露出来」的那一帧正好落在小节线,段的起点 = **小节线 − 转场的揭开点 × 转场时长**。示范片:fillZoom 揭开点 p=0.55、时长 0.45 → 起点 1.75(揭开在 2.00);bands 揭开点 ≈0.6、0.5s → 起点 3.70;push 用 expoInOut,肉眼的「到位」是位移 90% 那一刻(p≈0.58)而不是 p=1 → 起点 5.80(第一版按 p=1 算起点 5.65,审片量到「推完比重拍早 8 帧」)。所有镜头内的落点也写成拍号 `KT.b(n)`,不写秒。

## ⑤ 节奏与文字

- **120 BPM,4 小节+1 拍收尾(8.5s),每小节一个镜头**(标题 / 阶段一 / 阶段二 / 阶段三),每个镜头里:第 1 拍主词砸(+背景巨型阶段数字)、第 1.5 拍证据物、第 2 拍辅句、第 3 拍证据物动作、第 3.5 拍关键词放大+高亮、第 4 拍留白或退场;最后第 16 拍(8.0s)收尾重拍,再静住 0.5s。四个镜头同一套拍位,只换左右和内容——观众第二个镜头起就「知道下一下在哪」,这正是节奏感的来源。
- **主词落在强拍(每小节第一拍)**,配低频冲击;小元素落在八分音符上,配 pop;转场前 0.3s 一段上扬噪声把耳朵带到下一小节。
- 每个画面落点都有一个声音,每个重音都有一个画面——示范片音效表在实验归档的 `build_y5.py`(没收进 skill),和 `scenes/*.js` 的拍号一一对应。
- **停留时间够读**:英文视频文字指南给的下限是 13 字符/秒(SSW);中文没找到一手标准,按字幕行业的经验上限 7–9 字/秒算(未核实,当经验值用)。主词 2 字至少停 0.5s,辅句 7–8 字至少停 1.0s。
- 和口播对位时:主词=口播里的重音词,**画面宁早勿晚、最多早 1 帧**——人对「声音比画面早」比「声音比画面晚」敏感得多(广播声画同步容差 EBU R37 是声音领先 ≤40ms、落后 ≤60ms)。

## ⑥ 代码实现要点

> 收进 skill 后(2026-10-04 v0.4):本卡「新写」里的通用函数已统一进 `scripts/engine/lib/`(名字已换成统一后的 MO / CAM / DG / TY / CH / UI / CL / TOON),示范片自己的代码在 `scripts/engine/demos/y5_kinetic_type/`。库速查和「怎么为一段口播选语法」见 `references/09-视频动画语法.md`。

- **复用 skill**:引擎(段落表、转场新旧两层、`renderFrame`)、`render.py`、`U.clamp / lerp / rng`、`PAINT` 不需要(这风格不用纹理)。
- **engine 改动(已并进 skill 引擎)**:`window.BPM` 可配(默认 128,本片 120);任何段可写 `dur` 秒;转场 `punch:0` 可关(本片用自己的拍点微冲,冲在拍上,不冲在转场起点上)。
- **新写、现已统一进库**(`lib/motion.js` / `typo.js` / `camera.js`,转场进 `transitions.js`):
  - 缓动:`expoOut / expoIn / expoInOut / quintOut / backOut(p, s) / spring(t, freq, decay) / settle(t, amp, freq, decay)`。
  - 字:`TY.text`(缩放旋转以任意点为轴、描边、字距)、`TY.width`、`TY.rise`(遮罩升起)、`TY.pop`(弹入)、`TY.typed`(打字)、`TY.marker`(荧光笔斜切块)、`TY.underline`。
  - 镜头:`CAM.with(c, {x, y, z, r}, fn)`、`CAM.drift`。
  - 转场:`fillZoom`、`bands`、`push`。
- **本片 `y5_kinetic_type/kinetic.js`**:`KT.b(n)` 拍号、`KT.SZ` 字号阶梯、`KT.bump` 拍点微冲、`KT.slam` 主词砸入、`KT.dots` 点阵、进度轨(画在 `GLOBAL_OVERLAY` 固定层,值只由全片时间决定——skill 02 号「连续叙事锚」的用法;第一版画在各段里,推页时跟着页面跳)、`KT.key / keyMarker`(关键词先升起、到强调拍放大并钉住)、`KT.bigNum`(背景巨型阶段数字)、`KT.cam`。
- **中文字体**:示范片用阿里巴巴普惠体 3.0 四个字重(Black/Heavy/Bold/Medium)做;开源版因字体许可换成思源黑体 Noto Sans SC 900/800/700/500,family 名沿用 `PuHui-*`,GB2312 全量子集(`scripts/font_subset.py --gb2312`),换题目一般不用重做。
- **音乐(实验归档里的 `build_y5.py`,没收进 skill)**:numpy 合成鼓(kick 每拍、clap 2/4 拍、hat 反拍)+贝斯(每小节一个根音的八分音符)+事件音效(主词=boom、小元素=pop、打字=click、打勾=升调 pop、转场前=riser)。

## ⑦ 代表作品与一手参考

- Saul Bass 片头档案(Art of the Title):https://www.artofthetitle.com/designer/saul-bass/
- 维基「Kinetic typography」(motion typography / fluid typography 两类、Bass 是长片先驱):https://en.wikipedia.org/wiki/Kinetic_typography
- School of Motion《Kinetic Typography in After Effects》Part 2(帧数:小词滑入 4 帧、主词甩入 6 帧+2 帧过冲回正、镜头推 6 帧+2 帧回拉;「镜头要晚一点动,像是被声音推着走」):https://www.schoolofmotion.com/blog/kinetic-typography-after-effects-part-2
- School of Motion Part 3(下落要加速不要缓停、撞击时整个合成放大再回 100%):https://schoolofmotion.com/blog/kinetic-typography-after-effects-part-3
- Dan Ebberts 惯性回弹表达式(`amp·sin(2πft)/e^(decay·t)`,默认 freq 3 / decay 5):http://www.motionscript.com/articles/bounce-and-overshoot.html
- Lee, Forlizzi, Hudson,《The Kinetic Typography Engine》(UIST 2002,动态字表达情绪与语气):https://dl.acm.org/doi/10.1145/571985.571997
- 视频文字停留时间:https://www.ssw.com.au/rules/post-production-do-you-give-enough-time-to-read-texts-in-your-videos
- 本次实测的两支转载:DISCORD [Kinetic Typography] https://www.bilibili.com/video/BV1ts411S7Xa ;Charlie Puth – We Don't Talk Anymore (Kinetic Typography) https://www.bilibili.com/video/BV1by4y1r74Y

## ⑧ 最容易做错的 3 件事

1. **所有字一样大、一起动。** 没有层级就没有焦点,观众不知道先读哪个。主词与辅句至少 3:1,同一时刻只让一个东西在「入场」,其余全部静止。
2. **字一直在漂。** 字在读的时候不能动(会读不进去)。持续运动交给镜头微漂、拍点微冲、背景点阵;字砸进来 0.35s 后就钉住。
3. **动画不踩拍,或者踩在转场起点上。** 转场的第一帧不是重音,「新画面露出来」那一帧才是。把段起点往前挪「揭开点 × 时长」,再把镜头里每个落点写成拍号;节拍网格以外的落点每多一个,整片就散一分。

---

## 示范片

- 成片:`scripts/engine/demos/y5_kinetic_type/`(渲染 `render.py --film demos/y5_kinetic_type`)(8.5s,60fps,合成配乐 120 BPM);每镜一帧总览:`assets/动画语法/y5_kinetic_type_总览.jpg`
- 工程:`scripts/engine/demos/y5_kinetic_type/`(`eras.js`、`kinetic.js`、`k1_title.js / k2_complete.js / k3_chat.js / k4_agent.js`),通用部分在 `scripts/engine/lib/`
- 镜头表:K1 标题「AI 写代码 的 ③ 个阶段」→ 穿越放大 → K2「补全」(代码卡+灰字补全+Tab)→ 色带擦除 → K3「对话」(你一句、它一整段)→ 推 → K4「代理」(TODO 三条自己打勾)+进度轨满格

## 审片返修(独立 agent 只看成片)

审片结论:「开头 0–2s 是标准的 kinetic type,『3』的圆冲进镜头变成下一段底色是全片最好的设计」「声画对位几乎完美,所有视觉事件都落在 120BPM 网格上、和底鼓同一帧」。「必须改」5 条,处理如下:
1. **辅句停留太短**(0.6–0.9s)→ 辅句提前一拍出、压到 6–7 个字(「它补完下一行」「一句话换一整段」「你只说要什么」),可读时间 1.0–1.5s(阶段 2 仍偏紧,正式片配口播就够);全片加 0.5s。
2. **阶段 2 辅句快撞上 AI 面板**(14px)→ 辅句变短、右对齐,间距 >180px。
3. **推页早了 8 帧、进度轨跟着跳** → 段起点按 90% 位移重算(5.80);进度轨移到 `GLOBAL_OVERLAY` 固定层,颜色在揭开那一帧换。
4. **阶段段落不够 kinetic**(编号太小、关键词只高亮不放大)→ 加背景巨型阶段数字 1/2/3;关键词到强调拍放大 1.35 倍。
5. **结尾没有收尾的一击、打完勾全变灰** → 加第 16 拍收尾重拍(镜头拉远 6%+3.5% 冲击+低频+高音铃),勾完的字变绿不变灰,内容整体下移 70px 填掉底部空白。
另外:代码卡改用等宽字体(Menlo)。
没采纳的:「把每段延长到 2.5–3s、全片 10–11s」——示范片要求约 8 秒,用压字数代替延时长。

## qa.py 数字(返修后,`uv run scripts/qa.py --project scripts/engine --film demos/y5_kinetic_type`)

| 段 | 运动% | 静止帧对% | 跳变 | 均/峰 ms | 确定性 |
|---|---|---|---|---|---|
| k1_title | 2.37 | 0.0 | 1(t=1.63,标题退场) | 1.0/1.6 | ✓ |
| k2_complete | 2.39 | 0.0 | 0 | 1.5/3.2 | ✓ |
| k3_chat | 2.59 | 0.0 | 1(t=4.54,AI 气泡长出) | 1.6/2.2 | ✓ |
| k4_agent | 2.88 | 0.0 | 3(t=6.29 Agent+任务卡;t=8.00/8.04 收尾重拍) | 1.6/2.0 | ✓ |

转场冒烟(整帧峰值):fillZoom 6.8ms、bands 4.8ms、push 3.8ms。5 个跳变逐个看过帧,全是有意的拍点重音(qa 文档:「有意的节拍闪不算错」)。kinetic 的跳变就该落在拍上——可以拿跳变时刻去对节拍网格,对不上的才是 bug。
返修后逐帧扫描四条边:0 帧露黑。

---

<a id="y6_presenter_explainer"></a>

来源:https://github.com/alchaincyf/huashu-art-motion/blob/d861767d180008d27675819932070a670a3ae43f/references/动画语法/y6_presenter_explainer.md

# Y6 · 讲解员式财经科普

一个卡通讲解员在纸面、图表和关键词之间串联信息。适合商业史、产品机制和带情绪反应的知识讲解。参考代码在`scripts/engine/reference_films/spacex/spacex_lin/`;这是第9种语法卡,目前没有独立参数化片段,也不附角色sprite。

## 起手必查

- 分镜先分配版式:侧身讲解、满屏数字、左右对比、角色进入图里、反应特写。不要全片固定人左图右。
- 生帧至少备全身和胸像两档景别;坐姿和倚靠需要真实的对应帧。
- 每段第一个`cast`关键帧显式给出`x`和`s`,防止跨段继承造成回归。
- 嵌套绘制的透明度用`*=`,保留外层淡出。
- 顶栏年份、字幕和段标题读同一个时间源。
- 第一版即跑`qa.py`文字框景;浅底无字幕成片再跑`subzone_gate.py`。

## 帧与动作

角色采用AI生成帧,代码控制脚底锚点、位置、大小和换帧。姿势硬切配轻微弹出,避免不同轮廓溶解形成双影。说话和闭嘴随口播时间切换;停顿时停止口型,走路使用完整步态帧。姿势的身高按中位数校齐;反应特写用胸像素材,不把整帧截图硬放大。

数字在口播念到时落定。计数过程中不要提前带「超过」「+」等断言;强调圈在数字落定后出现。高光后的停顿要在脚本和口播阶段留出来。

## 参考实现

`common.js`提供`presenterFrame`、`drawFigure`、`hud`、`yearAt`、`popK`和`L.cast`。`prep_presenter.py`演示切帧及脚底锚点。转场`transitions/lin_page.js`只翻页面,讲解员和顶栏可跨页连续。

已知限制:人物遮字、角色被推镜裁掉仍需肉眼审片;参考代码中的整帧位图推近容易裁切,新片应优先使用场景相机。素材和口播需自行提供,不能直接把本卡当作完整成片模板。
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall