Doc Real
紀錄片寫實風格:信箱式寬螢幕、電影級調色、小型小寫字幕與地點標籤。
- 最佳用途: 微紀錄片、創業家故事、旅遊、訪談、品牌影片
- 類別: 談話頭短片
- 預設格式: 9:16(可使用
--format 9:16 | 1:1 | 4:5 | 16:9變更) - 需要攝影機素材: 是,一段原始談話片段
- 發言者背後文字: 否
開始之前
此風格需依賴 video-studio-core 技能執行,該技能必須安裝於相同的技能資料夾中。
CORE= 與此技能資料夾相鄰的video-studio-core資料夾(例如~/.claude/skills/video-studio-core)。STYLE= 此技能本身的資料夾(內含theme.json與theme.css)。- 首次在某台機器上執行時:
python CORE/scripts/check_env.py,並修復其報告的任何問題。 - 如果缺少
CORE,請告知使用者從同一套件安裝video-studio-core。
進行編輯
python CORE/scripts/run.py clip.mp4 --style STYLE --work edit-doc-real --stop-after plan --title "地點, 時間"
# 接下來請 refine edit-*/plan.json(見下方說明),然後檢查預覽影格:
python CORE/scripts/render.py edit-doc-real/plan.json --frames 1,3,6,9
python CORE/scripts/render.py edit-doc-real/plan.json
python CORE/scripts/finish.py edit-doc-real/plan.json
在完整渲染前,請先開啟 contact_sheet.png 並仔細檢視。最終影片會以 final.mp4 名稱存放在工作資料夾中。
若要輸出額外尺寸,請在 finish.py 中使用 --formats 1:1,16:9。若要在計劃中加入音樂,請在 plan 中加入 "music": {"src": "track.mp3", "volume": 0.12}。
視覺風格
- 信箱式黑色邊框、電影級調色、顆粒感、緩慢鏡頭推進。字幕為小寫、白色、置中偏低。
- 影片前 3 秒左上角顯示小型地點或章節標籤。無縮放、無表情符號、無音效。
優化剪輯計劃
make_plan.py 產生的草稿是自動化的。請將其精鍊:
- 閱讀
words.json,並將開頭(前 2-3 秒)的鉤子重寫為簡短、具體的承諾。 - 將自動選取的弱關鍵字替換為承載核心意義的字詞(數字、成果、名稱、對比)。
- 修正
words陣列中任何誤聽的字詞(保留其時間戳記)。 - 透過
--title傳遞地點/情境(例如 'julana, haryana — 6:40 am')。 - 對於較長的影片,請加入類別為
dr-chapter的titlecard章節分隔。 - 元素類型與欄位說明請參考:
CORE/references/plan-schema.md。
交付前檢查
- 聯絡表:文字可讀、無內容被裁切、無覆蓋臉部(除非有意為之)、安全區域正確(9:16 格式:文字維持在畫面高度的 10% 至 85% 之間)。
- 注意時間點:疊加元素應與說話內容同步落地,而非之後。
- 使用
ffprobe檢查最終檔案:確認尺寸、時長與音訊皆正確。 - 告知使用者你剪掉了多少(移除的秒數)、這個風格增添了什麼視覺效果,以及最終檔案的位置。
變更視覺風格
顏色與字型設定在 theme.json(vars、fontsUrl)與 theme.css 中。若要進行一次性變更,請直接在 plan.json 中修改(theme.vars、元素 style),而不修改技能檔案本身。
範例請求
- "紀錄片風格的編輯。"
- "讓我的故事看起來像 Netflix 紀錄片。"
- "帶有地點標籤的電影級紀錄片風格。"