紙偶動畫 QA 是做什麼的?
將影格與風格 DNA 和分鏡圖進行比較,重點在於風格而非內容。建議在建立每個場景時執行,並在最終渲染前對整部影片再執行一次。
前置檢查
- 安裝:標準 或完整安裝。靜態影格需要一個已建立 scaffold 且包含 Remotion 的專案,而接觸片則需要安裝了 numpy 和 Pillow 的 Python(
$MOTION_PY)。若缺少元件:執行./install.sh --doctor,然後再執行motion-setup。 kyfram專案不需要 Remotion:在檢查或修復 Kyfram 場景輸出前,請先呼叫kyfram技能。qa.sh會從快取的每個場景片段(core/tools/kyfram_qa.py)中提取其靜態影格,因此請在 QA 前先使用core/tools/render.sh渲染一次。以下所有說明同樣適用。- 函式庫:使用
$MOTION_LIB,否則讀取~/.config/motion-explainer/config.env中的MOTION_LIB=行,若仍無則於執行時詢問一次。 - 首先閱讀:位於
$MOTION_LIB/style/$MOTION_STYLE/docs/style-guide.md第 2 節的風格 DNA,以及背景底圖style/$MOTION_STYLE/remotion/public/bg/backdrops/_sheet.jpg。每張圖片約消耗 0.7-1.5k tokens,因此僅在需要時才開啟。 - 關於密度,請參考
$MOTION_LIB/style/$MOTION_STYLE/docs/frame-breakdown.md(結尾處的「節奏統計」):每個場景平均 2.8 秒,包含 2-4 個離散的視覺事件,每個事件間隔 0.4-0.8 秒並落在重讀的單詞上,大約每 0.6 秒出現一個新的圖卡頁面。請複製其密度,而非內容。
1. 渲染靜態影格
從專案的 video/ 資料夾執行:
$MOTION_LIB/core/tools/qa.sh NAME FROM-TO NTH [SCALE=0.3] [COLS=9]
- 每次檢查使用 4-6 個時間點。對於一個場景,NTH 約為其長度(以影格數計)除以 4。若要檢查整部影片,請省略
FROM-TO並提高 NTH。 - 輸出為
out/qa/NAME_0.jpg(以及較長範圍的_1、_2),每張接觸片最多 45 個影格。請閱讀接觸片,並保持其小巧。 - 每個場景只執行一個 QA 命令,且絕不同時執行兩個渲染任務。每個場景的修正保持在兩輪內。
- 與分鏡圖比對:該場景的第 0 影格、關鍵事件發生的單詞上的影格,確保沒有內容被裁切,也沒有任何東西遮擋橫幅或圖卡區域。
2. 檢查清單
- 每個物體看起來都像紙:具有紙張紋理、粗糙邊緣、投影、堆疊陰影,沒有輪廓線或漸層。
- 世界攝影機移動流暢。只有橫幅和標籤會抖動(階梯式、細微)。
- 橫幅固定在一個位置並用膠帶貼住,包含 3-7 個單詞,每個單詞一個事實,絕不重複 VO。僅憑橫幅就能讀懂為一張事實表。
- 每個場景都說明了其 VO 行中的一個具體單詞,數字是實體道具,並且在 CTA 之前有一個回顧場景。
- 每個數字和 UI 標籤都來自事實列表。腳本中至少有一個誠實的限制,並且功能堆疊恰好為三個。
- 圖卡:每個單詞一個標籤,傾斜放置,在起始時彈出,每頁 1-3 個,位於畫面 68-80% 的區域,絕不覆蓋人臉。
- 僅對角色、圖卡和信號進行飽和度調整。
- 每個重讀的單詞上都有一個視覺事件,且環境動畫始終在運行。
- 在橫幅變化處進行剪輯(導覽和新聞場景中為 1.5-3 秒,隱喻節拍中最多 5 秒),畫面底部 20% 保持清晰。
- HOOK 區塊(SAY / WRITE / SHOW / ALIGN)必須完全按照腳本顯示在畫面上: 第 0 影格顯示 SHOW 時刻正在進行中的動作,並在其上疊加 WRITE 標題,且第一行 VO 是 SAY。
- 每個場景都有一個攝影機運動、最多一個翻頁或撕頁效果、一個膠帶拉動或鞭打效果進入 CTA,且每個轉場都有其音效。
- 幽默感在畫面中可見:全片使用一種格式,每個想法一個服裝道具,一個掙扎的節拍,第 0 影格的道具在 CTA 場景中發生變化後回歸,每個笑點在 1 秒內可被理解,且絕不覆蓋橫幅、圖卡或關鍵數字。
- VO 和橫幅中的詞彙符合
SERIES.md中定義的觀眾水平。 - 旁白、圖卡和事件同步(在每個剪輯點仔細檢查 Studio)。
對於失敗的項目,請修正場景檔案(或函式庫中的套件,而非專案中的 src/lib/),然後重新執行該場景。使用 motion-build 重建場景。
3. 交付
開啟 Studio 預覽,列出各場景及其時間,並說明哪些是佔位符:語音、音樂、音效、素材。如果語音是佔位符,請說明如何重新配音(motion-voice)。發布後,數據將傳遞給 motion-strategy 進行後續分析。
原則審查
以 5 fps 的速度仔細檢查一個場景,並對照 $MOTION_LIB/style/$MOTION_STYLE/docs/motion-principles.md:每個大動作前的預備動作(2)、所有動作皆有緩入緩出(6)、撞擊後的尾隨效果(5)、一個焦點道具(3)、一個誇張的節拍(10)、堆疊陰影和一致的投影(11)。
交接
修正內容將回饋給 motion-build(場景或音效)或 motion-voice(同步)。一次乾淨的審查標誌著影片製作完成:當使用者要求時,使用 $MOTION_LIB/core/tools/render.sh 進行渲染。