CutPilot AI 影片編輯
CutPilot 是一個本地優先、Codex 優先的編輯工作流程,並內嵌手動審查時間軸。Codex 根據用戶的簡報、旁白、中繼資料和聯絡表做出編輯決策;CutPilot 工具使這些決策可重現且可渲染,同時用戶可以直接調整支援的時間軸細節。
工作流程
- 調用
inspect_media_folder檢查用戶提供的資料夾。請勿上傳原始檔案。 - 讀取回傳的清單,並在視覺選擇重要時檢查生成的聯絡表圖片。
- 根據用戶的命名或指示識別旁白檔案。僅詢問無法推斷的創意選擇。
- 檢查聯絡表,然後調用
annotate_assets提供事實性的視覺描述和標籤。不要猜測未見的內容。在大量資產變更後建置build_semantic_index。 - 偏好使用
search_semantic_assets來精確定位資產、場景子剪輯和轉錄範圍。當用戶希望減少重複時,將已使用的資產 ID 傳入avoidAssetIds。僅將rank_assets_for_narration作為輕量級備用方案。 - 撰寫一個包含頻繁、語義匹配鏡頭的剪輯計劃。每個視覺片段需要來源路徑、時間軸開始時間、來源開始時間和持續時間。除非用戶要求或重複有明確的編輯目的,否則切勿重複使用同一個鏡頭。
- 在進行昂貴的渲染之前,總結建議的結構並獲得批准,除非用戶明確要求端到端執行。
- 批准後調用
render_project。提供 MP4 和 JSON 專案。
編輯預設值
- 將視覺素材與口語意義匹配:提及程式碼時顯示程式碼,提及婚禮工作時顯示婚禮畫面,提及工廠細節時顯示工廠細節。
- 偏好更多有目的的剪輯,而非長時間持有一個通用鏡頭。
- 保留旁白作為主要音訊,並靜音 B-roll,除非用戶要求自然聲音。
- 除非用戶另有指定,否則使用 9:16、1080x1920、30fps 作為垂直社交影片的格式。
- 保持原始檔案不變。
專案優先工作流程
對於持久的編輯,偏好使用 v0.2 專案工具:
create_projectimport_assetsinspect_media_folderedit_timelinevalidate_projectread_project- 當需要轉錄時間時,使用
transcribe_asset。如果沒有可用的模型,請使用一次download_transcription_model。 - 當要求字幕時,使用
set_captions和export_subtitles。 - 在用戶批准剪輯後使用
render_project。 - 使用
edit_item_effects和set_transition進行非破壞性片段樣式設定。 - 使用
create_motion_graphic/update_motion_graphic進行可編輯的標題、下三分之一和資訊卡。 - 使用
generate_voiceover進行私有的 macOS TTS,或使用register_generated_asset為外部生成器創建的媒體保留來源。 - 在進行重大的自主修訂之前,調用
create_project_snapshot。當用戶想要比較或撤銷某個方向時,使用list_project_snapshots和restore_project_snapshot。 - 對於 Vlog 專案,調用
get_vlog_workflow_status來查找第一個不完整的基於證據的階段及其建議的下一個工具。 - 使用
submit_vlog_release_export進行最終的 MP4 輸出。它總是重新執行嚴格的預檢,並在有阻礙因素時拒絕輸出。 - 渲染後,調用
inspect_rendered_video並視覺檢查其聯絡表。將黑色/凍結片段警告視為線索,而非自動的編輯失敗。 - 使用
export_interchange搭配fcpxml用於 Resolve/Final Cut,或edl用於簡單的主要視頻交接。 - 每個請求的圖片/視頻/音樂/SFX 使用一次
submit_generation。使用track_generation查看狀態和實體化;當生成需要花費金錢時,不要在用戶審查之前放置生成的結果。 - 使用
edit_item_transform進行明確的位置、大小、旋轉、適應以及進入/退出/浮動動畫。檢查多個影格,避免將瞬態運動誤認為佈局損壞。 - 使用
create_motion_graphic_from_svg進行直接編寫的屬性驅動圖形。宣告每個{{property}},保持外部資源不在 SVG 中,並使用update_svg_motion_graphic進行後續的文字/顏色/來源變更。 - 使用有序的變換關鍵影格進行有意的 x/y/旋轉編排。僅在連續的相鄰片段邊界使用
cross-dissolve,並檢查轉場前、中、後的影格。 - 當用戶想要檢查或手動調整 AI 編輯時,調用
open_review_session並使用真實專案和最新預覽,然後在 Codex 中開啟其 localhost URL。當即時頁面不再需要時,使用close_review_session關閉它。 - 審查 UI 寫入是真實的專案編輯。它們會自動創建快照,並拒絕無效的時序、透明度、重疊、過期的令牌和格式錯誤的媒體範圍。
- 使用
split_item或razor_all_tracks進行來源連續的剪輯。使用trim_item進行邊界變更,使用ripple_delete_item移除時間,以及使用insert_timeline_gap打開時間,同時通過自動分割保留交叉媒體。 - 在審查 UI 中,用戶可以拖動片段主體、拖動修剪手柄、在播放頭處分割、套用 Ripple delete、插入全域間隙、設定流出轉場,以及檢查生成的實際波形。
- 轉場選擇包括淡入淡出、dip-black、cross-dissolve、四個方向的擦除、徑向揭示和四個方向的滑動。僅在連續的相鄰片段邊界使用進階轉場,並驗證中點影格。
- 命名的生成橋樑使用
MYCUT_SEEDANCE_ENDPOINT、MYCUT_KLING_ENDPOINT、MYCUT_MUREKA_ENDPOINT或MYCUT_SFX_ENDPOINT,並搭配可選的相應_TOKEN變數。它們保留 submit/status/materialize 語義;除非該端點實際配置並被調用,否則不要聲稱已現場測試過付費供應商。 - 使用
edit_item_keyframes進行 x/y/縮放/旋轉/透明度動畫。緩動儲存在左關鍵影格上,可以是 linear、ease-in、ease-out、ease-in-out、hold 或自定義 Bezier Y 控制項。驗證多個渲染時間。 - 使用
list_glsl_presets和apply_glsl_preset進行內建 WebGL 效果,或使用類型為glsl的edit_item_effects進行直接編寫的片段著色器程式碼。保持u_texture、u_time、u_progress和u_resolution宣告與 WebGL1 相容,並驗證編譯後的渲染。 - 使用
create_jsx_motion_graphic進行影格驅動的 React 元件,以及使用update_jsx_motion_graphic進行後續的來源/屬性變更。定義MotionGraphic;React 和 frame/fps/progress/dimensions 由系統提供。驗證透明度和多個影格。 - 使用
export_interchange搭配premiere-xml用於 Premiere Pro、fcpxml用於 Final Cut/Resolve,或edl用於簡單的剪輯列表。使用import_fcpxml或import_premiere_xml從本地 NLE XML 創建新的 CutPilot 專案,然後驗證和檢查導入的時間軸渲染。 - 僅在用戶接受實驗性的舊版純文字相容性時使用
export_jianying_draft。始終報告現代的 Jianying 草案是加密/版本依賴的,並調用validate_jianying_draft;未成功啟動目標應用程式前,切勿聲稱應用程式開啟相容性。 - 使用
list_caption_templates和update_caption_style進行豐富的字幕。僅在存在單詞時間戳時啟用karaoke,然後在燒錄渲染中驗證幾個單詞間隔。 - 使用
edit_item_playback進行 0.1x-16x 恆定速度、可編輯的速度曲線、反向或視頻凍結影格。曲線點使用片段本地時間軸時間以及速率和緩動;時間軸持續時間保持固定,而積分曲線決定來源範圍。音訊跟隨相同的曲線,並進行保留音高的分段時間拉伸。 - 使用
edit_item_effects進行有序的非破壞性視覺堆疊。chroma-key使用相似度/混合控制項移除選定的 RGB 顏色;mask支援矩形/橢圓幾何形狀、羽化和反轉;color-grade、curves和vignette提供本地後期處理。針對較低的視頻軌道驗證透明度,並檢查中心/邊緣/角落畫素。 - 使用
edit_item_audio_effects進行有序的每片段音訊處理。語音清理通常從高通濾波、閘門、EQ、壓縮和去噝聲開始;立體聲和音高是創意工具。音高保留時間軸持續時間。在報告成功之前,測量實際渲染的頻譜、RMS/峰值動態以及左右聲道能量。 - 當用戶想要處理過的旁白、音樂混音、播客或在沒有視頻的情況下進行音訊交接時,使用
render_audio。選擇 24-bit WAV 或 FLAC 進行無損續接,MP3 進行廣泛傳遞,M4A 進行緊湊的 AAC 傳遞;驗證匯出的檔案不包含視頻串流。 - 使用
list_timelines、create_timeline、duplicate_timeline、activate_timeline、rename_timeline和delete_timeline來管理共享一個資產庫的不同長篇、短篇、垂直或方形序列。切勿刪除最後一個時間軸。 - 使用
set_timeline_in_out和在render_project或render_audio上使用range: zone來指定精確的匯出範圍。範圍剪輯保留來源映射、速度曲線、字幕、標記和音訊時序,而不修改來源序列。 - 使用
export_motion_graphic將 SVG 或 JSX/React Motion Graphic 作為獨立的透明 ProRes 4444 MOV 交接。驗證 4444 配置文件和yuva阿爾法畫素格式。 - 使用
read_transcript_edit檢查計時的轉錄片段,然後使用apply_transcript_sequence重新排序或省略來源片段。這會從精確的來源範圍重建連結的 talking-head 視頻/音訊和單詞字幕;不要發明近似的片段時間。 - 使用
create_asset_bin、move_asset_bin、assign_assets_to_bin和list_asset_library來組織和搜尋本地媒體,而無需移動來源檔案。在渲染導入或移動的專案之前,使用scan_missing_assets。 - 使用
relink_asset進行明確的替換,或使用relink_missing_from_folder進行精確檔案名稱的批次恢復。切勿猜測模糊的匹配;保留資產 ID,以便每個時間軸引用、轉錄、註釋、標籤、容器和生成記錄保持完整。 - 正常的專案儲存會自動進入一個持續的 100 步編輯器日誌。使用
editor_history_status、undo_project和redo_project進行即時編輯還原;Undo 後的新編輯會有意清除 Redo 分支。保留命名的快照作為持久的里程碑。 - 使用
set_timeline_format搭配 16:9、9:16、1:1、4:3 或 3:4 來更改可編輯的畫布。當現有的基於畫素位置的變換、關鍵影格、遮罩和字幕應適應新畫布時,偏好使用layoutMode: scale。 render_project接受非破壞性的resolution(original、1080p、720p、480p)和frameRate(24-60)。驗證實際的 FFprobe 尺寸和幀率;這些輸出覆蓋不得修改可編輯的來源序列。- 使用
create_track、rename_track、reorder_track、edit_track和delete_track進行明確的軌道生命週期管理。軌道順序決定視頻合成順序;靜音的視頻被隱藏,靜音的音訊是無聲的,鎖定的軌道拒絕編輯。 - 以影格為單位配置
set_timeline_snapping。使用snap_timeline_time預覽輔助線,或使用move_item/已對齊的trim_item與片段邊緣、標記、In/Out、播放頭或時間軸起點對齊。切勿強制對齊超出容差範圍或導致重疊。 - 使用
set_edit_context進行精確的 ChatCut 樣式引用,引用資產、時間軸項目、時間軸時間、畫布區域或轉錄來源範圍。在採取行動之前調用resolve_edit_context,以便 AI 決策綁定到真實的 ID 和計時物件。選擇變更在本地持久化,但有意不進入 Undo/Redo。 - 在已知場景合適時,使用
list_project_starters和create_project_from_starter開始新工作。Starters 會創建真實的命名軌道、路由角色、容器、字幕、對齊、儲存的創意簡報和建議的工作流程。僅在每個時間軸為空時使用configure_project_starter;切勿用 starter 覆蓋已編輯的序列。 - 使用
place_asset_on_timeline進行來源監視器組合。設定精確的來源 In/Out 和相容的目標軌道。append使用目標軌道結尾;insert在每個解鎖的軌道上打開時間並移動字幕和標記;overwrite僅更改目標範圍,同時保留來源連續的左右剩餘部分。 - 當相機/視頻資產的原始音訊應保持同步時,使用
place_linked_av。連結成員共享linkGroupId;使用move_linked_group和trim_linked_group進行原子同步安全編輯,或在有意的獨立調整之前使用unlink_timeline_items。拒絕衝突和鎖定成員,而不是使其不同步。 - 偏好使用
submit_export_job進行長時間或用戶可見的匯出,以便 Codex 保持回應。輪詢read_export_job或list_export_jobs;報告確切的階段和輸出路徑,並僅在要求時使用cancel_export_job。作業從不可變的專案快照渲染,因此後續的時間軸編輯不能靜默更改正在進行的匯出。 - 在提出移除暫停之前使用
analyze_asset_silence。顯示檢測到的靜音範圍、閾值、最小持續時間、呼吸邊緣填充和總移除時間。僅在範圍被接受後調用apply_silence_cut;它會重建來源連續的連結 AV 並重新映射轉錄字幕。切勿將每個安靜段落視為編輯上可丟棄的。 - 當鏡頭邊界重要時,對長 B-roll 或相機檔案使用
analyze_asset_scenes。在save_scene_subclips之前審查其剪輯時間和聯絡表;然後註釋/標記子剪輯或使用list_asset_subclips搜尋它們。使用place_asset_subclip保留精確的檢測到的來源 In/Out,而不是近似鏡頭範圍。 - 使用
analyze_asset_beats在按節拍編輯之前檢查本地音樂。在save_beat_markers之前審查 BPM、節拍位置、靈敏度和最小間隔。建置
…
[為翻譯而截斷]