Communitygithub.com

影片產生器

根據腳本錄製清晰、無成本的葡萄牙語旁白影片。支援動畫模式(Reels/TikTok/Shorts 1080×1920,含角色、逐字字幕、持續移動的鏡頭、音樂、特效、封面與品質控制)與教學模式(錄製真實網頁,含游標、縮放與強調效果,2560×1440)。當使用者要求製作、錄製、剪輯、調整或審查影片、Reels、封面,或將腳本轉為影片時使用。

影片產生器 是什麼?

這項技能是一個全功能的影片產生器,專為AI代理設計,能根據文字腳本自動產生兩種模式的影片:動畫模式(適合Reels/TikTok/Shorts)與教學模式(螢幕錄製)。它讀取本地腳本檔案(docs/04_VIDEO_ANIMADO.md 等),並從範例資料夾(videos/exemplo-bolinha-vermelha)複製模板,再透過 roteiro.py 設定旁白順序、品牌名稱、角色PNG等,並在 pagina.html 中以函數定義各場景的動畫元素。產生過程中會呼叫 motor/animar.py 進行合成,包含逐字字幕同步、角色姿勢變換、動態鏡頭運鏡、背景音樂與音效。完成後會自動執行品質檢查(解析度、影格率、音量等),並可產生封面圖片(capa.py)與驗證文字位置(verificar_textos.py)。此技能支援Claude Code、Codex、Cursor等工具,透過Python腳本驅動,無需外部雲端費用。重要限制包括:需確保渲染函數僅依賴時間變數t、鏡頭持續運動、避免靜止畫面過長、遵循Instagram按鈕安全區域規則,以及角色PNG需為真透明背景。另外也包含安全提醒,如不將客戶個人資料傳至外部TTS服務、API金鑰僅存放於 ~/.secrets/、與用戶確認後才使用付費API額度。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/scamposgabriel/gerador-de-videos/tree/HEAD/.claude/skills/gerador-de-video

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

影片產生器 是做什麼的?

以葡萄牙語回答。螢幕文字與旁白不使用術語。在新的影片前,請閱讀 docs/04_VIDEO_ANIMADO.md(動畫模式)或 docs/01 與 docs/02(教學模式),以及 docs/03_QUALIDADE_E_CHECKLIST.md。

動畫影片流程(最常被要求)

  1. 腳本已批准。 若無,請使用 roteirista 技能,並在錄製前向使用者展示腳本 + 分鏡圖。
  2. 複製模板:videos/exemplo-bolinha-vermelha → videos/<影片短名稱>(新資料夾;絕不修改範例)。
  3. roteiro.py:替換 FALAS(一段台詞 = 一個場景,cena="名稱")、MARCA(頻道名稱、頭像),以及如有 PERSONAGEM(包含PNG姿勢的資料夾)。調整 saida 與 saida_so_voz。
  4. 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。
  5. 在全部錄製前先檢查:py motor/animar.py videos/<資料夾> --fotos 0,3,8,15(以實際解析度輸出PNG至 saida/fotos)並製作一個檢視表,逐一檢查每個場景。可搭配聲音測試:--ate 12。
  6. 錄製:py motor/animar.py videos/<資料夾>。會輸出含音樂的MP4、僅人聲版本,以及 saida/controle_de_qualidade.json (自動QA:解析度、FPS、靜止畫面>1秒、重複幀、黑畫面、音量-14 LUFS、峰值)。
  7. 封面:py ferramentas/capa.py videos/<資料夾> → saida/Capa.png。
  8. 文字檢查:py ferramentas/verificar_textos.py videos/<資料夾>(檢查文字是否被裁切、超出畫面或在Instagram按鈕下方)。
  9. 交付檔案路徑,並告知使用者需要聆聽確認的內容(你無法聽到音訊)。絕不發布。
  10. 預發布(可選,在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額度。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能