使用 Timeline Studio 進行 AI 影片編輯
將使用者的明確編輯請求和媒體轉換為可逆的 Timeline Studio 編輯。將可編輯的時間線作為唯一真理來源；切勿以不透明的單次渲染取代它。
選擇執行路徑
- 在初次安裝後的本機使用時，請閱讀 references/host-environment.md。如果無法使用 Node.js，請從零依賴的 Shell 或 PowerShell 引導程式開始；否則執行
node scripts/setup-host.mjs --check。在代理程式驅動的旁白前，也請執行node scripts/setup-host.mjs --check --capability voiceover；此功能僅在獲得明確批准後，才會在獨立環境中安裝 MeloTTS 及其語言資源。將結果視為功能證據。如果缺少語言執行環境或依賴項，請顯示確切的安裝計畫並在使用者明確批准後再進行安裝；切勿將技能安裝視為修改主機或下載模型的許可。 - 將本機專案檔案處理視為確定性編輯的預設方式：在本機檢查媒體，透過命令層或本機存檔服務修改可攜式
.timeline檔案，在本機渲染，並在本機驗證解碼後的輸出。不要僅僅因為編輯器有 UI 就打開瀏覽器。 - 僅當使用者明確要求使用網站、未提供本機儲存庫或專案路徑，或需要僅託管環境才有的功能時，才將
https://video-editor.ai-creator.top/視為正規託管編輯器。 - 當此儲存庫可用時，優先使用其代理程式命令層和本機媒體工具。僅在經過驗證的純 UI 操作（本機專案管線無法表達，且使用者未要求僅本機工作流程）時，才啟動本機伺服器和瀏覽器。從程序輸出讀取實際的伺服器 URL；切勿假設連接埠為 5173。
- 檢查
package.json以尋找代理程式命令腳本。不要使用npm run ... --if-present作為功能檢測，因為它可能靜默成功。 - 如果命令執行器存在，請閱讀 references/command-contract.md，檢查專案，建立版本化計畫，執行結構驗證器，並在
project.run之前使用project.diff作為權威的語義乾執行。 - 如果本機合約缺少必要操作，請說明確切的差距。對於儲存庫開發工作，在回退到 UI 之前，先實作最小的共用本機操作和渲染器支援。否則在使用瀏覽器工作流程前先詢問使用者。
- 當只有 UI 自動化可用時，不要聲稱已執行確定性或冪等性執行。說明此限制，並在 UI 支援的情況下保留可編輯的專案存檔。
工作流程
1. 編輯前檢查
- 逐字保留使用者的提示作為創意簡報。
- 將每個引用的素材解析為明確的路徑或 URL。未經許可，切勿掃描目錄。
- 檢查持續時間、尺寸、音訊存在與否以及媒體類型。
- 在變更現有專案之前，先讀取目前的專案摘要。
- 僅當未解決的選擇會實質上改變編輯時（例如所需的輸出持續時間或長寬比），才提出問題。
- 對於自動編輯請求，請閱讀 references/auto-edit-workflow.md。先檢查，以明確的信心水準對內容、目標和交付內容進行分類，然後僅詢問最少量的、可以改變剪輯的特定類別問題。切勿詢問可從媒體中發現的事實。
- 對於複製、模仿、重製或逆向工程參考影片的請求，請閱讀 references/replication-workflow.md。將其分類為
editing-style replication、AI-generation replication或混合型；在建構前重建濾鏡、重複、來源分割、速度曲線、轉場、鏡頭和時序；並明確解決是否必須保留授權的原始音軌。在複製分析完整性閘門通過之前，不要開始編輯。僅在需要生成時，才使用目前的網路搜尋來比較 AI 影片平台；僅在使用者未提供足夠素材時，才使用合法的網路來源片段。 - 在載入或下載用於媒體分析的模型之前，請閱讀 references/local-model-routing.md。盤點儲存庫現有的本機和固定鏡像功能，選擇實證差距所需的最少模型鏈，在本機運行推理（無需驅動可見編輯器 UI），並記錄確切的模型/運行時/回退來源。切勿預設載入所有可用模型或建立重複的快取。
- 當使用者需要網路來源的片段或詢問可於何處找到可下載素材時，請閱讀 references/web-footage-sourcing.md。從即時搜尋中提供當前、特定於任務的平台建議，並根據來源合法性、明確的下載支援、使用權、視覺契合度、品質和來源進行排名。保持技能提供者中立；切勿將一個平台或品牌硬編碼為永久路線。
- 對於每個完成的自動編輯，請閱讀 references/professional-editing-workflow.md。直接分析圖片；使用代表性幀、語音/OCR、語義以及全域加上主體區域光流來分析影片。在追蹤或增強之前先進行穩定化處理。僅在檢查證明生成確實有用時，才詢問有關圖片轉影片或圖片轉圖片模型的問題。
- 當遠端生成確實必要時，請閱讀 references/remote-video-generation.md。搜尋目前的官方文件，僅比較符合鏡頭藍圖的提供者，在任何付費或隱私敏感的工作之前獲得批准，規範化非同步任務和來源，下載即將過期的輸出位元組，並將驗證後的結果新增到「我的素材」中，而不自動放置到時間線上。
- 對於產品、品牌、
marketing-commerce、網站推廣或其他促銷編輯，請閱讀 references/promotion-narrative-workflow.md。主動構建一個有抱負的、有證據支持的總體敘事，而不是功能列表或動態排版蒙太奇。除非使用者明確要求預告片，否則應建立一個完整的「問題-轉變-證明-行動呼籲」架構，並主動尋找幾個視覺上不同的案例（對於 35-45 秒的短片，通常至少三個），每個案例都有自己的設定、產品動作、可見結果以及與最終回報的關聯。切勿為了讓故事聽起來更宏大而編造客戶、成果、指標或產品行為。 - 對於強調或戲劇性影響重要的精華編輯和參考複製，請閱讀 references/highlight-tension-workflow.md。將顯著性視為候選證據，分配設定/鋪陳/前高峰/高峰/餘波角色，設計非平坦的張力包絡線，保護決定性的英雄畫面，並在準確剪輯仍缺乏主導回報時拒絕完成。
- 對於網站操作說明或促銷錄製，請在錄製前使用支援的瀏覽器控制技能來檢查和排練授權的瀏覽路徑。在執行瀏覽器操作前完整閱讀該瀏覽器技能，然後遵循 references/website-promo-workflow.md。在得出產品結論之前，建立並完成頁面/流程覆蓋清單。當所需頁面被限制時，請使用者在選定的瀏覽器中自行登入；切勿要求提供憑證或將無法存取的行為描述為已驗證。分別確認任何重要的外部操作，保護已登入狀態和個人資料，並且在僅有螢幕截圖或靜態素材可用時，切勿聲稱已捕獲真實的螢幕錄影。
- 對於有旁白的編輯，請閱讀 references/voiceover-workflow.md。對於包含行內英文的中文旁白，請使用 MeloTTS
ZH，並確保在合成之前，其隔離環境和已批准的固定模型成品已準備就緒。除非使用者要求其他交付方式，否則選擇可用的最溫暖、最自然的說書人風格自有聲音，並指導一種親密、對話式的表現，具有有意義的措辭；切勿預設使用平淡、金屬質感或機械的系統語音效果。在最終確定場景持續時間或動作之前鎖定最終的自然語音表現。讓句子時間和停頓來驅動畫面剪輯。將近似持續時間視為目標範圍，而非允許全域時間壓縮語音；當無法自然達到確切限制時，請重寫或縮短旁白。
2. 以支援的精細度進行規劃
- 對於自動編輯，保留提示並將推斷、確認、預設和未解決的決策標準化為可編輯的簡報。在變更時間線之前，建立一個包含保留/移除/縮短/重新排序決策、原因、信心水準、字幕期望、音訊連續性限制和受保護內容的來源時間決策記錄。
- 對於解說性產品、教學或網站節奏，為單一名稱目標選擇一個明確的注意力處理方式：放大微小或密集的證據，在確切文字或數字下方加底線，或框出控制項、卡片或結果的確切邊界。最多使用一個帶有相機移動的輔助處理方式，並且僅在相機停止後才套用底線或框線。
- 使用命令執行器時，將編輯表達為具有穩定 ID、秒數、修訂版、操作 ID 和前置條件的宣告式操作。執行
scripts/validate_edit_plan.mjs <plan.json>以檢查傳輸形狀錯誤，然後執行npm run agent -- project.diff <plan.json>以在套用任何變更前拒絕不支援的操作和無效的專案特定編輯。 - 僅使用瀏覽器 UI 時，撰寫一個簡短的有序清單，列出可見的使用者意圖和預期的 UI 結果。偏好使用命名控制項和剪輯標籤；僅在最後手段，並以當前螢幕截圖為基礎時，才使用座標。
- 保持主要視覺元素連續。將字幕、貼圖、來源音訊、旁白、音樂和疊加層視為定時剪輯。
- 應用單向字幕轉語音規則：如果專案配置或啟用了任何字幕，則每個可見字幕都必須對應於可聽到的語音。將轉錄字幕連結到現有的口語來源剪輯，併為每個新的旁白、解說、推廣或文字主導的字幕生成旁白。現有的來源語音滿足此規則，且不得接收重複的旁白。如果未配置字幕，則旁白仍是可選的，並遵循簡報、內容和編輯目標。如果已配置的字幕沒有授權的語音路線，則忽略它或停止並保留可編輯的專案。
- 對於句子範圍的旁白編輯，將旁白拆分為物理上分離的存檔音訊檔案，並將每個字幕綁定到恰好一個匹配的
audioClipId；不要將可編輯的句子剪輯表示為單一龐大旁白檔案上的範圍。 - 在移動或修剪剪輯時，保留媒體身份和來源時間映射。
3. 安全套用
- 在進行破壞性批次操作之前，儲存專案版本或匯出
.timeline存檔。 - 每個使用者可見意圖應用一個交易。當前置條件失敗時，使整個交易失敗。
- 切勿以靜默方式取代缺失的媒體、聲音、模型、字型或效果。
- 保持每個結果在正常 UI 中可復原和可編輯。
- 在沒有明確使用者請求的情況下，不要開始付費或遠端生成工作。
- 不要將
output.render放入命令計畫中，也不要聲明project.run可以渲染影片。對其記錄的可移植子集使用單獨的版本化project.render請求，並對 AI 生成或不受支援的合成功能使用瀏覽器編輯器。 - 對於已完成的影片編輯請求，解析一個明確的絕對輸出目錄，並在其中建立一個可移植的
.timeline專案和渲染結果影片。規劃、診斷和明確的僅編輯器交接是唯一的例外情況。請勿僅報告一件成品即視為完成。
4. 驗證結果
- 重新讀取時間線摘要，並將其與請求的持續時間、排序、軌道放置和啟用狀態進行比較。
- 預覽開頭、每個剪輯或轉場、字幕邊界、疊加層以及最終幀。
- 在每個視覺、字幕和音訊邊界上連續播放時間線。時間線時鐘必須單調遞增；拒絕任何停滯、向後跳躍、重複剪輯尾部或同時啟動兩個相鄰半開剪輯的邊界。
- 檢查可聽到的行為，而不僅僅是可見的軌道。區分嵌入式影片音訊和明確分離的來源音訊剪輯，並驗證靜音/連結狀態。
- 當使用 FFmpeg 放置立體聲或多聲道音訊時，明確地將每個預期偏移套用到每個聲道。對於
adelay，使用adelay=<milliseconds>:all=1或為每個聲道提供一個延遲值；使用預設值all=false的單一值只會延遲第一個聲道，並可能將每個後續剪輯堆疊到時間為零的另一個聲道中。在交付之前，比較開始視窗中以及每個預定語音邊界附近的左右聲道活動。拒絕僅限聲道的過早語音、在開頭堆疊的多個旁白剪輯，或未說明的聲道間起始時間偏差。 - 驗證每個可見字幕在其完整有效間隔內都解析為一個可聽到的語音剪輯。拒絕孤立字幕、靜音連結剪輯、超出語音範圍的字幕、重複的來源語音加上旁白，或純文字字幕傳遞。
- 以正常播放速度聽完整的旁白。拒絕聽起來冷冰冰或機械的、音調和能量平坦的、合成的逐字傳遞、嚴格相等的停頓、急促的節奏、被剪掉的停頓、不自然的發音、句子層級的速度變化、無法解釋的音量跳躍，或僅僅為了達到目標持續時間而全域加速的旁白。要求溫暖、人性化和像說故事般的品質。