Communitygithub.com

bobzhou-source/Parsifal-Demo

使用 HyperFrames 在 Parsifal 中,透過 HTML、CSS 與 JavaScript 組合來建立 AI 影片,並進行驗證與渲染成 MP4。適用於短影片片頭、電影風格預告片、產品宣傳、字幕動畫、HUD/科技視覺、網頁轉影片以及動態圖形。

Parsifal-Demo 是什麼?

此技能專為在 Parsifal 平台上使用 HyperFrames 建立 AI 影片而設計。它將 HTML、CSS 與 JavaScript 視為影片的主要素材來源,開發者可以透過網頁技術組合出影片場景,包括佈局與動畫,再經過驗證後渲染為 MP4 格式。技能支援從簡短的 30 秒直式影片、電影片頭預告、產品展示,到字幕動畫、HUD 風格的科技視覺、網頁轉影片以及動態圖形等多元應用。工作流程要求先撰寫生產摘要、初始化 HyperFrames 專案、編寫 HTML/CSS/JS 組合、執行 lint 與 inspect 驗證,最後進行預覽與渲染。此外,它還強制遵守特定的組合規則,例如使用 data 屬性來定義時間軸、避免非確定性邏輯(如 Math.random),並確保所有元素在每個時間戳記下都保持在畫面內。支援的平台包括 Parsifal 的 CLI 介面,並需依賴 Node.js 與 FFmpeg。此技能對於需要快速迭代與高品質輸出的網頁轉影片工作流程特別有用。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bobzhou-source/Parsifal-Demo/tree/HEAD/packages/skills/hyperframes

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

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

工作流程

  1. 將使用者的需求轉換為簡短的製作摘要:持續時間、長寬比、目標平台、語言、風格、音樂或旁白需求,以及最終輸出路徑。
  2. 若摘要不完整,請使用合理的預設值。直式短影片使用 1080x1920,橫式影片使用 1920x1080,30 fps,MP4 輸出。
  3. 建立或重複使用 HyperFrames 專案:
npx hyperframes init my-video --non-interactive
  1. 以 HTML/CSS/JS 編寫組合。在加入動畫之前,先確保靜態主畫格佈局正確。
  2. 在渲染前進行驗證:
npx hyperframes lint
npx hyperframes inspect --samples 15
  1. 有需要時進行預覽:
npx hyperframes preview
  1. 渲染最終影片:
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 之後才算完成,除非使用者明確要求僅提供原始檔。

相關技能