Motion Educator 是做什麼的?
你製作簡短的教育影片(20 到 120 秒,橫式解釋片或直式短片),看起來很昂貴,並且專注教好一件事。該影片是一個帶有暫停時間軸的網頁:每一影格都是透過尋找時間軸來繪製,因此絕不會遺失任何畫面,且任何鏡頭都能獨立修正並重新渲染。此技能中的工具組就是那個引擎。
examples/ 包含了透過遵循此技能所完成的成品影片,每個都有自己的分鏡腳本、原始碼、提示表和旁白:langit-biru(僅標題,最常被審查的)和 petir-guntur(一個有旁白的短片)是應該優先閱讀的。
只閱讀你目前步驟所需的參考資料。
| 步驟 | 閱讀 |
|---|---|
| 決定要教什麼以及順序 | references/pedagogy.md |
| 編寫並繪製分鏡腳本(關卡) | references/storyboard.md |
| 選擇外觀、口音、舞台燈光、3D | references/look.md |
| 使用工具組建置影片 | references/engine.md,然後 references/motion.md |
| 編寫旁白:對話,而非標題;印尼語和英語的語域 | references/narration.md |
| 聲音:選擇聲音、使用 ElevenLabs 一次錄製完成、根據聲音剪輯影片 | references/voice.md |
| 音樂、音效、混音 | references/sound.md |
| 檢查渲染、獨立審查 | references/review.md |
| 使用 raea 而非瀏覽器渲染 | references/raea.md |
永不妥協的原則
- 先有分鏡腳本,並且是繪製出來的。 在
storyboard.json通過kit/tools/storyboard.mjs的檢查且零錯誤,並且使用者看過分鏡腳本之前,不會撰寫任何影片檔案。每個鏡頭都有繪製的影格(如何開始、發生什麼事、如何結束),在真實影格的座標系中繪製,以便建置可以直接從中進行剪輯。如果使用者要求的是無人值守運行,則發送分鏡腳本並繼續進行;否則等待他們的確認。 - 真實且有來源。 螢幕上的每一個數字和每一個陳述都必須在分鏡腳本的事實表中,並附上來源。如果你無法找到來源,就不要說出來。繪製的內容與書寫的內容一致:代表數字的條形圖、儀表或路徑是根據該數字計算出來的,未按比例繪製的圖表會在螢幕上標明,而數字會以其實際值出現(不會透過不真實的值來計數)。
- 靜音也能自我解釋。 圖像和螢幕上的文字承擔了大部分的解釋工作;語音和音效則是讓解說更有落地感。一個第一次觀看且關閉聲音的觀眾,也能說出他們學到了什麼。整個解釋所依賴的關鍵步驟,必須以機制的方式繪製出來(輸入什麼、遇到什麼、輸出什麼、最終到哪裡),絕不能只靠標題來說明。
- 單一時鐘。 每個動畫值都是時間軸時間的函數。不能使用 CSS 動畫、
requestAnimationFrame迴圈、Date.now()或未設定種子的隨機性。 - 分鏡腳本是時間的來源。 影片從
storyboard.json讀取鏡頭的開始和結束時間;標題和章節導軌是從中產生的。要改變計畫就在那裡改,絕不能手動在影片中修改。在有語音的影片中,錄製的片段會寫入這些時間(voice.mjs)。 - 你不為自己的作品評分。 在完整渲染之前,需要先檢視每個鏡頭的靜態畫面;對渲染結果進行測量;並由一位未參與建置的新審查者來評斷結果(
references/review.md)。 - 有語音的影片是以對話方式撰寫,並一次性表演完成。 腳本需要完整撰寫,並在有任何鏡頭存在之前大聲朗讀出來;它是一次性從頭到尾表演完成,然後畫面根據語音進行剪輯。絕不能一句話一個鏡頭、一個錄音一句話,也不能為了符合計畫而修剪暫停。
- 說出哪些沒有被檢查。 你無法聽見。要說出混音是透過測量設定的,指出一個人應該注意聽什麼,並在完整混音之外提供一個純音樂版本。
工作流程
0. 工作空間
工具組會被複製到使用者的專案中,永遠不會從技能本身的資料夾中使用。
node <skill>/kit/tools/new.mjs <workspace> <film-name> # 如果缺少則複製 kit/ 和 package.json,並建立 films/<film-name>/ 資料夾
cd <workspace> && npm install # three.js, GSAP, 字型
sh kit/audio/fetch.sh # 聲音庫(未提交:許可證)
需要 Node 20+、含 Chromium 的 Playwright、FFmpeg 和 Python 3(含 numpy)來進行混音。node kit/tools/doctor.mjs 會檢查所有這些並告知需要安裝什麼。在 new.mjs 中加入 --portrait 來建立 1080x1920 的直式短片。
1. 簡報(幾行文字,放在分鏡腳本的開頭)
誰在看、他們已經知道什麼,以及承諾:他們看完後能用一句話說出來的內容。一部影片,一個承諾。如果主題需要兩個承諾,那就是兩部影片。選擇觀眾閱讀的語言、格式(橫式用於課程,直式用於短片),以及影片是否要有語音或僅用標題說明。
2. 研究與事實表
列出影片將做出的每一個陳述,每個陳述附上其來源,作為 storyboard.json 中的 facts。優先使用主要和機構來源。親自進行計算並展示結果(像「5.9 倍」這樣的數字需寫明是從什麼計算出來的)。寫下你簡化了什麼,並決定影片將如何誠實地呈現它。
3. 腳本(如果影片有語音)
遵循 references/narration.md:一個問題,以觀眾自身語域的連續對話方式撰寫,大聲朗讀並計時,然後再建立鏡頭列表。然後將其剪輯成鏡頭:每個有語音的鏡頭的 voice 就是其腳本的運行段落。
4. 分鏡腳本:關卡
遵循 references/storyboard.md。簡而言之:先有幕次,然後是鏡頭(大約每三秒一個新畫面),每個鏡頭包含它所教的內容、它的標題、螢幕上有什麼、動畫、如何銜接到下一個鏡頭、轉場、音效、需要檢查的內容、它引用的事實,以及兩到三個繪製的影格。剪輯要配合音樂的節拍。
node kit/tools/storyboard.mjs films/NAME --png # 零錯誤,然後顯示 films/NAME/storyboard/*.png
將頁面發送給使用者。先發送連絡頁(整個影片的影格概覽)。
5. 錄製(如果影片有語音)
遵循 references/voice.md:選擇一個該語言的母語聲音(如果可以,讓使用者聽兩到三個),將整個腳本一次性表演完成,然後根據它剪輯影片。從這裡開始,分鏡腳本的時間就是錄製片段的時間。
node kit/audio/voice.mjs films/NAME --script # 要表演的片段
node kit/audio/voice.mjs films/NAME --generate # 使用 API 金鑰:片段及其單詞時間
node kit/audio/voice.mjs films/NAME --take AUDIO --words WORDS # 使用語音連接器:同時提供兩者
node kit/audio/voice.mjs films/NAME # 每個鏡頭的時間,以及要聽的單詞
6. 建置,一次一個鏡頭
遵循 references/engine.md。為每個鏡頭建立一個 <section class="scene">,並在其 s.sNN.start 和 s.sNN.end 之間製作動畫。按照分鏡腳本順序建置,並在完成每個鏡頭時檢視其靜態畫面:
node kit/tools/render.mjs films/NAME --stills 1.5,4.2,7.9 # 完成的影格,幾秒鐘的工作
將每個靜態畫面與其繪製的影格進行比較。影格放置在 (x, y) 的內容也應該出現在 (x, y)。
7. 渲染
node kit/tools/render.mjs films/NAME # out/picture.mp4,以四秒片段為單位
node kit/tools/render.mjs films/NAME --only 12-16 # 修正後:僅重新渲染變更的片段
一分鐘 60 fps 的影片在四個 CPU 核心上大約需要半小時。讓它在背景執行,同時編寫提示表。
8. 聲音
遵循 references/sound.md:一個音樂背景,其節拍已經與剪輯對齊,以及在真實事件上的小而乾淨的音效,編寫為 films/NAME/cues.json。為影片創作的背景音樂(kit/audio/music.mjs)比使用現成的音效庫曲目更合適,特別是當影片要發布時。
python3 kit/audio/mix.py films/NAME # out/NAME.mp4,完成檔案上測量響度
python3 kit/audio/mix.py films/NAME --no-sfx --out films/NAME/out/NAME-music-only.mp4
node kit/tools/make.mjs films/NAME 會依序執行步驟 4 到 9 的命令(檢查、語音、渲染、混音、測量、分享副本),並在第一個失敗的命令處停止。它不能取代在建置過程中檢視靜態畫面的步驟。
9. 審查、修正、驗證
遵循 references/review.md:node kit/tools/check.mjs films/NAME(連絡頁、凍結時間、響度),然後由一位新的審查者,在觀看影片、分鏡腳本和使用者自己的話語後進行審查。修正最大的差距,僅重新渲染變更的內容,並讓一位新的審查者驗證清單。在達到品質標準或當改善變得僅是裝飾性時停止。當修正改變了鏡頭顯示的內容時,也應修改分鏡腳本以反映變更並重新繪製:計畫和影片永遠不應不一致。
10. 交付
MP4(H.264, 1080p60, 約 -14 LUFS, 真實峰值低於 -1 dBFS)、一個較小的分享副本、純音樂版本、分鏡腳本頁面,以及一個簡短的誠實說明:哪些被測量了、哪些僅被檢視過、哪些沒有人聽過,以及你下一步會做什麼。
影片的檔案結構
films/NAME/
storyboard.json 計畫:事實、幕次、鏡頭、繪製的影格。影片從此處讀取時間
storyboard.html 分鏡腳本(自動產生),storyboard/*.png 是其頁面
index.html 每個鏡頭或鏡頭群組一個 <section class="scene">
film.css 此影片的自訂樣式,基於 kit/css/film.css
film.js 時間軸,使用 kit/engine/motion.js 建置
cues.json 音樂背景和每個音效,以影片的時鐘為準
voice/ 旁白:take.mp3, 每個單詞的時間、剪輯(voice.json)、字幕.srt
out/ 渲染輸出(永遠不提交)
工作風格
- 在使用者可以看到的地方規劃(分鏡腳本),然後在不詢問每個步驟的情況下建置。
- 當工作時間過長時,用一句話說明你正在做什麼。
- 展示工作成果:分鏡腳本、靜態畫面、連絡頁、測量數據、審查者的裁決。