短影片管線(與主題無關)
一份編輯清單(<short>/edl.json)加上旁白即可產出完成的影片:移動剪輯的「主題照片視窗」、文字字幕、鉤子版、英雄圓圈、封面、音效提示清單,最後以 -14 LUFS 進行音訊混音。
所有與頻道相關的內容(主題、語言、受眾、內容規則、視覺風格、旁白、片尾、排程)都寫在專案的 CHANNEL.md 中。請先閱讀它,並遵循其指示(而非下方的預設值)。 如果 CHANNEL.md 遺失或部分內容為空,請在產出任何作品前向擁有者詢問(或複製 engine/templates/CHANNEL.md 並與對方一起填寫)。
相關技能:shorts-script-voice(主題、腳本、旁白)和 shorts-packaging(完成的檔案、上傳文字)。
在開始任何步驟之前
- 套件腳本(
setup.sh、shorts-init.sh、doctor.sh、install-codex.sh)位於套件的scripts/資料夾中:即插件資料夾,或$SHORTS_HOME/kit/scripts/(setup.sh和install-codex.sh會在那裡保留一份副本)。 - 從一個專案資料夾開始工作,該資料夾需包含
_pipeline/、_tools/、_fonts/、CHANNEL.md(可使用scripts/shorts-init.sh <dir>建立)。以下所有命令都從該資料夾的根目錄執行。 - 在每台機器上執行一次
scripts/doctor.sh <project-dir>。它會檢查所有依賴項(系統程式、Python 套件、模型、可用磁碟空間),並必須以「All good.」結尾。如果沒有:對於 ffmpeg/Python/curl,請執行scripts/install-system-deps.sh;對於其餘部分,請執行scripts/setup.sh。完整列表請參閱套件的DEPENDENCIES.md。 SHORTS_HOME(預設~/.shorts-studio)存放 Python 虛擬環境和語音模型。如果將其放在其他位置,請匯出此環境變數。- 在撰寫編輯清單之前,請閱讀
_pipeline/README.md(引擎參考)和references/edl-notes.md。
工作流程(每個步驟都有其專屬檢查)
| # | 步驟 | 命令 / 輸出 | 驗證 |
|---|---|---|---|
| 1 | 主題 + 腳本 | 技能 shorts-script-voice | 一個主張、來源已標註、所有者 OK(當設定檔要求時) |
| 2 | 旁白 | $SHORTS_HOME/venv/bin/python _tools/build_vo.py <short>/vo/beats.json,然後 _tools/words.py <short>/vo | 讀取 vo/words.json:每個單字正確 |
| 3 | 素材 | _tools/grab.py <topic> '<url>' <start> <end> --tag NAME(記錄於 _footage/SOURCES.md),或自行錄製 | 每個剪輯的連絡表;遵守 CHANNEL.md 中的政策 |
| 4 | 編輯清單 | 複製 references/edl-template.json,修改內容 | build.py <edl> --words 顯示字幕標記 |
| 5 | 渲染 | python3 _pipeline/build.py <short>/edl.json --theme <theme>(3-10 分鐘;4K60 很慢) | 無錯誤;檔案比 edl 新 |
| 6 | 封面 | ... build.py <edl> --cover | 「無安全區違規」;在 180 像素寬時可讀 |
| 7 | 檢查 | python3 _pipeline/check.py <short>/<name>-<theme>-silent.mp4 <short>/edl.json | 顯示 ALL CHECKS PASS;你已經看過每張連絡表 |
| 8 | 音訊 | $SHORTS_HOME/venv/bin/python _pipeline/sound/mix.py <short> --theme <theme> --music <name> --strict | -14.0 +/-0.5 LUFS,真實峰值 <= -1.0 dBTP,單字錯誤接近 0 |
| 9 | 打包 | 技能 shorts-packaging | 檔案 + 封面 + 上傳區塊在 ready/ 中 |
來源剪輯的連絡表:ffmpeg -ss <t> -i <file> -t <d> -vf "fps=2,scale=320:-1,tile=7x4" -frames:v 1 out.png
(寫入 PNG:某些來源的 JPEG 輸出會因「non full-range YUV」而失敗)。鏡頭邊界:
ffmpeg -i <file> -vf "scale=320:180,select='gt(scene,0.25)',showinfo" -an -f null - 2>&1 | grep -o "pts_time:[0-9.]*"。
主題:case-file(檔案紙張)、panel-heist(漫畫頁面)、vice-dusk(霓虹暮色)、classic;設定檔會選擇一個。
好的短影片是什麼樣子(預設值;設定檔會覆蓋)
- 18-45 秒,一個從鉤子到收束的主張,每 1.5-3 秒一個剪輯,每個鏡頭都有動態,鉤子版從第 0 幀開始顯示
(
hook.y1170 使其避開展品標籤),一個英雄時刻,有一個紅圈圈出幀中實際顯示的內容。 - 畫面跟隨文字。字幕是 2-3 個單字的短語(
break_before);名字保持在同一組。 - 最後一個鏡頭剪輯回第一個幀(影片循環播放)。
- 所有可讀文字都保持在手機安全區內:y 300-1580,x 130-950(y 1000-1600 時 x <= 860)。check.py 會強制執行此規則。
- 高照片視窗
"aspect": "3:4"(900x1200),用於 1080p 及以上的剪輯;720p 或有信箱黑的來源無法填滿它。
硬學的教訓(詳細內容在 references/lessons.md 中)
- 編輯清單比渲染新?渲染就過時了。 在判斷 check.py 的結果之前,先重新建置。
- 凍結靜止畫面(連續幀之間差異小於 0.3 秒)會導致 check.py 失敗。靜態螢幕、單一顏色和靜止的主體需要恆速動態:
"move_ease": "linear",縮放範圍 0.15-0.4 以及平移 150+ 來源像素。 僅僅float是不夠的(正弦曲線在轉折點會減速到零)。 - 縮放限制: 4K 來源 <= 1.00、1080p <= 1.25、720p <= 1.0(check.py 會顯示每個剪輯的限制)。
- 創作者疊加層(浮水印、臉部攝影機、第三條、字幕、風格化橫幅)絕不能接觸畫面:使用頂層
sources的畫面覆蓋、移動裁切或選擇其他幀。檢查每個裁切幀。 - 誠實: 標籤、圓圈和字幕只能說明幀中顯示的內容,在旁白中將事實歸因於其來源。
- 封面: 一個滿版裁切的來源幀;版位位於
tab_y(330)並隱藏畫面的頂部。對於主體靠近頂部的情況,請將tab_y設定為約 1090,將stamp_y設定為約 410。 - 一次只進行一個渲染(4K60 渲染會使用所有核心);切勿啟動同一個資料夾的第二個渲染。
將編輯工作委託給子代理人
請提供代理人 BRIEF.md(由 shorts-init 從 references/editor-brief.md 建立),以及腳本、語音檔案和素材列表。主 session 負責寫入腳本和語音,親自審查每個幀,並進行音訊混音:代理人的報告只是一個聲明,不是證明。在接收前,請檢查檔案時間(無聲 mp4 比 edl 新,檢查日誌比 mp4 新)。