video-cutlisted

# 影片剪輯產線 從幾萬個檔案裡找出該剪哪些，剪成片，上字幕，配樂。 市面上的剪片工具都假設「你已經有一支片，告訴我怎麼剪」。這支 skill 補的是前面那段： **素材在哪、哪些能用、怎麼分群**。 --- ## 鐵則 1. **渲染完要抽格看過。** 程式沒報錯不等於畫面對。CLAUDE.md 第七原則在這裡沒有例外。 2. **每輪只修 1 到 3 個最大落差。** 看整支，講出最嚴重的那個，改完重新排序，不要照舊清單往下做。 3. **素材數字從圖庫實際查。** 「大概有幾百支」這種話會害你選錯版面和長度。 4. **合成前逐段驗證。** 渲染偶爾產出截斷的 mp4，`moov atom not found`，重跑該段就好。 --- ## 五個步驟 | # | 做什麼 | 產出 | |---|---|---| | 1 | 掃圖庫、去重、分群、抓地名 | `assets.json`、分群表 | | 2 | 抽格做檢視表，用眼睛選片 | `*_v.jpg`、`*_p.jpg` | | 3 | 寫剪輯表 | `edl.json` | | 4 | 渲染 → 抽格看 → 修 → 再看 | `clips/*.mp4` | | 5 | 合成、配樂、輸出 | `out/*.mp4` | 步驟 2 和 4 是這支 skill 的重點。**選片和驗收都要靠眼睛**，不能靠檔名和時長猜。 --- ## 開工前的環境檢查 第一次在一台機器上跑，先確認： ```bash for f in drawtext subtitles ass zscale overlay zoompan gblur; do printf "%-12s " $f; ffmpeg -hide_banner -filters 2>/dev/null | grep -qw "$f" && echo 有 || echo 沒有 done ffmpeg -hide_banner -version | grep -c -- --enable # 官方完整版 60+，精簡版 15 左右 python3 -c "import PIL; print('Pillow', PIL.__version__)" command -v exiftool sips ``` **如果沒有 `drawtext` 和 `subtitles`**：不要重裝 ffmpeg 才動工。改用 Pillow 產字幕 PNG 再 `overlay` 疊上去，中文排版反而更好控制。`scripts/render.py` 就是這樣寫的。 **如果沒有 `zscale`**：做不了正規的 HDR→SDR tone mapping。iPhone 的 HLG 素材直接轉 8-bit 通常可以接受（實測藍天飽和、雲有層次、亮部不過曝），先做出來看，不要為這件事卡住。要更準的顏色再 `brew reinstall ffmpeg`。 --- ## 步驟 1：掃素材 ```bash python3 scripts/scan_library.py --from 2026-06-10 --to 2026-06-22 ``` 它會複製 `Photos.sqlite`、查出區間內的資產、去重、分群、解出地名，寫成 `assets.json` 並印出分群表。 ### 四個必踩的坑 **`.mov` 的時間戳是 UTC，照片是當地時間。** QuickTime 的 `CreateDate` 存 UTC，HEIC 的 `Da