Kinetic reel
這是一種完全以程式碼製作編輯級、高能量動態作品集影片的方法,源自「Work Reel ’26」(一部 84 秒的作品集影片:Microsoft → UW–Madison Surgery → Enterprise RAG → trace finale)。它包裝為一個可執行的 template/(一個 17 秒的示範,使用了所有技術)和一個完整的工作範例 examples/work-reel-26/(上游僅提供:https://github.com/tuzhechen2005/opus-video-skills/tree/main/skills/kinetic-reel/examples/work-reel-26)。
運作方式。 每一幀畫面都是時間 t 的純函數。reel/index.html 載入 reel/cues.js(時間軸)和 reel/reel.js(一個 ES 模組:three.js 圖層、一個 2D 文字畫布和一個 WebGL 後製通道)。render.mjs 驅動無頭 Chrome 瀏覽器來渲染聯繫表、條狀圖和靜止畫面以供審查,或平行渲染每一幀,然後 ffmpeg 編碼為 MP4。music/score.mjs 在 Node 中根據相同的 cues.js 合成配樂,因此每個重拍都能精準落在其畫面上。
工作流程
0. 建立專案架構
bash ~/.claude/skills/kinetic-reel/scripts/new_project.sh <project-dir>
然後在開始設計之前,完整閱讀 references/style-guide.md(外觀、動態詞彙、轉場目錄、版面規則)和 references/sound.md。大致瀏覽 examples/work-reel-26/reel.js(未複製於此;請參閱 https://github.com/tuzhechen2005/opus-video-skills/tree/main/skills/kinetic-reel/examples/work-reel-26)以了解長篇影片的組織方式。
1. 決定重點,然後製作分鏡表
- 詢問(或確定)什麼是主軸,以及每個部分分配多少時間。觀眾會注意到比例:Work Reel 的第二版中 Microsoft 佔了大約 60%,因此必須重新平衡。解決方案是為其他章節增加播放時間,而不是刪減人們喜愛的部分。目標是讓主軸佔約 35–40%。
- 從範本撰寫
STORYBOARD.md:時間預算、事實的來源真相、一個統一的設計手法,以及每個鏡頭一行(標題、視覺機制、轉場進入、聲音)。 - 事實是神聖的。 只使用提供的來源中的數據,每個數據都要附帶其範圍(「約 180 個自建案例」、「320 個雙語提示」)。任何說明性的內容(工具 ID、文件 ID、範例答案、AST)在 HUD 中都要標示為
SCHEMATIC。切勿繪製你沒有的逐維度數據。視覺化的是流程。醫療/臨床相關工作:不得做出療效聲明,若屬實則應說明「開發中 / 尚未驗證」。
2. 建構
reel/cues.js:S(場景開始)、hits(每一個重要的節拍)、CH(章節 → 分段進度條)、dur。120 BPM:切割點落在節拍上,章節變換落在小節上。reel/reel.js:每個鏡頭一個函數,sName(t)。每個函數繪製整個畫面:bg()→ 透過glShot(...)建立 GL 圖層 → 文字和形狀 →hud(t, {...})。在SCENES中註冊鏡頭並附上 key;在TR中加入轉場(或省略以在節拍上進行硬切)。- 維持
CJK常數,列出你繪製的每個中文字元(字型會以子集方式載入)。
3. 仔細檢查每個鏡頭,多看幾次
node render.mjs --sheet=1,4,7,10,13,15.5 --cols=3 --w=640 --out=out/check/sheet.jpg # 關鍵影格
node render.mjs --stills=10.4 --out=out/stills # 全解析度細節
ffmpeg -ss 16.0 -t .6 -i out/reel.mp4 -vf "fps=10,scale=320:-1,tile=6x1" out/check/tr.jpg # 一個轉場,來自編碼後的影片
用 Read 開啟每張圖片。檢查是否有碰撞(標籤壓到線條、統計數字疊到統計數字、文字進入 HUD 區域)、在剪接點出現空白影格、寬度 1600 px 時的可讀性,以及每個轉場必須從某個東西開始並乾淨地結束。預算:每個章節一張聯繫表、每個密集鏡頭一張全解析度靜止畫面、每種轉場類型一條條狀圖。
4. 配樂、渲染、編碼
node music/score.mjs && ffmpeg -y -i music/score.wav -af "highpass=f=30,equalizer=f=250:t=q:w=1:g=-2,loudnorm=I=-14:TP=-1.2:LRA=8" -c:a aac -b:a 192k assets/score.m4a
node render.mjs --frames --workers=4 # Mac GPU 上約 8–40 毫秒/幀:只需數秒,而非數分鐘
node render.mjs --encode --audio=assets/score.m4a --out=out/reel.mp4 --fps=30
# 網路用副本:ffmpeg -i out/reel.mp4 -vf scale=1600:900:flags=lanczos -c:v libx264 -preset slow -crf 23 -c:a aac -b:a 128k -movflags +faststart out/reel-web.mp4
你無法聽到配樂:使用 showspectrumpic 和每個區段的 RMS 來檢查,並在報告時說明。僅修改音訊時無需重新渲染:重新封裝即可(-map 0:v -map 1:a -c:v copy)。
最重要的規則
- 文字是主角。 壓縮顯示字型(Anton)用於標題、寬體怪诞字型(Archivo Black)用於衝擊性語句、斜體襯線字型(Instrument Serif)用於唯一的「聲音」台詞、等寬字型(JetBrains Mono)用於所有標籤。大的英文標題,小的中文註解(當觀眾為雙語時)。
- 每個鏡頭都有一個視覺機制,而不只是文字:網格路由、矩陣掃描、token 在狀態機間跳躍、列表融合、封包通過閘門。標題命名機制;機制證明標題。
- 節拍鎖定。 字母、晶片、計數器和剪輯點都落在
hits上。快速進入(expo-out)、停頓、然後下一拍。 - 連續性。 在一個章節內部,優先使用形狀連續性轉場(透過眼睛注視的元素放大、從剛剛亮起的東西進行虹膜轉場),而非硬切。硬切加上衝擊效果則用於章節轉換。
- 不要使用雜訊嘶嘶聲。 在章節開始時使用調性內的漸強音,章節內部使用安靜的音調提示,約一半的剪輯點使用靜音。
- 誠實的數據(參見步驟 1),任何說明性的內容都要標上
SCHEMATIC標籤。 - 保護數學運算。 從
backOut()計算出的半徑可能低於 0(Canvas 拋出錯誤):circle/starburst/jelly已內建保護。在合成器中,在呼叫pow()之前將局部時間限制為 ≥ 0,並限制 SVF 的f/q值(範本中均已內建)。
將影片作為網站開場頁面部署
Work Reel 以網站進入頁面的形式部署:index.html 全螢幕播放影片,然後轉交控制權給作品集。此模式已包裝在 examples/site-intro/ 中(index.html、css/intro-reel.css、js/intro-reel.js,以及一個支援 HTTP Range 的 Cloudflare Worker):
- 嘗試自動播放並開啟聲音。如果被拒絕,則靜音播放並顯示脈動的「點擊開啟聲音」。如果也被拒絕,或使用者設定
prefers-reduced-motion,則顯示「開始」模式的結束畫面(播放是主要按鈕)。 - 播放期間:頂部中央顯示小型玻璃藥丸狀提示,因為影片的 HUD 佔據了角落。「跳過開場」帶有一個隨著影片進度填充的圓環。聲音切換鈕的等化器條會以影片的 BPM 脈動。Esc 跳過,M 靜音。
- 結束畫面:使用 HTML 重現影片的語法。角落括號、以 drop-in 字母(Anton)顯示的名字、等寬微字型、分段軌跡條、一個粒子地形的 2D 點陣版本、一個萊姆色主要 CTA(懸停時文字滾動、光澤、磁性、每個小節脈動一次),以及一個幽靈般的「再看一次」。
- 透過從按下的控制項進行萊姆色虹膜轉場,降低音訊,然後導航。
- 兩個編碼版本(1600×900 約 1.3 Mbps,960×540 約 0.6 Mbps 用於手機 / 省流量模式),
preload="auto",一張海報圖片。請使用 HTTP Range(206)提供服務,否則 Safari 的搜尋功能會出問題。