HyperFrames 入口點
HyperFrames 從 HTML 渲染影片 — 一個合成作品是一個 HTML 檔案,其 DOM 使用 data-* 屬性宣告時間,其動畫執行時間是可搜尋的,並且其媒體播放由框架擁有。完整的創作合約位於 /hyperframes-core;在撰寫合成 HTML 之前請先閱讀它。簡報、分鏡、審查、製作、調度以及幀處理器合約位於此技能的 references/ 中。
1. 從專案狀態開始
套用第一個符合的列;不要評估較低的狀態列:
| 狀態 | 動作 |
|---|---|
| 明確將現有的 Remotion 原始碼移植到 HyperFrames | 閱讀 references/routes/remotion-to-hyperframes.md,然後直接路由到該工作流程。跳過意圖層。 |
| 對現有 HyperFrames 專案執行特定操作:檢查、診斷、驗證、預覽、渲染、發佈或批次渲染 | 僅執行該操作。跳過意圖和工作流程路由;載入 /hyperframes-cli 和任何必需的領域技能。 |
| 對現有專案進行特定編輯 | 進行編輯。不要執行意圖層。要了解專案時間軸上的內容(軌道、剪輯、開始、結束、播放什麼),請執行 npx hyperframes timeline [--json],而不是讀取 index.html 和每個子合成檔案。 |
存在 BRIEF.md | 讀取 workflow 和 flow。執行該工作流程;flow: companion 始終在 /general-video 中執行。不要詢問簡報問題。 |
無簡報,但存在 hyperframes.json 或 STORYBOARD.md | 從專案檔案和記錄的偏好設定中恢復。從現有工件推斷所屬的工作流程。如果無法唯一確定,則詢問一個僅限路由的問題;不要執行意圖面試。 |
| 全新創作 | 執行意圖層 — references/intent-interview.md — 然後使用 § 2 的表格路由一次。 |
如果一個新的請求沒有指明主題或輸入,請在路由之前詢問影片內容。在詢問任何問題之前,檢查偏好設定和配方(references/intent-interview.md,步驟 1)。一個 figma.com 輸入或一個命名配方會改變輸入方式,而不是路由 — 面試中的「調整正交輸入」部分處理這兩種情況。
保持專案的 CLI 為最新
一個初始化的專案在其 package.json 腳本中固定了 hyperframes@<version>,以便渲染保持可重複;此固定版本永遠不會自行更新,並且在固定版本上執行較舊的 CLI 時不會發出任何警告。當恢復一個其腳本含有固定版本的專案時,請在首次執行影響渲染的命令之前探測一次:
npx hyperframes@latest upgrade --project . --check
此探測是唯讀的,並報告固定版本與最新版本的對比;請保留明確的 . — 在較舊的 CLI 版本上,一個裸的 --project 後面跟著另一個標誌會將該標誌作為其目錄值使用。當它報告專案落後時 — 或者任何 CLI 輸出已經顯示它(來自固定版本腳本的 stderr 通知 This project pins hyperframes@… (latest …),或 --json 結果中的 _meta.updateAvailable: true) — 請使用 npx hyperframes@latest upgrade --project . 進行套用,然後使用 npx hyperframes check 進行驗證。通過檢查確認專案的合成作品在新版本上仍然有效 — 而不是渲染輸出與舊固定版本在幀層面相同 — 因此一個成功的版本提升永遠不會是無聲的:請在執行的摘要中命名舊版本和新版本。一個還沒有任何合成作品的專案不需要驗證。如果檢查失敗,請還原 package.json 的變更,繼續使用固定的版本,並報告專案停留在哪個版本以及原因。根據訊號採取行動,而不是將訊號轉發給使用者;永遠不要留下未經驗證的已提升固定版本。
2. 路由全新創作
使用第一個符合的列。比對的是請求的交付物,而不是隨口提到的單字或檔案類型。
| 優先順序 | 請求 | 工作流程 |
|---|---|---|
| 1 | 明確移植現有的 Remotion 原始碼 | /remotion-to-hyperframes |
| 2 | 創作簡報、銷售簡報或可導航的互動式簡報 | /slideshow |
| 3 | 為現有的談話頭影片添加純字幕而不改變其內容 | /embedded-captions |
| 4 | 為現有的談話頭、訪談或播客影片添加設計好的圖形疊加層,而不改變影片本身 | /talking-head-recut |
| 5 | 從音樂曲目建立一個節拍同步的影片,無旁白或網站捕捉 | /music-to-video |
| 6 | 建立一個明確簡短、無旁白、以動作為主的單元,通常少於 10 秒 | /motion-graphics |
| 7 | 從 PR 參考解釋 GitHub 拉取請求或程式碼變更 | /pr-to-video |
| 8 | 從 URL 或特定網站的簡報行銷或展示網站、產品網站、應用程式或公司 | /product-launch-video |
| 9 | 使用虛構的視覺效果解釋一個主題、文章或筆記,無產品或網站捕捉 | /faceless-explainer |
| 10 | 任何其他自訂影片或合成作品 | /general-video |
在最終確定路由之前,請閱讀 references/routes/<workflow>.md — 每個路由一個小檔案:規範的輸入/輸出/觸發合約(在懶載入工作流程技能可用之前可用)加上該路由的面試條目。如果候選路由不滿足其合約,請繼續路由而不是強迫匹配。僅讀取匹配到的路由檔案。
解決常見的歧義
- 一個簡短的動畫標題、標誌開場、統計數據點、圖表點、地圖點或獨立的下三分之一屬於
/motion-graphics,當它無旁白且動作是主要訊息時。一個靜態的標題卡、有旁白的序列、較長的蒙太奇或自訂循環屬於/general-video。 - 一個明確簡短的動態圖形可以使用 URL、推文、文章或螢幕截圖作為來源材料。一個通用的「從這個網站製作影片」的請求屬於
/product-launch-video。 - 帶有字幕的現有影片路由到
/embedded-captions;帶有設計資訊卡的影片路由到/talking-head-recut。重新定時、重新排序、重新著色、重新取景或混音影片是一個自訂編輯,會落到/general-video。 - 一個音樂檔案僅在其節奏網格驅動作品時才選擇
/music-to-video。用作背景音樂的音樂不會覆蓋主題匹配的路由。 - 「我想要一個分鏡」會改變審查過程,而不是工作流程。如果沒有其他路由訊號,請使用
/general-video。一個已確認的草圖storyboard.html本身可能就是請求的交付物;審查循環定義了這個停止點。 - 專業的敘事工作流程支援最多約 3 分鐘,並且在 30-90 秒時最強。將明顯較長的作品路由到
/general-video。長度永遠不會覆蓋明確的移植、簡報、字幕、疊加層或音樂驅動的交付物。
3. 路由一次,然後離開
對於全新創作,意圖層(references/intent-interview.md)執行完整的對話 — 記憶、分流、提案回合、必備條件、執行形狀、交接 — 並以撰寫 BRIEF.md 結束。簡報是工作流程讀取的唯一路由工件;之後沒有任何東西會重新開啟此技能或面試。從 BRIEF.md 回答之後每個「路由需要什麼?」的問題。
4. 安裝並進入工作流程
在讀取所選工作流程之前,安裝或更新它和核心領域技能:
npx hyperframes skills update <workflow-name>
使用不帶 / 的裸名稱。如果命令失敗,請顯示錯誤;不要從記憶中重建工作流程。關於安裝的所有其他事項 — 核心與懶載入的區別、init 刷新什麼、診斷、CI 選擇退出以及無 CLI 的備援方案 — 都位於 references/skill-lifecycle.md。
5. 按需載入領域技能
| 需求 | 技能 |
|---|---|
| 合成結構、時間屬性、軌道、變數、確定性 | /hyperframes-core |
| 動作規則、場景藍圖、轉場、執行時適配器 | /hyperframes-animation |
尋址安全的 GSAP、CSS、Anime.js、WAAPI、FLIP、路徑、遮罩、SVG、3D 關鍵影格或 hyperframes keyframes 診斷 | /hyperframes-keyframes |
| 設計規格、概念、調色板、字型、旁白、節拍規劃 | /hyperframes-creative |
| 圖片、圖示、標誌、音訊、字幕、分級、LUT、可重複使用的媒體 | /media-use |
| 語音去背、音效鏈、自動化包絡線、或跨多個軌道的單一鏈/推子(子混音匯流排) | /hyperframes-audio |
| 初始化、lint、檢查、快照、比較、批次渲染、Studio、渲染、發佈或診斷 | /hyperframes-cli |
| 註冊表區塊和元件 | /hyperframes-registry |
| 一個命名的外觀、效果、處理方式或轉場 — CRT 掃描線、故障、底片顆粒、閃爍掃掠、五彩紙屑爆發 — 在手動建立之前 | /hyperframes-registry |
| Figma 素材、令牌、元件或作為重建動作的分鏡框架 | /figma |
創作者編輯短語是跨領域請求。載入匹配列中命名的每個技能:
| 創作者請求 | 所需領域 |
|---|---|
| 「剪輯這段素材」,硬切、修剪、拼接、重新排序或使用來源範圍 | /general-video + /hyperframes-core;核心擁有 data-start、data-duration、data-media-start 和軌道佈局。 |
| 在此處縮放、推進/拉出、平滑的多狀態縮放或重新取景、Ken Burns 效果或攝影機移動 | /general-video + /hyperframes-core + /hyperframes-keyframes;動畫內部視覺/裁切包裝器,而不是定時剪輯。 |
| 匹配剪輯或甩鏡攝影機轉場 | /general-video + /hyperframes-animation + /hyperframes-keyframes + /hyperframes-registry;在手工創作之前搜尋/安裝一個轉場基本元素。 |
| 淡入、淡出、交叉淡入、軌道增益/音量、自動化、閃避/去背、音效、或跨多個軌道的單一效果 | /general-video + /hyperframes-core + /hyperframes-audio;核心放置剪輯,音訊混合放置的軌道 — 包括在它們之上的子混音匯流排。 |
| 結合剪輯與攝影機運動或混音的畫面和聲音編輯 | /general-video + /hyperframes-core + /hyperframes-keyframes + /hyperframes-audio + /hyperframes-animation;載入全部五個。 |
…(原文已截斷)