brand-video — 按需產出風格一致的不露臉影片
使用指令 /brand-video。一條指令,多種風格。基於已驗證的 RestoreAssist 專案(已交付 9 支影片)建構。從 styles.md 中選取風格,其餘參數保持不變,確保產出批次一致、品牌統一。
輸入(僅在缺少時詢問;合理推斷)
- brand — RestoreAssist / Synthex / DR / NRPG / CARSI / CCW / Unite,或客戶名稱。設定主張、號召行動與配音。
- style —
styles.md中的鍵值(預設flat-line)。這就是「外觀」/下拉選項值。 - topic(s) — 單一主題,或批次清單(每個主題一支影片,平行處理)。
- voice —
ELEVENLABS_VOICE_ID(依品牌而定;來自~/.hermes/.env)。關鍵:產生前務必確認當前值——使用者經常更改它。 - upload? — 預設:僅算繪與暫存。僅在要求時上傳至 YouTube 非公開。
管道(每支影片一個 slug 資料夾,絕不共用目錄)
- 腳本 →
<slug>/script.md:一個乾淨的 VO 段落,約 120–140 字,約 12–16 個短句(一句 = 一個視覺節拍 = 一張圖),問題→解決方案→號召行動。主張需基於品牌 wiki;不得虛構功能。結尾為品牌號召行動詞句。 - 配音 → 執行 bundled 的
tts.py(讀取ELEVENLABS_API_KEY+ELEVENLABS_VOICE_ID+DIR):cd <workdir> && set -a && . ~/.hermes/.env && set +a && DIR=$PWD/<slug> python3 <skill>/pipeline/tts.py產出<slug>/voiceover.mp3+<slug>/transcript.json(節拍)。記下節拍數量。 - 圖片 → 每個節拍一張,提示詞 = 所選風格的 POSITIVE token + 該句子對應的具體場景 + 該風格的 NEGATIVE token,橫向 16:9,檔案名稱零填充
<slug>/images/01.png …。- 正式 / 無頭模式(預設):
python3 <skill>/pipeline/image_gen.py "<prompt>" <out.png>— Geminigemini-2.5-flash-image(「Nano-Banana」)透過 HTTPS,GEMINI_API_KEY從環境變數讀取。可在伺服器端運作;已完整驗證。這是應用程式 Worker 呼叫的方式(無需本機 MCP)。 - 互動模式(選擇性): 在 Claude 工作階段中執行時使用
mcp__margot__image_generate;使用 slug 前綴的檔名以避免平行衝突(參見 [[parallel-agents-shared-output-collision]])。
- 正式 / 無頭模式(預設):
- 合成 →
python3 <skill>/pipeline/stitch.py <slug>→<slug>/final-1080p.mp4(1920×1080@25,圖片時間來自節拍)。確認最終長度 ≈ 配音長度。
批次處理與新增外觀
- 批次: 每個主題分派一個子代理(平行處理),各自擁有自己的 slug 資料夾。參考 RestoreAssist 專案以取得精確的代理提示格式。
- 重配音(變更配音,腳本/圖片不變):重新產生 VO,將
list.txt的持續時間按new_total/old_total等比例縮放,重新合成。(重配音模式。) - 新增外觀: 在
styles.md中新增一個區塊(positive/negative token)。該鍵值立即可作為可選風格——此登錄檔就是下拉選單的資料來源。
上傳(YouTube,選擇性)
瀏覽器檔案上傳已失效(主機路徑被拒)。使用 [[youtube-api-upload-restoreassist]] 中記載的 YouTube Data API 路徑:桌面 OAuth 用戶端 → token 儲存於 ~/.hermes/yt-restoreassist-token.json → videos().insert privacyStatus=unlisted、category 27、not-for-kids;以頻道標題為保護條件;透過 uploaded.json 確保冪等性。需要在 OAuth 用戶端的 GCP 專案中啟用 YouTube Data API v3。
防護措施
- 主張必須真實(品牌 wiki / 產品事實)。扁平插圖 + 合成語音 → YouTube AI 揭露通常為「否」(上傳時確認;若有 AI 音樂則改為「是」)。
- 為保持一致性,一個批次只使用一種風格。保持
SKILL.md不超過 200 行(依據 [[feedback-tight-code]])。 - 參考實作與素材:
/Users/phill-mac/restoreassist-videos/。