hyperframe — 路由至 HeyGen HyperFrames
HyperFrames(Apache-2.0,github.com/heygen-com/hyperframes)可將 HTML/CSS/JS 組件轉換為確定性 MP4:渲染器在無頭 Chrome 中逐幀搜尋,並使用 FFmpeg 編碼。 此技能是一個精簡路由——所有真正的知識都存於上游的克隆儲存庫及其自身的 20 個代理技能中;切勿在此處重複上游文件。
本地路徑
解析順序:HYPERFRAMES_HOME 環境變數 → ~/.jstack/config.env → 下方預設值。
| 項目 | 位置 |
|---|---|
| 克隆的儲存庫(規範的本地副本) | ~/.jstack/vendor/hyperframes |
| 上游路由技能(任何「幫我做個影片」請求請先閱讀此處) | ~/.jstack/vendor/hyperframes/skills/hyperframes/SKILL.md |
其 20 個代理技能(也會由 hyperframes init 安裝至 ~/.claude/skills/ + ~/.agents/skills/) | ~/.jstack/vendor/hyperframes/skills/ |
區塊/組件註冊表(70+ 區塊:下三分之一 lt-*、code-*、logo-outro、glitch、data-chart…) | ~/.jstack/vendor/hyperframes/registry/{blocks,components} |
| 文件來源(快速入門、概念、參考、目錄) | ~/.jstack/vendor/hyperframes/docs/ |
| 線上:文件 + 區塊目錄 | hyperframes.heygen.com(快速入門/文件/目錄),hyperframes.dev(遊樂場 + 設計模板) |
安裝 / 健康檢查
需求:Node 22+ 和 FFmpeg 在 PATH 中(已在此機器上驗證可用,CLI 版本 v0.7.48)。
npx --yes hyperframes doctor # 環境健康檢查
npx --yes hyperframes init my-video # 建立專案(同時也會安裝/更新其代理技能)
cd my-video && npm run render # → renders/*.mp4
init 會建立 index.html + hyperframes.json,並在 package.json 的 scripts 中鎖定 CLI 版本(dev/check/render/publish)。可使用 git -C ~/.jstack/vendor/hyperframes pull 更新克隆。
調度表
根據意圖路由,然後開啟/執行上游目標——不要自行設計工作流程。
| 意圖 | 前往 |
|---|---|
| 任何「幫我做個影片/動畫」請求(進入點) | 閱讀 /hyperframes 路由技能:~/.jstack/vendor/hyperframes/skills/hyperframes/SKILL.md — 它會選擇工作流程 |
| 動畫鉤子文字 / 動態標題 / 統計顯示 / 標誌開場 / 結尾卡 / 下三分之一(短、無旁白、設計主導) | /motion-graphics 工作流程:克隆中的 skills/motion-graphics/;下三分之一區塊 = 註冊表 lt-*,結尾卡 = logo-outro |
| 在現有談話頭影片上疊加動態字幕 | /embedded-captions 工作流程:skills/embedded-captions/(素材不變,字幕疊加其上) |
創作或編輯 HTML→MP4 組件(data-* 時間合約、片段、軌道) | /hyperframes-core 然後 /hyperframes-animation:skills/hyperframes-core/、skills/hyperframes-animation/ |
| 瀏覽/安裝區塊和組件 | 註冊表目錄 registry/{blocks,components} 或 hyperframes.heygen.com/catalog;透過 /hyperframes-registry 和 npx hyperframes add [block] 安裝並連結 |
| 渲染/預覽/檢查/驗證組件 | /hyperframes-cli:npx hyperframes preview、npx hyperframes lint && npx hyperframes validate、npx hyperframes render、npx hyperframes doctor |
| 為組件添加背景音樂 / 音效 / 旁白 / 圖示 / 去背 | /media-use:skills/media-use/ |
| 投影片 / 簡報、產品宣傳、PR-to-video、音樂同步、網站導覽、Remotion 移植 | 在 skills/ 中匹配的工作流程技能(請見 /hyperframes 路由的速查表) |
何時不使用(StayFrame 紅線)
StayFrame 的摘要美學北極星(ADR 0002,編輯極簡——「這張圖放在 Aman/Soneva 網格中會不會顯得不自然?」)使得大量動態圖形風格不符合品牌調性:Hormozi 風格的動態字幕、glitch/VFX 區塊、新聞跑馬燈、液態玻璃小工具。對於 StayFrame 短影片,僅可使用 HyperFrames 來做細微的極簡疊加,且:
- 靜態文字疊加應留在現有路線——透過
/jstack-sf-caption使用無頭 Chrome + ffmpeg。請勿將其遷移至 HyperFrames。 - 生成式影片(i2v/t2v)絕非 HyperFrames——這屬於
/vidgen。
注意事項
hyperframes init沒有--yes標誌(遇到未知標誌會報錯);它本身已是非互動模式。init副作用:會將 HyperFrames 自身的核心技能安裝/更新到~/.claude/skills/和~/.agents/skills/——這是預期行為,可保持上游路由最新。- 獨立安裝技能:
npx skills add heygen-com/hyperframes --full-depth——請保留--full-depth,否則你會拿到過時的 skills.sh 註冊表 blob,落後於main。 - 遙測預設為開啟;使用
hyperframes telemetry disable關閉。 - 渲染輸出會放在專案目錄內的
renders/[project]_[timestamp].mp4。
後續技能
| 後續 | 時機 |
|---|---|
/vidgen | 組件需要生成式素材(i2v/t2v 片段)作為來源媒體——影片生成一律路由至此,絕不直接到後端。 |
/jstack-sf-caption | StayFrame 短影片需要純靜態文字疊加——該路線繼續使用無頭 Chrome + ffmpeg,而非 HyperFrames。 |
/jstack-sf-trim-stitch | 已渲染的 HyperFrames 疊加/結尾卡需要組裝進 StayFrame 短影片。 |