如何精准识别缓动曲线:reanimate的easing拟合与弹簧参数还原技巧详解
如何精准识别缓动曲线:reanimate的easing拟合与弹簧参数还原技巧详解
reanimate 是一个开源的 Claude Code 技能:它逐帧录制参考动画,重建到本地代码后,再用完全相同的方式录制副本,逐帧对比直到缓动曲线(easing)、时长和时序数字全部对上。本文详解它最硬核的部分——easing 拟合(自动匹配 25 种命名缓动曲线)与弹簧参数还原(从过冲百分比反推 stiffness / damping),帮你告别"看着像 easeOut 就先用着"的玄学时代。
为什么"肉眼猜"缓动曲线不可靠
做过动效克隆的人都有同感:一个卡片入场动画,你看着觉得是 ease-out,写完后并排一比总觉得"差一点感觉"。问题出在三点:
- 缓动的信息藏在中间帧。只看首尾帧完全看不出差别,真正的区分度在"中点位置落在哪"(详见 analysis.md 的读帧方法)。
- 声明时长 ≠ 可见时长。expo 类曲线有长尾巴,最后 1% 的位移可能要拖很久,直接目测结束时刻会猜短时长。
- 弹簧不是贝塞尔曲线。GSAP 的
elastic、Framer 的type: "spring"都会过冲回弹,任何cubic-bezier都无法精确复现。
reanimate 的思路是:把"感觉"变成"测量"。它给每个动画元素逐帧记录位置、尺寸、透明度、transform(约每 16 ms 一个样本),生成 track.json,然后交给 easing.ts 脚本做数学拟合(SKILL.md 定义了完整的工作流)。
easing.ts 的拟合原理:4 步得到"这条动画用了哪条曲线"
核心脚本 easing.ts 的用法只有一行:
bun easing.ts --track ref/track.json --selector "section.hero h1" --prop translateY
它内部分四步工作:
1️⃣ 提取原始序列
从 track.json 中取出目标选择器在某属性(translateY、opacity、scale、rotate 等)上随时间的数值序列;Canvas/WebGL 场景则用 --channel 直接取 GPU uniform 通道(如 u_hover),同样是一条 [时间, 值] 序列。也支持 --series '[[0,0],[100,12],...]' 直接喂自定义数据。
2️⃣ 自动测定 delay、duration、overshoot
- delay:第一个位移超过"1% 变化下限"的样本时刻(噪声阈值
eps = max(|range|×1%, 0.002),见 easing.ts)。 - visibleDurationMs:从首次变化到"进入终值 1% 以内"的时长,即你肉眼看到的"动了多久"。
- overshoot:曲线冲过终点后又拉回的幅度百分比——这是判断弹簧的关键证据。
3️⃣ 对 25 条命名缓动逐一最小二乘拟合
内置缓动库(easing.ts)覆盖:CSS 四大内置值、Material standard/emphasized、expo/quint/cubic/quart/quad 全套 in/out/inOut、back、GSAP power3.inOut、以及落地页高发的 cubic-bezier(0.19,1,0.22,1)。
关键的技巧在拟合循环(easing.ts):时长是自由参数,在 1×~2× 可见时长的范围内以 5% 步进搜索——因为 expo 类曲线的长尾会落在 1% 变化下限之下,声明时长往往比"看得见"的时长更长。每条缓动算出 RMSE(均方根误差),排序后取 Top 5 输出。
4️⃣ 输出 verdict 判决
结果是一个 JSON,包含 delayMs、visibleDurationMs、overshootPct、bestFits(前 5 名及其 RMSE 与拟合时长),以及一段人话判决:
| 证据 | 判决 |
|---|---|
| overshoot > 2% | spring-like / back easing (overshoots),转弹簧还原流程 |
| 最佳 RMSE < 0.03 | good fit,直接采用该曲线 |
| RMSE 0.03~0.08 | approximate,可用但需人工复核 |
| RMSE ≥ 0.08 | poor fit,多半是多段动画、弹簧或滚动联动,别硬套单条曲线 |
弹簧参数还原:从过冲和回落时间反推 stiffness / damping
当 verdict 判定为弹簧时,implementation.md 给了一套不用看源码、纯靠测量的还原公式:
- 由过冲定阻尼比 ζ:过冲 ≈
exp(−πζ / √(1−ζ²))。查表即可——10% 过冲 → ζ≈0.59;5% → ζ≈0.69;20% → ζ≈0.46。 - 由回落时间定刚度:回落时间 ≈
4 / (ζ·ω),其中ω = √(stiffness/mass)。 - 固定
mass: 1,先按过冲选 ζ,再按回落时间解出 stiffness,最后必须对副本重新跑一遍easing.ts验证过冲和回落是否对齐。
Framer Motion 中的典型对应:10% 过冲、约 600 ms 回落 ≈ type: "spring", stiffness: 300, damping: 20(damping 越小过冲越狠,stiffness 越小越慢)。
💡 reanimate 在 turborepo.com 速度表示例中用这套方法复刻了弹簧指针:悬停期间 0 px 差异——指针的冲过红区再回弹,正是按上述公式反推的参数。
验证闭环:--compare-track 证明"我的副本动了得一样"
拟合完只是起点,reanimate 的哲学是"交付物是代码 + 证据,而不是'看着差不多'"。把副本用与参考完全相同的参数重新录制后,运行:
bun easing.ts --track clone-1/track.json --selector "section.hero h1" \
--prop translateY --compare-track ref/track.json
它会输出两组轨道在同一时刻的 maxAbsDiff / meanAbsDiff(单位是 px 或透明度)以及副本自身的最佳拟合曲线。结合 compare.ts 的逐帧对比,验收标准(verify.md)非常量化:
- 起止时刻与时长误差 ≤ 0.08 s(25 fps 下的两帧);
- 缓动族相同(out / in / in-out / linear / spring),且 RMSE ≤ 0.05,或
meanAbsDiff≤ 位移距离的 5%; - stagger 间隔误差 ≤ 0.04 s,位移距离误差 ≤ 10%。
指针跟随类动效同理:在 stripe.com 的 Visa 卡片上,卡片倾斜被记录为一条曲线(−0.174 → 0.262 rad,33~1800 ms),复刻版在 33 ms 与 0.5% 量程误差内完全对齐——两侧走的是同一条指针路径、同一套缓动。
常见失败模式对照表
每轮迭代只改证据指向的最小变量,通常 2~5 轮收敛。verify.md 总结了症状 → 病因 → 修法:
| 症状 | 常见原因 | 修法 |
|---|---|---|
| 副本前快后慢,比参考"急" | 缓动过强(用了 expo 而原站是 quint),或时长取了可见窗口而非拟合时长 | 用 easing.ts 输出的拟合 durationMs 作为声明时长 |
| 参考过冲、副本不过冲 | 把弹簧误当贝塞尔曲线 | 换真弹簧(Framer spring / GSAP back、elastic / CSS linear() 采样曲线) |
| 活动曲线形状一致但整体平移 | 触发延迟或漏了初始 delay | 调 delay,别靠对齐去掩盖 |
| 只有最后几帧不同 | 缺 forwards 填充模式 |
补 animation-fill-mode: forwards |
特别提醒一个坑(SKILL.md):--playback-rate 只能放慢 CSS 动画,对 GSAP、Framer 弹簧这类 JS 驱动动画无效——这类动效必须走 track.json + easing.ts 的测量路线。
拟合结果怎么落地:跨框架缓动对照
拿到 best fit 后,按项目技术栈翻译即可(完整表见 implementation.md):
| 拟合结果 | CSS | Framer Motion | GSAP |
|---|---|---|---|
| easeOutExpo | cubic-bezier(0.16,1,0.3,1) |
ease: [0.16,1,0.3,1] |
"expo.out" |
| easeInOutCubic | cubic-bezier(0.65,0,0.35,1) |
[0.65,0,0.35,1] |
"power2.inOut" |
| easeOutBack | cubic-bezier(0.34,1.56,0.64,1) |
[0.34,1.56,0.64,1] |
"back.out(1.7)" |
| 弹簧(10% 过冲 / ~600 ms 回落) | linear() 采样曲线 |
type:"spring", stiffness:300, damping:20 |
"elastic.out(1,0.5)" |
总结
reanimate 把缓动识别从"视觉玄学"变成了三件可复现的事:
- 测——
track.json逐帧采样 +easing.ts对 25 条命名曲线做 RMSE 拟合,连声明时长都被当作自由参数一起解出来; - 反推——弹簧不猜参数,用"过冲定 ζ、回落时间定 stiffness"两个公式还原;
- 证——
--compare-track的meanAbsDiff≤ 5%、RMSE ≤ 0.05,数字达标才算通过。
相关模块路径:拟合脚本 skills/reanimate/scripts/easing.ts、分析文档 skills/reanimate/references/analysis.md、验收标准 skills/reanimate/references/verify.md。想要本地体验,可执行 git clone https://gitcode.com/gh_mirrors/rean/reanimate 后查看示例站点 site/。



