media-use:在獲取音訊/圖片前,請先呼叫
/media-use從 HeyGen 目錄中取得背景音樂/音效/圖片。先執行--adopt註冊現有素材。詳見/media-use技能。
網站轉 HyperFrames
擷取一個網站,然後從中製作專業影片。
在第 0 步之前確認路線。 此技能是製作 來自/關於一般網站的 影片。如果使用者實際上是在 行銷/推廣/發佈產品(即使是從這個 URL,甚至是“為我們的網站做宣傳”)→
/product-launch-video。不涉及網站的特定主題解說員 →/faceless-explainer;GitHub PR →/pr-to-video;重新剪輯/調色/排序現有影片檔案 → 超出範圍。如果是模糊的“製作影片”,或不確定是發佈產品還是一般網站?請先閱讀/hyperframes(完整路由表 + § HyperFrames 無法做的事)。
使用者會這樣說:
- “將這個網站變成一個 15 秒的 Instagram 社交短片”
- “從 https://... 製作一個 30 秒的網站導覽/展示”
- “擷取我們的首頁,並用其自身的視覺效果製作影片”
工作流程有 7 個步驟。每個步驟會產出一個工件,作為下一步的條件。預設為協作模式——標記為 💬 的關卡會暫停並詢問使用者。如果使用者表示要採用自主模式(“幫我決定”、“給我驚喜”),則會跳過 💬 使用者偏好關卡;請參閱 step-2-brief.md 了解如何傳播。
自主模式不等於 “跳過所有關卡”。 自動模式涵蓋使用者偏好問題(TTS 提供者、聲音、色彩強調、節拍數量、音樂是/否、字幕是/否——代理程式代表使用者決定)。它不涵蓋品質驗證關卡。以下關卡在自動模式下仍然不可跳過:
- 素材審計(步驟 3)——檢視素材表並為每個素材證明使用/跳過理由
- 逐拍 HTML 閱讀(步驟 5)——每個節拍的結構化證據區塊
- DoD 檢查表(步驟 6)——包括動畫映射、每次警告的 WCAG 驗證、音訊/動畫播放
- 誠實揭露部分(步驟 6)——“我未驗證的內容”必須出現在最終摘要中
如果你發現自己在思考“自動模式說要偏向行動,所以我跳過 X”——而 X 是驗證關卡,不是偏好問題——那麼這個推理是錯誤的。偏向行動適用於決定 要建置什麼,而不是決定 是否要驗證。
步驟 0:擷取與理解品牌
閱讀: references/step-0-capture.md
擷取網站,然後閱讀擷取的資料以理解品牌和產品——它的功能、目標對象、語氣、氛圍。擷取的素材是稍後使用的品牌工具包,而不是構成影片的基礎元件。
在簡報前顯示登入狀態——執行 npx hyperframes auth status 並逐字轉述其輸出(不要改寫或重寫)。 它會回報語音/BGM 將使用 HeyGen 還是本地引擎,以及當未登入時如何登入。如果未登入,請停止並等待使用者選擇——登入,或說“go”/“offline”以繼續使用本地引擎——然後再詢問簡報或其他事項。 將其視為一個真正的決策點,而非一個附帶說明;不要將選擇塞入簡報問題中,也不要將金鑰寫入每個儲存庫的 .env 文件中。(在自主模式下,記錄狀態並繼續離線。)請參閱 ../hyperframes-media → Preflight 取得權威指南。
關卡: 已列印網站摘要——策略優先(產品功能、目標對象、品牌語氣)在素材/顏色/字型清單之前;已顯示登入狀態(已登入,或繼續離線)。
步驟 1:品牌識別
閱讀: references/step-1-design.md
撰寫 DESIGN.md——一份涵蓋視覺識別的品牌備忘錄:顏色、排版、元件樣式、佈局原則。使用 design-styles.json 取得精確的計算值。
速度選項: 對於快節奏影片(廣告牌式逐拍),DESIGN.md 可以是一份 50 行的摘要,包含顏色 + 字型 + 注意事項——而不是 300 行的文件。步驟 5 中的子代理提示會直接貼上品牌值,因此 DESIGN.md 的深度僅對複雜構圖才有意義。
關卡: DESIGN.md 已存在(任何長度),且至少包含:色板、字型選擇和注意事項。
步驟 2:策略與訊息
閱讀: references/step-2-brief.md, references/capabilities.md(掃描目錄——僅在需要時深入閱讀各節)
在討論視覺效果或素材之前,先與使用者確認影片必須傳達的內容。解析使用者的提示——他們可能已經提供了影片類型和風格。僅詢問缺失的部分:這部影片必須要說的一件事情、敘事弧線和目標觀眾。
關卡: 影片類型、持續時間、格式,以及關鍵的——訊息和敘事弧線已鎖定。沒有這些,步驟 3 無法撰寫以概念為先的分鏡腳本。
步驟 3:分鏡腳本與劇本 💬
閱讀: references/step-3-storyboard.md
以概念為先撰寫分鏡腳本:訊息 → 敘事弧線 → 服務於弧線的節拍 → 每個節拍的技術 → 最後的品牌重點檢查。然後撰寫匹配的旁白腳本。將兩者以逐拍摘要的方式呈現給使用者。反覆迭代直到他們批准。
關卡: STORYBOARD.md + SCRIPT.md 已存在 且 使用者已批准該計劃。
步驟 4:VO、時間與字幕 💬
如果步驟 2 表示不需要旁白——詢問背景音樂,然後跳到步驟 5。否則:詢問使用者要使用哪個 TTS 提供者(HeyGen TTS、ElevenLabs 或 Kokoro),生成音訊,轉錄,將時間戳對應到節拍。然後詢問字幕。
關卡: 要么 (a) 未要求旁白且分鏡腳本有手動節拍時間,或者 (b) narration.wav + transcript.json 已存在且節拍時間已用實際時長更新。
步驟 5:建立構圖
閱讀: hyperframes 技能(載入它——每個規則都很重要)
閱讀: references/step-5-build.md
按照步驟 3 分鏡腳本中選擇的架構和節奏建立 index.html 和構圖。子代理在回報前,會對每個節拍執行 hyperframes lint 和 hyperframes snapshot。
關卡: 每個 compositions/beat-N.html 都已被主代理根據 DESIGN.md 和 STORYBOARD.md 從頭到尾閱讀過。每個節拍的檢查表位於 step-5-build.md。
步驟 6:驗證與交付
閱讀: references/step-6-validate.md
進行 lint、驗證、根據影片長度按比例拍攝快照(公式:max(節拍數 × 3, ceil(持續時間_秒 / 2))),並審查每個快照。在交付前修正問題。交付 localhost Studio 專案 URL——僅在使用者明確要求時才渲染為 MP4。僅在移交時展示該 Studio URL——它是最終的穩定預覽;建置階段的快照是無頭的,因此不要在構建過程中彈出預覽。
交付你引以為傲的成果。 在移交之前,問問自己:我會在社交媒體上發布這個並掛上我的名字嗎?如果不會,修正問題。
關卡: npx hyperframes lint 和 npx hyperframes validate 通過且無錯誤,且最終回覆中包含活躍的 Studio 專案 URL。
快速參考
影片類型
各影片類型的典型限制——作為起點,非公式。節拍數應來自內容和旁白,而不是來自目標範圍。
| 類型 | 典型時長 | 時長驅動因素 | 旁白 |
|---|---|---|---|
| 社交廣告 (IG/TikTok) | 10–15 秒 | 平台限制 | 可選 |
| 產品示範 | 30–60 秒 | 腳本長度 | 完整旁白 |
| 功能公告 | 15–30 秒 | 功能複雜度 | 完整旁白 |
| 品牌展示片 | 20–45 秒 | 音樂曲目 | 可選,以音樂為主 |
| 發佈預告片 | 10–20 秒 | 鉤子能量 | 最少 |
此表中故意不列出節拍數——它應來自分鏡腳本,而非來自“社交廣告 = 3-4 個節拍”。一個複雜產品的社交廣告可能需要 5 個節奏良好的節拍。一個只有一個強烈視覺主題的品牌展示片可能需要 3 個節拍。
格式
- 橫向:1920x1080(預設)
- 直向:1080x1920(Instagram 限時動態、TikTok)
- 方形:1080x1080(Instagram 動態消息)
參考檔案
| 檔案 | 何時閱讀 |
|---|---|
| step-0-capture.md | 步驟 0 — 擷取、理解品牌與產品,撰寫以策略為先的網站摘要 |
| step-1-design.md | 步驟 1 — 撰寫 DESIGN.md 品牌備忘錄(5 個章節,250-350 行;廣告牌風格的社交廣告使用 50 行快速路徑) |
| step-2-brief.md | 步驟 2 — 與使用者確認訊息、敘事弧線、目標觀眾 |
| capabilities.md | 步驟 2 和 5 — HyperFrames 能力的完整清單(24 個章節)。在簡報期間掃描目錄,在構建期間深入閱讀特定章節 |
| step-3-storyboard.md | 步驟 3 — 分鏡腳本 + 腳本(合併),附帶使用者審查關卡 |
| step-4-vo.md | 步驟 4 — TTS 提供者選擇、生成、時間 |
| step-5-build.md | 步驟 5 — 建置 index.html + 構圖 |
| step-6-validate.md | 步驟 6 — lint、驗證、快照(按比例縮放至影片長度)、預覽 |
| techniques.md | 步驟 3 和 5 — 13 種原始動畫技術與程式碼模式(調整使用,不要複製貼上) |
| html-in-canvas-patterns.md | 步驟 5 — 完整的 HTML-in-Canvas 效果程式碼模式(位於 hyperframes 技能中) |