HyperFrames
當使用者要求 Parsifal 使用 HyperFrames 製作影片時使用此技能,例如 30 秒直式影片、短片片頭、電影風格微型預告片、產品宣傳、動態字幕、HUD 風格的科技視覺、網頁轉影片作品,或是 HTML/CSS/JS 動態圖形渲染。
HyperFrames 將 HTML 視為影片的單一事實來源。將影片場景建構成 HTML 組合,搭配 CSS 佈局與 JavaScript 動畫,驗證佈局後再將結果渲染成 MP4。
設定
若未安裝 HyperFrames 或缺少官方技能,請先安裝:
parsifal skills install official/creative/hyperframes
使用 npx hyperframes 進行專案操作。HyperFrames 需要 Node.js 與 FFmpeg。若渲染或預覽失敗,請執行:
npx hyperframes doctor
工作流程
- 將使用者的需求轉換為簡短的製作摘要:持續時間、長寬比、目標平台、語言、風格、音樂或旁白需求,以及最終輸出路徑。
- 若摘要不完整,請使用合理的預設值。直式短影片使用 1080x1920,橫式影片使用 1920x1080,30 fps,MP4 輸出。
- 建立或重複使用 HyperFrames 專案:
npx hyperframes init my-video --non-interactive
- 以 HTML/CSS/JS 編寫組合。在加入動畫之前,先確保靜態主畫格佈局正確。
- 在渲染前進行驗證:
npx hyperframes lint
npx hyperframes inspect --samples 15
- 有需要時進行預覽:
npx hyperframes preview
- 渲染最終影片:
npx hyperframes render --output final.mp4 --quality standard
在快速迭代時使用 --quality draft,當使用者要求精美匯出時,使用 --quality high 進行最終交付。
組合規則
- 使用帶有
data-composition-id、data-width與data-height的根元素。 - 使用
data-start、data-duration與data-track-index來定義時間片段。 - 在
window.__timelines上同步註冊 GSAP 時間軸。 - 使用 CSS 作為最終佈局狀態,再從該狀態(或朝向該狀態)進行動畫。
- 將媒體播放交由 HyperFrames 執行階段處理。請勿手動呼叫
play()、pause()或定位媒體。 - 避免非確定性的動畫邏輯,例如
Math.random()或Date.now(),除非使用種子生成器。 - 不要使用無限重複。根據組合持續時間計算有限的重複次數。
- 檢查文字、字幕、UI 面板與 HUD 元素,確保它們在每個檢查的時間戳記下都保持在畫面內。
交付
完成時,告知使用者:
- 渲染出的 MP4 路徑;
- 若預覽伺服器正在執行,則提供預覽 URL;
- 關於持續時間、長寬比、風格、旁白或音樂的任何假設;
- 任何尚未解決的驗證問題。
不要只寫完 HTML 就停止。HyperFrames 任務只有在組合已經過 lint 與 inspect 檢查,並渲染成 MP4 之後才算完成,除非使用者明確要求僅提供原始檔。