HyperFrames — 從這裡開始
HyperFrames 從 HTML 渲染影片 — 一個合成就是一個 HTML 檔案,其 DOM 使用 data-* 屬性宣告時間軸,動畫運行時可搜尋,媒體播放由框架管理。完整的創作合約位於 /hyperframes-core;在撰寫合成 HTML 之前,請先閱讀該內容。
以下內容包含:功能映射(按需載入的領域技能)和意圖路由器(為任何「幫我做一支影片」的請求選擇工作流程)。
功能映射 — 領域技能
按需載入的基本功能 — 並非完整的影片工作流程。若請求為「幫我做一支影片」,請使用下方的意圖路由器。
| 您想要… | 技能 |
|---|---|
創作 / 編輯 HTML 合成 — data-* 合約、片段、軌道、子合成、變數 | /hyperframes-core |
| 製作動畫 — 原子運動、場景藍圖、轉場、執行時期轉接器(GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
創意方向 — frame.md / design.md、調色盤、字體排印、敘事、節奏規劃、音訊反應 | /hyperframes-creative |
| 媒體 — TTS 旁白、背景音樂、轉錄、去背、字幕 | /hyperframes-media |
媒體解析 — 從 HeyGen 目錄中尋找並匯入 BGM、SFX、圖片、圖示至 .media/ 並附帶清單追蹤 | /media-use |
| CLI 開發循環 — 初始化、程式碼檢查、驗證、檢查、預覽、渲染、發布、診斷 | /hyperframes-cli |
安裝註冊表區塊 / 元件(hyperframes add) | /hyperframes-registry |
意圖路由 — 選擇工作流程
本節僅知道頂層工作流程;不會載入其內部參考或上面的領域技能。
路由前 — 先確認輸入,而非規格
路由需要知道影片內容 — 其輸入和主題。如果該內容未指定(「為我們的產品做一支影片」但沒有 URL、產品、主題或素材),請在進入任何工作流程前先詢問 — 提交工作流程本身就是路由決策。最多問兩個問題:
- 輸入 — 產品(URL / 簡報)、一般網站、GitHub PR、要解釋的主題、或現有的談話頭影片?
規格預設值 — 直接告知,不詢問(它們永遠不會改變路由):寬高比 16:9(僅在指定的直向目的地 — TikTok / Reels / Shorts 時使用 9:16);旁白 / 字幕語言 = 使用者的語言。所選工作流程會在其第一步重新確認其自身的細節。
工作流程速查表
| 工作流程 | 使用時機 |
|---|---|
/product-launch-video | 行銷 / 發布 / 推廣產品 — 從其 URL、簡報或腳本(即使只提到了網站名稱) |
/website-to-video | 將一般網站轉換成影片 — 網站導覽、作品集 / 登陸頁面展示、來自網站視覺效果的社交短片 |
/faceless-explainer | 從文字解釋主題 / 概念 — 沒有產品、沒有 URL;每個視覺效果都是 LLM 虛構的 |
/pr-to-video | GitHub PR / 程式碼變更 → 變更日誌 / 功能揭曉 / 修正 / 重構解說員 |
/embedded-captions | 為現有談話頭影片新增字幕 / 副標題(原始影片未經修改) |
/talking-head-recut | 為現有談話頭影片套用設計過的圖形疊加層 — 下方三分之一、資料呼叫、動態標題、引言引述 |
/motion-graphics | 簡短、無旁白、設計為主的動態圖形 — 動態字體、統計 / 圖表重點、標誌開場、下方三分之一疊加層 |
/music-to-video | 音樂曲目 → 節拍同步的影片 — 歌詞影片、幻燈片或動態宣傳片;音樂驅動節奏(可選的使用者圖片 / 影片會按節拍網格剪輯) |
/slideshow | 簡報 / 提案簡報 / 互動式簡報 — 離散投影片、片段、分支、熱點;輸出為可導覽的簡報,而非渲染影片 |
/general-video | 其他任何情況 — 較長或多場景片段、靜態循環 / 海報、自訂合成 |
/remotion-to-hyperframes | 將現有 Remotion (React) 合成移植到 HyperFrames(遷移,非創作) |
消歧義(僅在可能混淆時):
- 運動優先且無旁白(約 10 秒以下,運動本身就是訊息) →
/motion-graphics,無論輸入為何。 - URL 或腳本 — 行銷特定產品(即使只提了網站名稱) →
/product-launch-video;一般非產品網站 →/website-to-video;GitHub PR 連結 →/pr-to-video;解釋概念但沒有產品 / 網站 →/faceless-explainer。若真的分不清產品 vs 主題,或發布 vs 一般網站 → 問一個問題。 - 現有影片 — 純口語字幕 →
/embedded-captions;設計過的疊加卡片 →/talking-head-recut。兩者都不會編輯影片本身(重新剪輯 / 調色 / 重構 / 重新排序 / 音訊屬於非線性剪輯 — 不在範圍內)。 - 輸入是音樂曲目(音訊檔案,或要擷取音訊的影片)且無旁白 →
/music-to-video— 音樂的節拍 / 能量驅動節奏。(有旁白的片段仍保留在以上輸入匹配的工作流程;/motion-graphics用於非音樂驅動的簡短無旁白動畫。) - 簡報 / 提案簡報 / 互動式簡報(離散投影片、導覽、簡報者模式) →
/slideshow— 輸出為可導覽的簡報,而非渲染影片。明確的「幻燈片」請求會直接進行;相關觸發(「簡報 / 投影片 / 簡報 / 轉換此頁面」)會讓/slideshow在創作前確認是否為幻燈片,若不是則切換到適當的非幻燈片工作流程。 - 長度是指引,而非門檻 — 意圖決定工作流程;僅在片段明顯長於約 3 分鐘,或是靜態 / 循環 / 自訂格式時,才使用
/general-video。
如果匹配的工作流程未安裝
一旦您選定了工作流程,請檢查它是否確實可用。如果匹配的工作流程技能未安裝,請不要退回猜測 — 告知使用者先安裝它:
- 僅此工作流程:
npx skills add heygen-com/hyperframes --skill <工作流程名稱>(例如--skill pr-to-video— 純名稱,無前導/)。 - 一次安裝所有工作流程:
npx skills add heygen-com/hyperframes --all(核心 + 所有工作流程,跳過選擇器)。
執行後,重新讀取工作流程的技能並繼續。
工作流程詳情
/product-launch-video
- 輸入: 正在行銷的產品 — (a) 產品 URL(使用無頭 Chrome 爬取資源 + 品牌權杖),(b) 有提及產品網站(即使沒有連結)的腳本 / 簡報(PLV 會解析 + 爬取該網站,除非使用者選擇退出),或 (c) 無法推導出網站 /「不要抓取」的腳本(無擷取模式 — 選擇提供調色盤 + 設計系統的風格預設)。提供的腳本可以作為逐字旁白或按場景重新結構 — PLV 會詢問。
- 輸出: 產品發布 / SaaS 宣傳片,作為 HyperFrames 合成 → MP4(最佳長度 30–90 秒)。
- 觸發詞:「X 的發布影片」、「我們網站的宣傳片」、「在一分鐘內解釋我的 SaaS」、「將我的腳本變成 60 秒宣傳片」、「純文字發布影片,不要抓取」。
/website-to-video
- 輸入: 要轉換成影片的一般網站 / URL — 目標是製作關於該網站的影片,而非產品發布。使用無頭 Chrome 擷取真實螢幕截圖 + 品牌資源。
- 輸出: 基於網站自身視覺效果的網站導覽 / 作品集 / 登陸頁面展示 / 社交短片 → MP4。
- 觸發詞:「將此網站變成影片」、「從 的網站導覽」、「我們首頁的社交短片」、「我只有一個 URL — 做點什麼」。
/faceless-explainer
- 輸入: 任意文字 — 正在解釋的主題、文章或筆記,無行銷產品、無網站可擷取。(從
/product-launch-video分叉;無無頭 Chrome。) - 輸出: 無臉解說影片 → MP4,每個視覺效果都是 LLM 按場景虛構的(字體排印 / 抽象 / 圖表 / 資料視覺化);內含
pin-and-paper預設。(最佳長度 30–90 秒)。 - 觸發詞:「關於 X 的無臉解說影片」、「解釋 DNS 如何運作的影片」、「將此文章變成解說影片」、「根據我的筆記製作解說影片」。
/pr-to-video
- 輸入: GitHub 拉取請求 — PR URL、
owner/repo#N引用或「此 PR」— 透過ghCLI 讀取(非可爬取的網站)。 - 輸出: 程式碼變更解說影片(變更日誌 / 功能揭曉 / 修正 / 重構)→ MP4 — 差異亮點、前後對比、檔案樹 + 影響場景。最佳長度 30–90 秒。
- 觸發詞:「製作關於此 PR 的影片」、「將 PR #1187 變成變更日誌影片」、「來自 github.com/org/repo/pull/123 的版本說明影片」。
/embedded-captions
- 輸入: 現有的談話頭影片(MP4)以加入字幕 — 實際影片,非 URL 或簡報。本地轉錄(Whisper,無需 API 金鑰)並進行去背處理(RVM),使主體可以遮擋字幕。
- 輸出: 相同的未經修改的影片,帶有字幕層 — 標準(逐字下方三分之一軌道 + 主體後方的嵌入式高潮)或電影級(每個字幕都合成在主體後方)。任何長度。
- 觸發詞:「在此影片中加入字幕 / 副標題」、「主體後方的字幕」、「我的剪輯的電影級字幕」。
/talking-head-recut
- 輸入: 現有的談話頭 / 訪談 / 播客影片(MP4),要包裝上畫面圖形 — 實際影片。本地轉錄(Whisper)。影片在下方完整播放,未經修改。
- 輸出: 相同的影片,帶有定時的圖形疊加卡片 — 動態標題、下方三分之一、資料呼叫、引言引述、側邊面板、子母畫面 — 與轉錄文字同步。任何長度。
- 觸發詞:「包裝此影片」、「在我的演講中加入圖形疊加層 / 下方三分之一 / 資料呼叫」、「將此訪談變成圖形包裝的剪輯」。
/motion-graphics
- 輸入: 簡短、設計為主的動態圖形,其中運動就是訊息 — 通常約 10 秒以下,無旁白。類型:動態字體排印、統計 / 數字計數、圖表重點、標誌開場、下方三分之一 / 疊加層、或搜尋驅動的頁面 / 推文 / 標題畫面。
- 輸出: 簡短的動態圖形 → MP4 或透明疊加層(alpha WebM / MOV)用於下方三分之一 / 呼叫。
- 觸發詞:「8 秒的標誌開場」、「為此統計數據製作動畫」、「動態字體介紹」、「將此推文變成動態圖形」、「透明的下方三分之一疊加層」。
/music-to-video
- 輸入: 音樂曲目 — 音訊檔案,或要從中提取音訊的影片 — 無旁白且無網站擷取。可選的使用者提供的圖片 / 影片以穿插其中。曲目會被分析一次,產生確定性的節拍 / 能量圖(
audiomap.json),整個影片都基於此建構。 - 輸出: 節拍同步的 HyperFrames 合成 → MP4,由音樂驅動節奏。字體排印和模板是基礎(一個完整的影片不需要任何資源);任何提供的媒體都會按相同的節拍網格剪輯(節拍剪輯 / 肯·伯恩斯效果)。類型 — 歌詞影片、幻燈片、動態宣傳片 — 由每個畫格的選擇決定;管道永遠不分支。
- 觸發詞:「為這首歌製作影片」、「從此曲目製作節拍同步影片」、「歌詞影片」、「將此音樂變成影片」、「音樂視覺化工具 / 隨此節拍的動態宣傳片」。
/slideshow
- 輸入: 要創作的簡報 / 提案簡報 / 互動式簡報 — 簡報、大綱或要轉換成投影片的現有頁面。非渲染影片的請求;如果意圖不明確,技能會在創作前確認「您是否希望將其作為 HyperFrames 幻燈片?」。
- 輸出: 可執行的 HyperFrames 合成 + 一個 JSON 島,播放器的
SlideshowController會讀取它,將 GSAP 時間軸轉換成可導覽的簡報 — 離散投影片、片段揭示、分支序列、熱點導覽、簡報者模式和講者備註。交付成果是簡報,而非 MP4。 - 觸發詞:「製作提案簡報 / 簡報 / 投影片簡報」、「互動式簡報」、「將此頁面轉換成投影片」、「具有簡報者模式的幻燈片」。
/general-video
- 輸入: 以上未提及的任何內容 — 創意簡報、要製作動畫的單一元素、對您正在建構的合成進行的編輯。輸入和長度不拘。
- 輸出: HyperFrames 合成(任何長度 / 格式)經由原始流程:設計系統 → 提示擴展 → 計畫 → 動畫前佈局 → 建構(委派給
hyperframes-* 技能)→ 驗證
…
[為翻譯而截斷]