HyperFrames,從這裡開始
HyperFrames 從 HTML 渲染影片:一個合成作品就是一個 HTML 檔案,其 DOM 透過 data-* 屬性宣告時間,動畫執行時期可搜尋,多媒體播放由框架掌控。完整的編寫合約位於 /hyperframes-core;在撰寫合成 HTML 前請先閱讀。
以下是能力地圖(按需載入的領域技能)和意圖路由器(為任何「幫我做個影片」的請求挑選工作流程)。
能力地圖。領域技能
按需載入的原子化能力:並非完整的影片工作流程。對於「幫我做個影片」這類請求,請使用下方的意圖路由器。
| 你想要… | 技能 |
|---|---|
編寫/編輯 HTML 合成作品:data-* 合約、片段、軌道、子合成、變數 | /hyperframes-core |
| 製作動畫:原子化動作、場景藍圖、轉場、執行時期適配器(GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
編寫可搜尋關鍵影格:GSAP 時間軸、CSS 關鍵影格、Anime.js、WAAPI、FLIP、路徑、遮罩、SVG 變形/繪圖、3D 深度,以及 hyperframes keyframes 診斷工具 | /hyperframes-keyframes |
創意指導:frame.md / design.md、色板、字體、旁白、節奏規劃、音訊反應 | /hyperframes-creative |
| 媒體處理:TTS 語音旁白、背景音樂、轉錄、背景去除、字幕 | /hyperframes-media |
媒體解析:從 HeyGen 目錄中搜尋並凍結 BGM、音效、圖片、圖示至 .media/ 並附帶清單追蹤 | /media-use |
| CLI 開發循環:初始化、檢查、驗證、檢查、預覽、渲染、發布、診斷 | /hyperframes-cli |
安裝登錄區塊/元件(hyperframes add) | /hyperframes-registry |
| 匯入 Figma 內容:素材、代碼記號、元件、故事板→動畫腳本(REST/CLI);動態、著色器(MCP) | /figma |
意圖路由,挑選工作流程
此區段僅知道頂層工作流程;它不會載入其內部參考或上述領域技能。
路由前,先確認輸入內容,而非規格
路由需要知道影片的內容:其輸入和主題。如果這點未指定(例如「製作一個關於我們產品的影片」而沒有網址、產品、主題或素材),請在進入任何工作流程前先詢問,因為決定工作流程本身就是路由的決策。最多問兩個問題:
- 輸入內容:一個產品(網址/簡介)、一個一般網站、一個 GitHub PR、一個待解釋的主題,或一個現有的談話頭影片?
規格預設值,直接說明,無需詢問(它們永遠不會改變路由):畫幅 16:9(僅在目標平台明確指定為垂直格式時才使用 9:16,例如 TikTok / Reels / Shorts);旁白/字幕語言 = 使用者的語言。所選的工作流程會在其第一步重新確認自己的具體細節。
工作流程速查表
| 工作流程 | 使用時機 |
|---|---|
/product-launch-video | 銷售產品(SaaS、應用程式、公司/產品網站)。從網址、簡介或腳本 → 宣傳影片。任何商業網址的預設選項,即使只提到網站名稱也是如此。 |
/website-to-video | 展示網站本身:使用網站自己的螢幕截圖進行導覽/展示。適用於非商業網站(作品集、部落格、文件、個人、活動),或當使用者想要導覽而非宣傳影片時。 |
/faceless-explainer | 從文字解釋主題/概念,無產品、無網址;每個視覺元素均由 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,無論輸入內容為何。 - 網址或腳本:問一個問題:這個網站是在銷售產品嗎?是(SaaS / 應用程式 / 產品 / 公司網站)→
/product-launch-video:宣傳影片,且為任何商業網址的預設選項,即使只提到網站名稱。否,或使用者只想照原樣展示網站(作品集 / 部落格 / 文件 / 個人 / 活動)→/website-to-video:導覽。GitHub PR 連結 →/pr-to-video;無產品或網站的概念 →/faceless-explainer。 - 現有影片素材:純口語字幕 →
/embedded-captions;設計好的疊加卡片 →/talking-head-recut。兩者均不編輯影片素材本身(重新調整時間 / 重新著色 / 重新構圖 / 重新排序 / 音訊屬於非線性編輯,超出範圍)。 - 音樂曲目是輸入內容(音訊檔案,或從中提取音訊的影片),且無旁白 →
/music-to-video:音樂的節拍/能量驅動節奏。(有旁白的作品仍使用上述與輸入內容相符的工作流程;/motion-graphics適用於非音樂驅動的短小無旁白動作。) - 簡報 / 提案簡報 / 互動式簡報(離散投影片、導覽、簡報者模式)→
/slideshow:輸出為可導覽的簡報,而非渲染的影片。明確的「幻燈片」請求直接進行;若觸發條件相似(「簡報 / 投影片 / 簡報 / 轉換此頁面」),則讓/slideshow在開始編寫前先確認是否為幻燈片,若不是則切換至適當的非幻燈片工作流程。 - 長度是參考,不是門檻:意圖選擇工作流程;僅當作品明顯長於約 3 分鐘,或是靜態 / 循環 / 自訂格式時,才使用
/general-video。
如果匹配的工作流程未安裝
一旦選定工作流程,請檢查它是否實際可用。如果匹配的工作流程技能未安裝,請不要退而求其次地猜測,而是告知使用者先安裝它:
- 僅此工作流程:
npx skills add heygen-com/hyperframes --skill <workflow-name>(例如--skill pr-to-video:僅技能名稱,無前導/)。 - 一次安裝所有工作流程:
npx skills add heygen-com/hyperframes --all(核心 + 每個工作流程,跳過選擇器)。
使用者執行後,重新讀取該工作流程的技能並繼續。
保持技能最新
HyperFrames 技能具有版本控制。npx hyperframes init 會檢查已安裝的技能是否與 GitHub 上的最新版本一致,並在有任何內容過期或缺失時安裝/刷新完整組合。因此,剛初始化的專案始終擁有完整、最新的組合(在已最新的專案上重新執行 init 不會有任何操作)。此檢查是一次快速的 GitHub 往返;離線(或速率受限)時,它會在短暫超時後退而安裝,因此 init 永遠不會因網路問題而硬失敗。創作工作流程會透過 init 搭建,因此啟動新專案時始終執行此檢查,並在技能過期時從 GitHub 拉取最新技能。--skip-skills 旗標目前已被禁用(這是 skills.sh 註冊表追趕過程中的臨時措施):傳遞此旗標不再跳過檢查,因此每次 init 都會檢查 GitHub。CI/測試可透過 HYPERFRAMES_SKIP_SKILLS=1 環境變數選擇退出。
如果任務表現異常,或在大規模建置之前,請確認已安裝的技能是最新的:
- 檢查:
npx hyperframes skills check(加上--json可取得機器可讀的結果;當有任何內容過期或缺失時,會以非零狀態碼退出)。 - 更新:
npx hyperframes skills update:將完整組合拉取至最新版本,安裝任何尚未存在的技能(與 init 的安裝步驟相同)。
CLI 也會在 render / lint / validate 執行偵測到過期技能時,顯示一行提示。
工作流程詳情
/product-launch-video
- 輸入內容: 正在行銷的產品,(a) 產品網址(使用無頭 Chrome 爬取素材 + 品牌代碼記號),(b) 即使沒有連結但指名了產品網站的腳本/簡介(PLV 會解析並爬取該網站,除非使用者選擇退出),或 (c) 無法推導出網站或「不要爬取」的腳本(無擷取模式,選擇提供色板 + 設計系統的樣式預設集)。提供的腳本可以是逐字的旁白,或按場景重組。PLV 會提問。
- 輸出內容: 產品發布 / SaaS 宣傳影片,以 HyperFrames 合成作品形式呈現 → MP4(最佳長度 30-90 秒)。產品價值是主題,而非網站導覽。若為單純的網站導覽,請使用
/website-to-video。 - 觸發條件:「X 的發布影片」、「我們網站的宣傳片」、「用一分鐘解釋我的 SaaS」、「將我的腳本變成 60 秒宣傳片」、「純文字發布影片,不要爬取」。
/website-to-video
- 輸入內容: 一個網站/網址,其目標是展示網站本身,而非銷售產品。最適合非商業網站(作品集、部落格、文件、個人、活動),或當使用者明確想要照原樣導覽網站時。使用無頭 Chrome 擷取真實螢幕截圖 + 品牌素材。如果該網站正在銷售某物且使用者想要宣傳片,請使用
/product-launch-video。 - 輸出內容: 網站導覽 / 展示 / 社群短片,使用網站自己的視覺元素製成 → MP4。
- 觸發條件:「將此網站變成影片」、「來自 的網站導覽」、「來自我們首頁的社群短片」、「我只有一個網址,做點東西」。
/faceless-explainer
- 輸入內容: 任意文字。要解釋的主題、文章或筆記,無需行銷任何產品或擷取任何網站。(源自
/product-launch-video;不使用無頭 Chrome。) - 輸出內容: 無臉解說影片 → MP4,每個視覺元素由 LLM 按場景創建(字體 / 抽象 / 圖表 / 資料視覺化);附帶
pin-and-paper預設集。(最佳長度 30-90 秒)。 - 觸發條件:「關於 X 的無臉解說影片」、「解釋 DNS 如何運作的影片」、「將這篇文章變成解說影片」、「根據我的筆記製作解說影片」。
/pr-to-video
- 輸入內容: GitHub pull request:PR 網址、
owner/repo#N引用,或「這個 PR」。透過ghCLI 讀取(非需爬取的網站)。 - 輸出內容: 程式碼變更說明影片(更新日誌 / 功能展示 / 修復 / 重構)→ MP4,包含差異重點、前後對比、檔案樹 + 影響場景。 ≤(最佳長度 30-90 秒)。
- 觸發條件:「製作關於這個 PR 的影片」、「將 PR #1187 變成更新日誌影片」、「來自 github.com/org/repo/pull/123 的版本說明影片」。
/embedded-captions
- 輸入內容: 現有的談話頭影片(MP4)以添加字幕,實際影片素材,非網址或簡介。本地轉錄(Whisper,無需 API 金鑰)並合成遮罩(RVM),使主體可以遮擋字幕。
- 輸出內容: 相同的影片素材不做修改,加上字幕層,標準(逐字低位三欄 + 嵌入主體後方的高潮)或影院級(每個字幕合成在主體後方)。任何長度。
- 觸發條件:「為此影片添加字幕/標題」、「主體後方的字幕」、「為我的短片添加影院級字幕」。
/talking-head-recut
- 輸入內容: 現有的談話頭 / 訪談 / 播客影片(MP4)以包裝螢幕圖形,實際影片素材。本地轉錄(Whisper)。片段完整播放於下方,不做修改。
- 輸出內容: 相同的影片素材,加上即時圖形疊加卡片:動態標題、低位三欄、數據標註、引文、側面板、子母畫面,同步...
(翻譯內容因原文截斷而結束)