動態效果選取器
來源：tools/repos/awesome-ai-motion（MIT 授權；GSAP 以其免費授權條款綑綁，請參閱其 ATTRIBUTIONS.md）。637 張效果卡，其中 128 張附有渲染片段與 HTML 範本、11 種配方、決策表。無需閱讀整個索引，直接查詢即可。
步驟
- 用一句話說明場景意圖與媒介（「開啟影片的提問，短影音」）。
- 查詢：
python -S studio.py motion find reveal --purpose attention --medium shorts --rendered --limit 8
python -S studio.py motion show mask-reveal
python -S studio.py motion recipe # 列出配方
python -S studio.py motion recipe edu-hook # 含時間與參數的步驟
用途：注意力、解釋、比較、序列、強調、轉場、資料、回饋、氛圍、品牌。媒體類型：解說、短影音、滾動簡報、簡報、產品展示、資料故事、網頁 UI。也可使用 --family、--level。
3. 選擇 2 或 3 個候選，閱讀每張效果卡的 use_when、avoid、params、ease、pairs_with。先採用卡片預設值，再進行調整。
4. 依照共用規則進行組合：每個場景一個焦點、一個主要動作加上一或兩個輔助動作、完成狀態需停留足夠閱讀時間、僅使用 transform 與 opacity。
5. 實作為純時間函數。效果卡的 snippet 為 GSAP，請將其轉譯，不要匯入：
- 秒數轉為進度：
p = clamp((t - start) / duration)；間隔 =start + i * gap - 來自
templates/motion-helpers.js的緩動函數（easeOut、easeIn、easeInOut、backOut、elasticOut、spring）：power3.out為easeOut(3) yPercent: 110 -> 0表示在設有overflow: hidden的視窗內，將行內元素從translateY(110% -> 0%)
- 使用
motion-ui-polish（代碼記號與閘門）建構，檢視開始、主要動作與結束狀態的畫面幀，並與效果卡的good_example進行比較。
當範本存在時
若 show 輸出 html_template，請開啟它以檢視結構與時間安排，將其複製到工作的 source/ 目錄中，並取代文字或資料。保留時間軸。請勿在未安裝 Playwright 依賴項的情況下執行目錄的 render.mjs；我們的管線透過 vstudio 或 HTML 渲染器進行渲染。
前五秒（教育與解說影片）
0 到 1 秒：提問或令人驚訝的結果；1 到 3 秒：機制或比較的線索；3 到 5 秒：學習承諾，並提供可閱讀的停頓。每個畫面一個主張。大型鏡頭移動僅用於揭示問題或結果。從 motion recipe edu-hook 開始，接著使用 mask-reveal、split-compare、count-up、annotation-callout。
限制
- 效果卡參數名稱部分為韓文；數值、範圍、
ease與snippet為語言中立。描述與提示會以英文回傳。 - 標示
planned的效果卡沒有片段或範本；僅使用其參數與提示。 - 過度使用的效果看起來像程式產生的。請勿在一個場景中對一個以上元素重複使用同一效果，也不要同時對同一時刻疊加三個效果。