Communitygithub.com

jonosin/jstack

精簡路由至 HeyGen HyperFrames — 以 HTML 為基礎的動態圖形引擎(撰寫 HTML,透過無頭 Chrome + FFmpeg 在本機渲染確定性 MP4)。

jstack 是什麼?

這個技能作為一個輕量級路由,連接到 HeyGen HyperFrames,這是一個 Apache-2.0 授權的開源引擎,能將 HTML/CSS/JS 組件轉換為確定性的 MP4 影片。它適合用於產生動態圖形,例如動畫鉤子文字、動態標題、結尾卡、下三分之一處標題以及動態字幕,明確區別於生成式影片(/vidgen)和靜態文字疊加(/jstack-sf-caption)。本地路徑統一在 ~/.jstack/vendor/hyperframes 下,包含超過 70 個可用的區塊和組件,文件則託管在 hyperframes.heygen.com 和 hyperframes.dev。工作流程包括 init、render、preview、lint 和 validate 等指令,要求 Node 22+ 和 FFmpeg。它透過詳細的調度表處理多種意圖,確保基於使用者請求正確路由到適當的子技能(如 /motion-graphics 或 /embedded-captions),同時維護 StayFrame 風格的品牌邊界,確保動態圖形不過度影響 StayFrame 的美學。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jonosin/jstack/tree/HEAD/skills/hyperframe

在你喜歡的 AI 中提問

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

說明文件

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-captionStayFrame 短影片需要純靜態文字疊加——該路線繼續使用無頭 Chrome + ffmpeg,而非 HyperFrames。
/jstack-sf-trim-stitch已渲染的 HyperFrames 疊加/結尾卡需要組裝進 StayFrame 短影片。

相關技能