動態語言 (Motion Language)
繼承自 skills/00-house-rules/SKILL.md。其實作位於 scripts/stingers.py;
用於渲染所有內容的圖庫腳本是 scripts/build_stinger_gallery.py。
唯一關鍵區別
場景在解釋。字卡在強調。
| 場景 | 字卡 | |
|---|---|---|
| 長度 | 8–15秒 | 2–4秒 |
| 承載內容 | 你必須讀懂的論述 | 你已經聽過的一個想法 |
| 人臉 | 隱藏或畫中畫 | 隱藏 — 你直接切到它 |
| 數量 | 一部10分鐘影片約3–6個 | 每20–40秒一個 |
| 若移除它 | 論點將無法傳達 | 影片變平淡,但不會出錯 |
搞錯這個區別是常見的失敗。一個包含實際內容的三項列表是 compare 場景;同樣的列表作為 steps 則是裝飾。如果觀眾需要閱讀它,它就不是字卡。
字卡是用剪輯切入的,不是疊加上去的。 在它們短暫的幾秒內,它們占據整個畫面。一個全畫面圖形後面還能看到演講者,看起來像個錯誤,而他臉部消失3秒鐘毫無損失。
詞彙庫
五個元素。庫中所有東西都是它們的組合,這使得看似無關的動畫能讀起來像一個系統。
| 基底 | 接近黑色,帶有柔和的徑向漸亮。絕不使用純 #000 — 真正的黑色畫面會讓人覺得是訊號中斷,而不是設計。 |
| 玻璃 | 半透明填充 ~4.5% 墨色,1px 邊框 ~14%,圓角 26。立體感來自邊框和內部高光,絕對不能在卡片上使用投影。 |
| 光澤 | 卡片定位時,一個低角度的鏡面掃掠效果。這是標誌性動作 — 它讓一個扁平矩形看起來像個實體物件。 |
| 路徑 | 細虛線曲線,約10%墨色。東西沿著路徑移動。沒有東西是瞬間傳送的。 |
| 狀態 | 一排小圓點承載系統狀態。該排圓點的顏色變化不需任何文案就能說「然後它就壞了」。 |
時間間隔為 120–160 毫秒。 低於 100 毫秒,同層物體會讀成一個物件;超過 200 毫秒,觀眾會開始等待。
每個字卡都停留在其最後一幀。 它是配合語音剪輯的,所以在訊息傳達後,停留在任何畫面上都必須是安全的。沒有循環動畫,沒有以空舞台結束的動畫。
函式庫
{ "kind": "converge", "from": "萬流歸宗", "dur": 3.4,
"chips": ["skill.md", "prompt", "context", "tool", "rule", "doc"] }
| kind (類型) | 它所屬的句子 | dur (持續時間) |
|---|---|---|
converge | 「所有這些都匯聚到一處。」晶片沿虛線路徑移入一個發光核心;狀態圓點在承受負載時逐一填滿。 | 3.0–3.6 |
overload | 「然後它就不動了。」同一個核心裂開並變成紅色。與 converge 共享幾何佈局,兩者剪接在一起形成一個故事。 | 2.4–3.0 |
steps | 「這裡有三個。」編號的玻璃卡片,依次出現,每個都帶有光澤。最可重複使用,也最容易過度使用。 | 2.6–3.2 |
swap | 「這個,不是那個。」A 被劃掉並向上退場;B 從其下方進入。兩者皆保持清晰可讀。 | 3.0–3.6 |
countup | 「是百分之四十三。」數字攀升,大小隨數值增長,並顯示在可見的來源行上方。 | 2.6–3.4 |
beats | 三個短促片語,節奏分明。每個在一個共享的節拍網格上都有不同的入場方式。 | 2.4–3.2 |
surround | 「你被工具埋沒了。」帶標籤的晶片環繞著一個靜止的中心,然後向內聚攏。中心從不移動。 | 3.2–4.0 |
photo | 一張找到的經過處理的圖片。放在玻璃卡片內,緩慢的 Ken Burns 效果,附有說明文字和來源行。 | 2.8–4.0 |
clip | 同一張卡片,但容納的是影片素材而非靜止圖片。無 Ken Burns 效果 — 因為它本身就在動。 | 2.4–3.0 |
在 composition.json 中使用它們,就像使用場景一樣 — 同樣的 from / at / dur 定位,同樣在片語無法解析時報錯。
B-Roll:photo / clip 字卡
兩種處理方式,由 full 參數決定。full 是選擇加入的;省略它則得到卡片。
full: true — B-ROLL | full: false — 引用來源 | |
|---|---|---|
| 畫面 | 滿版,無卡片 | 玻璃卡片,光澤,緩慢移動 |
| 畫面上的文字 | 一個下三分之一區域,標明這個鏡頭是什麼 | 說明文字和來源行 |
| 畫面中的來源 | 絕對沒有 | 必須有 |
| 用途 | 用於承載一個瞬間的素材和靜態影像 | 截圖、圖表、價格頁、文件 |
B-Roll 是全螢幕的,且不帶來源參考。來自人類的長期指示,2026-08-14。 它像每個人看過的任何剪輯中的 B-Roll 一樣占據整個畫面。唯一允許覆蓋在其上的文字是一個下三分之一區域,說明這個鏡頭是什麼,絕不說它從哪裡來。歸屬仍然需要進行 — 在 drop 目錄下的 _FINAL/ATTRIBUTION.md 檔案中,由 fetch_stock.py 在下載時寫入,且任何剪輯都不能跳過這個步驟。Pexels 和 Pixabay 都允許在畫面上不標註來源,因此這個記錄單獨就能滿足授權要求,畫面也保持乾淨。
這條規則取代了之前關於 B-Roll 的段落,該段落曾說滿版素材「看起來像是另一部不同的影片」,並將所有內容都放在卡片內。這個論點仍然適用於引用來源的情況,且僅適用於此:當觀眾需要閱讀該素材作為你引用的證據時,full: false 並將來源行放回畫面上。
建構器預設仍為卡片,這是故意為之。 顛倒預設值會無聲地重新處理所有已根據它編寫的 photo 場景 — 其中包含 drop-005 的 working/stingers/plan.json — 而一個昨天渲染卡片的規格必須在今天渲染出同一張卡片。新作品要求 "full": true;skills/executive-animator 總是這麼做。如果將來要完全淘汰卡片,只需在 st_photo 中修改一個單詞。
一個幾何注意事項:滿版使用 object-fit: cover,所以請提供一個已經是 16:9 的來源。在全畫面顯示一個 2.19:1 的裁切,會在兩側各損失 221 像素,這就是為什麼一個圖表的首尾欄位會被切掉,而每個檢查點都回報正確的邊界框。
一個建構器,兩個名稱。 photo 用於靜止圖片,clip 用於影片素材;它根據檔案副檔名進行分支,所以名稱僅讓規格易於閱讀。實際的差異如下:
photo | clip | |
|---|---|---|
| 元素 | <img> | 帶有框架計時的 <video muted playsinline> |
| Ken Burns 效果 | 是,在卡片上以 1.00 → 1.07 的比例移動 | 無 |
影片素材沒有 Ken Burns 效果。 剪輯本身提供了動態,而在真實動態之上疊加縮放變化的效果,正是讓購買素材看起來像素材的原因。靜止圖片沒有動態,需要鏡頭緩慢移動來保持活力;影片則不需要。
// B-Roll。全螢幕,下三分之一區域說明它是什麼,畫面上無來源。
{ "kind": "clip", "from": "萬物同時移動", "dur": 3.0,
"src": "broll/cut-data-flow.mp4", "caption": "萬物同時移動" }
// 引用來源。觀眾將之視為證據來閱讀的文件,因此卡片和來源行回歸。
{ "kind": "photo", "full": false, "from": "價格頁面變了", "dur": 3.2,
"src": "assets/pricing.png", "caption": "Anthropic 定價, 2026年8月",
"credit": "ANTHROPIC.COM · 擷取於 2026-08-13" }
下三分之一區域位於 cap_left / cap_bottom,預設為 96 / 186 — 橫向,這能避開 youtube_long 左邊的 96 和底部的 132 區域。9:16 的豎直影片必須傳入自己的 cap_bottom:Reels 在底部保留了 520 像素,且卡拉OK字幕條佔據 y 1150-1400,因此橫向預設值會將說明文字放在進度條下方。沒有一組參數能同時適用於兩種畫面比例。
src 的解析是相對於規格檔案的,並且建構器會將其複製到專案的 assets/ 目錄,因此一個錯誤的路徑會在建構時直接報錯,而不是顯示空白卡片。兩個路徑都可以從 scripts/fetch_stock.py 取得,該腳本會列印出可供貼上的區塊。
歸屬是一個帳冊義務,不是畫面義務。 每個第三層級素材都會在 drop 的 _FINAL/ATTRIBUTION.md 中有一行記錄,由 fetch_stock.py 在下載時寫入 — 這是 config/broll-policy.md 的要求,且不可選擇。是否要在畫面上也顯示來源資訊是一個設計決策,而對於 B-Roll,答案是否定的。在引用來源卡片上,它會保留,並以符合 WCAG AA 標準渲染,一個沒人能讀的歸屬不是歸屬。
首先按層級順序解析所有圖片。照片屬於第三層級:僅在你自己拍攝的素材和第二層級疊加畫面都確實無可用的東西時才使用它。Ken Burns 效果作用於剪裁卡片內部的 <img> 元素,從不作用於卡片本身。
⚠ 不要複製冗長的第三方影片插入模式。 此語言所參考的某個資料中有一個長達50秒的他人訪談片段。config/broll-policy.md 明確禁止這種做法,再好的動態設計也無法讓它變成我們的內容。有標示來源的照片是可以的;但搬運半支影片則不行。
更廣泛的選單 — 當上述內容不適用時該用什麼
存在兩個上游語料庫,且兩者都比這個函式庫更大。從中選用比自創動畫更好。
hyperframes-animation 技能 — 48條原子規則 + 22個場景藍圖。使用 Skill(hyperframes-animation) 載入,然後開啟 rules-index.md 並在 rules/<name>.md 中閱讀你需要的規則。房規預設是在一個暫停的時間軸上組合 2–4 條原子規則;藍圖適用於你想要一個完整的 4–5 階段鏡頭的情況。
區塊註冊表 — 373個可安裝區塊:npx hyperframes catalog --query "<概念>",然後執行 npx hyperframes add <區塊>。
情境 → 規則
為談話性解說節目精選。以下是適用於我們格式的規則;其餘48條大多假設有產品UI或我們沒有的驅動滑鼠游標。
| 當台詞是… | 規則 | 為何適用 |
|---|---|---|
| 一個數字、統計資料、百分比 | counting-dynamic-scale, stat-bars-and-fills | 已實作為 countup;對於長條圖、環狀圖、星形填充,可直接使用規則 |
| 一個強而有力的列表,快節奏 | kinetic-beat-slam, waterfall-entry | 已實作為 beats;waterfall-entry 是較溫和的串聯效果 |
| 一個定義或一個術語登場 | gradient-text-sweep, depth-scatter-assemble | 前者文字從不移動;後者從畫面深處組合文字 |
| 「它的形狀是這樣的」(圖表) | svg-path-draw | 輪廓自行描繪。使用 getTotalLength() 在設定時測量 |
| 「它被包圍/埋沒/連接」 | radial-surround, avatar-cloud-network, orbit-3d-entry | 已實作為 surround;另外兩個增加了連接線和3D入場 |
| 一個想法取代另一個 | scale-swap-transition, card-morph-anchor, morph-swap | 已實作為 swap;card-morph-anchor 會變形容器本身 |
| 「靠近看這裡」 | depth-of-field-blur, coordinate-target-zoom, viewport-change | 焦距轉換,或是 .world 包裝器上的虛擬相機 |
| 強調某個口語單詞 | asr-keyword-glow, css-marker-patterns | 光暈與單詞時間戳同步 — 我們已有測量到的單詞時間 |
| 一個強烈的、撞擊式的重音 | chromatic-glitch, particle-burst, motion-blur-streak | 謹慎使用;每部影片最多一個 |
| 一個平靜的休止拍 | titlecard-reveal (藍圖), ambient-glow-bloom | 低動態才是內容重點,不是缺點 |
| 任何入場方式 | spring-pop-entrance | 典型的彈入效果。有疑問時,選這個 |
值得了解的藍圖
22個藍圖中,大部分是產品發布廣告的形狀。有四個映射到我們實際製作的內容:
kinetic-type-beats— 主力。文字主導鏡頭,沒有佈景,沒有表面。dataviz-countup— 當數據承載論點時使用。comparison-split— 同時權衡兩種能力(我們的compare場景是它的平面版本)。titlecard-reveal— 呼吸節拍,恰如其分的克制動作。
跳過 cursor-ui-demo, device-surface-showcase, cta-morph-press, prompt-type-submit-generate 以及其他演示家族,除非我們真的在展示產品UI。它們很優秀,但不適合我們的格式 — 一個談話性解說節目突然展示一個假的應用程式演示,會讓人覺得像廣告。
每個上游規則假設的契約
在複製一個規則之前值得了解,因為破壞這些規則不會導致檢查失敗 — 而是會導致渲染失敗:
- 一個暫停的 GSAP 時間軸,掛在
window.__timelines上。永遠不要自動播放,永遠不要有第二個時間軸。 - 雙向搜尋安全 — 使用
fromTo搭配明確的 from 狀態、絕對值,永遠不用相對+=。狀態必須是時間軸時間的純函數。 - 確定性 — 沒有
Math.random(),沒有Date.now()。僅允許基於索引的偽隨機。有限次重複,永遠不要repeat: -1。 - 僅限變形與繪畫。 禁止使用針對
width/height/top/left的補間動畫;使用 scale/translate 代理或遮罩。 - 群組交錯時間上限,使進入讀起來像一個拍子 —
items × stagger ≤ ~0.5s。 - 預先計算佈局常數。 永遠不要在補間時間計算位置;渲染器會並行採樣,導致測量結果不同步。
新增一個概念
- 先搜尋註冊表 —
npx hyperframes catalog --query "<概念>"。現有 373 個區塊。radial-surround、morph-swap、split-tilt-cards和particle-image-reveal與此函式庫中的元素非常接近,可能是比編寫新程式碼更好的起點。 - 使用上述五個元素來建構它。需要第六個元素的概念,要不是一個場景,就是表明詞彙庫需要審慎擴展的跡象 — 不是例外。
- 將其加入
scripts/stingers.py的KINDS字典。 - 渲染圖庫,然後把所有東西放在一起看。這是判斷新概念是加入了這個家族,還是只是偶然放在旁邊的唯一方法。
python3 scripts/build_stinger_gallery.py <輸出目錄> --photo <圖片>
cd <輸出目錄> && npx hyperframes check
python3 scripts/probe_frames.py <輸出目錄> --plan --grid sheet.png
此函式庫已捕捉到的三個缺陷
每一個在有人查看畫面之前都通過了乾淨的 hyperframes check:
- GSAP 無法對
::after進行動畫。 它使用querySelector解析目標,該方法永遠不會返回偽元素,因此每個光澤效果都在無聲中失敗。現在光澤是一個真實的子元素 (SHEEN_EL)。如果你新增一個卡片,請將其放在內部。 - GSAP 解析
clip-path時,如果 URL 以數字結尾,則會將其視為 SVG 節點 ID。在所有變數外圍加上引號可以避免這個問題。path()是安全的,因為它永遠不會與 GSAP 的語法衝突。 will-change: transform在父元素和帶有filter的子元素上會觸發 Safari 的一個合成器錯誤。僅將其設定在即將進行補間動畫的元素上,並在動畫結束後將其移除。
對感知速度的附註
上述所有 dur 值都包含補間動畫時間加上尾隨停頓,因此一個持續時間為 3.0 秒的字卡可能有一個 1.8 秒的動畫和一個 1.2 秒的停頓。將字卡視為對語音的視覺打點:如果下一個單詞在你準備好之前就到達,就縮短停頓。不要調整動畫速度來適應語音 — 調整停頓。
在圖庫網格中,每張字卡很短的持續時間使得觀看一部由它們組成的完整影片可能會感到侷促。那就是預期的效果:沒有字卡會停留到讓觀眾失去興趣。