HyperFrames 進入點
HyperFrames 從HTML渲染影片 — 一個合成就是一個HTML檔案,其DOM透過data-*屬性宣告時間軸,其動畫執行時期是可搜尋的,且其媒體播放由框架所擁有。完整的創作合約位於/hyperframes-core;在撰寫合成HTML之前,請先閱讀該文件。
1. 從專案狀態開始
套用第一個符合的列;不要評估較低的狀態列:
| 狀態 | 動作 |
|---|---|
| 明確地將現有Remotion原始碼移植到HyperFrames | 閱讀 references/routes/remotion-to-hyperframes.md,然後直接路由到該工作流程。跳過意圖層。 |
| 對現有HyperFrames專案執行特定操作:檢查、診斷、驗證、預覽、渲染、發佈或批次渲染 | 僅執行該操作。跳過意圖和工作流程路由;載入 /hyperframes-cli 和任何必要的領域技能。 |
| 對現有專案進行特定編輯 | 進行編輯。不要執行意圖層。 |
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 | 為現有的頭部說話、訪談或Podcast素材添加設計好的圖形疊加層,而不變更素材本身 | /talking-head-recut |
| 5 | 從音樂曲目建立一個與節拍同步的影片,無旁白或網站捕捉 | /music-to-video |
| 6 | 建立一個明確簡短、無旁白、以動作為先的單元,通常少於10秒 | /motion-graphics |
| 7 | 從PR引用解釋GitHub Pull Request或程式碼變更 | /pr-to-video |
| 8 | 從URL或特定網站的簡報推廣或展示網站、產品頁面、應用程式或公司 | /product-launch-video |
| 9 | 使用自創視覺效果且無產品或網站捕捉來解釋主題、文章或筆記 | /faceless-explainer |
| 10 | 任何其他自訂影片或合成 | /general-video |
在最終確定路由之前,請閱讀 references/routes/<workflow>.md — 每個路由一個小檔案:規範的輸入/輸出/觸發合約(可在延遲安裝的工作流程技能之前取得)加上該路由的訪談條目。如果候選路由不符合其合約,則繼續路由,而不是強迫匹配。僅讀取匹配到的路由的檔案。
解決常見歧義
- 一個簡短的動畫標題、Logo sting、統計數據命中、圖表命中、地圖命中或獨立的lower-third,如果是無旁白且動作為主的,則屬於
/motion-graphics。靜態標題卡、有旁白的序列、較長的蒙太奇或自訂循環則屬於/general-video。 - 一個明確簡短的動態圖形可以使用URL、推文、文章或螢幕截圖作為素材來源。一個通用的「從這個網站製作影片」的請求屬於
/product-launch-video。 - 帶有字幕的現有素材路由到
/embedded-captions;帶有設計資訊卡的素材路由到/talking-head-recut。重新調整時間軸、重新排序、重新著色、重新構圖或重新混音素材屬於自訂編輯,並會落入/general-video。 - 僅當拍點網格驅動該作品時,音樂檔案才會選擇
/music-to-video。用作背景音樂的音樂不會覆蓋與主題匹配的路由。 - 「我想要一個故事板」會改變審查流程,而非工作流程。如果沒有其他路由信號,請使用
/general-video。一個已確認的草圖板本身可能就是所請求的交付物;審查循環會定義那個停止點。 - 專門的敘事工作流程最多支援約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 |
| Figma資產、token、元件或故事板影格作為重構的動態 | /figma |
關於照片式媒體外觀或行為的廣泛回饋也會路由到
/media-use,即使使用者從未說出「色彩校正」或「效果」:修正
暗/平淡/無趣的素材、為片段增添風格、隱藏臉部,或改善媒體
揭示。在編輯處理方式之前,請閱讀 ../media-use/references/media-treatments.md;它管理素材如何被處理,絕不涉及媒體是否可以使用。
不要用通用的 LUT、CSS 濾鏡/疊加層或不透明補間來替代
現有的規範處理原始物件。將純文字/版面/動畫編輯保留在它們所屬的領域中。
在包含重要照片式媒體的建置過程中,請在最終品質檢查中包含一次基於實際情況的媒體潤飾掃描;將合適的媒體保持不變是一個有效的結果。
領域技能絕不會接管端到端交付物的所有權。僅載入當前工作流程所需的技能。