FilmCraft — 由 Claude 驅動的剪輯
在本機安裝
| 項目 | 路徑 |
|---|---|
| 應用程式 + CLI（可攜版 0.13.0） | %LOCALAPPDATA%\Programs\FilmCraft\（filmcraft.exe、filmcraft-cli.exe，資料在 data\） |
| 啟動器（控制通道 127.0.0.1:9876 + 令牌） | {{DEPOT}}\filmcraft-mcp\launcher\FilmCraftClaude.exe（桌面捷徑「FilmCraft」） |
| 控制通道令牌 | %LOCALAPPDATA%\FilmCraft-Claude\control.token（切勿顯示或複製到別處） |
| MCP 伴隨（Python，uv） | {{DEPOT}}\filmcraft-mcp\server\ |
| FilmCraft 原始碼（文件） | {{DEPOT}}\filmcraft\docs\（agents.md、control-protocol.md、captions.md、graphics.md） |
啟動（務必依此順序）
filmcraft_status（MCP filmcraft-assist）。如果running=false→filmcraft_launch（如有需要，可附帶files= 專案.fcproj或媒體）。- 載入 MCP 工具（如果延遲）：ToolSearch
+filmcraft（兩個伺服器）。 - 切勿將使用者的工作掛載到示範專案中：使用
command_run file.newProject {name}然後file.saveAs {path}到專案資料夾，或file.open {path}。
兩個 MCP
| 需求 | 工具 |
|---|---|
| 狀態 / 啟動應用程式 | filmcraft_status、filmcraft_launch（assist） |
| 讀取專案、ID | doc_inspect、project_inspect、sequence_inspect（filmcraft） |
| 執行操作 | command_run {id, params}、command_batch {steps, stop_on_error}、media_import（filmcraft） |
| 尋找指令 | command_list {filter} 或在 references/commands.md 中 grep |
| 查看結果 | render_frame {seconds}、ui_screenshot {panel?}（filmcraft）；contact_sheet（assist）然後讀取圖片 |
| 剪輯前分析素材 | media_probe → 如為 VFR 則 media_conform（assist） |
| 逐字轉寫（法語） | transcribe_media（assist）——切勿使用 transcript.generate（whisper-base，法語表現差） |
| 對齊音樂 | music_beats {add_markers, every, offset_seconds}（assist） |
| 最終品管 | export_qc {path, platform}（assist） |
除了 MCP 之外，CLI 也可以在 Bash 中執行（無頭模式，無視窗）：filmcraft-cli --project p.fcproj --save exec <id> key=value、filmcraft-cli --project p.fcproj export out.mp4 --preset "YouTube 1080p Full HD"。
工作循環
- 檢查（
sequence_inspect）→ 取得剪輯/項目的 ID。ID 在 razor 操作後會改變：需重新檢查。 - 使用明確的目標執行操作（
clips: [id]、item: id），而非選取範圍。 - 透過查看驗證：關鍵點使用
render_frame、調色使用scopes.read、節奏使用contact_sheet。 - 如果出錯：
command_run edit.undo。經常儲存：file.save。
避免錯誤的規則
- 時間：ticks（254,016,000,000 / 秒）。大多數指令接受
seconds、frame或timecode→ 優先使用seconds。markers.add和sequence.addEdit需要time以 ticks 為單位。 - 序列 = 輸出格式：
file.newSequence {name, width, height, fps, sampleRate: 48000}設定為廣播格式（16:9 1920×1080、9:16 1080×1920、1:1 1080×1080），幀率 = 已轉換素材的幀率。 - 法語口頭禪：
transcript.removeFillers的預設英語清單 → 務必傳遞fillers（由transcribe_media回傳）。 - 長時間匯出：
file.exportMedia {…, wait: true}。務必以export_qc然後contact_sheet對匯出的檔案結尾。 - PATH 中的 ffmpeg 是 2013 年版：請使用 assist 工具中的 ffmpeg（ffmpeg 8 WinGet）或
%LOCALAPPDATA%\Microsoft\WinGet\Links\ffmpeg.exe。 - 指令被拒絕「not available right now」：缺少條件（未開啟序列、未選取正確類型的剪輯、未指定目標）。讀取
command_list {filter: "<id>"}→enabled欄位。
食譜
詳細食譜及確切參數：references/recipes.md。
- A. 教學 / 人臉鏡頭：probe → conform → 轉寫 → 去除「嗯」和空白 → 純淨人聲 → 字幕 → 調色 → 匯出 -14 LUFS → QC。
- B. 直向短影音 9:16：序列 1080×1920、裁切、大而簡短的字幕、預設「Social Vertical 1080×1920」。
- C. 音樂剪輯：
music_beats→ 小節標記 → 在標記處剪輯 → ducking。 - D. 調色：Lumetri（實際參數在
references/effects.md，效果lumetri）、場景匹配lumetri.applyMatch、檢查scopes.read。 - E. 混音：Essential Sound（對話/音樂）、ducking、混音匯流排上的 true peak 限制器。
- F. 匯出 + QC：預設在
references/export-presets.md、loudnessLufs、captionSidecar、burnCaptions。
參考資料
references/recipes.md— 食譜 A–F 的逐步說明，附帶 JSON 負載。references/commands.md— 按系列分類的 710 條指令（grep：`timeline.,`captions.,`lumetri.,`essentialSound.,`export.,`transcript.）。references/effects.md— 303 個效果/轉場，附帶參數 ID、範圍和選項（grep`lumetri`,`hard_limiter`,`cross_dissolve`）。references/export-presets.md— 39 個匯出預設。scripts/gen_reference.py— 在 FilmCraft 更新後重新產生三個參考檔案：python -I scripts/gen_reference.py。
FilmCraft 更新
從 github.com/storytold/filmcraft/releases 下載 filmcraft-<ver>-windows-x64-portable.zip（驗證 SHA256SUMS.txt），關閉 FilmCraft，取代 %LOCALAPPDATA%\Programs\FilmCraft\ 中的 filmcraft.exe 和 filmcraft-cli.exe（保留 data\ 和 portable.txt），然後重新執行 scripts/gen_reference.py。