如何精准识别缓动曲线:reanimate的easing拟合与弹簧参数还原技巧详解

原创2026-11-05 12:48:421,960 阅读

如何精准识别缓动曲线:reanimate的easing拟合与弹簧参数还原技巧详解

reanimate 是一个开源的 Claude Code 技能:它逐帧录制参考动画,重建到本地代码后,再用完全相同的方式录制副本,逐帧对比直到缓动曲线(easing)、时长和时序数字全部对上。本文详解它最硬核的部分——easing 拟合(自动匹配 25 种命名缓动曲线)与弹簧参数还原(从过冲百分比反推 stiffness / damping),帮你告别"看着像 easeOut 就先用着"的玄学时代。

reanimate 缓动曲线拟合工具演示:逐帧逆向动画并以帧为单位对比

为什么"肉眼猜"缓动曲线不可靠

做过动效克隆的人都有同感:一个卡片入场动画,你看着觉得是 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 给了一套不用看源码、纯靠测量的还原公式:

  1. 由过冲定阻尼比 ζ:过冲 ≈ exp(−πζ / √(1−ζ²))。查表即可——10% 过冲 → ζ≈0.59;5% → ζ≈0.69;20% → ζ≈0.46。
  2. 由回落时间定刚度:回落时间 ≈ 4 / (ζ·ω),其中 ω = √(stiffness/mass)。
  3. 固定 mass: 1,先按过冲选 ζ,再按回落时间解出 stiffness,最后必须对副本重新跑一遍 easing.ts 验证过冲和回落是否对齐。

Framer Motion 中的典型对应:10% 过冲、约 600 ms 回落 ≈ type: "spring", stiffness: 300, damping: 20(damping 越小过冲越狠,stiffness 越小越慢)。

turborepo 速度表缓动曲线复刻:弹簧驱动的指针回弹动效示例

💡 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 原站与 reanimate 复刻卡片的入场缓动对比:相同时刻、相同位移轨迹

指针跟随类动效同理:在 stripe.com 的 Visa 卡片上,卡片倾斜被记录为一条曲线(−0.174 → 0.262 rad,33~1800 ms),复刻版在 33 ms 与 0.5% 量程误差内完全对齐——两侧走的是同一条指针路径、同一套缓动。

stripe 卡片悬停倾斜缓动:原站与 reanimate 复刻版在同一指针路径下的姿态对比

常见失败模式对照表

每轮迭代只改证据指向的最小变量,通常 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 把缓动识别从"视觉玄学"变成了三件可复现的事:

  1. 测——track.json 逐帧采样 + easing.ts 对 25 条命名曲线做 RMSE 拟合,连声明时长都被当作自由参数一起解出来;
  2. 反推——弹簧不猜参数,用"过冲定 ζ、回落时间定 stiffness"两个公式还原;
  3. 证——--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/。

登录后查看全文
reanimate