Avenox Studio — 操作員路由器
本地優先、代理操作影片管線的快速操作指南。 一切都在您自己的機器上執行:無需雲端編輯器,無需上傳後再渲染。
人類負責指導和批准品質;代理(AI)負責執行管線。
設定
export STUDIO_JOBS="$HOME/video/projects" # 大型媒體檔案存放在這裡
export STUDIO_ROOT="/path/to/this/repo" # 腳本、範本、品牌資源
需求:macOS(透過 h264_videotoolbox 進行硬體編碼;Apple Silicon 用於 mlx-whisper)、ffmpeg、python3、melt/MLT、Node(用於 HyperFrames)。大部分功能在 Linux 上也能運作,只需換成 libx264 和 CUDA 版本的 whisper。
操作原則
- 媒體紀律。 大型媒體檔案絕對不能放在雲端同步的資料夾中 — 同步會因數 GB 的中間檔案而崩潰,並可能損壞正在寫入的檔案。工作檔案存放在
$STUDIO_JOBS/<job>/目錄下(raw/ cut/ graphics/ audio/ outputs/)。您的筆記系統只存放核心:本系統、品牌規範、edit.json計畫。 - 導演迴圈。 先產出預覽(圖形靜態稿 + 快速草稿渲染)→ 發送審閱 → 只有在確認後才進行最終渲染。未經簽核絕不能交付最終版本。這是最重要的一條規則;未經審查就渲染最終版的代理會浪費數小時在一個被拒絕的剪輯上。
- 品牌是硬性約束,而非建議。 在製作任何圖形之前,請先閱讀
brand/frame.md。定義一次後就鎖定。(參考實作刻意反對「AI 拼貼風」:強調優質編輯、暖色紙張 + 墨水 + 單一強調色,無霓虹/漸層/玻璃擬態/3D 光澤。) - 格式: YouTube 16:9 1080p60。預設配置在
brand/presets/youtube-16x9.json。 - 完成是混合模式。 自動產生草稿;同一個
.mlt檔案可以在 Kdenlive 或 Shotcut 中開啟進行手動精修。不要試圖讓自動化來決定品味。 - 轉錄預設使用本地端
mlx-whisper搭配whisper-large-v3-turbo— 快速、免費,且對非英語音訊表現優異。請注意,大多數 LLM 路由代理不提供 whisper 端點;如果需要遠端,請使用專用的語音 API。
腳本 (scripts/)
| 腳本 | 功能 |
|---|---|
| `autocut.sh IN.mp4 [balanced | aggressive |
transcribe.py IN.mp4 PREFIX | → transcript/PREFIX_timed.json + _narration.txt |
mltgen.py edit.json out.mlt --base <job-dir> | 編輯清單 → MLT 專案檔案(Kdenlive/Shotcut/melt) |
| `vrender.sh project.mlt out.mp4 [fast | quality]` |
grabshot.sh | 剪貼簿截圖 → 磁碟 |
slides2png.sh | 舊版靜態投影片 — 建議改用 HyperFrames |
remove-silence.py | 獨立靜音處理 |
7 個步驟
- 素材引入 — 複製原始檔 →
$STUDIO_JOBS/<job>/raw/。確認簡報和哪些片段實際重要。 - 粗剪 —
autocut.sh raw.mov balanced→cut/screen_cut.mp4;transcribe.py生成腳本。完整食譜 →avenox-roughcut技能。 - 圖形 — HyperFrames。透過
hyperframes技能路由 → 通常是motion-graphics(短節拍)、faceless-explainer(概念說明)或general-video。先閱讀brand/frame.md;將動畫 MP4 渲染到graphics/目錄。完整食譜 →avenox-graphics技能。 - 組裝 — 編寫
edit.json(範本在templates/edit.json),混合cut/*.mp4+graphics/*.mp4+ 音樂 →mltgen.py edit.json project.mlt --base <job-dir>。 - 字幕 —
transcribe.py→.srt;套用brand/caption-corrections.json(從caption-corrections.example.json複製 — 這是一個尋找/取代對應表,用於修正 ASR 經常誤判的詞彙)。以 YouTube CC 字幕形式輸出,不要燒錄進影片。 - 音樂 — 背景音樂鋪在一切之下,旁白時進行側鏈壓縮,目標 ~-14 LUFS。在
CREDITS.md中記錄曲目來源。 - 輸出 —
vrender.sh project.mlt draft.mp4 fast→ 導演審查 →vrender.sh … final.mp4 quality→ 清理暫存檔案。
圖形品質標準
HyperFrames 片段必須遵守 brand/frame.md。偏好由排版驅動、內斂、有份量的動態。如果某個節拍不需要動畫,保持乾淨的靜態畫面即可 — 不要為了動畫而動畫。
參考
- 粗剪:
avenox-roughcut· 圖形:avenox-graphics - HyperFrames 技能:
hyperframes(路由器)、hyperframes-cli、hyperframes-animation、hyperframes-creative、motion-graphics、faceless-explainer、general-video - 品牌規範:
brand/frame.md(從brand/frame.template.md填入內容)