general-video — 通用影片工作流程
在開始構建之前,先確認路線。 這是用於創作自訂合成影片的備用方案。如果輸入明顯適合某個專業工作流程,則優先使用該流程:主題解說 →
/faceless-explainer;GitHub PR →/pr-to-video;現有素材 →/embedded-captions·/talking-head-recut;短無旁白動態圖形 →/motion-graphics。不適用範圍:即時/渲染時數據、對已完成影片的 NLE 風格編輯,或產出 HyperFrames 無法捕捉的素材。不確定?請先閱讀/hyperframes。
僅構建所要求的內容。 標題卡就是標題卡——不是標題卡加三個支撐場景再加字幕。如果額外的場景或元素能真正改善作品,請提出建議;不要默默加入。對於小型編輯(修色、調整一個時長、加入一個元素),跳過規劃步驟,直接進行構建。
方法
探索——僅限開放式請求
對於模糊、探索性的請求(「為我們的品牌做點東西」、「一個很酷的開場」)——在選擇顏色之前,先了解意圖:
- 觀眾——誰在看?開發者/主管/一般消費者?
- 平台——在哪裡播放?社群媒體 (15s) /網站英雄區/產品展示/內部使用?
- 優先級——最重要的是什麼?動畫品質/內容準確度/品牌忠誠度/速度?
- 變體——一個最佳版本,還是 2-3 個有意義的不同選項(不同的節奏、能量或結構——而不僅僅是換色)?
對於具體請求(「加入一個標題卡」、「修正場景 3 的時機」),跳過探索階段。
步驟 1 — 設計系統 → hyperframes-design
首先建立視覺識別。如果專案有設計規格,請閱讀它(優先順序為 frame.md → design.md → DESIGN.md;將其視為品牌真理——準確的顏色、字體、限制)。
如果沒有規格,你必須在選擇任何顏色或字體之前,同時閱讀 hyperframes-design/references/house-style.md 和 hyperframes-design/references/video-composition.md。 house-style.md 提供了「解讀提示/生成真實內容」的開場、惰性預設列表和圖層配方;video-composition.md 提供了影片媒介的密度/比例/前景細節化(數據欄、註冊標記、等寬字體元數據、「8-10 個元素,其中兩個用戶沒要求的」),這是區分「精心製作」與「隨意生成」的關鍵。只讀一個是最常見的失誤——video-composition.md 正是那些 AI 代理經常跳過的文件,也正是防止輸出變成扁平、置中、網頁樣式外觀的關鍵。不要自行發明調色板並跳過這些步驟;進入 hyperframes-design 在此是強制的,不是可選分支。接著,根據需要從 references/visual-styles.md 中提取一個命名的風格/情緒。規格/風格定義的是品牌,不是構圖規則。
尋找切入點(模糊簡報,無規格): 在選擇顏色之前,寫一個句子——這個名字/單詞/主題喚起了什麼,什麼樣的視覺_世界_(隱喻、場景、樂器、母題)能表現它?例如,一個網路安全工具 -> 保險庫門 / 周界掃描線 / 鎖芯;一個冥想應用程式 -> 潮汐、呼吸、緩慢的光綻放。閱讀主題的_意義_,而不僅僅是其文字;選擇一個具體的切入點,而不是字面上的重新造型。這是單場景作品中提示擴展(步驟 2)的廉價替代品——在這種情況下,擴展被正確地跳過——而這就是一個設計概念與通用標誌搭配漸層背景之間的區別。
步驟 2 — 提示擴展 → hyperframes-design
每個多場景構圖都執行此步驟(單場景作品和瑣碎編輯跳過)。根據設計規格和內部風格,將請求轉化為一個一致的中間表示,使下游工作能以相同的方式讀取。請參閱 hyperframes-design/references/prompt-expansion.md。
步驟 3 — 規劃
在撰寫 HTML 之前,先從高層次思考:
- 什麼——觀眾體驗:敘事弧線、關鍵時刻、情緒節拍。
- 結構——有多少個構圖、子構圖與內聯、哪些軌道承載影片/疊加層/字幕。關於單個檔案與模組化子構圖的選擇,請參閱
/hyperframes/core/references/composition-patterns.md§ 兩種架構(經驗法則:≥3 個硬場景剪輯,或任何重複使用的場景 -> 模組化;一個短的單場景作品保持為單一檔案)。 - 節奏——在實作之前先命名模式(例如
fast-fast-SLOW-SHADER-hold);請參閱hyperframes-design/references/beat-direction.md。 - 時機——哪些剪輯驅動時長、轉場落在哪裡、節奏。
- 佈局——先構建最終狀態(見下文)。
- 動畫——然後透過
hyperframes-motion加入動態。
先佈局,後動畫
將每個元素放置在其最顯眼的時刻——完全進入、正確定位、尚未退出。先將其寫成靜態 HTML + CSS。還沒有 GSAP。
為什麼: 如果你將元素定位在其動畫起始狀態(畫面外、縮放至 0、透明度 0),然後補間到你_認為_它們會到達的位置,你就是在猜測最終佈局——重疊在渲染之前仍然不可見。先構建最終狀態,你就可以在加入動畫之前看到並修復佈局問題。
- 為每個場景識別主幀——最多元素同時可見的時刻。這就是你要構建的佈局。
- 為該幀撰寫靜態 CSS。內容容器必須用內邊距填充場景,而不是使用絕對偏移:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* 內邊距定位內容;填充任何場景大小 */
gap: 24px;
box-sizing: border-box;
}
絕對不要在內容容器上使用 position: absolute; top: Npx——當內容高於空間時它會溢出。將絕對定位保留給裝飾性元素。
⚠ 上述
width/height: 100%僅在每個祖先元素都有確定的高度時才有效。 根<div data-composition-id>以及它與.scene-content之間的任何包裝器都必須設置尺寸(根元素使用position: relative; width: 1920px; height: 1080px——請參閱/hyperframes/core→「根元素必須設置尺寸」)。跳過這個步驟,flex 容器會坍縮到約 0,內容會堆疊到左上角,第一個字元在 x=0 處被裁剪——而lint/inspect仍報告 0 個問題。而且始終在.scene-content上保留padding(≥80px):它是標題安全邊距。絕不要用單純的gap來取代它。
- 加入入場動畫——使用
gsap.from()從畫面外/不可見動畫到 CSS 位置(在子構圖中,偏好使用gsap.fromTo(),這樣起始狀態是明確的;請參閱/hyperframes/core/references/sub-compositions.md)。CSS 位置是基本事實;補間動畫是到達它的旅程。 - 退場由轉場處理——根據
hyperframes-motion/transitions/中的場景轉場規則,只有最終場景會將元素動畫化退場;場景之間的轉場本身就是退場。
時間共享空間: 如果元素 A 在元素 B 進入同一區域之前退場,兩者仍需為各自的主幀設定正確的 CSS 位置——時間線排序防止它們共存,而佈局步驟會捕捉意外的重疊。分層發光/陰影和 Z 軸堆疊深度是_有意的_重疊;這個步驟的目的是捕捉_無意的_碰撞(兩個標題疊在一起、內容溢出畫面)。
構建——委派給領域技能
這將技能的全部範圍(請參閱 description)映射到其參考文獻——非詳盡;當意圖未列出時,請透過 hyperframes-design(外觀/概念)、hyperframes-motion(動畫)、/hyperframes/core(契約)進行路由。第一行是附加性的——請閱讀它以及你的意圖行,而不是二選一。
| 構建… | 首先閱讀(按順序) |
|---|---|
| 始終——每個非瑣碎的作品,加上你下面的意圖行 | hyperframes-design/references/house-style.md + references/video-composition.md(也在步驟 1 / HARD-GATE 中檢查;「精心製作,而非隨意生成」的前景細節) |
| 動態排印 / 文字為主 | hyperframes-motion/techniques.md(動態排印) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| 標題卡 / 下三分之一 / 疊加層 / PiP / 主體後文字 | hyperframes-design/references/composition-patterns.md + (對於置中/設定尺寸的畫面) /hyperframes/core → 「根元素必須設置尺寸」 |
| 標誌 / 品牌標記揭示 | hyperframes-motion/rules/svg-path-draw.md(繪製) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| 數據 / 統計 / 數字 | hyperframes-motion/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-design/references/data-in-motion.md |
| 產品 / 應用程式 / UI 展示 | hyperframes-motion/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| 多場景 / 轉場 | hyperframes-motion/transitions/overview.md 然後 transitions/catalog.md(在總覽之後你還沒完成——GSAP 配方在目錄中) |
| 模組化 / 子構圖 | /hyperframes/core/references/composition-patterns.md + references/sub-compositions.md |
輸出檢查清單 → /hyperframes/cli
-
npx hyperframes lint和npx hyperframes validate通過(阻止於結果) - 如果存在規格(
frame.md/design.md),則驗證設計符合性——檢查清單在hyperframes-design/references/design-adherence.md -
npx hyperframes inspect通過,或所有溢出都已被有意標記 - 對比度警告已處理;對於多場景作品,審查動畫地圖(
hyperframes-motion/scripts/animation-map.mjs) - 提供預覽;僅在明確要求時渲染為 MP4
- 僅在交接時展示預覽(它是穩定、最終的預覽);不要在構建過程中彈出——構建階段的快照是無頭模式