Communitygithub.com

heygen-com/hyperframes — 超大游標 (Eye-Carrier)

為 HyperFrames 啟動畫面打造的「室內風格」超大 macOS 游標技術。適合任何包含游標或指標引導動作、啟動 UI 場景、以點擊觸發變形/轉場/打字動畫,或是靜態、停滯的場景需要廉價但高效的視覺動感來引導視線並打破停滯狀態時使用。涵蓋游標尺寸/外觀(含品牌主題游標)、畫外進入法則、尖端定位與點擊、點擊觸發下一拍、以及離開與跨場景交接。

hyperframes — 超大游標 (Eye-Carrier) 是什麼?

heygen-com/hyperframes 是一套專為 HyperFrames 啟動影片設計的「超大游標」技術。其核心概念是讓一個刻意放大的 macOS 風格游標,像一個「可視主角」般在畫面中移動:從畫外進入,引導觀眾視線至下一個重點,點擊觸發接下來發生的事件,然後離開。這套技術在多次啟動影片中經過實戰驗證,核心優勢在於提供一種「最廉價的高回報動態來源」——僅需一個元素與 transform-only 補間動畫,就能讓原本死氣沉沉的場景活絡起來,並為轉場提供因果關聯(「那個點擊造成的」)。 這套技術不僅規範了標準 macOS 游標的尺寸(全畫面場景為 7cqw)、外觀(白色箭頭+黑色描邊或黑色箭頭#1c1c1c+白色描邊1.4px),更鼓勵使用品牌主題游標——例如協作設計工具的多人箭頭附姓名標籤(類似 Figma 風格)、創意套件的精確十字準線或產品特有的指標,只要該主題能被辨識即可。游標永遠從畫外物理進入,不允許在原地淡入,尖端精準對準目標中心點擊,且每次點擊必須在同影格內觸發下一事件(例如選單展開、打字開始、視窗轉換)。 在長時間不屬於游標主導的環節(如旁白打字時),游標會先漂移到旁邊(0.5–0.9秒),避免凍結在動作上方或無謂晃動。離開場景時有兩種正規出口:加速離開畫面邊緣(power2.in),或是透過「切曲線交接法」在最後 0.3 秒內朝下一場景的首個點擊點加速移動,讓游標成為縫合場景接縫的載體元素。整體而言,這是一套極為實用且經過驗證的動畫原則,能顯著提升 UI 導向影片的流暢度與專業感。

相容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/heygen-com/hyperframes/tree/HEAD/.agents/skills/oversized-cursor

在你喜歡的 AI 中提問

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

說明文件

超大游標 —— 視線引導者

一個刻意放大的 macOS 風格指針,作為 可視主角 在畫面中移動:它從畫外進入,引導觀眾視線到下一個重點,點擊觸發下一事件,然後離開。本技術已在多個啟動影片中經過實戰驗證。

為何需要它。 在啟動影片中,大游標移動是「最廉價的高回報動態來源」之一:只需一個元素、transform-only 補間動畫,就能 (1) 讓原本死氣沉沉的場景帶來橫跨畫面的視覺動感,(2) 為形變/轉場提供因果觸發(「是那次點擊造成的」),以及 (3) 在啟動新場景或複雜動畫序列時,將視線從停滯狀態中解放出來。越大越好——實際尺寸的游標在影片比例下會消失。

尺寸與外觀(室內慣例)

  • 全畫面場景:7cqw(約 1920 解析度下的 134px)。內嵌 / 小畫面變體:4.6–5.5cqw。絕不更小。
  • 所有地方使用同一組 SVG 箭頭幾何。兩種經測試的填色——白色本體 + 黑色描邊,或黑色本體(#1c1c1c)+ 白色描邊(1.4px)。依場景對比選擇,整支影片保持固定。
  • 品牌主題游標(進階玩法)。 macOS 箭頭是預設值,而非強制。當主體品牌有可辨識的游標識別——協作設計工具的彩色多人箭頭附姓名標籤(Figma 風格)、創意套件的精確十字準線、獨特的產品指針——就使用那個游標:對任何了解該產品的人而言,這是瞬間可讀的品牌語言。同樣法則照舊(超大比例、物理進入/離開、尖端定位、點擊觸發),而有姓名標籤的變體則作為一體化的剛體移動(標籤跟隨箭頭)。只在該主題確實可被參考時才使用;沒人認得的游標只是個奇怪的箭頭——請退回使用 macOS 預設。
  • filter: drop-shadow(0 4px 6px rgba(0,0,0,.3))、pointer-events: none、z-index 高於所有場景內容、will-change: transform。
#root .cursor {
  position: absolute;
  left: 48%;
  top: 115%; /* 畫外下方 —— 靜止位置就是畫外 */
  width: 7cqw;
  height: 7cqw;
  z-index: 20;
  filter: drop-shadow(0 4px 6px rgba(0, 0, 0, 0.3));
  pointer-events: none;
  will-change: transform;
}

進入法則 —— 物理性,絕不揭露

游標 永遠從畫外進入(典型:從下方 top:115–120%),並在一次減速滑行中移動到第一個目標。它必須 感覺像是走進了房間。絕對不要在靜止位置用不透明度淡入,也不要用遮罩揭露——那看起來像破圖(真實、反覆觀察到的失效模式)。

  • 預設路徑:沿 Y 軸直上 到目標——不要有分段對角線。當故事需要時(朝向偏軸目標進入),對角線也沒問題,但無論如何都是一條連續的向量。
  • duration: 0.4–0.92s、ease: power3.out、immediateRender: false 用於 fromTo。
tl.fromTo(
  cursor,
  { left: "48.6%", top: "115%" },
  { left: "48.6%", top: "55%", duration: 0.85, ease: "power3.out", immediateRender: false },
  0.25,
);

尖端定位與點擊

熱點是箭頭 尖端,不是盒子中心。讓 尖端 落在目標中心,並讓所有按壓縮放以尖端為軸心:transformOrigin: '21% 14%'(用於在 24 單位 viewBox 中的室內箭頭路徑)。

點擊 = 不對稱壓縮/擴張(1:2 比例看起來像真實按壓):

tl.to(cursor, { scale: 0.84, duration: 0.1, ease: "power2.in", transformOrigin: "21% 14%" }, t);
tl.to(
  cursor,
  { scale: 1, duration: 0.22, ease: "power2.out", transformOrigin: "21% 14%" },
  t + 0.1,
);

目標的反應是獨立的、平行的補間(按鈕:scale: 0.94 + 按壓顏色/陰影,從同一個 t 開始)。僅遊標點擊(例如聚焦文字輸入框)則沒有目標反應。搭配 cursor-click-ripple / press-release-spring 用於目標端。

點擊觸發下一拍

絕不讓形變、打字動畫、視窗轉換或場景定義動畫 單純開始。讓游標停在觸發點上,讓點擊在同影格內造成它:

  • 點擊 ▸ 選單/子選單串聯、切換翻轉
  • 點擊 ▸ 在輸入框中開始打字
  • 點擊 ▸ 合成器縮小/視窗縮小
  • 點擊 ▸ Logo 啟動/飛行發射
  • 點擊 ▸ 產品模擬中的播放狀態切換 + UI 生命喚醒

在長時間不屬於它主導的環節(打字、旁白)中,游標 漂移到旁邊(0.5–0.9 秒,power2.out)——絕不凍結在動作上方,也不無謂晃動。

離開法則與跨場景交接

兩種正規出口——都是物理性的,絕不原地不透明度淡出:

  1. 離開畫面:以 power2.in 加速離開最近的邊緣(left:'118%'、left:'-12%' 或 top:'116%'),0.5–0.7 秒。
  2. 切曲線交接:在硬切剪前的最後約 0.3 秒內,游標開始加速(power2.in)朝向下一個場景的第一個點擊點,覆蓋該路徑的前約 1/3;下一個合成用 gsap.set 將游標設定在交接姿勢,並以匹配的速度繼續使用 power2.out。游標本身成為縫合場景接縫的載體元素:
// 場景 A,最後 0.3 秒 —— 開始旅程:
tl.to(cursor, { left: "40.7%", top: "63.7%", duration: 0.3, ease: "power2.in" }, CUT - 0.3);
// 場景 B,t=0 —— 以匹配的速度完成:
gsap.set(cursorB, { left: "40.7%", top: "63.7%" });
tl.to(cursorB, { left: "22%", top: "45%", duration: 0.6, ease: "power2.out" }, 0);

檢查清單

  • ≥ 7cqw 全畫面(模擬內 4.6–5.5cqw)——不確定時就選更大
  • 從畫外進入,沿一條連續向量(無淡入/遮罩揭露)
  • 尖端落在目標中心;按壓以 transformOrigin: '21% 14%' 為軸心
  • 每次點擊在同影格內造成某件事
  • 在不屬於它主導的環節中漂移到旁邊;零無謂晃動
  • 物理性離開(畫外或切曲線交接)——無原地淡出

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

general-video

>

heygen-com/animejs

Anime.js adapter patterns for HyperFrames. Use when writing Anime.js animations or timelines inside HyperFrames compositions, registering animations on window.__hfAnime, making Anime.js seek-driven and deterministic, or translating Anime.js examples into render-safe HyperFrames HTML.

heygen-com/claude-design-hyperframes

Use when running inside Claude Design specifically. Produces a valid, brand-accurate HyperFrames video draft using pre-valid skeletons. For Claude Code / Cursor / Codex, use the `hyperframes` skill instead.

heygen-com/contribute-catalog

Author a new HyperFrames registry block (caption style, VFX block, transition, lower third) or component (text effect, overlay, snippet) and ship it as an upstream PR to the hyperframes repo. Use ONLY when the user wants to CONTRIBUTE to the public catalog — for in-project caption/transition authoring use the `hyperframes` skill, for installing existing registry items use the `hyperframes-registry` skill.

heygen-com/css-animations

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

heygen-com/gsap

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

heygen-com/hyperframes

A tiled headline surface flips cell by cell under a sweeping depth field to reveal the rear headline. HyperFrames block, 1920×1080, 8s, 18 variables.

heygen-com/hyperframes

Leaves sweep through the frame and part to reveal the headline. HyperFrames block, 1920×1080, 12s, 11 variables.

heygen-com/hyperframes

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

heygen-com/hyperframes

A single feature card orbits a dot sphere on approved Blender camera motion. HyperFrames block, 1920×1080, 10s, 4 variables.

heygen-com/hyperframes

A wireframe portal bursts open, the title comes through, then its letters swap into a second phrase. HyperFrames block, 1920×1080, 8s, 9 variables.

heygen-com/hyperframes

Glass shards fly in through fog and tile themselves into the headline. HyperFrames block, 1920×1080, 12.16s, 19 variables.

heygen-com/hyperframes

Render-correctness doctrine for scene-to-scene seams in HyperFrames launch videos — the prerequisites that make transitions composite correctly on the master timeline. Load when assembling the master timeline / index.html, when a white flash appears at a cut or crossfade seam (especially on dark films), when reasoning about why a transition opacity dip shows through, or when verifying the render-side mechanics of how overlapping scene wrappers blend. Covers the opaque stage-ground (#root background) white-flash guard and how the injector overlaps wrappers, holds final frames, ping-pongs tracks, and stamps lint-clean template code onto the master timeline. Does NOT contain the per-transition catalog — see the transition registry for individual transition entries.

heygen-com/hyperframes

An orbiting camera follows an ice logo as it breaks apart, reforms into two text moments, and fades. HyperFrames block, 1920×1080, 22.5s, 216 variables.

heygen-com/hyperframes

name: embedded-captions

heygen-com/hyperframes

A chain of bevelled cuboids rides a travelling wave as a content carousel. HyperFrames block, 1920×1080, 6.666666666666667s, 40 variables.

heygen-com/hyperframes

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

heygen-com/hyperframes

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

heygen-com/hyperframes

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

heygen-com/hyperframes

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

相關技能