影片產生器 是做什麼的?
以葡萄牙語回答。螢幕文字與旁白不使用術語。在新的影片前,請閱讀 docs/04_VIDEO_ANIMADO.md(動畫模式)或 docs/01 與 docs/02(教學模式),以及 docs/03_QUALIDADE_E_CHECKLIST.md。
動畫影片流程(最常被要求)
- 腳本已批准。 若無,請使用
roteirista技能,並在錄製前向使用者展示腳本 + 分鏡圖。 - 複製模板:
videos/exemplo-bolinha-vermelha→videos/<影片短名稱>(新資料夾;絕不修改範例)。 - roteiro.py:替換
FALAS(一段台詞 = 一個場景,cena="名稱")、MARCA(頻道名稱、頭像),以及如有PERSONAGEM(包含PNG姿勢的資料夾)。調整saida與saida_so_voz。 - pagina.html:每個場景有一個註冊在
MONTA的c名稱(r, c)函數。重複使用模板中的元件:quando(cena, "palavra")(聲音說出該詞的瞬間)、entra()(同步入場)、sai()、anim()、personagem()(在正確的詞語時切換姿勢;手中物體透過.extra)、bola()/bolaDiv()、jardim()、cachorro()、som()、結尾卡片(montarFim)和 封面(montarCapa,在render(t < 0)中繪製)。顏色設定在--fundo、--tinta、--destaque。 - 在全部錄製前先檢查:
py motor/animar.py videos/<資料夾> --fotos 0,3,8,15(以實際解析度輸出PNG至saida/fotos)並製作一個檢視表,逐一檢查每個場景。可搭配聲音測試:--ate 12。 - 錄製:
py motor/animar.py videos/<資料夾>。會輸出含音樂的MP4、僅人聲版本,以及saida/controle_de_qualidade.json(自動QA:解析度、FPS、靜止畫面>1秒、重複幀、黑畫面、音量-14 LUFS、峰值)。 - 封面:
py ferramentas/capa.py videos/<資料夾>→saida/Capa.png。 - 文字檢查:
py ferramentas/verificar_textos.py videos/<資料夾>(檢查文字是否被裁切、超出畫面或在Instagram按鈕下方)。 - 交付檔案路徑,並告知使用者需要聆聽確認的內容(你無法聽到音訊)。絕不發布。
- 預發布(可選,在QA通過後):透過維度進行編輯QA(
py creative-intelligence/ci.py avaliacao modelo ...)、 版本間鉤子比較(ci comparar)以及僅在成本批准並取得素材擁有者授權後進行的預測性評估(Higgsfield)(ci prever ... --modelo-autorizacao)。 參閱engenharia-reversa技能第5節。此步驟非錄製或教學所必需;引擎不依賴於此。
影格表(每2秒一幀):ffmpeg -i saida/<video>.mp4 -vf "fps=1/2,scale=240:427,tile=9x3" -frames:v 1 folha.png。
教學模式(真實網頁)
複製 modelos/roteiro_modelo.py 到 videos/<資料夾>/roteiro.py;動作說明請參考 docs/02_ACOES_DO_ROTEIRO.md。
測試:py motor/gravar.py videos/<資料夾> --so 02-04;然後錄製完整影片。
曾經付出慘痛代價的規則(請勿重犯)
render(t)只依賴t(不儲存前一幀的任何資料);漸層停頓點必須始終有序。- 絕不凍結畫面:鏡頭持續移動(緩慢拉近 + 漂移);結束的片段從後往前播放;結尾卡片也要動態。
- 第一幀就呈現動作:第一秒就展示謎團(不要有空洞的場景等待)。
- Reels(1080 × 1920):標題範圍在150到440像素之間;字幕約在1330像素,每個區塊最多約16個字(寬度限制860像素); 1600像素以下以及右側(x > 960)介於1100與1750像素之間不可放置重要內容——Instagram的按鈕與描述區域。
- 示範物體必須夠大:鏡頭靠近;前景的草/元素僅在物體底部出現。
- 「之前 × 之後」比較,兩個畫面須保持相同構圖;兩者之間要有可視的轉場(例如掃動)。
- 直式畫面中,不可有水平橫條在中間;橫式片段進入直式畫面時需裁切(最大放大倍率約1.2×)。
- 角色PNG:確認背景真的是透明(5%的顏色會在影片中變成矩形區塊)。
- 刻意縮放可能導致文字短暫(< 0.5秒)移出畫面;除此之外,文字檢查器應完全通過。
- 請勿使用瀏覽器螢幕錄製或Playwright的影片(結果模糊);引擎採用逐幀拍攝。
roteiro.py中的Windows路徑務必寫成r"..."。- 語音:句子要簡短;
vozes.py會逐句產生並加入呼吸(voz["respiro"])。自然語速為每秒2.4至3.2個單詞 (引擎會顯示持續時間;單詞數 ÷ 秒數)。 - 圖庫片段:僅使用允許用途的授權(Mixkit "Free";"Restricted" 禁止廣告用途);記錄在
midia/CREDITOS.md。
安全性
- 語音會送至外部服務(Edge TTS 或 ElevenLabs):絕不在朗讀文字中包含姓名、CPF或客戶資料。
- 金鑰僅存放在
~/.secrets/(ElevenLabs:~/.secrets/elevenlabs/.env);絕不列印,絕不複製到儲存庫中。 - 模擬或虛構角色:在畫面上標示(「近似模擬」、「虛構角色」)。
- 未經使用者批准,不得花費付費API額度。