media-use:在獲取音訊/圖片前,請呼叫
/media-use從 HeyGen 目錄中解析 BGM/SFX/圖片。先執行--adopt以註冊現有資產。請參閱/media-use技能。
general-video — 通用影片工作流程
在開始建置前,請先確認路線。 這是用於自訂合成編寫的後備方案。如果輸入內容明顯符合某個專門工作流程,請優先使用:行銷產品 →
/product-launch-video;一般網站 →/website-to-video;主題解說 →/faceless-explainer;GitHub PR →/pr-to-video;現有素材 →/embedded-captions·/talking-head-recut;短篇無旁白動畫 →/motion-graphics;Remotion 移植 →/remotion-to-hyperframes。超出範圍:即時/渲染時資料、對已完成影片進行 NLE 風格剪輯,或產生 HyperFrames 無法捕捉的素材。不確定?請先閱讀/hyperframes。
嚴格建置所要求的內容。 標題卡就是標題卡 — 而不是標題卡 + 三個輔助場景 + 環境音樂 + 字幕。如果額外場景或元素確實能改善作品,請_提議_它們;不要默默添加。對於小幅編輯(修正顏色、調整一個時長、添加一個元素),跳過規劃步驟,直接進行建置。
方法
探索 — 僅限開放式請求
對於模糊、探索性的請求(「為我們的品牌製作一個影片」、「一個酷炫的開場」)— 在選擇顏色前先了解意圖:
- 觀眾 — 誰會觀看?開發人員 / 高層 / 一般消費者?
- 平台 — 在哪裡播放?社群 (15s) / 網站主視覺 / 產品展示 / 內部使用?
- 優先級 — 什麼最重要?動畫品質 / 內容準確度 / 品牌忠實度 / 速度?
- 變化 — 一個最佳版本,或 2-3 個有意義的不同選項(不同的節奏、能量或結構 — 不只是顏色切換)?
對於具體請求(「添加一個標題卡」、「修正場景 3 的時間」),則跳過探索。
步驟 1 — 設計系統 → hyperframes-creative
首先建立視覺識別。如果專案有設計規範,請閱讀它(優先順序 frame.md → design.md → DESIGN.md;將其視為品牌真相 — 確切的顏色、字體、限制)。
如果沒有規範,你必須先閱讀 hyperframes-creative/references/house-style.md 和 hyperframes-creative/references/video-composition.md 兩者,才能選擇任何顏色或字體。 house-style.md 提供「解讀提示 / 產生真實內容」的開場、懶惰預設列表和圖層配方;video-composition.md 則提供影片媒體的密度 / 比例 / 前景細節(資料條、標記、等寬中繼資料、「8-10 個元素,其中兩個使用者並未要求」),這區分了「製作的」與「生成的」。只讀其中一個是最常見的遺漏 — video-composition.md 正是代理人常跳過的那個,而它正是防止產生扁平、置中、網頁風格輸出的關鍵。不要自行發明調色盤並跳過這些;進入 hyperframes-creative 是強制性的,而不是可選分支。根據需要,從此處也提取一個命名風格/情緒 → references/visual-styles.md,或互動式選擇器 → references/design-picker.md。規範/風格定義的是品牌,而非合成規則。
尋找角度(模糊簡報,無規範): 在選擇顏色之前,寫一個句子 — 這個名稱/詞彙/主題喚起了什麼?哪個視覺_世界_(隱喻、場景、工具、母題)能表達它?例如,網路安全工具 → 保險庫門 / 周界掃描線 / 鎖芯;冥想應用 → 潮汐、呼吸、緩慢的光暈綻放。閱讀主題的_含義_,而不僅僅是它的文字;選擇一個具體的角度,而不是字面上的重新造型。這是針對單場景作品的提示擴展(步驟 2)的低成本替代方案,在單場景作品中應正確跳過擴展 — 這也是設計概念與通用 Logo 配漸層的區別所在。
步驟 2 — 提示擴展 → hyperframes-creative
對每個多場景合成執行(跳過單場景作品和瑣碎編輯)。根據設計規範 + 自家風格將請求歸納為一個一致的、下游工作以相同方式讀取的中間產物。請參閱 hyperframes-creative/references/prompt-expansion.md。
步驟 3 — 規劃
在編寫 HTML 之前,從高層次思考:
- 什麼 — 觀眾體驗:敘事弧線、關鍵時刻、情緒節拍。
- 結構 — 多少個合成、子合成 vs 內聯、哪些軌道承載影片 / 音訊 / 疊加 / 字幕。關於單一檔案與模組化子合成的選擇,請參閱
hyperframes-core/references/composition-patterns.md§ 兩種架構(經驗法則:≥3 個硬場景切換,或任何重複使用的場景 → 模組化;一個短的單場景作品保持單一檔案)。 - 節奏 — 在實現之前先為模式命名(例如
fast-fast-SLOW-SHADER-hold);請參閱hyperframes-creative/references/beat-direction.md。 - 時間 — 哪些剪輯驅動時長、轉場落在何處、節奏。
- 佈局 — 先建置最終狀態(見下文)。
- 動畫 — 然後透過
hyperframes-animation加入動作。
動畫前的佈局
將每個元素放置在其最顯眼的時刻所在的位置 — 完全進入、正確放置、尚未退出。首先將其編寫為靜態 HTML + CSS。請勿使用 GSAP。
原因: 如果你將元素定位在其動畫起始狀態(螢幕外、縮放至 0、透明度 0)並補間到你_認為_它們最終到達的位置,你是在猜測最終佈局 — 重疊在渲染前一直不可見。先建置最終狀態,你就能在添加動畫前看到並修復佈局問題。
- 為每個場景識別主要影格 — 最多元素同時可見的時刻。這就是你要建置的佈局。
- 為該影格編寫靜態 CSS。內容容器必須使用內邊距填滿場景,而不是絕對偏移:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* 內邊距定位內容;填滿任何場景大小 */
gap: 24px;
box-sizing: border-box;
}
切勿在內容容器上使用 position: absolute; top: Npx — 當內容高於可用空間時它會溢出。將絕對定位保留給裝飾性元素。
⚠ 上述的
width/height: 100%只有在每個祖先元素都有已計算的高度時才有效。 根<div data-composition-id>及其與.scene-content之間的任何包裝器都必須設定大小(根元素使用position: relative; width: 1920px; height: 1080px— 請參閱hyperframes-core→「根元素必須設定大小」)。跳過此步驟,彈性容器將收縮到接近 0,內容會堆疊在左上角,且第一個字形會在 x=0 處被裁剪 — 而lint/inspect仍會報告 0 個問題。並且始終保持.scene-content上的padding(≥80px):這是標題安全邊距。切勿用單純的gap取代它。
- 添加入場動畫 — 使用
gsap.from()從螢幕外/不可見動畫到 CSS 位置(在子合成中偏好使用gsap.fromTo(),使起始狀態明確;請參閱hyperframes-core/references/sub-compositions.md)。CSS 位置是基本事實;補間是到達它的過程。 - 退場由轉場處理 — 根據
hyperframes-animation/transitions/中的場景轉場規則,只有最終場景會將元素動畫退出;場景之間的轉場本身就是退場。
跨時間的共享空間: 如果元素 A 在元素 B 進入同一區域之前退出,兩者仍需要為其各自的關鍵影格設定正確的 CSS 位置 — 時間軸排序可防止它們共存,而佈局步驟會捕捉意外的重疊。分層發光/陰影和 z 堆疊深度是_有意的_重疊;此步驟在於捕捉_非故意的_碰撞(兩個標題重疊在一起、內容溢出畫面)。
建置 — 委派給領域技能
這映射了技能的全部表面(請參閱description)到其參考資料 — 非詳盡列表;當意圖未列出時,請透過 hyperframes-creative(外觀/概念)、hyperframes-animation(動作)、hyperframes-core(合約)、hyperframes-media(音訊/字幕)路由。第一行是附加的 — 請閱讀它以及你的意圖行,而不是只讀其中一個。
| 正在建置… | 優先閱讀(按順序) |
|---|---|
| 始終 — 每個非瑣碎作品,除了下方你的意圖行外 | hyperframes-creative/references/house-style.md + references/video-composition.md(也在步驟 1 / HARD-GATE 中設為門檻;「製作的,而非生成的」前景細節) |
| 動態排印 / 文字為主 | hyperframes-animation/techniques.md(動態類型)+ adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| 標題卡 / 下方三分之一 / 疊加 / PiP / 主體後文字 | hyperframes-creative/references/composition-patterns.md +(對於居中/設定大小的影格)hyperframes-core →「根元素必須設定大小」 |
| 標誌 / 品牌標記揭示 | hyperframes-animation/rules/svg-path-draw.md(繪製)+ rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| 資料 / 統計 / 數字 | hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md |
| 產品 / 應用程式 / UI 展示 | hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| 音訊反應 / 音樂驅動 | hyperframes-creative/references/audio-reactive.md(預先提取頻段;映射到動作) |
| 旁白 / 語音 / 音樂 / SFX / 字幕 | hyperframes-media → 共享音訊引擎 scripts/audio.mjs(一次呼叫 = TTS + BGM + SFX → audio_meta.json);透過 hyperframes-core 進行字幕編寫 + 資產放置。請參閱下方的音訊。 |
| 多場景 / 轉場 | hyperframes-animation/transitions/overview.md 然後 transitions/catalog.md(看完概述還沒完 — GSAP 配方在目錄中) |
| 模組化 / 子合成 | hyperframes-core/references/composition-patterns.md + references/sub-compositions.md |
音訊:一個引擎(TTS · BGM · SFX)
僅在作品需要時使用(根據「嚴格建置所要求的內容」— 標題卡上不要有環境音樂)。不要手動製作 TTS 或複製供應商:編寫一個中性的 audio_request.json 並呼叫 hyperframes-media 中的共享引擎。它會根據一個開關自動降級 — 存在 HeyGen 憑證 → 使用 HeyGen TTS + 音樂/SFX 擷取;不存在 → 使用 ElevenLabs/Kokoro TTS、Lyria/MusicGen BGM 生成以及捆綁的 SFX 庫。完整標誌列表 + 請求/中繼資料架構:請參閱 hyperframes-media/scripts/audio.mjs 的標頭註解。
// audio_request.json — 每個旁白段落一行;`id` 由你定義(將 audio_meta 連接回來)
{
"lines": [
{ "id": "s1", "text": "您的開場白。", "sfx": ["whoosh"] },
{ "id": "s2", "text": "下一個節拍。" },
],
"bgm": { "query": "calm cinematic underscore" }, // 省略 "mode" → 自動(如果存在 HeyGen 則擷取,否則生成);設為 "none" 以停用
}
# <MEDIA_DIR> = 已安裝的 hyperframes-media 技能目錄(此技能的兄弟目錄)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json
然後讀取 audio_meta.json:將每個 voices[].path +(bgm.path、sfx[])掛載為 <audio> 軌道,並使用 voices[].words 作為字幕,全部依照 hyperframes-core(音訊軌道 + 字幕編寫)。如果 BGM 走的是生成路徑(bgm_pending: true),請在最終渲染前執行 hyperframes-media/scripts/wait-bgm.mjs。