HyperFrames — 請先閱讀本文件
開始任何 HyperFrames 任務前請先閱讀此文件 — 特別是當專案中沒有代理程式設定檔 (CLAUDE.md / AGENTS.md / .cursorrules) 時。以下是能力對應表與影片路由器。
能力對應表 — 哪種意圖使用哪種技能
| 你想要… | 請前往 |
|---|---|
| 製作影片 (從網址、簡報、主題、GitHub PR、現有素材,或是一個需要動畫化的單一元素) | 下方的 影片路由器 (請參閱 § 影片路由) |
創作 / 編輯 HTML 組合 — data-* 合約、片段、音軌、子組合、變數 | /hyperframes-core |
| 動畫化 — 原子動作規則、場景藍圖、轉場、運行時適配器(GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
創意指導 — design.md、色板、字體設計、旁白、節奏規劃、音訊反應式設計 | /hyperframes-creative |
| 媒體預處理 — TTS 配音、背景音樂、轉寫、去背、字幕 | /hyperframes-media |
| CLI 開發循環 — 初始化、檢查、驗證、預覽、渲染、發布、診斷 | /hyperframes-cli |
安裝套件組件 (hyperframes add) | /hyperframes-registry |
組合創作合約 (每個時間元素需要
data-start/data-duration/data-track-index;時間元素需要class="clip";GSAP 時間軸需要暫停並註冊在window.__timelines上;僅允許確定性邏輯 — 禁止使用Date.now()/Math.random()/ 網路)此處不重複 — 它存在於/hyperframes-core中。在撰寫組合 HTML 之前,請務必閱讀該文件。
HyperFrames 無法做到的事 — 請優先檢查此清單
HyperFrames 透過程式碼創作 HTML 組合並將其渲染成 MP4。這個模型有嚴格的邊界。當請求超出其中一項限制時,這不是路由選擇的問題 — 而是超出範圍,因此請婉拒(或指出正確的工具),而不是嘗試執行某個工作流程。以下限制源於其架構,並非來自單一請求:
- 渲染是確定性且自包含的。 每一個數值、資源和文字片段在創作時就已嵌入;渲染過程不進行任何網路呼叫,也不進行即時 / 渲染時的資料拉取(核心規則:禁止
Date.now()/Math.random()/ 網路)。「在渲染時即時更新數字」是不允許的 — 請在創作時一次性擷取資料並嵌入,否則請婉拒。 - 現有影片只能疊加,不能編輯。 HyperFrames 會在來源片段之上組合影格 —
/embedded-captions添加字幕層,/graphic-overlays添加設計好的圖形卡片(下方三分之一、數據引用、標題)— 底下的片段會保持不變地播放,但無法後製處理已編碼的影片串流。改變素材本身(其時間、色彩、構圖、順序或音訊)屬於 NLE 風格編輯,超出範圍。 - Remotion 導入是單向的。
/remotion-to-hyperframes會將 Remotion 框架的 原始碼轉換為 HyperFrames。沒有逆向轉換(HyperFrames → Remotion,或 → 任何其他框架 — 超出範圍),且非 Remotion 的 React / 網頁動畫原始碼沒有 Remotion 原始碼可轉換 — 請透過/general-video重新建立。 - 無法產生不存在的輸入內容。 無法進行螢幕 / 會話錄製、攝影機捕捉、AI 談話頭像 / 嘴型同步虛擬角色生成。如果素材或資源尚不存在,HyperFrames 無法憑空創造 — 請先要求使用者提供(或使用正確的捕捉工具)。
除此之外的所有內容 — 來自網址、簡報、主題、PR、待標註的素材,或是需要動畫化的單一元素 — 皆在範圍內;請按下方方式路由。
影片路由
此部分僅了解頂層工作流程。它不會載入工作流程內部的階段、領域技能(hyperframes-* — 請參閱上面的能力對應表)或技術參考文件。
決策表
INPUT 類型(意圖)是主要軸線;OUTPUT 長度僅為上限,而非閘門。 對於匹配的輸入,專門的工作流程可以處理最多約 3 分鐘 的內容 — 選擇哪個 工作流程是由意圖(輸入類型,以及對於文字來說的主題)決定,而非長度。長度僅在頂端才有影響:真正較長的內容(3-5 分鐘的教學、5 分鐘以上的深度探討)屬於不同的領域,應路由到 /general-video。在 ≤~3 分鐘的範圍內,第三個軸線將兩個以文字為輸入的工作流程分開 — 主題:是正在行銷的產品,還是正在解釋的主題(請參閱下方步驟 3 中的消歧規則)。
| 長度 / 輸入 | 產品發布(網址 / 簡報 / 腳本) | 一般網站 / URL | GitHub PR / 程式碼變更 | 主題 / 文章 / 筆記(無產品,無網址) | 現有影片(談話頭像)† |
|---|---|---|---|---|---|
| ≤ ~3 分鐘 | /product-launch-video | /website-to-video | /pr-to-video | /faceless-explainer | /embedded-captions · /graphic-overlays † |
| 3-5 分鐘教學 | /general-video | /general-video | /general-video | /general-video | /embedded-captions · /graphic-overlays † |
| 5 分鐘以上深度探討 | /general-video | /general-video | /general-video | /general-video | /embedded-captions · /graphic-overlays † |
| 靜態 / 循環 | /general-video | /general-video | /general-video | /general-video | /general-video |
目前的涵蓋範圍:≤ ~3 分鐘 的範圍針對產品發布 / 一般網站 / GitHub-PR / 主題輸入有專門的工作流程(網址會依據_類型_ 再依_意圖_ 拆分 — 請參閱步驟 3),而現有影片欄位在任何長度下都由 /embedded-captions(字幕 / 隱藏式字幕)或 /graphic-overlays(設計好的圖形疊加層)涵蓋,依據意圖拆分(請參閱步驟 2)。所有其他儲存格都是 /general-video — 通用的 HTML 組合創作流程(輸入和長度無關):所有超過 ~3 分鐘 的內容(3-5 分鐘 / 5 分鐘以上行)以及每種靜態 / 循環格式。路由器永遠不會因為可創作的影片而走入死胡同;唯一真正的「一般 / 無」答案是超出 HyperFrames 本身的請求(例如 NLE 風格編輯已完成的影片檔案 — 重新計時、重新著色、重新構圖、重新排序、音訊)。
† 現有素材依據意圖拆分,而非長度。 字幕 / 隱藏式字幕 → /embedded-captions;設計好的圖形疊加層 / 包裝 — 下方三分之一、數據引用、標題卡片、引言 — → /graphic-overlays。兩者都疊加在片段之上,底下的片段會保持不變地播放;兩者都不編輯素材本身。
類型短路(優先於上表)。 一個簡短(約少於 10 秒)、無旁白、以設計為主導的動態圖形 — 動態字體、統計 / 圖表呈現、標誌動畫、下方三分之一 / 疊加層,或是一個動畫推文 / 標題 / 已捕捉頁面重點 — 無論輸入為何,都路由到 /motion-graphics。這是一個 OUTPUT 類型,而非輸入類型,因此當要求很明顯是動態優先且無旁白時(請參閱步驟 2),它會優先於上面的輸入類型表。一個較長或有旁白的處理方式則不屬於此(請依輸入類型路由,或使用 /general-video)。
遷移現有組合(特殊情況)
上表適用於從輸入創作影片。有一個工作流程不在此表中:如果使用者明確要求將現有的 Remotion (React) 組合移植 / 轉換 / 遷移到 HyperFrames → /remotion-to-hyperframes。這是原始碼翻譯,而非從輸入創作,因此沒有 INPUT × LENGTH 儲存格。僅在明確的遷移用詞(「移植我的 Remotion 專案」、「轉換這個 Remotion 組合」、「將其重寫為 HyperFrames」)時路由至此 — 隨口提到 Remotion 並不觸發;預設使用創作表或 /hyperframes-core。
路由程序
- 確定 INPUT 類型 + 目標長度。 路由需要知道影片的內容 — 其主題和輸入。如果主題本身未指定(例如「製作一個關於我們產品的影片」沒有網址、命名產品、主題或素材可用),或輸入類型未知,請在進入任何工作流程之前詢問 — 先釐清;不要呼叫工作流程技能然後再問,因為承諾一個工作流程本身就是路由決策。最多問 2 個釐清問題:
- 「您的輸入是什麼——產品(網址或簡報)、一般網站 / URL、GitHub PR / 程式碼變更、要解釋的主題或文章,還是要添加字幕的現有談話頭像影片?」
- 「目標長度——大約 3 分鐘或以下,還是更長(3-5 分鐘的教學 / 5 分鐘以上的深度探討)?」
- 規格預設值——直接說明,不要問(這些不影響路由,所以永遠不要因為它們而阻塞路由):比例 16:9(引擎也支援 9:16 直式 — 僅在使用者指定直式目的地如 TikTok / Reels / Shorts 時才切換);旁白 / 字幕語言 = 使用者的語言。僅在使用者提出異議時才確認;所選擇的工作流程會在其步驟 0 重新確認其自身的規格。
- 先依 INPUT 類型(意圖)選擇;長度僅為上限,而非閘門。
- 簡短、以設計為主導的動態圖形(類型短路,優先於輸入表) — 動畫本身就是訊息:動態字體、統計 / 數字遞增、圖表呈現、標誌動畫、下方三分之一 / 疊加層,或是一個動畫推文 / 標題 / 已捕捉頁面重點;通常少於 ~10 秒,無旁白 / 配音 →
/motion-graphics。這是 OUTPUT 類型,而非輸入類型 — 當要求很明顯是一個快速、無旁白、以設計為主導的動畫作品時,無論輸入為何都路由至此。一個較長或有旁白的同主題處理方式則不屬於此(請依輸入類型路由,或使用/general-video)。 - 現有談話頭像影片(使用者有一個片段並希望在其上添加內容)→ 依據意圖拆分,任何長度(輸入類型優先於長度):字幕 / 隱藏式字幕(口語文字轉換為可讀文字)→
/embedded-captions;設計好的圖形疊加層 — 下方三分之一、數據引用、有標題的資訊卡、引言、圖形包裝編輯 →/graphic-overlays。(編輯素材_本身_ — 重新計時、重新著色、重新構圖、重新排序、音訊 — 屬於 NLE 風格,超出範圍;請參閱 § HyperFrames 無法做到的事。) - GitHub PR / 程式碼變更(一個
github.com/<owner>/<repo>/pull/<N>連結、一個owner/repo#N參照,或「這個 PR」)→/pr-to-video(最多 ~3 分鐘)。 - 其他情況(產品網址 / 簡報 / 主題文字):意圖透過步驟 3 選擇工作流程,並且它可以處理最多 ~3 分鐘 的內容 — 一個 15-30 秒的短片和一個 ~100 秒的解說片都依據意圖而非長度路由。僅在目標明顯超過 ~3 分鐘(一個 3-5 分鐘的教學、一個 5 分鐘以上的深度探討)時,才路由到
/general-video(長度無關的後備方案 — 請參閱步驟 4)。切勿將真正較長的內容強行塞入 ≤~3 分鐘的工作流程 — 意圖決定範圍內的選擇,/general-video涵蓋其餘部分。
- 簡短、以設計為主導的動態圖形(類型短路,優先於輸入表) — 動畫本身就是訊息:動態字體、統計 / 數字遞增、圖表呈現、標誌動畫、下方三分之一 / 疊加層,或是一個動畫推文 / 標題 / 已捕捉頁面重點;通常少於 ~10 秒,無旁白 / 配音 →
- 消歧 ≤~3 分鐘的 URL / 文字輸入(意圖拆分)。 兩種拆分:
- URL 類型 + 意圖 — 網址不再自動贏得 PLV;其_類型_ 再依_意圖_ 決定:一個 GitHub PR 連結(
.../pull/<N>、owner/repo#N、「這個 PR」)→/pr-to-video;否則一個網站網址依意圖拆分 — 行銷 / 發布 / 推廣特定產品或 SaaS →/product-launch-video;一個一般網站 → 影片(網站導覽、作品集 / 部落格 / 登陸頁面展示、來自網站本身視覺效果的社交片段,或只是「將這個網站變成影片」)→/website-to-video。兩者都使用 headless Chrome 爬取;PR 網址是
- URL 類型 + 意圖 — 網址不再自動贏得 PLV;其_類型_ 再依_意圖_ 決定:一個 GitHub PR 連結(