概要
此技能用於建立無人物解說影片——以旁白驅動、無鏡頭前主持人——作為 HyperFrames 組合內容。適用於產品或概念解說,透過旁白搭配視覺畫面傳達訊息。最終會根據您提供的腳本,產出 MP4 格式影片。
HyperFrames — 無人物解說
將任意文字轉換為解說影片:選擇設計系統、規劃教學故事,然後逐格建置。無人物表示所有視覺元素均為原創——無需擷取步驟,也沒有真實資產庫。
使用時機
- 使用者想要從文章、筆記或簡要說明中製作主題解說
- 使用者想要概念拆解(說明某事物如何運作)
- 使用者想要操作指南或教學(無螢幕錄製)
- 使用者想要清單列表或動畫列表
- 使用者想要數據驅動的解說(圖表、統計數據、比較)
不應使用時機
- 使用者想要產品發布(請使用
hyperframes-product-launch-video) - 使用者想要人物訪談影片(請使用
hyperframes-embedded-captions) - 使用者想要動態圖形(請使用
hyperframes-motion-graphics) - 使用者想要擷取網站(請使用
hyperframes-product-launch-video)
工作流程
0 · 設定
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=faceless-explainer
初始化後立即撰寫 BRIEF.md(永遠不要在初始化之前寫——init 會拒絕非空目錄)。使用以下指令記錄偏好設定:node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes .
1 · 簡報(無擷取)
將使用者的完整輸入內容逐字儲存:
capture/extracted/visible-text.txt— 完整的文章/筆記/主題/簡要說明capture/extracted/tokens.json—{ "title": "", "description": "", "colors": [], "fonts": [] }
請勿執行 npx hyperframes capture — 沒有網址。無人物視覺畫面將在後續流程中原創產生。
2 · 設計系統
選擇一個符合主題、語氣和觀眾的影格預設:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .
這會將預設的 FRAME.md 複製為 frame.md,並重新混合品牌代碼。無人物解說通常沒有品牌顏色/字型 → 腳本會保留預設本身的調色盤。
3 · 分鏡腳本與旁白腳本
將文字轉換為逐格教學計劃。影片的順序來自敘事設計,而非輸入文字的段落順序——可以重新排序、合併、省略、壓縮。
撰寫 STORYBOARD.md 以及(需要旁白時)SCRIPT.md。每個影格需要:
focal/roles— 原創的視覺元素(主詞、圖表節點、數據視覺化序列)blueprint— 鏡頭形狀(來自hyperframes-animation/blueprints/)transition_in— 影格如何進入
3.1 · 音訊
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <voice-id> &
預設管道語音:HeyGen 的 Marcia (女聲) / Kokoro 的 am_michael。背景音樂氛圍來自分鏡腳本的 music: 欄位。
標準靜音標記: STORYBOARD.md 頂端 YAML 區塊中設定 music: none 且沒有 SCRIPT.md = 完全無聲專案。
4 · 影格視覺設計
針對每個影格,撰寫時間碼鏡頭序列:
- 選擇影格的藍圖(或組合)
- 使用此影格的原創內容來實例化藍圖
- 根據旁白安排每個場景的呈現節奏,使影格在全長度內持續發展
在每個場景中內嵌描述佈局與動畫。加入一個全影片範圍的 ## Video direction 區塊。
5 · 建置影格
等待步驟 3.1 音訊完成。然後:
node <SKILL_DIR>/scripts/audio.mjs sync-durations --audio-meta ./audio_meta.json --storyboard ./STORYBOARD.md
node <SKILL_DIR>/scripts/audio.mjs fetch-sfx --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/frame-packets.mjs --project "$PROJECT_DIR" --storyboard "$PROJECT_DIR/STORYBOARD.md"
為每個影格分派一個子代理。每個工作者會獲得:
_role.md(影格工作者角色)- 該影格的封包(精確的分鏡腳本區塊 + 藍圖主體 + 引用的規則配方,內嵌)
工作者只寫入 compositions/frames/NN-*.html。他們從不編輯 STORYBOARD.md。
全出血背景使用 class="clip" 圖層,不能使用 #root。 影格的地面就是它自己的全長背景剪輯片段。
在背景中建置字幕並組裝索引:
node <SKILL_DIR>/scripts/captions.mjs build --storyboard ./STORYBOARD.md --audio-meta ./audio_meta.json --hyperframes . --out ./caption_groups.json &
node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .
6 · 最終確認
node <SKILL_DIR>/scripts/transitions.mjs inject --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/transitions.mjs verify --storyboard ./STORYBOARD.md --index ./index.html
npx hyperframes lint
npx hyperframes check
npx hyperframes snapshot --at <frame-midpoints>
僅在使用者核准後才進行渲染:
npx hyperframes render --skill=faceless-explainer --quality high --output renders/video.mp4
反合理化對照表
| 合理化行為 | 實際情況 |
|---|---|
| 「我會擷取文章的網站」 | 無人物 = 無擷取。視覺畫面是原創的,不是擷取的 |
| 「我會按照文字段落順序」 | 敘事設計決定順序,而非來源順序 |
| 「我會跳過設計系統」 | frame.md 是顏色/字型/佈局的真相來源 |
| 「我會先把所有內容放好,然後凍結」 | 依照旁白安排呈現節奏——影格在全長度內發展 |
| 「我會寫一個藍圖然後到處重用」 | 每個影格根據內容選擇自己的藍圖 |
| 「我會跳過音訊,只用文字」 | 音訊是時鐘——所有節拍時間都來自單詞時間戳 |
| 「我會在呈現之間加入閒置動畫」 | 每個階段都有作用——階段性呈現、有目的的鏡頭移動、或順序 UI |
| 「我會對齊 42% 以留出字幕空間」 | 字幕是疊加層——對齊真正的中心(y = H/2) |
驗證
-
hyperframes.json和BRIEF.md已存在 -
frame.md來自某個有名稱的預設 -
STORYBOARD.md已存在,包含必要的敘事欄位 -
SCRIPT.md已存在(當需要旁白時) - 音訊工作已啟動,或專案標記為無聲
- 每個影格都有時間碼鏡頭序列,並根據旁白安排節奏
- 每個影格指定了原創的
focal和/或roles -
index.html已存在 - 字幕已建置或明確跳過
- 渲染前已通過
lint和check - 使用者在審閱暫停時已核准