RoleModel 品牌 for HyperFrames
我們已擁有深入的 HyperFrames 工具組。從那份清單開始著手,而不是從零開始。 此技能僅是上層的品牌層:我們的規範從何而來、該選用哪個代碼、以及我們不做哪些事。
工具清單
已安裝兩套技能組,且名稱上有重疊。請確認你正在呼叫的是哪一套。
官方(HeyGen),位於 ~/.claude/skills:
| 技能 | 何時使用 |
|---|---|
hyperframes | 合成腳本創作、時間軸設定、媒體管理、製作流程 |
hyperframes-core | 合成協定與 data-* 時間屬性 |
hyperframes-animation | 動態規則、場景藍圖、GSAP 及其他執行期 |
hyperframes-keyframes | 特寫切入、鏡頭移動、重構畫面、安全關鍵影格 |
hyperframes-creative | 色盤、節奏規劃、旁白、合成模式 |
hyperframes-audio | 已放置音軌的混音 — 淡入淡出、側壓、自動化 |
hyperframes-cli | 初始化、檢查、預覽、渲染、轉錄、文字轉語音 |
hyperframes-registry | 安裝區塊與元件 |
media-use | 尋找或生成音樂、音效、圖片、語音 |
標準(我們的),位於 ~/.claude/skills/synced:
| 技能 | 何時使用 |
|---|---|
hyperframes | 我們自己的合成技能 — 讀取 design.md、house-style.md |
hyperframes-cli | 我們自己的 CLI 筆記 |
hyperframes-direction-harness | 在最終 index.html 之前,當方向尚未鎖定時 |
optics-context | 任何同時也需作為產品界面的內容 |
gsap | GSAP 特定細節 |
impeccable | 我們的工藝規範 |
名稱衝突。
hyperframes與hyperframes-cli同時存在於兩套清單中。 當你取得哪一套很重要時,請明確指定。
請勿在此重述它們的任何規則。 合成協定、檢查錯誤、音軌衝突、暫停的時間軸 — 所有這些都歸屬於那些技能,並在那裡維護。第二份副本會隨著它們發佈新版本而走樣,且無人察覺。如果某條規則遺漏了,請在上游修正,而不是在此檔案中。
品牌透過 design.md 連接到 HyperFrames
標準版的 hyperframes 技能已會從專案根目錄讀取 design.md,將其視為 "品牌色彩、字型與限制的唯一真相來源",並被指示使用其確切數值,而非自行發明。這就是連結點。請善用它。
品牌儲存庫會產生此檔案:
cp rolemodel-brand/dist/design.md <video-project>/design.md
它由 rolemodel-brand/tokens/brand.json 透過 scripts/build-tokens.mjs 產生,因此不可能與其他 RoleModel 界面使用的代碼不一致。切勿手動編輯它 — 請修改 brand.json 後重新執行。
該檔案包含色彩、字型、完整的動態尺度、四項動態原則,以及以下的限制。一旦檔案進入專案,現有的技能就會接手後續工作。
若要在合成本身中使用 CSS 自訂屬性:
<link rel="stylesheet" href="rolemodel-brand/css/academy-theme.css">
<body data-theme="academy">
選擇動態代碼
完整數值在 design.md 中。選擇的規則很簡短:
根據元素在做什麼來選擇,而不是根據它看起來像什麼。
- 一個元素進入畫面 →
--duration-base+--ease-enter - 同一個元素離開畫面 →
--duration-fast+--ease-exit。 離開總是比到達更快。 - 已在畫面上的元素改變位置或大小 →
--ease-move - 刻意吸引目光的效果 →
--ease-emphasis,唯一可能 overshoot 的曲線 - 一個群組 → 兄弟元素之間使用一個
--stagger,切勿同時出現
切勿在合成中直接使用原始時長或原始 cubic-bezier。工作室對色彩也適用相同的規則,原因相同。
我們不做的事
這些是具有約束力的。其中幾項由工具包中的 npm run check 強制執行,且全部列在 design.md 中,供合成技能讀取。
- 禁止使用徑向漸層,任何地方都不行。 品牌是線性的 — 方向性,而非模糊色塊。
- 禁止畫面 wipe。 請勿繪製白色或淺色邊框、框線或盒子,作為場景轉場。Claude 未經提示就會使用這個效果;這是典型的範本花招,不是我們的風格,而且它無法引導注意力。請透過直接剪接,或使用
--ease-enter揭露進入的內容來進行轉場。沒有任何東西會圍繞畫面畫框。 - 禁止裝飾性線條、底線或分隔線。 請勿為標題加底線、在區塊之間加入分隔線,或在卡片、統計數據、引言或 Lower Third 周圍畫邊框。Claude 傾向使用這些來標示結構;它們只表示多加了東西。區隔應來自空間、重量與背景。系統中唯一許可的規則線是標題下方的短品牌槓,而
rm-title會繪製它 — 切勿手動加上第二條。 - 邊緣必須是實線,而非漸層。 這規範的是必要邊緣如何繪製,並非給予你加上邊緣的許可。如果沒有邊緣也不會導致混淆,就不要加。
- 橙色僅可作為強調色 — 絕不能作為背景色。
- 禁止裝飾。 如果一個元素不承載資訊或引導注意力,就移除它。
當方向尚未鎖定時
請勿直接開始撰寫 index.html。請使用 hyperframes-direction-harness — 它正是為此而建,能在任何合成之前產生可審閱的工作板:
01_intake.md → 02_design_direction.md → 03_critical_frame_plan.md
→ direction_board.html (導演工作台,已審閱)
→ 04_render_plan.md (僅在審閱後備妥)
→ 移交給 hyperframes 技能
僅在對現有合成進行小幅編輯時可跳過此流程 — 例如修正錯字、微調時間軸、更改一個顏色、修正 lint 問題。
哪個工具解決哪個問題
HyperFrames 用於合成,而非錄製。如果影片必須顯示真實產品介面,它就是錯誤的工具。
| 輸入 | 工具 | 保持最新? | |
|---|---|---|---|
| 錄製 | 你的螢幕 | openscreen | 否 — 需手動重新錄製 |
| 合成 | 腳本或簡報 | HyperFrames | 重新執行簡報即可 |
| 從測試 | Playwright 追蹤 | playwright-recast | 是 — 重新執行測試即可 |
當你需要為錄製內容加上標題卡、Lower Third 與動態圖形時,才使用 HyperFrames。
旁白、時間軸、交付
請勿在合成內部合成旁白。
rm-voice <project> --script opener --voice af_nova
每行一個片段,每個都經過測量,SRT 檔案根據已知時長撰寫 — 因此時間軸透過建構方式精確無誤,且進行文案編輯時僅重新合成變更的部分。Kokoro 在本地端執行:無需 API 金鑰,且未發佈的客戶產品相關資訊不會離開你的機器。
渲染與旁白音軌處於不同的時間軸上。 playwright-recast 會壓縮閒置時間;旁白則取決於文字所需的時間。將 22 秒的字幕軌燒入 3.8 秒的渲染中,cue 1 會為整個片段保持等待,而其餘部分則會被靜默丟棄 — 這看起來像是運作成功了。
rm-mux --video demo.mp4 --audio narration.wav --srt narration.srt -o final.mp4
rm-share final.mp4 --project "Ridgeline Railing"
rm-share 會回傳一個連結,客戶無需帳號即可開啟,並可留下帶有時間戳的評論。rm-share --check 則會顯示它是否已設定。
在客戶專案開始前
export HYPERFRAMES_NO_TELEMETRY=1
遙測功能預設為開啟。專案名稱與影片內容絕不會被收集,但 hyperframes auth login 會將你的 HeyGen 帳號電子郵件連結到你的使用情況,並將先前的匿名活動與之關聯。 請在專案腳手架中加入退出選項。
鎖定版本。HyperFrames 採用 Apache-2.0 授權 — 無座位數限制,無公司規模門檻,這也是它成為我們預設選項的原因 — 但它處於 1.0 版之前,且幾乎每日發佈,並未聲明任何相容性保證。今天能渲染的客戶專案,六個月後也應能以同樣方式渲染。
致謝
三層框架以及從剪接 → 分鏡 → 動態圖形管線的概念,來自 Jay at RoboNuggets 的 hyperframes-helper,使用 CC BY 4.0 授權。若你重新分享此內容,請保留此出處 — 這是授權條款的要求。