運動匹配:測量任何動畫,重建它,證明它移動方式相同
將「讓它像這樣移動」轉化為數字:每一個剪輯點,每個移動元素的開始、持續時間、緩動、超調、位移、旋轉和形狀變化。在用戶使用的任何工具中重建運動(CSS、Web Animations API、Framer Motion、GSAP、Remotion、SwiftUI、After Effects),然後逐格比對,直到時間匹配在 ±0.08 秒內。沒有參考運動,只有靜態圖像?使用導演模式(如下)處理 UI 進入動畫,故事模式處理短影片和解說片段:Claude 設計運動、構建它,然後用相同的腳本測量自己的渲染結果,因此「流暢」是經過檢查的,而不是聲稱的。要將影片片段剪輯成廣告(UGC、AI 生成、實拍)?使用編輯模式:對素材應用相同的測量、導演規則和審查。 方法改編自 NiazMorshed2007/reanimate 和 rossark0/rossark-motion-skill(皆為 MIT 授權);腳本是我們自己的。
<skill> 是此技能的文件夾。工作目錄位於當前文件夾的 ./motion-match/<name>/:
ref/(參考分解)、ours/(我們的渲染分解)、compare-N/(每次比較的結果)、spec.md。
設置(首次使用)
需要在 PATH 上安裝 ffmpeg/ffprobe 以及一個包含 numpy 和 Pillow 的 Python 3。
- 檢查:
python3 -c "import numpy, PIL"。如果失敗,尋找一個包含它們的 Python(現有項目虛擬環境),否則詢問用戶一次,然後:python3 -m venv ~/.motion-match/venv && ~/.motion-match/venv/bin/pip install numpy pillow並使用~/.motion-match/venv/bin/python作為下面的python。每個腳本都使用-I運行。 - 導演和故事模式也需要渲染無頭頁面:
pip install playwright && python -m playwright install chromium(詢問一次)。如果無法安裝,則改為螢幕錄製頁面,並說明時間可能不太精確。 - 無需其他安裝;不會上傳任何內容到任何地方。
0. 範圍(在測量之前將其寫在 spec.md 頂部)
- 目標: 用戶明確指定的文件 + 時間範圍(+ 裁切)(例如「前 3 秒」、「只需按鈕」)。
- 忠實度: 運動忠實(預設):順序、時間(±0.08 秒)、緩動家族、超調、相對於元素大小的位移、交錯。用戶自己的藝術作品、顏色、字體和文字。僅在用戶要求且僅用於私人練習時才使用畫素忠實:他人的設計、標誌、角色和音樂屬於他們;永遠不要幫助發布它們的副本。
- 目標: 運動將進入的工具或程式碼(如果不清楚,詢問一次:它決定輸出格式)。
- 獲取參考: 用戶提供的檔案,或他們製作的螢幕錄製(網站和應用程式:錄製互動;技能基於影格運作,而非網站的程式碼)。僅在用戶要求特定影片時,才從 YouTube 或網站下載,放入其自己的文件夾;將其視為私人參考資料。
1. 分解它
python -I <skill>/scripts/ref_frames.py REF.mp4 --out motion-match/<name>/ref [--start S --end E --crop x:y:w:h]
→ 以原始 fps 的每個影格,sheets/timing_NN.png(每個影格:時間、緩動、跟隨動作)和 sheets/poses.png(每秒 2 張:發生了什麼)。閱讀每張 sheet。GIF 的處理方式相同。
2. 測量
- 剪輯和段落:
python -I <skill>/scripts/motion_compare.py motion-match/<name>/ref motion-match/<name>/ref --out motion-match/<name>/self --no-align列出參考的剪輯點(場景變化)及其時間與動作。從未靜止的參考會在其剪輯點處分割。 - 精確顏色:
python -I <skill>/scripts/track_motion.py <ref>/frames --sample X,Y --at T(完整尺寸影格的像素座標,而非 contact sheet 的)。 - 每個移動元素:
track_motion.py <ref>/frames --name btn --colors HEX,HEX --tol 35 --region x,y,w,h [--save-masks](或使用--not-bg HEX表示「所有不是背景的內容」)。在發光或忙碌的參考上,始終提供--region和元素特有的顏色;檢查列印的可見影格範圍是否合理。記錄每個影格的位置(cx cy)、尺寸(w h)、壓縮(aspect)、邊緣、淡入淡出/增長(presence)、顏色和旋轉(angle)。 - 每個移動:
python -I <skill>/scripts/fit_easing.py <ref>/track_btn.json --prop cy --from A --to B(每次移動一個視窗,從不跨越剪輯點)→ 開始、結束、持續時間(毫秒和影格數)、緩動家族、超調、穩定時間以及可直接複製貼上到 CSS、WAAPI、Framer Motion、GSAP 和 Remotion 的程式碼行。 誤差 ≤ 0.03 是良好的擬合;「無單一緩動可擬合」表示需要分割視窗,或者它是一個姿勢鏈(關鍵影格)。 - 小幅度運動(2% 的擠壓、5 像素的浮動)在 sheets 上看不到,但在追蹤數據中會顯示:閱讀它們。
- 小型淡入文字接近活動曲線的雜訊:改用
track_motion測量。
哪些數字測量哪種運動
| 運動 | 測量方式 | 備註 |
|---|---|---|
| 移動、滑動、浮動 | cx, cy | 每個軸一次擬合 |
| 縮放、增長、擠壓 | w, h, aspect | |
| 淡入淡出 | presence(搭配 --colors) | |
| 旋轉、自旋 | angle(度數,順時針為正,連續超過 360) | 來自輪廓;圓形為 None:追蹤其上的標記作為獨立元素並擬合其 cx/cy。具有 n 折對稱性的形狀(正方形:4)每影格需要 < 180/n 度,因此快速自旋需要高 fps 來源。區域內其他相同顏色的形狀會干擾:縮小 --region |
| 變形(形狀 → 形狀) | --save-masks,然後使用 shape_compare.py | 見下文 |
| 3D 翻轉 / 卡片翻轉 | w(像 cos 一樣縮小)+ presence;在中點處顏色翻轉 | 背面是其自己的元素 |
| 路徑運動(弧線、曲線) | cx 和 cy 兩者,如果沿路徑轉彎則加上 angle | 擬合每個軸;路徑形狀在 sheets 上 |
| 剪輯 / 遮罩揭示、擦拭 | x1 或 y1(前緣)、w/h | |
| 線條繪製 | presence | |
| 文字分割(每個單詞/字母) | 追蹤第一個和最後一個單詞;交錯是它們的開始間隔 ÷(計數 − 1) | |
| 計數器、圖表條 | 條形:h/y0;數字:sheets(目測) |
變形。 track_motion.py ... --name blob --save-masks 保存每個影格的輪廓(居中、縮放到等面積)。然後:
python -I <skill>/scripts/shape_compare.py <ref>/track_blob_masks.npz --from A --to B將morph系列(0 = 初始形狀,1 = 最終形狀)添加到track_blob.json中。然後fit_easing.py ... --prop morph給出其開始、結束和持續時間。變形進度遵循面積,因此其時間是可靠的,但其緩動名稱不是要貼上的值:從規格中獲取緩動,或者從您可以追蹤的參數(w、aspect、angle)中獲取。- 我們的與參考的比對:
shape_compare.py REF_masks.npz --vs OURS_masks.npz --from A --to B [--rotate]→ 形狀路徑:參考的每個中間形狀是否也存在於我們的形狀中,無論其時間如何(通過:平均值 ≤ 10%,最差值 ≤ 整個變形過程的 25%)。然後fit_easing.py REF_TRACK --prop morph --vs OUR_TRACK檢查時間。--rotate在變形同時旋轉時忽略轉動(使用angle檢查)。
3. 撰寫運動規格(spec.md;每一行都變成一個檢查點)
| # | 元素 | 屬性 | 從 → 到 | 開始秒 | 持續秒 (影格數) | 緩動 | 超調 | 交錯/備註 | 來源 |
| 1 | 卡片 | translateY | 40 → 0 px | 0.20 | 0.60 (18) | easeOutCubic / cubic-bezier(.33,1,.68,1) | 0% | +0.08 秒每張卡片 | 追蹤 + fit_easing |
| 2 | 圖標 | rotate | 0 → 180 deg | 0.40 | 0.30 (9) | easeOutCubic | 0% | — | 追蹤角度 + fit_easing |
| 3 | 色塊 | morph | 正方形 → 圓形 | 0.50 | 0.40 (12) | easeInOutCubic | — | 形狀路徑通過 | shape_compare |
| c | — | 剪輯 | — | 1.77, 2.33 | — | — | — | — | motion_compare 自檢 |
行中的「?」表示影格尚未讀取。也要註明沒有移動的內容。當工作量很大時,在構建之前向用戶顯示規格。
4. 構建
在用戶的工具中,使用他們的設計。從規格複製時間,從該工具的擬合器輸出複製緩動。當佈局不同時,相對於元素或影格映射距離。姿勢鏈:使用平滑、無超調的插值的關鍵影格;在參考有超調和穩定時使用彈簧。
- 旋轉: 顯式設置
transform-origin(測量樞軸點:其cx、cy保持不變的點)。 - 變形: SVG 路徑在兩端需要相同數量和類型的命令(或使用 flubber / GSAP MorphSVG);UI 佈局變形(按鈕 → 卡片、縮略圖 → 頁面)使用 FLIP 或共享元素過渡(Framer
layoutId、View Transitions API);圓角半徑/尺寸變形是純 CSS。 - 3D: 父元素設置
perspective800–1200 px,backface-visibility: hidden,兩個面作為單獨的圖層。
5. 比較和修正(2-5 輪)
- 在相同視窗中以相同 fps 渲染或螢幕錄製我們的結果(以與參考相同的方式錄製網頁)。
ref_frames.py OURS.mp4 --out motion-match/<name>/ours --like motion-match/<name>/ref/frames.json(相同的視窗、裁切、fps 和影格大小)。motion_compare.py motion-match/<name>/ref motion-match/<name>/ours --out motion-match/<name>/compare-N→ 偏移、每個剪輯和移動的開始/結束/持續時間/峰值誤差、±0.08 秒內通過、activity.png(兩條曲線)和sheets/compare_NN.png(參考 | 我們的 | 差異)。每輪都閱讀 sheets。- 每個規格行:以相同方式追蹤我們的,然後
fit_easing.py REF_TRACK --prop P --from A --to B --vs OUR_TRACK→ 每個移動的時間通過/失敗、位移和緩動家族匹配。變形行:也使用shape_compare.py --vs。 - 根據證據修正最小的問題,重新渲染,重複。5 輪後,報告任何仍然失敗的項目及其數字和原因。永遠不要暗中放寬容差。
| 症狀 | 常見原因 | 修正 |
|---|---|---|
| 所有內容都偏移一個偏移量 | 起始延遲或觸發延遲 | 調整第一個延遲 |
| 我們的更短且前置 | 緩動太強(expo 與 cubic) | 使用擬合後的貝塞爾曲線 |
| 參考有超調,我們的沒有 | 彈簧/back 與普通緩動 | back.out / 一個根據測量的超調調整的彈簧 |
| 我們的移動過早停止 | 缺少次要運動(漂移、推入) | 查看該視窗中的 sheets |
| 我們這裡多了一個移動或剪輯 | 某物在參考中靜止卻被動畫化了 | 移除或延遲它 |
| 元素編號跳動 | 追蹤捕捉到另一個元素 | 縮小 --region,使用其特有的顏色 |
旋轉位移正確,但我們的 cx/cy 搖晃 | 錯誤的 transform-origin | 將樞軸移動到測量的靜止點 |
| 變形時間通過,形狀路徑失敗 | 路徑插值不同(點順序、起始點) | 重新排序路徑點/匹配命令;使用變形庫 |
6. 報告
忠實度;匹配了什麼以及用戶自己的是什麼;最後的比較表(剪輯和移動及其誤差、通過/失敗);每個元素的行;activity.png 和比較 sheets 的路徑;每個剩餘差異及其數字和原因;以及哪些檢查是測量的(腳本產生的)與目測的(查看 sheet)。
導演模式:輸入靜態圖像,為其設計運動
當用戶提供圖像(UI 截圖、模型、海報、產品照片)而沒有參考運動,或者要求 Claude 選擇運動時使用。工作目錄照常位於 ./motion-match/<name>/(ours/、spec.md、check-N/)。
對於影片片段而不是 UI 進入動畫,請在下方故事模式的步驟中遵循這些步驟。
- 讀取圖像。 列出每個元素(背景、導航、標題、正文、圖像、行動呼籲、卡片、圖標)及其像素框、角色和排名:一個焦點,然後是支援元素,最後是裝飾元素。注意閱讀順序、分組(一行卡片、一個列表)、氛圍(平靜/高端、中性/產品、有趣)以及任何暗示特殊運動的內容(切換圖標、圖表、標誌標記、曲線路徑、可翻轉卡片)。
- 根據氛圍選擇個性,除非用戶指定。當他們要求選項時,構建所有三種。
| 個性 | 進入方式 | 持續時間 | 緩動 | 位移 | 交錯 | 超調 |
|---|---|---|---|---|---|---|
| 平靜 | 淡入 + 上升 | 400–600 ms | easeOutQuart / cubic-bezier(.25,1,.5,1) | 8–16 px | 60–80 ms | 無 |
| 中性 | 淡入 + 上升,或縮放 .97→1 | 250–400 ms | easeOutCubic / cubic-bezier(.33,1,.68,1) | 12–24 px | 40–60 ms | 無 |
| 有趣 | 上升 + 縮放 .9→1 | 彈簧 | 彈簧(剛度 300–400,阻尼 20–26) | 16–32 px | 50–70 ms | 3–8% |
- 根據角色選擇特殊運動(詞彙;數值是起點,按個性縮放):
| 運動 | 用於何時 | 預設值 |
|---|---|---|
| 變形 | 圖標切換(選單 ↔ 關閉、播放 ↔ 暫停)、按鈕展開為卡片或面板、形狀標誌 | 300–500 ms easeInOutCubic;透過 FLIP/共享元素的佈局變形 |
| 旋轉 | 切換/箭頭圖標、刷新、傾斜進入 | 圖標 90–180° 在 200–300 ms easeOutCubic;進入 −6…−10° → 0 配合個性的緩動;載入器 360° 線性 0.8–1.2 秒循環 |
| 3D 翻轉/傾斜 | 具有兩個面的卡片、定價切換、懸停深度 | 翻轉 rotateY 180° 在 500–700 ms easeInOutCubic;懸停傾斜 ≤ 8° |
| 路徑運動 | 某物在行進(飛機、沿路線的點、遊標) | easeInOutSine,沿路徑轉彎,0.8–1.6 秒 |
| 剪輯/遮罩揭示 | 英雄圖像、大標題 | 插入或圓形剪輯,500–800 ms easeOutQuart |
| 文字分割 | 僅主標題 | 單詞間隔 40–60 ms,字母間隔 15–30 ms;整行 ≤ 1 秒 |
| 線條繪製 | 圖標、簽名、圖表、底線 | stroke-dashoffset,600–1000 ms easeInOutCubic |
| 計數器/圖表增長 | 數字、條形、環形 | 數字 800–1200 ms easeOutExpo;條形從基線開始,交錯 40–60 ms |
| 視差/深度 | 分層英雄、滾動場景 | 圖層速度 0.2–0.6 的滾動;支援時使用滾動時間線 |
- 按以下規則編排:
[由於內容被截斷,此處無法提供完整翻譯,但會根據規則完成]