影片引擎 (Hyperframes v0.8.77 & Brag)
HyperFrames 從 HTML 渲染影片 — 一個組合就是一個 HTML 文件,其 DOM 使用 data-* 屬性 (data-start, data-duration) 宣告時序,其動畫執行時間是可搜尋的,且媒體播放由框架擁有。
1. 專案狀態偵測
在採取行動之前,請按順序評估專案狀態:
| 狀態 | 動作 |
|---|---|
| 將 Remotion 移植到 HyperFrames | 直接閱讀並執行 workflows/remotion-to-hyperframes/SKILL.md。跳過意圖層。 |
| 檢查、診斷、預覽或渲染 | 執行相應的 CLI 指令 (npx hyperframes check, preview, render)。不要重新執行攝入。 |
| 編輯現有專案 | 執行 npx hyperframes timeline [--json] 來檢查軌道、片段與時序;執行有針對性的編輯。 |
存在 BRIEF.md | 從簡報中讀取 workflow 與 flow;立即執行該工作流程。 |
存在 hyperframes.json 或 STORYBOARD.md | 從現有專案檔案和記錄的偏好設定恢復。 |
| 全新的創作請求 | 執行意圖攝入並使用下方的路由矩陣進行路由。 |
CLI 版本管理
在恢復一個在 package.json 中鎖定了依賴項的現有專案時:
npx hyperframes@latest upgrade --project . --check
如果存在可用的更新並已驗證,則使用 npx hyperframes@latest upgrade --project . 應用更新,並執行 npx hyperframes check。
2. 意圖路由矩陣
將全新的創作請求路由到第一個匹配的工作流程:
| 優先級 | 請求類型 | 目標工作流程 |
|---|---|---|
| 1 | 明確的 Remotion 程式碼移植 | workflows/remotion-to-hyperframes |
| 2 | 簡報、投影片簡報或互動式投影片 | workflows/slideshow |
| 3 | 純文字時間同步的字幕或影片腳本 | workflows/embedded-captions |
| 4 | 頭部特寫、訪談或播客上的圖像疊加 | workflows/talking-head-recut |
| 5 | 由音樂軌驅動的節拍同步動態(無語音) | workflows/music-to-video |
| 6 | 短時、動畫優先的動態視覺 (<10 秒) | workflows/motion-graphics |
| 7 | GitHub Pull Request 或程式碼變更解說 | workflows/pr-to-video |
| 8 | 產品發表、網站展示、SaaS 促銷、/brag | workflows/product-launch-video(或模式 1) |
| 9 | 概念性主題或文件解說 | workflows/faceless-explainer |
| 10 | 任何其他自訂影片或多軌組合 | workflows/general-video |
3. 操作模式
模式 1:產品發表與展示 (/brag & product-launch-video)
用於網站發表、產品展示、SaaS 促銷及 /brag。
- 攝入與檢查:
- 解析選項:
--tone(預設、精緻、YC 惡搞、混亂、電影、面無表情、App Store,定義於references/brag/tones.md),--format(16:9, 9:16, 1:1),--duration(15–25 秒)。 - 如果提供了 URL,則擷取即時網站資產:
npx hyperframes capture "<URL>" -o ./capture --json
- 解析選項:
- 設計系統與預設:
- 從
references/creative/frame-presets/挑選設計預設(capsule、cobalt-grid、daisy-days 等)並混搭品牌標記:node workflows/product-launch-video/scripts/build-frame.mjs --preset <preset-name> --hyperframes .
- 從
- 分鏡腳本與音頻混音:
- 撰寫
STORYBOARD.md與SCRIPT.md。 - 音頻:從
assets/music/選擇背景音樂,或使用/media-use解析曲目和 TTS 配音(references/audio/)。 - 運行節拍提示分析:
python3 scripts/analyze_music_cues.py --audio <path> --output audio_cues.json。
- 撰寫
- 驗證與輸出:
- 驗證佈局與時序:
npx hyperframes check。 - 編譯最終影片:
npx hyperframes render --output brag.mp4。 - 將海報框 0 儲存為
brag.jpg,並將發佈文案複製到share-copy.txt。
- 驗證佈局與時序:
模式 2:敘事與技術解說 (faceless-explainer, pr-to-video)
用於將程式碼差異、工程文件或複雜主題轉化為清晰的影片敘事。
- 故事主幹:遵循
references/creative/references/story-spine.md(鉤子、問題陳述、架構/解決方案、影響)。 - 鏡頭形狀:從
references/animation/blueprints-index.md選擇藍圖(程式碼編輯器、分割比較、統計數據標註、流程圖)。 - 框架工作單元包:使用
workflows/faceless-explainer/scripts/frame-packets.mjs生成有界子代理單元包。每個框架都是獨立建構的(compositions/frames/NN-*.html)。 - 組裝與音頻:將框架連結到根
index.html,使用閃避包絡線混合配音軌道,然後渲染。
模式 3:動態動畫與執行環境 (motion-graphics, music-to-video)
用於獨立動態圖像、動畫 UI 組件、節奏格點和循環動畫。
- 執行時間配接器 (
references/animation/adapters/):- GSAP:精確的多屬性補間和可搜尋安全時間軸。
- Three.js:3D 空間視口、粒子系統和模型 (
references/animation/adapters/three.md)。 - Lottie:向量動畫播放器 (
references/animation/adapters/lottie.md)。 - Anime.js / WAAPI:緊湊的 DOM 變形和關鍵影格。
- CSS 關鍵影格:硬體加速轉換。
- 攝影機過渡與變形 (
references/keyframes/):- 肯·伯恩斯平移、推近變焦、SVG 路徑變形和景深效果。
- 註冊表區塊與著色器 (
references/registry/):- 搜尋並安裝預建的效果區塊(CRT 掃描線、故障、底片顆粒、閃爍掃掠、五彩紙屑)。
模式 4:自訂組合與多軌編輯 (general-video, slideshow)
用於互動式投影片簡報、多軌時間軸編輯和自訂 HTML 影片。
- 工作室慣例 (
references/studio/studio-conventions.md):- 每個場景都是一個子組合 (
data-composition-src)。 - 一個字幕軌 (
data-track-kind="captions")。 - 每個軌道一種元素類型(影片、圖像、字幕、音頻)。
- 安全區域合規(Premiere 標題/動作安全框)。
- 每個場景都是一個子組合 (
- 跨領域創作者食譜:
- 修剪與剪輯:更新
data-start、data-duration和data-media-start(references/core/tracks-and-clips.md)。 - 平滑變焦:在保持片段時序穩定的同時,使用 CSS/GSAP 為內部裁剪包裝器添加動畫(
references/keyframes/)。 - 音頻增益與閃避:應用音量包絡線和匯流排壓縮(
references/audio/)。
- 修剪與剪輯:更新
4. 驗證與 CLI 工具鏈
在交付之前始終運行驗證閘門:
# 使用工作流程支架初始化一個新的 Hyperframes 專案
npx hyperframes init "videos/<project>" --skill=<workflow-name>
# 擷取即時網路資產、螢幕截圖和品牌標記
npx hyperframes capture "<URL>" -o ./capture --json
# 檢查組合時間軸、軌道和片段
npx hyperframes timeline [--json]
# 驗證時序屬性、安全區域和缺失的資產
npx hyperframes check
# 啟動互動式本地播放器
npx hyperframes preview
# 渲染最終 MP4 輸出
npx hyperframes render --output output.mp4
5. 目錄對照表
| 路徑 | 用途 |
|---|---|
workflows/ | 所有 11 個上游工作流程 (product-launch-video, faceless-explainer, pr-to-video, motion-graphics 等) |
engine/ | 規範的 Hyperframes v0.8.77 上游套件 |
references/core/ | 時序屬性、確定性規則、軌道模型、子組合 |
references/animation/ | GSAP、Three.js、Lottie、Anime.js、CSS 配接器、藍圖、動態模糊 |
references/keyframes/ | 2D/3D 攝影機過渡、變焦、SVG 變形、景深效果 |
references/audio/ | EQ、閃避、壓縮、子混音匯流排自動化包絡線 |
references/creative/ | 設計規範、字體排印學、調色盤、框架預設、故事主幹 |
references/registry/ | 視覺區塊、著色器組件、安裝與接線 |
references/studio/ | 工作室時間軸佈局、字幕軌、安全區域 |
references/brag/ | 策劃的 /brag 逐步指南、語調與音樂提示 |
assets/music/ | 策劃的音樂背景,涵蓋電影、狂熱、獨立、平靜等風格 |
scripts/ | analyze_music_cues.py、框架封包核心及音頻提取器 |