閘門 — 在任何合成之前
觸發條件:交付結果為渲染後的媒體檔案。 MP4、WebM、MOV、PNG。 是交付格式,而非外觀。
在以下情況不啟用此技能:
- 網站內嵌的影片 — 主視覺、背景、見證影片。這是一般的網頁資產,
與其他圖片或字型相同處理方式(參見
referencias/assets.md)。 - 看似影片但實際可互動的 UI 元件 — 屬於介面動態或 3D, 非渲染輸出。
區分標準在於交付格式。如果結果可在瀏覽器中開啟並回應點擊, 則不屬於此技能。
格式、解析度、幀率與時長沒有預設值
選擇「1080p 30fps 因為很常見」正是閘門要防止的情況。四個欄位 — 格式、解析度、幀率、時長 — 必須在合成開始前由使用者決定。
營運成本 — 在承諾前先確認
HyperFrames 不是一個匯入工具:它是一個生產流程。依賴 Chrome 與 FFmpeg 已安裝,且捕獲過程可能分散執行。
在承諾使用此路徑之前,請確認基礎設施已就緒。如果渲染時才發現 缺少 FFmpeg,代表整個合成程式碼都已寫完才發現問題。
渲染絕非自動執行
未經使用者明確授權,不得執行任何渲染。 渲染會消耗機器時間, 且在涉及媒體生成時,可能產生實際費用。
當缺少某項素材且替代方案為自行生成時:請列出缺少的項目與要生成的 內容 — 然後在此暫停。
使用方法
frontend-video/
├── SKILL.md ← 本檔案。唯一總是會被讀取的檔案
└── referencias/
├── hyperframes.md 閘門、格式/幀率/時長、確定性時間、
│ adapter、字幕、渲染授權
├── direcao-visual.md 附有原因說明的 Token,反通用
├── assets.md 來源、授權、最佳化 — 此處資產即為交付物
└── validacao.md 可套用於媒體的閘門
| 你的任務 | 開啟檔案 |
|---|---|
| 決定格式、解析度、幀率、時長 | hyperframes.md §3 |
| 內容、字型、字幕、權利 | hyperframes.md §4 |
| 確定性時間、可重現輸出、場景適配器 | hyperframes.md §5 |
| 可及性與效能 | hyperframes.md §6 |
| 授權渲染 | hyperframes.md §7 |
| 合成美學方向 | direcao-visual.md |
| 圖片、字型、音軌授權 | assets.md |
| 完成交付 | validacao.md |
永遠忽略: SEO、可索引的 DOM、導航流程與應用狀態 — 確定性媒體 不包含上述任何一項。瀏覽器作為最終交付環境也不適用:此處瀏覽器 是捕獲工具,而非目的地。
可重現性 — 「確定性」的真正要求
引擎讓合成結果可按時間搜尋。僅此並不能保證輸出完全相同。
要承諾逐位元組可重現的檔案,必須鎖定以下所有項目:HyperFrames、Chrome、 FFmpeg、字型、素材、編解碼器與旗標、解析度、幀率、時長與環境。 沒有上述鎖定條件的同一 commit 不允許做出此承諾。
稽核來源:儲存庫 heygen-com/hyperframes,commit
af1cb1c10da33bade100db8233435c7591b7c0bc,該 commit 下主套件 0.8.17,
根目錄與 CLI 皆採用 Apache-2.0 授權。最後驗證時間:2026-08-28。
若版本變更或合成內容依賴未涵蓋於此記錄的能力,則需重新稽核。
永遠適用的原則
- 使用真實內容,絕不虛構 — 不可使用看似最終版的佔位符。
- 字幕與對比度是交付物的一部分,非額外選項。
- 在實際輸出上驗證,而非預覽。 預覽顯示的內容與最終檔案中的內容 在編解碼器、色彩與時間上可能不同。
- 場景程式碼仍須自行負責資源清理。 合成中的 Three/WebGL 場景 與其他地方一樣需要正確的拆卸程序。