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 分鐘的範圍內,第三個軸線區分了兩個文字輸入的工作流程 — 內容:正在_行銷_的產品 vs. 正在_解說_的主題(請參閱下方步驟 3 中的消歧規則)。
| 長度 / 輸入 | 產品發布(網址 / 摘要 / 腳本) | 一般網站 / 網址 | 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 類型 + 目標長度。 路由需要知道影片的內容是什麼 — 其主題和輸入。如果主題本身不明確(例如「製作一個關於我們東西的影片」但沒有網址、有名稱的產品、主題或可使用的資產),或者輸入類型未知,請在進入任何工作流程之前詢問 — 先釐清;不要直接呼叫工作流程技能然後才問,因為提交到工作流程本身就是路由決策。最多問兩個釐清問題:
- 「你的輸入是什麼 — 產品(網址或摘要)、一般網站/網址、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 分鐘的網址/文字輸入(意圖區分)。 兩個區分:
- 網址類型 + 意圖 — 網址不再自動勝出用於 PLV;其_類型_然後_意圖_決定:GitHub PR 連結(
.../pull/<N>、owner/repo#N、「這個 PR」)→/pr-to-video;否則網站網址依意圖區分 — 行銷 / 發布 / 推廣特定產品或 SaaS →/product-launch-video;一般網站 → 影片(網站導覽、作品集/部落格/登陸頁面展示、從網站自身視覺製作的社交片段、或只是「將這個網站變成影片」)→/website-to-video。兩者都會使用無頭 Chrome 爬取;PR 網址則透過gh讀取。當一個網站網址是產品發布還是普通網站影片確實難以判斷時,問一個問題。 - 產品 vs 主題(文字,無網址)— 決定性問題是影片的內容是什麼,而非輸入格式:
- 一個特定的產品 / 公司 / SaaS / 應用程式 / 網站正在被行銷、發布或推廣 →
/product-launch-video。 - 一個概念 / 主題 / 文章 / 某事物如何運作正在被解說,且無產品也無網址 →
/faceless-explainer。 - 決定性因素:「推廣 / 發布 / 銷售 / 我們的產品」措辭 → PLV。「解說 / 教學 / X 如何運作 / 什麼是 X」且無產品 → 無臉解說片。無臉解說片的出貨風格始終是
pin-and-paper。 - 一個有名稱的網站但未貼上網址仍然是 PLV。 腳本中提及產品或其網站(「我們的網站是 acme.io」、「推廣 <品牌>」)即使沒有可點擊的連結,仍路由至 PLV — PLV 可以搜尋網站並爬取其品牌資產(除非使用者選擇退出,→ 無擷取預設模式)。未貼上網址不會使其成為無臉/無擷取工作。對於提供的腳本,逐字 vs 重構的選擇是 PLV 內部的問題,永遠不會改變路由。
- 衝突的線索 → 詢問,不要猜測。 如果提供的來源是產品_自身的_行銷材料(其登陸頁面、關於_他們的_平台的促銷部落格)但使用者明確要求去除推廣 — 一個關於底層概念的_中立_解說片,而非廣告 — 則視為真正模稜兩可(該影片是…
- 一個特定的產品 / 公司 / SaaS / 應用程式 / 網站正在被行銷、發布或推廣 →
- 網址類型 + 意圖 — 網址不再自動勝出用於 PLV;其_類型_然後_意圖_決定:GitHub PR 連結(
(其餘內容已被截斷)