電影級節拍同步短片
與 video-editor-pro 搭配使用（請參閱 references/studio-folder-structure.md、lessons-and-feedback.md）。參考專案：projects/2026-10-16_car-delivery-cinematic-reel（22.7 秒、97 BPM、19 個鏡頭、v1→v3）。
資料夾結構
projects/YYYY-MM-DD_<slug>/
raw/ （影片 IMG_*.MOV、照片 *.JPG、歌曲 .mp3）
edit/ plan.py build_shots.py compose.py ff.sh
work/ base.mp4 → fx.mp4 → mix exports/ vN_<what>.mp4 notes.md
ff.sh：exec /opt/homebrew/opt/ffmpeg-full/bin/ffmpeg -nostdin "$@"（背景執行的 ffmpeg 若無 -nostdin 會卡住）。
處理管線
- 探測所有素材（fps、方向、長度）+ 製作縮圖索引；挑選主鏡頭、細節鏡頭、儀式鏡頭及廣角鏡頭。60 fps 的手機影片可實現 0.5 倍真正的慢動作。
- 節拍網格：
video-editor-pro/scripts/beat_detect.py song→ BPM、節拍長度、第一個節拍。在plan.py中：T(n)=FIRST+BEAT*n，裁切幀數對齊至round(T*FPS)。 - SHOTS 列表
(start_beat, clip, src_in, speed, ("in"|"out", amount), (fx,fy))。按小節結構：慢動作主鏡頭開場 → 美麗細節（慢速）→ 以 1 拍/鏡頭進行儀式 → 鋪陳 → 重拍（廣角鏡頭、在重拍處閃光 + 衝擊）→ 慢速側拍 → 情感時刻 → 結尾照片（快門音效、白色閃光）→ 主照片加標題 → 淡出。慢速小節使用長鏡頭，1 拍剪輯以增加能量。 - build_shots.py →
work/base.mp4（平滑推/拉、每個鏡頭的焦點）。 - FX 處理（獨立 ffmpeg）：電影調色（滾動式亮部、青藍暗部/暖色亮部）、綻放效果、暗角、顆粒 →
work/fx.mp4。此步驟與疊加處理分開進行。 - compose.py：標題、白色/琥珀色閃光（
FLASHES = (beat, colour, dur, alpha)）、音效（重拍處的 boom_hit/sub_drop、之前的上昇音效、照片處的快門聲）、歌曲母帶 → 合成。 - 交付：正規化至
-14 LUFS、--tp -1.5、AAC 320k、qc.py --platform reels。對結果製作縮圖索引。
標題規則（根據反饋學到）
使用大膽的 Optima 風格標題，並帶有強烈漸層/陰影 – 微弱的標題曾被拒絕（v1→v2）。將文字保持在安全邊框內（v3）。將片尾文字置於單純區域（例如屋頂），避免遮擋臉部或車牌。典型片尾卡：WELCOME HOME / FAMILY NAME / DELIVERY DAY。
縮圖（務必執行，2026-10-16 使用者要求）
每次匯出時（及每次預覽時）請製作 exports/vN_cover_reels_1080x1920.jpg（所有文字位於中央 1080x1440 = Instagram 3:4 網格裁切區域內）以及 exports/vN_thumb_youtube_1280x720.jpg，使用最清晰的原始解析度照片/影格，調色風格與影片一致，加上粗體 Montserrat Black 標題、品牌黃色強調標記以及真實 logo。請使用 thumbnail-designer 技能。