dsh-drawai 0.3.3 → 0.4.0

package/lib/motion/shotcraft/catalog.json

@@ -0,0 +1,2461 @@
+{
+  "commit": "1266a3ec4831289c4d893d42dd5102723658039a",
+  "categories": {
+    "opening": {
+      "zh": "开场与品牌",
+      "en": "Opening & Brand"
+    },
+    "typography": {
+      "zh": "文字与字卡",
+      "en": "Typography & Title Cards"
+    },
+    "ui-entrance": {
+      "zh": "界面登场与陈列",
+      "en": "UI Entrance & Showcase"
+    },
+    "camera": {
+      "zh": "运镜与空间",
+      "en": "Camera & Space"
+    },
+    "data": {
+      "zh": "数据与指标",
+      "en": "Data & Metrics"
+    },
+    "interaction": {
+      "zh": "交互与功能演示",
+      "en": "Interaction & Feature Demo"
+    },
+    "transition": {
+      "zh": "转场",
+      "en": "Transitions"
+    },
+    "rhythm": {
+      "zh": "节奏与蒙太奇",
+      "en": "Rhythm & Montage"
+    },
+    "effects": {
+      "zh": "光效与强调",
+      "en": "Light & Emphasis"
+    },
+    "outro": {
+      "zh": "收尾",
+      "en": "Outro"
+    }
+  },
+  "cards": [
+    {
+      "id": "assemble-then-type-flyin",
+      "category": "effects",
+      "summary": "空的暗底网格上，无文字的组件骨架先从四面八方飞入贴合；随后各处文字逐字从 3D 空间旋转着飞来落位，先大标题后小标注，全部落位后页面成形",
+      "use": "页面/海报\"自己长出来\"的开场；排版类产品的能力展示；从骨架到成稿的两段式叙事",
+      "duration": "约5.6s（168f@30fps）",
+      "energy": "中高（骨架段稀疏、文字段密集，能量单调上升到收尾）",
+      "source": "references/shots/effects/assemble-then-type-flyin.md",
+      "styles": [
+        {
+          "key": "assemble-then-type-flyin",
+          "label": "assemble-then-type-flyin",
+          "description": "空的暗底网格上，无文字的组件骨架先从四面八方飞入贴合；随后各处文字逐字从 3D 空间旋转着飞来落位，先大标题后小标注，全部落位后页面成形",
+          "demo": "demos/effects/assemble-then-type-flyin/AssembleThenTypeFlyin.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/assemble-then-type-flyin.mp4?v=1790980736765"
+        }
+      ]
+    },
+    {
+      "id": "aurora-bloom-bg-flip",
+      "category": "effects",
+      "summary": "浅灰底从底部升起紫橙柔焦 blob，随后整个底色在约 0.36s 内压暗到近黑、blob 压成余晖；文案同步 blur-out 换句 blur-in，换句间留空档不 cross-fade",
+      "use": "叙事转折点（\"多年以来…→一切都变了\"）；品牌片从铺垫拉到重音的那一拍；深浅色系之间的段落切换",
+      "duration": "约5.2s（156f@30fps）",
+      "energy": "由低到高（前 2/3 是酝酿，压暗那一瞬是全片重音）",
+      "source": "references/shots/effects/aurora-bloom-bg-flip.md",
+      "styles": [
+        {
+          "key": "aurora-bloom-bg-flip",
+          "label": "aurora-bloom-bg-flip",
+          "description": "浅灰底从底部升起紫橙柔焦 blob，随后整个底色在约 0.36s 内压暗到近黑、blob 压成余晖；文案同步 blur-out 换句 blur-in，换句间留空档不 cross-fade",
+          "demo": "demos/effects/aurora-bloom-bg-flip/AuroraBloomBgFlip.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/aurora-bloom-bg-flip.mp4?v=1790980736766"
+        }
+      ]
+    },
+    {
+      "id": "autolayout-gap-dial",
+      "category": "interaction",
+      "summary": "间距拨盘驱动布局——一排链接块带框选描边+缝隙间距标注，徽章数字逐格跳动、块被参数实时推开再弹簧回弹归位；\"参数驱动布局\"的可视化",
+      "use": "设计工具/低代码产品的\"改一个数、界面跟着动\"卖点镜头；\"用设计工具语义做包装\"的品类语言",
+      "duration": "~5s（150f：框选入场 + 预备回收 10f + 拉松 34f + 屏息 hold 20f + 弹簧回弹 + 落定 hold）",
+      "energy": "中（工具理性型，爽点在数字与位移的锁定同步）",
+      "source": "references/shots/interaction/autolayout-gap-dial.md",
+      "styles": [
+        {
+          "key": "autolayout-gap-dial",
+          "label": "autolayout-gap-dial",
+          "description": "间距拨盘驱动布局——一排链接块带框选描边+缝隙间距标注，徽章数字逐格跳动、块被参数实时推开再弹簧回弹归位；\"参数驱动布局\"的可视化",
+          "demo": "demos/interaction/autolayout-gap-dial/AutolayoutGapDial.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/autolayout-gap-dial.mp4?v=1790980736767"
+        }
+      ]
+    },
+    {
+      "id": "avatar-bracket-carousel",
+      "category": "ui-entrance",
+      "summary": "\"Your ___ agent\" 填空排版，四角对焦框钉在句中不动，头像队列在框内垂直 spring 轮换三次，入框放大清晰、出框按距离缩小淡化模糊，角色标签同步更换，切换瞬间对焦框呼吸 7%",
+      "use": "\"一个位置，多种角色\"的能力枚举；团队/身份/预设/人格类产品的核心一句话镜头",
+      "duration": "约 5.2s（156f@30fps）",
+      "energy": "中（三次等距切换构成稳定节拍器，对焦框脉冲是唯一装饰性动作）",
+      "source": "references/shots/ui-entrance/avatar-bracket-carousel.md",
+      "styles": [
+        {
+          "key": "avatar-bracket-carousel",
+          "label": "avatar-bracket-carousel",
+          "description": "\"Your ___ agent\" 填空排版，四角对焦框钉在句中不动，头像队列在框内垂直 spring 轮换三次，入框放大清晰、出框按距离缩小淡化模糊，角色标签同步更换，切换瞬间对焦框呼吸 7%",
+          "demo": "demos/ui-entrance/avatar-bracket-carousel/AvatarBracketCarousel.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/avatar-bracket-carousel.mp4?v=1790980736768"
+        }
+      ]
+    },
+    {
+      "id": "basic-3d-scene",
+      "category": "camera",
+      "summary": "impress.js 式空间演示：卡片以不同位置/旋转/缩放散布 3D 空间，相机取各步姿态之逆依次飞行对齐，末步拉到 OVERVIEW 总览",
+      "use": "概念/路线图/三步法的空间化讲述；替代平面 slides 的\"每一步都换个空间视角\"",
+      "duration": "约 7.5s（225f@30fps；四站，三段飞行 28/32/32f，每站停留 ≥30f）",
+      "energy": "中（每次转场有空间惊喜，停留段安静读卡）",
+      "source": "references/shots/camera/basic-3d-scene.md",
+      "styles": [
+        {
+          "key": "basic-3d-scene",
+          "label": "basic-3d-scene",
+          "description": "impress.js 式空间演示：卡片以不同位置/旋转/缩放散布 3D 空间，相机取各步姿态之逆依次飞行对齐，末步拉到 OVERVIEW 总览",
+          "demo": "demos/camera/basic-3d-scene/Basic3DScene.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/basic-3d-scene.mp4?v=1790980736769"
+        }
+      ]
+    },
+    {
+      "id": "beat-cut-moves",
+      "category": "rhythm",
+      "summary": "硬切当节拍乐器——连闪定格：三次白闪各硬切同一画面的一个裁切（全景→卡片→特写），快门余韵沉降后停在特写收束",
+      "use": "高光段落把\"切\"本身打成鼓点；颁奖连拍式的仪式感、关键信息的加冕",
+      "duration": "全程 140f ≈4.7s（活素材 30f + 三闪 + hold 70f）",
+      "energy": "高",
+      "source": "references/shots/rhythm/beat-cut-moves.md",
+      "styles": [
+        {
+          "key": "paparazzi-flash",
+          "label": "paparazzi-flash 连闪定格",
+          "description": "硬切当节拍乐器——连闪定格：三次白闪各硬切同一画面的一个裁切（全景→卡片→特写），快门余韵沉降后停在特写收束",
+          "demo": "demos/rhythm/beat-cut-moves/PaparazziFlash.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/paparazzi-flash.mp4?v=1790980736770"
+        }
+      ]
+    },
+    {
+      "id": "beat-step-list-theme-cycle",
+      "category": "rhythm",
+      "summary": "三通道节拍器——深色场形容词列表逐拍上移一行，视口中央固定胶囊\"接住\"下一个词并换色，整场底色同拍跟换；行、色、场三通道锁死同一拍点",
+      "use": "\"同一产品多种气质/多主题展示\"段落（modern/playful/expressive 式形容词连打）；全片节奏最密的一段；音乐段对拍",
+      "duration": "铺垫 30f + 每拍 18f × 拍数 + 收尾 hold；4 拍约 4.7s（demo 140f）",
+      "energy": "高（0.6s 一拍三通道齐跳，密度型高能）",
+      "source": "references/shots/rhythm/beat-step-list-theme-cycle.md",
+      "styles": [
+        {
+          "key": "beat-step-list-theme-cycle",
+          "label": "beat-step-list-theme-cycle",
+          "description": "三通道节拍器——深色场形容词列表逐拍上移一行，视口中央固定胶囊\"接住\"下一个词并换色，整场底色同拍跟换；行、色、场三通道锁死同一拍点",
+          "demo": "demos/rhythm/beat-step-list-theme-cycle/BeatStepListThemeCycle.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/beat-step-list-theme-cycle.mp4?v=1790980736771"
+        }
+      ]
+    },
+    {
+      "id": "before-after-slider-scrub",
+      "category": "data",
+      "summary": "前后对比拉杆——\"处理前/后\"两版叠放，分割杆先猛甩后慢扫，杆过处新版\"显影\"揭出",
+      "use": "AI 增强/优化/重构类功能的效果对比段落（\"用前 vs 用后\"一镜讲清）",
+      "duration": "4–5s",
+      "energy": "中（快甩是打击点，慢扫是阅读期）",
+      "source": "references/shots/data/before-after-slider-scrub.md",
+      "styles": [
+        {
+          "key": "before-after-slider-scrub",
+          "label": "before-after-slider-scrub",
+          "description": "前后对比拉杆——\"处理前/后\"两版叠放，分割杆先猛甩后慢扫，杆过处新版\"显影\"揭出",
+          "demo": "demos/data/before-after-slider-scrub/BeforeAfterSliderScrub.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/before-after-slider-scrub.mp4?v=1790980736772"
+        }
+      ]
+    },
+    {
+      "id": "bezier-source-converge-merge",
+      "category": "ui-entrance",
+      "summary": "左侧四个来源节点各有一条细贝塞尔曲线连向右侧同一汇聚点，曲线先错峰由左向右 draw-on，节点沿自己的曲线滑向汇聚点并三段式加速缩小到消失，强调色数据包全程沿路径滑行，吞并完成后曲线从左端反向擦除只留品牌标志（demo：白瓷圆片托 video-shotcraft 镜刻标志）",
+      "use": "\"多源整合/统一接入/数据汇聚\"的核心机制镜头；集成、聚合、单一入口类产品的说明段落",
+      "duration": "约 5.6s（168f@30fps）",
+      "energy": "中（长镜慢速推进，靠数据包滑行维持活性；吞并瞬间是唯一小高点）",
+      "source": "references/shots/ui-entrance/bezier-source-converge-merge.md",
+      "styles": [
+        {
+          "key": "bezier-source-converge-merge",
+          "label": "bezier-source-converge-merge",
+          "description": "左侧四个来源节点各有一条细贝塞尔曲线连向右侧同一汇聚点，曲线先错峰由左向右 draw-on，节点沿自己的曲线滑向汇聚点并三段式加速缩小到消失，强调色数据包全程沿路径滑行，吞并完成后曲线从左端反向擦除只留品牌标志（demo：白瓷圆片托 video-shotcraft 镜刻标志）",
+          "demo": "demos/ui-entrance/bezier-source-converge-merge/BezierSourceConvergeMerge.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/bezier-source-converge-merge.mp4?v=1790980736773"
+        }
+      ]
+    },
+    {
+      "id": "blur-slide",
+      "category": "typography",
+      "summary": "标题逐词入场，y 0.38em→0 + blur 18→0 + opacity 0→1 三通道走同一条 ease-out 同步收敛，词间隔约 4f；副标题在标题收完前就错峰跟进",
+      "use": "几乎所有标题/副标题成对出现的场合；产品页首屏文案、章节小标题；需要\"专业但不抢戏\"的默认文字 reveal",
+      "duration": "约 4.0s（120f@30fps）",
+      "energy": "低（一次性收敛，无峰值无循环）",
+      "source": "references/shots/typography/blur-slide.md",
+      "styles": [
+        {
+          "key": "blur-slide",
+          "label": "blur-slide",
+          "description": "标题逐词入场，y 0.38em→0 + blur 18→0 + opacity 0→1 三通道走同一条 ease-out 同步收敛，词间隔约 4f；副标题在标题收完前就错峰跟进",
+          "demo": "demos/typography/blur-slide/BlurSlide.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/blur-slide.mp4?v=1790980736774"
+        }
+      ]
+    },
+    {
+      "id": "bottom-push-stack-wipe",
+      "category": "transition",
+      "summary": "底边上推换章——新场景连底色整屏从底边向上推入，把旧场景物理顶出画外，连推数章各配一种饱和底色，内容钉死在各自色底坐标系里随底色走",
+      "use": "多章节产品片的换章骨架（每章一个卖点一种底色）；需要\"翻页节奏感\"贯穿全片的段落切换",
+      "duration": "demo 三连推 170f（~5.7s）；单次推入 26f + 章内 hold ~1.2s",
+      "energy": "中",
+      "source": "references/shots/transition/bottom-push-stack-wipe.md",
+      "styles": [
+        {
+          "key": "bottom-push-stack-wipe",
+          "label": "bottom-push-stack-wipe",
+          "description": "底边上推换章——新场景连底色整屏从底边向上推入，把旧场景物理顶出画外，连推数章各配一种饱和底色，内容钉死在各自色底坐标系里随底色走",
+          "demo": "demos/transition/bottom-push-stack-wipe/BottomPushStackWipe.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/bottom-push-stack-wipe.mp4?v=1790980736775"
+        }
+      ]
+    },
+    {
+      "id": "brace-expand",
+      "category": "typography",
+      "summary": "一对紧贴的小花括号先在正中出现，随即带一次过冲向左右弹开并放大到标题级，文字 clip 宽度严格绑括号内缘、像被拉开幕布般从中间揭示，落定后字距再细微松弛",
+      "use": "开发者/技术产品的标题字卡；章节开场；需要\"一个符号完成揭示\"的极简一拍",
+      "duration": "约 4s（120f@30fps：光标 0–6f → 6f 小括号硬切 → 14f 弹开 → 40–64f 字距松弛 → 副标 → hold）",
+      "energy": "中（单次过冲是唯一峰值，其余静止）",
+      "source": "references/shots/typography/brace-expand.md",
+      "styles": [
+        {
+          "key": "brace-expand",
+          "label": "brace-expand",
+          "description": "一对紧贴的小花括号先在正中出现，随即带一次过冲向左右弹开并放大到标题级，文字 clip 宽度严格绑括号内缘、像被拉开幕布般从中间揭示，落定后字距再细微松弛",
+          "demo": "demos/typography/brace-expand/BraceExpand.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/brace-expand.mp4?v=1790980736776"
+        }
+      ]
+    },
+    {
+      "id": "brand-frame-snap",
+      "category": "effects",
+      "summary": "品牌色画框语法——一圈粗纯色画框先于内容长出包住全屏，录屏窗口落进框内；模式切换时整圈画框同帧硬翻色+窗内布局同帧换，一个 borderColor 干完章节导航/状态提示/品牌露出三件事",
+      "use": "双模式/双章节产品片的全片包装层（蓝=模式A、绿=模式B 颜色编码）；真实录屏素材的品牌化包裹",
+      "duration": "单次翻色 ~4.7s（140f）；画框本身可全片驻场",
+      "energy": "中（翻色瞬间高，其余时间是安静的包装层）",
+      "source": "references/shots/effects/brand-frame-snap.md",
+      "styles": [
+        {
+          "key": "brand-frame-snap",
+          "label": "brand-frame-snap",
+          "description": "品牌色画框语法——一圈粗纯色画框先于内容长出包住全屏，录屏窗口落进框内；模式切换时整圈画框同帧硬翻色+窗内布局同帧换，一个 borderColor 干完章节导航/状态提示/品牌露出三件事",
+          "demo": "demos/effects/brand-frame-snap/BrandFrameSnap.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/brand-frame-snap.mp4?v=1790980736777"
+        }
+      ]
+    },
+    {
+      "id": "brand-ink-open",
+      "category": "opening",
+      "summary": "墨线十字准星描画→字标逐字压印→打字机副标→满一秒静止再上浮消散",
+      "use": "品牌开场；任何\"先立名号再进产品\"的片头",
+      "duration": "约 2.8s（83f）",
+      "energy": "低（起步位，为后续镜头留爬升空间）",
+      "source": "references/shots/opening/brand-ink-open.md",
+      "styles": [
+        {
+          "key": "brand-ink-open",
+          "label": "brand-ink-open",
+          "description": "墨线十字准星描画→字标逐字压印→打字机副标→满一秒静止再上浮消散",
+          "demo": "demos/typography/brand-ink-open/BrandInkOpen.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/brand-ink-open.mp4?v=1790980736778"
+        }
+      ]
+    },
+    {
+      "id": "canvas-materialize-moves",
+      "category": "interaction",
+      "summary": "内容\"物化上画布\"两式——panel-to-canvas 行倒卡（面板表格行沿弧线飞出、跨容器变形成画布卡片）与 diagram-cascade 级联生成树（prompt 打字后节点逐层弹出、连线先于节点生长）",
+      "use": "AI/协作工具\"生成结果落到画布上\"的叙事段落；A 式讲\"已有内容换了个存在形态\"，B 式讲\"从一句话长出一棵结构\"",
+      "duration": "A ~5s（150f）/ B ~6s（180f）",
+      "energy": "中",
+      "source": "references/shots/interaction/canvas-materialize-moves.md",
+      "styles": [
+        {
+          "key": "panel-to-canvas",
+          "label": "panel-to-canvas 行倒卡",
+          "description": "复选框逐个自动打勾→按钮按下→三行沿上抛弧线错峰飞出，途中行形态与卡形态交叉淡化，落位带随机倾角；面板行槽塌陷成虚线留白",
+          "demo": "demos/interaction/canvas-materialize-moves/PanelToCanvasMaterialize.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/panel-to-canvas.mp4?v=1790980736779"
+        },
+        {
+          "key": "diagram-cascade",
+          "label": "diagram-cascade 级联生成树",
+          "description": "prompt 逐字敲出（敲完描边变深确认）→根（深色）→2 子→4 孙逐层弹出，折角连线描线先行 8f，成树后整棵呼吸一拍",
+          "demo": "demos/interaction/canvas-materialize-moves/DiagramCascadeBuild.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/diagram-cascade.mp4?v=1790980736780"
+        }
+      ]
+    },
+    {
+      "id": "card-flip-reveal",
+      "category": "transition",
+      "summary": "功能卡 3D 翻面揭示——卡片沿 Y 轴翻 180°，正面 UI 翻到侧棱最薄处掠过一道随角度移动的受光，背面揭出大号结论数字，逐张错峰扫过整排",
+      "use": "\"功能→成果\"的成对叙事：一排功能卡逐张翻出各自的指标/结论；元素级转场卡",
+      "duration": "全程 150f（~5s，含 hold）；单卡 4f 预备 + 16f 翻 + ~10f 弹簧落定，三卡错峰 12f",
+      "energy": "中高",
+      "source": "references/shots/transition/card-flip-reveal.md",
+      "styles": [
+        {
+          "key": "card-flip-reveal",
+          "label": "card-flip-reveal",
+          "description": "功能卡 3D 翻面揭示——卡片沿 Y 轴翻 180°，正面 UI 翻到侧棱最薄处掠过一道随角度移动的受光，背面揭出大号结论数字，逐张错峰扫过整排",
+          "demo": "demos/transition/card-flip-reveal/CardFlipReveal.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/card-flip-reveal.mp4?v=1790980736781"
+        }
+      ]
+    },
+    {
+      "id": "card-flock-tumble",
+      "category": "transition",
+      "summary": "三张 UI 页卡从侧棱薄边 3D 翻飞成阶梯站定（全程清晰、样条连续丝滑），站定后保持慢转不停，快速收束吸入中心，炸出单个湍流烟雾环扩散，巨字横贯收场",
+      "use": "能量高潮段（功能页群→品牌口号的爆点转场）；霓虹/极光暗场调性；\"多页面能力\"收束成一句话的段落",
+      "duration": "翻飞 ~1.5s + 慢转展示 ~0.3s + 收束 0.3s + 烟环+巨字 ~2s；全段 4.5s",
+      "energy": "极高（全片能量顶点用）",
+      "source": "references/shots/transition/card-flock-tumble.md",
+      "styles": [
+        {
+          "key": "card-flock-tumble",
+          "label": "card-flock-tumble",
+          "description": "三张 UI 页卡从侧棱薄边 3D 翻飞成阶梯站定（全程清晰、样条连续丝滑），站定后保持慢转不停，快速收束吸入中心，炸出单个湍流烟雾环扩散，巨字横贯收场",
+          "demo": "demos/transition/card-flock-tumble/CardFlockTumble.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/card-flock-tumble.mp4?v=1790980736782"
+        }
+      ]
+    },
+    {
+      "id": "card-stack",
+      "category": "ui-entrance",
+      "summary": "一组模板卡（demo 9 张）从屏幕下方逐张 spring 弹入、越落越快叠成一摞，全员落位后整摞一次性展成扇面——每张按序号偏转 6.5°、横移 138px，最后中心卡被抽出",
+      "use": "需要交代\"我们有一组东西\"的产品段落；卡片墙/模板库/方案列表的建立镜头，也能当 logo 前的一拍蓄势",
+      "duration": "约 5.0s（150f@30fps）",
+      "energy": "中高（入场是连续小爆发，展开段收成一次平滑的整体动作）",
+      "source": "references/shots/ui-entrance/card-stack.md",
+      "styles": [
+        {
+          "key": "card-stack",
+          "label": "card-stack",
+          "description": "一组模板卡（demo 9 张）从屏幕下方逐张 spring 弹入、越落越快叠成一摞，全员落位后整摞一次性展成扇面——每张按序号偏转 6.5°、横移 138px，最后中心卡被抽出",
+          "demo": "demos/ui-entrance/card-stack/CardStack.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/card-stack.mp4?v=1790980736783"
+        }
+      ]
+    },
+    {
+      "id": "carousel-3d",
+      "category": "ui-entrance",
+      "summary": "8 张卡排成圆环整环自转一圈（匀速底 + 每 45° 一次停靠的分步），每卡只绕 Y 公转、自身 billboard 朝外，正反两层同向贴图配 backface-visibility:hidden 保证任何时刻都正立不倒置，正前方卡被点亮、环下字幕随之换字，相机全程钉在浅俯角",
+      "use": "作品集/模板库/集成清单的循环展示；需要无缝 loop 的背景拍或落地页 hero",
+      "duration": "约 5.6s（168f@30fps）",
+      "energy": "中（可无限循环的稳态运动，每 45° 一次停靠给出节拍）",
+      "source": "references/shots/ui-entrance/carousel-3d.md",
+      "styles": [
+        {
+          "key": "carousel-3d",
+          "label": "carousel-3d",
+          "description": "8 张卡排成圆环整环自转一圈（匀速底 + 每 45° 一次停靠的分步），每卡只绕 Y 公转、自身 billboard 朝外，正反两层同向贴图配 backface-visibility:hidden 保证任何时刻都正立不倒置，正前方卡被点亮、环下字幕随之换字，相机全程钉在浅俯角",
+          "demo": "demos/ui-entrance/carousel-3d/Carousel3D.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/carousel-3d.mp4?v=1790980736784"
+        }
+      ]
+    },
+    {
+      "id": "chart-live-moves",
+      "category": "data",
+      "summary": "活体图表三式——oscilloscope-stream 示波流线（曲线右端实时写入+突发尖峰）、unit-dot-swarm-regroup 点阵重组（点群三幕迁徙聚成数字）、axis-rescale-shock 轴爆表重标（新值冲出画框逼 y 轴重标）",
+      "use": "数据叙事段落；分别讲\"实时性\"、\"每个数字是一个人\"、\"增长装不下\"",
+      "duration": "各 165–192f（5.5–6.4s）",
+      "energy": "中高（数据即剧情）",
+      "source": "references/shots/data/chart-live-moves.md",
+      "styles": [
+        {
+          "key": "oscilloscope-stream",
+          "label": "oscilloscope-stream",
+          "description": "采样窗平移 8px/f + 余弦包络尖峰 + 刹停真静止",
+          "demo": "demos/data/chart-live-moves/OscilloscopeStreamV2.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/oscilloscope-stream.mp4?v=1790980736785"
+        },
+        {
+          "key": "unit-dot-swarm-regroup",
+          "label": "unit-dot-swarm-regroup",
+          "description": "三幕 spring 错峰迁徙（stiffness 150、错峰 8f），终幕点阵拼数字",
+          "demo": "demos/data/chart-live-moves/UnitDotSwarmRegroupV2.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/unit-dot-swarm-regroup.mp4?v=1790980736786"
+        },
+        {
+          "key": "axis-rescale-shock",
+          "label": "axis-rescale-shock",
+          "description": "冲出框 220px + 重标三联动（刻度换/网格密/旧线压扁）+ 震 8px",
+          "demo": "demos/data/chart-live-moves/AxisRescaleShockV2.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/axis-rescale-shock.mp4?v=1790980736787"
+        }
+      ]
+    },
+    {
+      "id": "chip-grid-single-select-blackout",
+      "category": "interaction",
+      "summary": "五个选项 chip 以 3+2 居中排布逐个淡入；选中帧先插一帧灰色按压块，紧接数帧内底色变墨黑、文字变白并做 1→1.04→1 极轻回弹，其余 chip 淡到 18% 但位置锁死；随后余项归零，黑 chip 上移收窄，下方升起结算价格",
+      "use": "单选/套餐/档位选择的交互演示；\"选了它之后会怎样\"的因果镜头；价格/参数结算类链路",
+      "duration": "约5.5s（165f@30fps）",
+      "energy": "中低（唯一的爆点是那一帧灰闪，其余都在收）",
+      "source": "references/shots/interaction/chip-grid-single-select-blackout.md",
+      "styles": [
+        {
+          "key": "chip-grid-single-select-blackout",
+          "label": "chip-grid-single-select-blackout",
+          "description": "五个选项 chip 以 3+2 居中排布逐个淡入；选中帧先插一帧灰色按压块，紧接数帧内底色变墨黑、文字变白并做 1→1.04→1 极轻回弹，其余 chip 淡到 18% 但位置锁死；随后余项归零，黑 chip 上移收窄，下方升起结算价格",
+          "demo": "demos/interaction/chip-grid-single-select-blackout/ChipGridSingleSelectBlackout.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/chip-grid-single-select-blackout.mp4?v=1790980736788"
+        }
+      ]
+    },
+    {
+      "id": "circle-match-iris",
+      "category": "transition",
+      "summary": "圆心匹配光圈切——光圈从页面上圆形元素的圆心炸开，圈内新页的圆形图表接在同一个圆上；匹配剪辑给光圈一个语义锚点",
+      "use": "前景有圆形元素（头像/图标/圆钮）、后景有圆形主体（donut 图/圆环进度）的接缝；转场技法卡",
+      "duration": "5.5s / 165f（入场+定睛 40f + 蓄力 7f + 接圆开圈 37f + sweep 58f + 静止 47f）",
+      "energy": "中高",
+      "source": "references/shots/transition/circle-match-iris.md",
+      "styles": [
+        {
+          "key": "circle-match-iris",
+          "label": "circle-match-iris",
+          "description": "圆心匹配光圈切——光圈从页面上圆形元素的圆心炸开，圈内新页的圆形图表接在同一个圆上；匹配剪辑给光圈一个语义锚点",
+          "demo": "demos/transition/circle-match-iris/CircleMatchIris.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/circle-match-iris.mp4?v=1790980736789"
+        }
+      ]
+    },
+    {
+      "id": "cloner-depth-echo",
+      "category": "ui-entrance",
+      "summary": "克隆纵队——主卡瞬间\"复印\"出 7 个半透明分身沿斜向纵深排开成队，停一拍后全体加速吸回本体合一+弹跳",
+      "use": "\"多副本/多租户/规模感/批量处理\"卖点；一镜讲完\"一个=很多\"",
+      "duration": "138f（约 4.6s）",
+      "energy": "中（陈列-收束型）",
+      "source": "references/shots/ui-entrance/cloner-depth-echo.md",
+      "styles": [
+        {
+          "key": "cloner-depth-echo",
+          "label": "cloner-depth-echo",
+          "description": "克隆纵队——主卡瞬间\"复印\"出 7 个半透明分身沿斜向纵深排开成队，停一拍后全体加速吸回本体合一+弹跳",
+          "demo": "demos/ui-entrance/cloner-depth-echo/ClonerDepthEcho.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/cloner-depth-echo.mp4?v=1790980736790"
+        }
+      ]
+    },
+    {
+      "id": "collab-cursor-moves",
+      "category": "interaction",
+      "summary": "协作光标当演员——cast-ensemble 五光标群演氛围层（错峰飞入+正弦漂移+打字 cameo+聚拢围观）",
+      "use": "协作/多人主题的画布场景，给画面铺\"团队在场\"体温",
+      "duration": "A ~5.2s（156f）",
+      "energy": "A 低中（氛围层，可垫任何时长）",
+      "source": "references/shots/interaction/collab-cursor-moves.md",
+      "styles": [
+        {
+          "key": "cast-ensemble",
+          "label": "cast-ensemble",
+          "description": "协作光标当演员——cast-ensemble 五光标群演氛围层（错峰飞入+正弦漂移+打字 cameo+聚拢围观）",
+          "demo": "demos/interaction/collab-cursor-moves/CursorCastEnsemble.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/cast-ensemble.mp4?v=1790980736791"
+        }
+      ]
+    },
+    {
+      "id": "countdown-arc-scatter",
+      "category": "typography",
+      "summary": "纸面表盘 9 个等大数字沿大弧切向排布，整盘扫过 96° 后减速急停，\"5\" 停在弧顶随即平移落位成标题首字符，其余数字带 blur 原地散去，标题逐词模糊淡入、末词转强调色",
+      "use": "倒计时/时长承诺类文案（\"5 min to install\"）；数据揭晓的一拍；需要\"仪表盘\"语汇的浅底短镜",
+      "duration": "约 3.3s（100f@30fps：扫动 ~30f + 落位 20f + 标题成句 + hold 22f；最短可压到 33f 单拍）",
+      "energy": "高（96° 大幅扫动压进 ~20 帧，纯冲击）",
+      "source": "references/shots/typography/countdown-arc-scatter.md",
+      "styles": [
+        {
+          "key": "countdown-arc-scatter",
+          "label": "countdown-arc-scatter",
+          "description": "纸面表盘 9 个等大数字沿大弧切向排布，整盘扫过 96° 后减速急停，\"5\" 停在弧顶随即平移落位成标题首字符，其余数字带 blur 原地散去，标题逐词模糊淡入、末词转强调色",
+          "demo": "demos/typography/countdown-arc-scatter/CountdownArcScatter.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/countdown-arc-scatter.mp4?v=1790980736792"
+        }
+      ]
+    },
+    {
+      "id": "crane-rise-reveal",
+      "category": "opening",
+      "summary": "升降臂拉升揭示——开场怼在一行数据特写，相机沿 Y 轴减速升起后拉，行行涌入直到整面 dashboard 铺满全幅",
+      "use": "\"从细节到全局\"的开场定场；与 drone-dive-landing（全局→单点俯冲）互为反向",
+      "duration": "5.5s（165f：特写 hold 24f + 拉升 102f + 落定/余波/静止 39f）",
+      "energy": "中高（持续单向运动，无冲击拍）",
+      "source": "references/shots/opening/crane-rise-reveal.md",
+      "styles": [
+        {
+          "key": "crane-rise-reveal",
+          "label": "crane-rise-reveal",
+          "description": "升降臂拉升揭示——开场怼在一行数据特写，相机沿 Y 轴减速升起后拉，行行涌入直到整面 dashboard 铺满全幅",
+          "demo": "demos/opening/crane-rise-reveal/CraneRiseReveal.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/crane-rise-reveal.mp4?v=1790980736793"
+        }
+      ]
+    },
+    {
+      "id": "crash-zoom-punch",
+      "category": "camera",
+      "summary": "全景一拍急推到目标特写（6f），落位二选一——过冲回弹（弹性）或撞停震屏（重量）",
+      "use": "功能段\"点名\"镜头——把观众视线一拍按到目标卡/模块上；强调级用撞停",
+      "duration": "约 0.5s 动作 + 前后 hold（动作 6–11f，前 hold ≥30f 建立全景、后 hold ≥45f 读特写）",
+      "energy": "高（瞬时冲击，非持续高能）",
+      "source": "references/shots/camera/crash-zoom-punch.md",
+      "styles": [
+        {
+          "key": "crash-zoom-punch",
+          "label": "crash-zoom-punch",
+          "description": "全景一拍急推到目标特写（6f），落位二选一——过冲回弹（弹性）或撞停震屏（重量）",
+          "demo": "demos/camera/crash-zoom-punch/CrashZoomReal.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/crash-zoom-punch.mp4?v=1790980736794"
+        }
+      ]
+    },
+    {
+      "id": "cursor-flyover",
+      "category": "camera",
+      "summary": "整页俯瞰后，相机依次飞到四个功能区 zoom-in 特写，SVG 光标先一步到位指点、点击留下涟漪并触发界面响应，最后拉回俯瞰",
+      "use": "单页产品的功能巡览：一镜带观众看完四个功能区，光标当\"导游手指\"",
+      "duration": "约 8.0s（240f@30fps；俯瞰 22f · 四站各 44f（飞行 20f + 停留 24f）· 拉回 24f · hold 18f）",
+      "energy": "中（等距巡航，节奏靠点击涟漪打点）",
+      "source": "references/shots/camera/cursor-flyover.md",
+      "styles": [
+        {
+          "key": "cursor-flyover",
+          "label": "cursor-flyover",
+          "description": "整页俯瞰后，相机依次飞到四个功能区 zoom-in 特写，SVG 光标先一步到位指点、点击留下涟漪并触发界面响应，最后拉回俯瞰",
+          "demo": "demos/camera/cursor-flyover/CursorFlyover.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/cursor-flyover.mp4?v=1790980736795"
+        }
+      ]
+    },
+    {
+      "id": "dataviz-landscape-open",
+      "category": "opening",
+      "summary": "暗场支流线束地景开场——多条流线汇入主干、虚构 ID 标签浮在线上、相机重景深低速飞越",
+      "use": "品牌级抽象开场（\"数据宇宙\"隐喻），接亮场产品段或字标；与 glow-flyline-moves 分工：那卡是段落内卡片之间的连线叙事，本卡是开场专用的全画幅地景",
+      "duration": "5–8s（开场氛围段，一支片 ≤1 次；demo 180f）",
+      "energy": "低开缓升（起步位，为后续爬升留空间）",
+      "source": "references/shots/opening/dataviz-landscape-open.md",
+      "styles": [
+        {
+          "key": "dataviz-landscape-open",
+          "label": "dataviz-landscape-open",
+          "description": "暗场支流线束地景开场——多条流线汇入主干、虚构 ID 标签浮在线上、相机重景深低速飞越",
+          "demo": "demos/opening/dataviz-landscape-open/DatavizLandscapeOpen.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/dataviz-landscape-open.mp4?v=1790980736796"
+        }
+      ]
+    },
+    {
+      "id": "deck-deal-flyin",
+      "category": "ui-entrance",
+      "summary": "暗色石墨桌面上的实体牌堆特写环绕开局，灯从牌堆亮到旁边的页面板，一摞卡像发牌一样硬加速甩进网格，相机追着发牌升起后仰、落在整块满板的跑道式俯瞰上定格",
+      "use": "展示\"内容量大/源源不断汇入\"的列表页与卡片墙；建立信息密度的第一印象",
+      "duration": "150f（约 5s：0–36 牌堆特写 + 预备，36–~101 发牌，108–150 满板 hold）",
+      "energy": "高（节奏爬升段主力，不放开场第一镜）",
+      "source": "references/shots/ui-entrance/deck-deal-flyin.md",
+      "styles": [
+        {
+          "key": "deck-deal-flyin",
+          "label": "deck-deal-flyin",
+          "description": "暗色石墨桌面上的实体牌堆特写环绕开局，灯从牌堆亮到旁边的页面板，一摞卡像发牌一样硬加速甩进网格，相机追着发牌升起后仰、落在整块满板的跑道式俯瞰上定格",
+          "demo": "demos/ui-entrance/deck-deal-flyin/DeckDealFlyin.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/deck-deal-flyin.mp4?v=1790980736797"
+        }
+      ]
+    },
+    {
+      "id": "depth-layer-moves",
+      "category": "camera",
+      "summary": "分层深度运镜——多层视差滑轨：3 层速度梯度横移出纵深，滑轨落定时主角浮起",
+      "use": "平面截图要\"有厚度\"的段落：卡组 / 列表 / 整页的横向巡览",
+      "duration": "4–5.5s 持续（demo 165f）",
+      "energy": "中（质感型）",
+      "source": "references/shots/camera/depth-layer-moves.md",
+      "styles": [
+        {
+          "key": "multiplane",
+          "label": "multiplane",
+          "description": "分层深度运镜——多层视差滑轨：3 层速度梯度横移出纵深，滑轨落定时主角浮起",
+          "demo": "demos/camera/depth-layer-moves/MultiplaneReal.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/multiplane.mp4?v=1790980736798"
+        }
+      ]
+    },
+    {
+      "id": "doc-park-left-pill-deal",
+      "category": "ui-entrance",
+      "summary": "文档不淡出而是向左滑出只露约 35% 宽并微缩到 0.92，右侧按旁白节奏慢速发牌三张白底描边药丸（outBack 弹入），每张落定后其下方字幕逐词加深、下一张到来前整句淡出，左侧文档全程极缓慢自动滚动保持\"正在被读\"",
+      "use": "旁白驱动的\"分析结论逐条给出\"段落；文档理解、推荐理由、审阅意见类产品的核心说明镜头",
+      "duration": "约 5.8s（174f@30fps）",
+      "energy": "低（慢发牌节奏，全片无峰值；靠自动滚动维持活性）",
+      "source": "references/shots/ui-entrance/doc-park-left-pill-deal.md",
+      "styles": [
+        {
+          "key": "doc-park-left-pill-deal",
+          "label": "doc-park-left-pill-deal",
+          "description": "文档不淡出而是向左滑出只露约 35% 宽并微缩到 0.92，右侧按旁白节奏慢速发牌三张白底描边药丸（outBack 弹入），每张落定后其下方字幕逐词加深、下一张到来前整句淡出，左侧文档全程极缓慢自动滚动保持\"正在被读\"",
+          "demo": "demos/ui-entrance/doc-park-left-pill-deal/DocParkLeftPillDeal.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/doc-park-left-pill-deal.mp4?v=1790980736799"
+        }
+      ]
+    },
+    {
+      "id": "document-typewriter-reveal",
+      "category": "typography",
+      "summary": "悬浮在暗场里的整页真排版文档窗口在光标后自己\"写\"出来、侧栏跟进、历史条目逐个落入轨道，相机从斜侧标题特写一路后撤到全窗",
+      "use": "文档/报告/笔记类功能镜头；信息密度最高的一拍",
+      "duration": "150f（约 5s，含 history-list-stack 尾段与标语 hold）",
+      "energy": "低中（信息密度最高，节奏放稳让观众读字）",
+      "source": "references/shots/typography/document-typewriter-reveal.md",
+      "styles": [
+        {
+          "key": "document-typewriter-reveal",
+          "label": "document-typewriter-reveal",
+          "description": "悬浮在暗场里的整页真排版文档窗口在光标后自己\"写\"出来、侧栏跟进、历史条目逐个落入轨道，相机从斜侧标题特写一路后撤到全窗",
+          "demo": "demos/ui-entrance/document-typewriter-reveal/DocumentTypewriterReveal.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/document-typewriter-reveal.mp4?v=1790980736800"
+        }
+      ]
+    },
+    {
+      "id": "draw-svg-trace",
+      "category": "ui-entrance",
+      "summary": "描边生长圈注——一条带笔头的墨线沿元素轮廓跑一圈把它\"画\"出来，闭合瞬间闪黑交棒、内容淡入；同套路可给标题画下划线",
+      "use": "单个卡片/图表/标题的被点名入场；元素级手法（整页级蓝图描线归 wall-reveal-moves B 式）",
+      "duration": "132f（预告 10f + 描边 40f + 闪黑交棒 16f + 下划线 18f + hold 40f，约 4.4s）",
+      "energy": "中",
+      "source": "references/shots/ui-entrance/draw-svg-trace.md",
+      "styles": [
+        {
+          "key": "draw-svg-trace",
+          "label": "draw-svg-trace",
+          "description": "描边生长圈注——一条带笔头的墨线沿元素轮廓跑一圈把它\"画\"出来，闭合瞬间闪黑交棒、内容淡入；同套路可给标题画下划线",
+          "demo": "demos/ui-entrance/draw-svg-trace/DrawSvgTrace.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/draw-svg-trace.mp4?v=1790980736801"
+        }
+      ]
+    },
+    {
+      "id": "element-body-moves",
+      "category": "ui-entrance",
+      "summary": "元素身体感——contact-shadow-lift 接触阴影离面抬升：卡抬起时桌上的阴影同步放大变淡，纸片离桌被阴影证明",
+      "use": "给\"位置在变\"之外补\"身体在变\"：卡片点名给悬浮证据；配 2.5D 运镜与逐张点名",
+      "duration": "A 150f 5s",
+      "energy": "A 低中",
+      "source": "references/shots/ui-entrance/element-body-moves.md",
+      "styles": [
+        {
+          "key": "contact-shadow-lift",
+          "label": "contact-shadow-lift",
+          "description": "元素身体感——contact-shadow-lift 接触阴影离面抬升：卡抬起时桌上的阴影同步放大变淡，纸片离桌被阴影证明",
+          "demo": "demos/ui-entrance/element-body-moves/ContactShadowLift.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/contact-shadow-lift.mp4?v=1790980736802"
+        }
+      ]
+    },
+    {
+      "id": "flying-words",
+      "category": "typography",
+      "summary": "22 个关键词按黄金角铺在扁椭圆截面上，沿 z 轴从远处飞到相机前擦身而过，透明度走 [0,1,0.5,0.2,0] 生命曲线，跑满 2 整圈首尾无缝",
+      "use": "关键词云/能力清单的动态背景；片头片尾的\"信息量\"垫底层；需要纵深穿越感的转场",
+      "duration": "约 6.0s（180f@30fps，2 个完整循环，可无缝接续）",
+      "energy": "高（全屏持续 3D 位移，画面无一刻静止）",
+      "source": "references/shots/typography/flying-words.md",
+      "styles": [
+        {
+          "key": "flying-words",
+          "label": "flying-words",
+          "description": "22 个关键词按黄金角铺在扁椭圆截面上，沿 z 轴从远处飞到相机前擦身而过，透明度走 [0,1,0.5,0.2,0] 生命曲线，跑满 2 整圈首尾无缝",
+          "demo": "demos/typography/flying-words/FlyingWords.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/flying-words.mp4?v=1790980736803"
+        }
+      ]
+    },
+    {
+      "id": "fracture",
+      "category": "opening",
+      "summary": "5×5 瓦片从 3D 碎片态按中心波纹逐圈聚合成整面海报，停一拍亮字，随后全部碎片背离中心加速旋转飞出画面",
+      "use": "开场第一镜\"从混沌到成形\"的品牌/海报揭示；倒放或只取后半可作硬转场",
+      "duration": "约 5.2s（156f@30fps；聚合 0–2.6s · hold 1s · 飞散 1.5s）",
+      "energy": "高（两头高能、中段静止，适合压 BGM 重音起收）",
+      "source": "references/shots/opening/fracture.md",
+      "styles": [
+        {
+          "key": "fracture",
+          "label": "fracture",
+          "description": "5×5 瓦片从 3D 碎片态按中心波纹逐圈聚合成整面海报，停一拍亮字，随后全部碎片背离中心加速旋转飞出画面",
+          "demo": "demos/opening/fracture/Fracture.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/fracture.mp4?v=1790980736804"
+        }
+      ]
+    },
+    {
+      "id": "fui-hud-moves",
+      "category": "effects",
+      "summary": "FUI/HUD 准星咬合——reticle-lock-on 四个 L 形角标组成的取景框从画外飞入、超调回弹后咬合锁定目标",
+      "use": "任何\"看这里\"的目标点名（替代箭头圈红，画面不冻结）",
+      "duration": "2–3s（demo 90f）",
+      "energy": "中高（咬合帧是打击点）",
+      "source": "references/shots/effects/fui-hud-moves.md",
+      "styles": [
+        {
+          "key": "reticle-lock-on",
+          "label": "reticle-lock-on",
+          "description": "FUI/HUD 准星咬合——reticle-lock-on 四个 L 形角标组成的取景框从画外飞入、超调回弹后咬合锁定目标",
+          "demo": "demos/effects/fui-hud-moves/ReticleLockOn.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/reticle-lock-on.mp4?v=1790980736805"
+        }
+      ]
+    },
+    {
+      "id": "gauge-readout-moves",
+      "category": "data",
+      "summary": "仪表读数两式——needle-sweep-selftest 满弧扫针（点火自检指针甩满全弧再回落真值）与 tape-scroll-fixed-pointer 滚带定针（针不动刻度带滚过+冲刺刹车）",
+      "use": "dashboard 开场仪式/性能指标揭晓；A 多表盘开机感，B 单指标大跳变",
+      "duration": "A 140f（4.7s）/ B 150f（5s）",
+      "energy": "中高（机械仪式型）",
+      "source": "references/shots/data/gauge-readout-moves.md",
+      "styles": [
+        {
+          "key": "needle-sweep-selftest",
+          "label": "needle-sweep-selftest",
+          "description": "指针去程 ~12f ease-out 甩满弧，回程 ~20f 带 5-8° 过冲回摆落真值；多表错峰 3-5f；落定同帧盘下数值弹出",
+          "demo": "demos/data/gauge-readout-moves/NeedleSweepSelftest.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/needle-sweep-selftest.mp4?v=1790980736806"
+        },
+        {
+          "key": "tape-scroll-fixed-pointer",
+          "label": "tape-scroll-fixed-pointer",
+          "description": "长刻度带 translate：慢爬段→45px/f 冲刺 ~25f→spring 刹车过冲回摆停位；窗内读数同步刷新",
+          "demo": "demos/data/gauge-readout-moves/TapeScrollFixedPointer.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/tape-scroll-fixed-pointer.mp4?v=1790980736807"
+        }
+      ]
+    },
+    {
+      "id": "glass-pill-dictation-typing",
+      "category": "interaction",
+      "summary": "一条定宽玻璃胶囊以约 1.25 倍略大弹出后缓落到位，内部自左淡到右浓铺一层强调色暖光；光标先行、随后匀速打出听写句，光（连同胶囊背后的环境光）随打字进度渐渐退去，收尾成一条中性的磨砂玻璃条",
+      "use": "语音/AI 输入框的登场；\"跟它说话\"的交互提示镜头；高能段之间的一个安静过渡拍",
+      "duration": "约3.3s（100f@30fps）",
+      "energy": "低（全片最安静的一拍，只有光在退）",
+      "source": "references/shots/interaction/glass-pill-dictation-typing.md",
+      "styles": [
+        {
+          "key": "glass-pill-dictation-typing",
+          "label": "glass-pill-dictation-typing",
+          "description": "一条定宽玻璃胶囊以约 1.25 倍略大弹出后缓落到位，内部自左淡到右浓铺一层强调色暖光；光标先行、随后匀速打出听写句，光（连同胶囊背后的环境光）随打字进度渐渐退去，收尾成一条中性的磨砂玻璃条",
+          "demo": "demos/interaction/glass-pill-dictation-typing/GlassPillDictationTyping.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/glass-pill-dictation-typing.mp4?v=1790980736808"
+        }
+      ]
+    },
+    {
+      "id": "glitch-cycle",
+      "category": "typography",
+      "summary": "同一行等宽槽位循环轮播 4 条状态短语，每条头尾按概率关键帧 [1,0,0,0.1,0,0,1] 全乱码、中段偶发单字抖动，切换瞬间叠 RGB 分离与整行位移；末条概率收 0 保证收尾干净",
+      "use": "加载/构建/部署过程的状态播报；技术型片头的\"系统自述\"；需要机器口吻推进时间的一段垫底",
+      "duration": "约 5.6s（168f@30fps；demo 每条短语 38f，末条延续到片尾作收尾 hold）",
+      "energy": "中高（持续的高频噪声脉冲，切换点是峰值）",
+      "source": "references/shots/typography/glitch-cycle.md",
+      "styles": [
+        {
+          "key": "glitch-cycle",
+          "label": "glitch-cycle",
+          "description": "同一行等宽槽位循环轮播 4 条状态短语，每条头尾按概率关键帧 [1,0,0,0.1,0,0,1] 全乱码、中段偶发单字抖动，切换瞬间叠 RGB 分离与整行位移；末条概率收 0 保证收尾干净",
+          "demo": "demos/typography/glitch-cycle/GlitchCycle.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/glitch-cycle.mp4?v=1790980736809"
+        }
+      ]
+    },
+    {
+      "id": "glow-flyline-moves",
+      "category": "effects",
+      "summary": "暗场光斑与飞线三式——glow-orb-ambient 光斑底噪、flyline-arc 飞线连接、orb-flyline-relay 同帧共振组合",
+      "use": "全片唯一暗场段落的氛围与数据叙事：铺底噪用 A、讲数据流向用 B、要背景给前景搭腔用 C；Linear 官网味",
+      "duration": "A 170f（~5.7s）/ B 140f（~4.7s）/ C 165f（5.5s）",
+      "energy": "A 低（底噪级）/ B 中 / C 中高",
+      "source": "references/shots/effects/glow-flyline-moves.md",
+      "styles": [
+        {
+          "key": "glow-orb-ambient",
+          "label": "glow-orb-ambient",
+          "description": "三团 500-700px radial 光斑 + blur(100px)，双正弦漂移；卡缘辉光按光斑距离 [180,720]px→[1,0] 加权取 max 驱动",
+          "demo": "demos/effects/glow-flyline-moves/GlowOrbAmbient.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/glow-orb-ambient.mp4?v=1790980736810"
+        },
+        {
+          "key": "flyline-arc",
+          "label": "flyline-arc",
+          "description": "手写 bezier 100 段采样，22f out-cubic 生长；光头条件挂载领跑，段 opacity 按离头距离渐隐；落点描边脉冲，可接力",
+          "demo": "demos/effects/glow-flyline-moves/FlylineArc.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/flyline-arc.mp4?v=1790980736811"
+        },
+        {
+          "key": "orb-flyline-relay",
+          "label": "orb-flyline-relay",
+          "description": "A+B 焊接：光斑 surge 与卡脉冲共用落点帧，涨亮 1+1.6×surge、5f 起升 15f 消散",
+          "demo": "demos/effects/glow-flyline-moves/OrbFlylineRelay.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/orb-flyline-relay.mp4?v=1790980736812"
+        }
+      ]
+    },
+    {
+      "id": "gradient-transition",
+      "category": "transition",
+      "summary": "背景在 linear、radial、conic 三类 CSS 渐变间平滑过渡——角度、色标、中心、半径逐参数插值，段间交叉淡化换类型",
+      "use": "氛围底/章节底色的连续变奏；给静态排版段落提供\"活着\"的背景层",
+      "duration": "约 6.7s（200f@30fps；linear 0–2.3s · radial 1.9–4.4s · conic 3.9–6.7s）",
+      "energy": "低（纯背景运动，为前景内容让路）",
+      "source": "references/shots/transition/gradient-transition.md",
+      "styles": [
+        {
+          "key": "gradient-transition",
+          "label": "gradient-transition",
+          "description": "背景在 linear、radial、conic 三类 CSS 渐变间平滑过渡——角度、色标、中心、半径逐参数插值，段间交叉淡化换类型",
+          "demo": "demos/transition/gradient-transition/GradientTransition.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/gradient-transition.mp4?v=1790980736813"
+        }
+      ]
+    },
+    {
+      "id": "gradient-word-sweep",
+      "category": "typography",
+      "summary": "黑底标语里关键词被渐变彩光从左到右快速扫过\"充能\"——波前字符辉光最强向后衰减，填满后字符间勾连细紫红闪电、整词稳态泛光呼吸",
+      "use": "标语里给单个动词/卖点词充能（Supercharged/faster/AI…）；能量高潮段的文字戏；黑场品牌片的口号帧",
+      "duration": "扫充 ~15–20f（要快）+ 稳态闪电呼吸 1–2s；全段 2.5–3.5s",
+      "energy": "高（一词爆点，前后都该让位）",
+      "source": "references/shots/typography/gradient-word-sweep.md",
+      "styles": [
+        {
+          "key": "gradient-word-sweep",
+          "label": "gradient-word-sweep",
+          "description": "黑底标语里关键词被渐变彩光从左到右快速扫过\"充能\"——波前字符辉光最强向后衰减，填满后字符间勾连细紫红闪电、整词稳态泛光呼吸",
+          "demo": "demos/typography/gradient-word-sweep/GradientWordSweep.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/gradient-word-sweep.mp4?v=1790980736814"
+        }
+      ]
+    },
+    {
+      "id": "grain-dissolve",
+      "category": "outro",
+      "summary": "整行字爆裂成沸腾颗粒噪点并浮现斜纹选区框，噪点云急速凝聚成更大号发光短字标，位移衰减归零定格",
+      "use": "收尾\"XX. Now Live\"式上线宣告；长句信息压缩成品牌短标的能量聚合拍",
+      "duration": "约 2.0s（60f@30fps；砂化 0.26–0.56s · 凝聚 1.2–1.42s · 凝固回落收尾）",
+      "energy": "中高（短促、一次性的能量脉冲，天然的 outro 卡点）",
+      "source": "references/shots/outro/grain-dissolve.md",
+      "styles": [
+        {
+          "key": "grain-dissolve",
+          "label": "grain-dissolve",
+          "description": "整行字爆裂成沸腾颗粒噪点并浮现斜纹选区框，噪点云急速凝聚成更大号发光短字标，位移衰减归零定格",
+          "demo": "demos/outro/grain-dissolve/GrainDissolve.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/grain-dissolve.mp4?v=1790980736815"
+        }
+      ]
+    },
+    {
+      "id": "graze-face-tour",
+      "category": "camera",
+      "summary": "大倾角贴面游走特写——镜头贴着 UI 表面低飞掠过（侧栏树/顶栏/列表当地形），页面文字初始悬浮在界面上空带同形软影，随镜头行进先后加速贴落回界面",
+      "use": "功能区巡礼（把 UI 当地景飞掠）；配合暗场+霓虹缘光做产品\"内部世界\"段落；界面内容逐区登场",
+      "duration": "单段 4–5s；可多段接力延长",
+      "energy": "中高（运镜持续推进+元素连续落位，信息密度高）",
+      "source": "references/shots/camera/graze-face-tour.md",
+      "styles": [
+        {
+          "key": "graze-face-tour",
+          "label": "graze-face-tour",
+          "description": "大倾角贴面游走特写——镜头贴着 UI 表面低飞掠过（侧栏树/顶栏/列表当地形），页面文字初始悬浮在界面上空带同形软影，随镜头行进先后加速贴落回界面",
+          "demo": "demos/camera/graze-face-tour/GrazeFaceTour.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/graze-face-tour.mp4?v=1790980736816"
+        }
+      ]
+    },
+    {
+      "id": "hashtag-to-pill-materialize",
+      "category": "interaction",
+      "summary": "话题词打字实体化——居中打出 \"#word\"（红实心光标恒亮），1 帧硬切变成宽大胶囊标签，hold 后缩小左移落到页面标签位，再 1 帧硬切揭示成品页；\"两次硬切一次滑动\"的节奏骨架",
+      "use": "标签/分类/关键词功能的演示段（笔记 app 打 tag、话题聚合）；\"输入 → 变成 UI 实体 → 归位到成品\"的三段式叙事",
+      "duration": "120f（4s）——打字 ~40f + 硬切胶囊 hold ~18f + 缩移 ~14f + 硬切揭示后静置 ~1.2s（原片 18–21.5s）",
+      "energy": "中（干脆利落，靠硬切给劲，不靠弹跳）",
+      "source": "references/shots/interaction/hashtag-to-pill-materialize.md",
+      "styles": [
+        {
+          "key": "hashtag-to-pill-materialize",
+          "label": "hashtag-to-pill-materialize",
+          "description": "话题词打字实体化——居中打出 \"#word\"（红实心光标恒亮），1 帧硬切变成宽大胶囊标签，hold 后缩小左移落到页面标签位，再 1 帧硬切揭示成品页；\"两次硬切一次滑动\"的节奏骨架",
+          "demo": "demos/interaction/hashtag-to-pill-materialize/HashtagToPillMaterialize.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/hashtag-to-pill-materialize.mp4?v=1790980736817"
+        }
+      ]
+    },
+    {
+      "id": "icon-field-colorize",
+      "category": "opening",
+      "summary": "灰阶小图标点阵错峰浮现铺满全屏，停一拍后多道品牌色横带波纹极快向下扫翻全场——\"功能全景先摆满，品牌一瞬间点亮\"的开场/收束卡",
+      "use": "开场铺陈产品能力面（图标=功能宇宙）再一举打上品牌色；功能集合页、生态/集成规模展示、片头 logo 前垫场",
+      "duration": "浮现 ~45f 错峰 + 静置 ~10f + 翻色 12–45f + 终态静置；全段 3–6s（demo 170f：翻色走 30f 档 + 标题落版 + 终态 hold 1s）",
+      "energy": "中（浮现是铺垫，翻色瞬间是唯一爆点）",
+      "source": "references/shots/opening/icon-field-colorize.md",
+      "styles": [
+        {
+          "key": "icon-field-colorize",
+          "label": "icon-field-colorize",
+          "description": "灰阶小图标点阵错峰浮现铺满全屏，停一拍后多道品牌色横带波纹极快向下扫翻全场——\"功能全景先摆满，品牌一瞬间点亮\"的开场/收束卡",
+          "demo": "demos/opening/icon-field-colorize/IconFieldColorize.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/icon-field-colorize.mp4?v=1790980736818"
+        }
+      ]
+    },
+    {
+      "id": "icon-performance-moves",
+      "category": "effects",
+      "summary": "图标表演——attention-bounce 求关注弹跳（图标连跳递增+落地压扁+镜头被吸引）",
+      "use": "半屏级 icon 特写段落；新功能引出",
+      "duration": "156f（5.2s）",
+      "energy": "蓄势引入",
+      "source": "references/shots/effects/icon-performance-moves.md",
+      "styles": [
+        {
+          "key": "attention-bounce",
+          "label": "attention-bounce",
+          "description": "图标表演——attention-bounce 求关注弹跳（图标连跳递增+落地压扁+镜头被吸引）",
+          "demo": "demos/effects/icon-performance-moves/AttentionBounce.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/attention-bounce.mp4?v=1790980736819"
+        }
+      ]
+    },
+    {
+      "id": "impact-feedback",
+      "category": "effects",
+      "summary": "命中反馈两式——hit-counter 连招计数（顿帧+伤害数字+combo 跳字）、anime-impact 动漫打击帧（负片+集中线+色散）",
+      "use": "元素落位/撞击的\"命中一瞬\"——给砸入、撞停加游戏级手感；按强度阶梯选式",
+      "duration": "n/a（元素级技法，寄生在落位动作上；各式占用帧数见参数表）",
+      "energy": "高（瞬时冲击）",
+      "source": "references/shots/effects/impact-feedback.md",
+      "styles": [
+        {
+          "key": "hit-counter",
+          "label": "hit-counter 连招计数",
+          "description": "三卡接连砸入，每命中 = 顿帧 2f + 伤害数字上浮 + ×N 计数跳字逐次加码",
+          "demo": "demos/effects/impact-feedback/HitCounter.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/hit-counter.mp4?v=1790980736820"
+        },
+        {
+          "key": "anime-impact",
+          "label": "anime-impact 打击帧",
+          "description": "crash-zoom 撞停的 3f 整幅负片反色 + 放射集中线 + 红青色散，第 4f 全撤",
+          "demo": "demos/effects/impact-feedback/AnimeImpact.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/anime-impact.mp4?v=1790980736821"
+        }
+      ]
+    },
+    {
+      "id": "integration-hub-map",
+      "category": "ui-entrance",
+      "summary": "旧页面一次性快翻 180°（侧棱瞬间亮闪）落成新中枢页，五个集成 app 图标同帧弹现、随即五条彩虹光管同帧齐连，光管内输送脉冲持续流动——\"翻开新一页，生态一齐接入\"",
+      "use": "集成/生态能力段（一个产品连一切）；版本翻新叙事（旧页翻成新页）；暗场霓虹调性的功能高潮",
+      "duration": "前摇 ~0.5s + 快翻 ~1.2s + 图标齐现 → 光管齐连两拍 ~0.7s + 输送呼吸 ≥1.5s；全段 4.5–5s",
+      "energy": "中高（翻面是爆点，输送段是余韵）",
+      "source": "references/shots/ui-entrance/integration-hub-map.md",
+      "styles": [
+        {
+          "key": "integration-hub-map",
+          "label": "integration-hub-map",
+          "description": "旧页面一次性快翻 180°（侧棱瞬间亮闪）落成新中枢页，五个集成 app 图标同帧弹现、随即五条彩虹光管同帧齐连，光管内输送脉冲持续流动——\"翻开新一页，生态一齐接入\"",
+          "demo": "demos/ui-entrance/integration-hub-map/IntegrationHubMap.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/integration-hub-map.mp4?v=1790980736822"
+        }
+      ]
+    },
+    {
+      "id": "lead-word-zoom-assemble",
+      "category": "typography",
+      "summary": "首词以 2.3 倍字号占据画面中央、hold 期间继续推近 6%，随后一条曲线同时完成「缩回终字号」与「整行左滑归位」，后续词各自从槽位右侧 0.5em 被推进来；支点横向钉首词中心、纵向钉基线（挂载时实测），整行上移的同一时窗副行浮出，停一拍后整幕 crash-zoom 推近失焦交棒",
+      "use": "品牌名/产品名的 Introducing 字卡；发布会式开场第二镜；一句话主张需要\"先让一个词占满画面、再把整句补齐\"的场合",
+      "duration": "约 2.8s（84f@30fps；组句 f36 完成、上移与副行 f32–46、静止 26f、末 12f crash）",
+      "energy": "中高（起手就是满画面的大字，但全程只有一次运动，没有二次冲击）",
+      "source": "references/shots/typography/lead-word-zoom-assemble.md",
+      "styles": [
+        {
+          "key": "lead-word-zoom-assemble",
+          "label": "lead-word-zoom-assemble",
+          "description": "首词以 2.3 倍字号占据画面中央、hold 期间继续推近 6%，随后一条曲线同时完成「缩回终字号」与「整行左滑归位」，后续词各自从槽位右侧 0.5em 被推进来；支点横向钉首词中心、纵向钉基线（挂载时实测），整行上移的同一时窗副行浮出，停一拍后整幕 crash-zoom 推近失焦交棒",
+          "demo": "demos/typography/lead-word-zoom-assemble/LeadWordZoomAssemble.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/lead-word-zoom-assemble.mp4?v=1790980736823"
+        }
+      ]
+    },
+    {
+      "id": "letterspace-materialize",
+      "category": "opening",
+      "summary": "大字距字标全字符并行连续描画结晶——所有字母同帧起笔、笔画像手写一样连续生长、同帧齐收成词；氛围底景上的品牌字标显影",
+      "use": "片尾/片头品牌字标登场（大字距细骨架字标；demo 为 video-shotcraft 全小写）；章节题字；needs 静谧/高级感的收束帧",
+      "duration": "静置 ~15f + 描画 ~50f + 终态静置 ≥30f；全段 3–4s",
+      "energy": "低（静谧仪式感，一次呼吸完成）",
+      "source": "references/shots/opening/letterspace-materialize.md",
+      "styles": [
+        {
+          "key": "letterspace-materialize",
+          "label": "letterspace-materialize",
+          "description": "大字距字标全字符并行连续描画结晶——所有字母同帧起笔、笔画像手写一样连续生长、同帧齐收成词；氛围底景上的品牌字标显影",
+          "demo": "demos/opening/letterspace-materialize/LetterspaceMaterialize.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/letterspace-materialize.mp4?v=1790980736824"
+        }
+      ]
+    },
+    {
+      "id": "light-play-moves",
+      "category": "effects",
+      "summary": "光效两式——spotlight-sweep 聚光扫字、sheen 单点扫光",
+      "use": "把光当另一种笔触（扫/擦）：暗场标题揭示（A）、主角卡加冕（B）",
+      "duration": "A 170f ~5.7s / B 150f ~5s",
+      "energy": "A 中 / B 低",
+      "source": "references/shots/effects/light-play-moves.md",
+      "styles": [
+        {
+          "key": "spotlight-sweep",
+          "label": "spotlight-sweep",
+          "description": "双层同文本：暗版 0.07 常驻，亮版 radial mask 随光斑走，锥形光摆两个来回后全亮定格",
+          "demo": "demos/effects/light-play-moves/SpotlightSweepReveal.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/spotlight-sweep.mp4?v=1790980736825"
+        },
+        {
+          "key": "sheen-sweep",
+          "label": "sheen-sweep",
+          "description": "深墨卡上 45° 高光带 translateX 扫一次，overflow hidden 圆角裁剪",
+          "demo": "demos/effects/light-play-moves/SheenSweepRetry.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/sheen-sweep.mp4?v=1790980736826"
+        }
+      ]
+    },
+    {
+      "id": "line-carry-transition",
+      "category": "transition",
+      "summary": "线条接力横移转场——场景 A 的进度条延伸出画，镜头跟线横移，线在移动中拐角围出场景 B 的卡框，全程无剪切",
+      "use": "两个有图形亲缘的场景之间（进度条→卡框、下划线→图表轴）；一支片子的招牌转场位，Catch Me If You Can 片头的图形接力",
+      "duration": "~6.3s / 190f（进度条走满 36f + 冲出 10f + 横移 56f + 收框 24f + 框内海报 30f + 静止 24f）",
+      "energy": "中",
+      "source": "references/shots/transition/line-carry-transition.md",
+      "styles": [
+        {
+          "key": "line-carry-transition",
+          "label": "line-carry-transition",
+          "description": "线条接力横移转场——场景 A 的进度条延伸出画，镜头跟线横移，线在移动中拐角围出场景 B 的卡框，全程无剪切",
+          "demo": "demos/transition/line-carry-transition/LineCarryTransition.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/line-carry-transition.mp4?v=1790980736827"
+        }
+      ]
+    },
+    {
+      "id": "list-reveal",
+      "category": "ui-entrance",
+      "summary": "垂直菜单 6 项按 10f 的间隔依次 scale 找位、软 back 轻微过冲落定，同时整个列表容器全程匀速上移——逐项入场与整体漂移是两层不相干的运动",
+      "use": "导航/侧边栏/设置面板的入场；任何\"界面自己长出来\"的 UI 段落，也适合做旁白铺垫时的低能量底",
+      "duration": "约 4s（120f@30fps）",
+      "energy": "低（稳定节拍，无峰值；靠漂移维持画面不死）",
+      "source": "references/shots/ui-entrance/list-reveal.md",
+      "styles": [
+        {
+          "key": "list-reveal",
+          "label": "list-reveal",
+          "description": "垂直菜单 6 项按 10f 的间隔依次 scale 找位、软 back 轻微过冲落定，同时整个列表容器全程匀速上移——逐项入场与整体漂移是两层不相干的运动",
+          "demo": "demos/ui-entrance/list-reveal/ListReveal.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/list-reveal.mp4?v=1790980736828"
+        }
+      ]
+    },
+    {
+      "id": "list-stack-press",
+      "category": "ui-entrance",
+      "summary": "列表卡从画面底部逐张飞上摞起，每张落地压弹整摞、计数器同步跳一格",
+      "use": "feed/雷达/收件箱类\"每天有新东西\"的镜头；强调持续积累的资产列表",
+      "duration": "约 3s（18–88f）",
+      "energy": "中",
+      "source": "references/shots/ui-entrance/list-stack-press.md",
+      "styles": [
+        {
+          "key": "list-stack-press",
+          "label": "list-stack-press",
+          "description": "列表卡从画面底部逐张飞上摞起，每张落地压弹整摞、计数器同步跳一格",
+          "demo": "demos/ui-entrance/list-stack-press/ListStackPress.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/list-stack-press.mp4?v=1790980736829"
+        }
+      ]
+    },
+    {
+      "id": "logo-shrink-wordmark-lockup",
+      "category": "outro",
+      "summary": "霓虹切口大环快速收束成中央实心小白 O、过冲刹车时换成 video-shotcraft 标志，图标左移让位，字标字母逐个滑入完成 lockup，强调色标语收尾",
+      "use": "片尾品牌定妆：从满屏图形能量收束到\"图标+字标+标语\"的标准 lockup",
+      "duration": "约 4.4s（132f@30fps；收束 0.1–1.2s · 让位 1.5–2.1s · 字母 2–2.7s · 标语 3.2–3.7s）",
+      "energy": "中（收束段有冲击力，整体是沉稳的落定节奏）",
+      "source": "references/shots/outro/logo-shrink-wordmark-lockup.md",
+      "styles": [
+        {
+          "key": "logo-shrink-wordmark-lockup",
+          "label": "logo-shrink-wordmark-lockup",
+          "description": "霓虹切口大环快速收束成中央实心小白 O、过冲刹车时换成 video-shotcraft 标志，图标左移让位，字标字母逐个滑入完成 lockup，强调色标语收尾",
+          "demo": "demos/outro/logo-shrink-wordmark-lockup/LogoShrinkWordmarkLockup.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/logo-shrink-wordmark-lockup.mp4?v=1790980736830"
+        }
+      ]
+    },
+    {
+      "id": "magician-card-flourish",
+      "category": "opening",
+      "summary": "午夜蓝暗场上蓝色星芒闪现 0.3s（X 形针状光束旋转 90°+中心辉光放射小光芒），卡片从闪光点弹射而出——极速自旋弧线飞向镜头、自旋随靠近衰减、瞬间硬定格（卡高 86% 画高）、光脉冲 + sheen 扫光，右侧文案随后逐行揭示",
+      "use": "单张卡片/海报/封面的魔术性登场（片头主视觉、产品卡揭晓）；纯黑暗场；需要\"变出来\"仪式感的爆点",
+      "duration": "156f（闪光 0.3s + 飞行 1.6s + 定格/扫光/文案揭示 + hold 3.3s；全段 5.2s）",
+      "energy": "高（一次性爆点，定格后即静）",
+      "source": "references/shots/opening/magician-card-flourish.md",
+      "styles": [
+        {
+          "key": "magician-card-flourish",
+          "label": "magician-card-flourish",
+          "description": "午夜蓝暗场上蓝色星芒闪现 0.3s（X 形针状光束旋转 90°+中心辉光放射小光芒），卡片从闪光点弹射而出——极速自旋弧线飞向镜头、自旋随靠近衰减、瞬间硬定格（卡高 86% 画高）、光脉冲 + sheen 扫光，右侧文案随后逐行揭示",
+          "demo": "demos/opening/magician-card-flourish/MagicianCardFlourish.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/magician-card-flourish.mp4?v=1790980736831"
+        }
+      ]
+    },
+    {
+      "id": "marker-underline-title",
+      "category": "typography",
+      "summary": "大标题落定后，关键词下方马克笔下划线从左到右快速描画——变宽笔形、毛糙边缘、微上斜跟随斜体字势，贴着字底",
+      "use": "标题里强调单个关键词（new/free/AI…）；手写感/人味的品牌调性；正文标注式强调",
+      "duration": "标题落定 +4~8f 后起笔，划线 8–12f，总 1–1.5s",
+      "energy": "低（一笔点睛，不抢标题的戏）",
+      "source": "references/shots/typography/marker-underline-title.md",
+      "styles": [
+        {
+          "key": "marker-underline-title",
+          "label": "marker-underline-title",
+          "description": "大标题落定后，关键词下方马克笔下划线从左到右快速描画——变宽笔形、毛糙边缘、微上斜跟随斜体字势，贴着字底",
+          "demo": "demos/typography/marker-underline-title/MarkerUnderlineTitle.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/marker-underline-title.mp4?v=1790980736832"
+        }
+      ]
+    },
+    {
+      "id": "mosaic-reframe",
+      "category": "transition",
+      "summary": "12 张瓦片在规则网格、feature mosaic、对角瀑布串三种排版间连续变形，位置宽高各自插值、逐片微错峰，段间留 hold",
+      "use": "\"同一批内容多种看法\"的陈列转场：作品集/模板库/相册产品的布局能力展示",
+      "duration": "约 7.1s（214f@30fps；浮现 0–22f · hold A · A→B 56–92f · hold B · B→C 132–176f · hold C 至 214f）",
+      "energy": "中（连续流动的重排，无爆点，气质从容）",
+      "source": "references/shots/transition/mosaic-reframe.md",
+      "styles": [
+        {
+          "key": "mosaic-reframe",
+          "label": "mosaic-reframe",
+          "description": "12 张瓦片在规则网格、feature mosaic、对角瀑布串三种排版间连续变形，位置宽高各自插值、逐片微错峰，段间留 hold",
+          "demo": "demos/transition/mosaic-reframe/MosaicReframe.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/mosaic-reframe.mp4?v=1790980736833"
+        }
+      ]
+    },
+    {
+      "id": "neon-frame-forerun",
+      "category": "ui-entrance",
+      "summary": "强透视直角霓虹框自左缘两头奔画先行成型，页面在框内由暗转亮，同时框内组件/文字从 3D 上空带同形软影错峰贴落、随页面点亮同步完成贴合，背景霓虹群（demo 为同形框纵深回声隧道）终段熄灭让位",
+      "use": "暗场品牌片里给 UI 面板做\"登场仪式\"（框先到、内容后落）；功能区首次亮相；霓虹/赛博调性的段落开场",
+      "duration": "框奔画 ~0.7s + 点亮&贴落 ~2.7s + 背景熄灭收束 ~1s；全段 4–4.7s（demo 140f）",
+      "energy": "中高（三层动作叠进，但都服务同一次登场）",
+      "source": "references/shots/ui-entrance/neon-frame-forerun.md",
+      "styles": [
+        {
+          "key": "neon-frame-forerun",
+          "label": "neon-frame-forerun",
+          "description": "强透视直角霓虹框自左缘两头奔画先行成型，页面在框内由暗转亮，同时框内组件/文字从 3D 上空带同形软影错峰贴落、随页面点亮同步完成贴合，背景霓虹群（demo 为同形框纵深回声隧道）终段熄灭让位",
+          "demo": "demos/ui-entrance/neon-frame-forerun/NeonFrameForerun.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/neon-frame-forerun.mp4?v=1790980736834"
+        }
+      ]
+    },
+    {
+      "id": "neon-frame-orbit-drop",
+      "category": "ui-entrance",
+      "summary": "霓虹框先行描框后，镜头绕页面左→右弧线旋转，页面全部组件/文字**同帧**从空中往下贴合（同形软影同步收敛）——整体登场式的框内安放",
+      "use": "单页 UI 的一次性隆重登场（与巡礼/逐区亮相相对）；暗场霓虹调性段落的主视觉揭幕；neon-frame-forerun 的姊妹镜",
+      "duration": "描框 ~0.5s + 旋转&同时贴落 ~2.5s + 落定 ~1s；全段 ~4.7s（140f，旋转到 128f 收住后留落定）",
+      "energy": "中高（一次性的大动作，落定即静）",
+      "source": "references/shots/ui-entrance/neon-frame-orbit-drop.md",
+      "styles": [
+        {
+          "key": "neon-frame-orbit-drop",
+          "label": "neon-frame-orbit-drop",
+          "description": "霓虹框先行描框后，镜头绕页面左→右弧线旋转，页面全部组件/文字**同帧**从空中往下贴合（同形软影同步收敛）——整体登场式的框内安放",
+          "demo": "demos/ui-entrance/neon-frame-orbit-drop/NeonFrameForerunOrbit.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/neon-frame-orbit-drop.mp4?v=1790980736835"
+        }
+      ]
+    },
+    {
+      "id": "neon-triple-marquee",
+      "category": "outro",
+      "summary": "三行对向霓虹跑马灯 recap——三连词空心霓虹灯管巨字上中下排满一面斜拍的砖墙，奇偶行反向匀速无限横滚，三行按 1/3 相位轮流点亮，结尾逐行断电",
+      "use": "片尾主题词复读机段落；三连词口号的\"余韵\"拍法；音乐段无旁白铺陈",
+      "duration": "4–5s（demo 150f：18f 逐行点火上电 + 循环体 + 18f 逐行断电 + 8f 熄灯 hold）",
+      "energy": "中高（持续流动 + 逐行脉冲，无瞬时冲击）",
+      "source": "references/shots/outro/neon-triple-marquee.md",
+      "styles": [
+        {
+          "key": "neon-triple-marquee",
+          "label": "neon-triple-marquee",
+          "description": "三行对向霓虹跑马灯 recap——三连词空心霓虹灯管巨字上中下排满一面斜拍的砖墙，奇偶行反向匀速无限横滚，三行按 1/3 相位轮流点亮，结尾逐行断电",
+          "demo": "demos/outro/neon-triple-marquee/NeonTripleMarquee.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/neon-triple-marquee.mp4?v=1790980736836"
+        }
+      ]
+    },
+    {
+      "id": "orbit-ring-title-open",
+      "category": "opening",
+      "summary": "石墨暗场上八张 16:9 暗色内容卡按 45° 均布在 720×380 椭圆上匀速公转（卡身永不倾斜，纵深只由 sin θ 给出 ±12% 缩放、z 序与远处压暗失焦），环撑开期间卡内容冻结首帧、f24 之后八张一起开播；居中两级标题逐字解糊下沉落定，关键词到位那一刻荧光马克块自左横扫铺满、扫过处字反白为墨，mono 副行随后浮出；可选末段整行失焦淡出、环继续转着交棒下一镜",
+      "use": "开场第一镜 = 「这个产品有一整套东西」；素材库/模板库/功能矩阵/案例集的门面拍；需要用真实运动的产品画面托住一句主张，而不是把截图摆成静态九宫格",
+      "duration": "150f（5s@30fps；马克块 f64 落定后 2.9s 稳态巡回 + 极缓推近；开 HANDOFF_EXIT 时 f118 起退场交棒）",
+      "energy": "中（唯一的持续运动是匀速公转，全片只有马克块横扫一次冲击）",
+      "source": "references/shots/opening/orbit-ring-title-open.md",
+      "styles": [
+        {
+          "key": "orbit-ring-title-open",
+          "label": "orbit-ring-title-open",
+          "description": "石墨暗场上八张 16:9 暗色内容卡按 45° 均布在 720×380 椭圆上匀速公转（卡身永不倾斜，纵深只由 sin θ 给出 ±12% 缩放、z 序与远处压暗失焦），环撑开期间卡内容冻结首帧、f24 之后八张一起开播；居中两级标题逐字解糊下沉落定，关键词到位那一刻荧光马克块自左横扫铺满、扫过处字反白为墨，mono 副行随后浮出；可选末段整行失焦淡出、环继续转着交棒下一镜",
+          "demo": "demos/opening/orbit-ring-title-open/OrbitRingTitleOpen.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/orbit-ring-title-open.mp4?v=1790980736837"
+        }
+      ]
+    },
+    {
+      "id": "outline-word-fill",
+      "category": "typography",
+      "summary": "空心词（细暖灰描边、500 字重）从 3.2 倍急缓收缩落位，虚线大圆随后从 2.8 倍收到字周围并缓慢自转，左右水平虚线从画框边缘内伸；描边先微微增亮，实心白热字在一帧内硬切点亮，一闪辉光即定格",
+      "use": "单词式利益点/口号的重锤一拍；节奏卡点上的\"钉子\"镜；深底品牌片的强调帧",
+      "duration": "约 3.0s（90f@30fps，短促单拍 + 36f 落定）",
+      "energy": "高（3.2 倍收缩 + 瞬时点亮，短时高冲击）",
+      "source": "references/shots/typography/outline-word-fill.md",
+      "styles": [
+        {
+          "key": "outline-word-fill",
+          "label": "outline-word-fill",
+          "description": "空心词（细暖灰描边、500 字重）从 3.2 倍急缓收缩落位，虚线大圆随后从 2.8 倍收到字周围并缓慢自转，左右水平虚线从画框边缘内伸；描边先微微增亮，实心白热字在一帧内硬切点亮，一闪辉光即定格",
+          "demo": "demos/typography/outline-word-fill/OutlineWordFill.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/outline-word-fill.mp4?v=1790980736838"
+        }
+      ]
+    },
+    {
+      "id": "outro-group-photo-launch",
+      "category": "outro",
+      "summary": "全片元素从四面八方飞来围住字标合影，crane 落机位+舞台光+金尘做成发布会收场",
+      "use": "outro/品牌收尾；多功能产品的\"全家福\"式终镜",
+      "duration": "约 4.8s（145f）",
+      "energy": "峰值（全片最高点）",
+      "source": "references/shots/outro/outro-group-photo-launch.md",
+      "styles": [
+        {
+          "key": "outro-group-photo-launch",
+          "label": "outro-group-photo-launch",
+          "description": "全片元素从四面八方飞来围住字标合影，crane 落机位+舞台光+金尘做成发布会收场",
+          "demo": "demos/outro/outro-group-photo-launch/OutroGroupPhotoLaunch.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/outro-group-photo-launch.mp4?v=1790980736839"
+        }
+      ]
+    },
+    {
+      "id": "overhead-camera-moves",
+      "category": "camera",
+      "summary": "俯拍揭示两式——tilt-reveal 俯仰抬正揭示、overhead-tabletop-drop 桌面卡阵横滑骤降扎入",
+      "use": "用\"俯仰角\"讲故事的开场/转场：单页 establishing 用 A，多页巡视择一扎入用 B",
+      "duration": "A 120f（4s）/ B 140f（4.7s）",
+      "energy": "A 中 / B 中高",
+      "source": "references/shots/camera/overhead-camera-moves.md",
+      "styles": [
+        {
+          "key": "tilt-reveal",
+          "label": "tilt-reveal",
+          "description": "perspective 容器内整页 rotateX -80° 平躺，~43f 抬正，rotateX/scale/translateY 共用 out-cubic，末端轻过冲",
+          "demo": "demos/camera/overhead-camera-moves/TiltReveal.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/tilt-reveal.mp4?v=1790980736840"
+        },
+        {
+          "key": "overhead-tabletop-drop",
+          "label": "overhead-tabletop-drop",
+          "description": "卡阵平躺 rotateX 62°，pan 段只动 translateX 横滑掠过，drop 段角度/缩放/位移三通道同跑扎入落版",
+          "demo": "demos/camera/overhead-camera-moves/OverheadTabletopDrop.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/overhead-tabletop-drop.mp4?v=1790980736841"
+        }
+      ]
+    },
+    {
+      "id": "page-turn-transitions",
+      "category": "transition",
+      "summary": "整页体块转场——barn-door-split 对开门裂幕（旧页裂两半滑出、新页迎上）",
+      "use": "章节级换页：新旧交替的两个大段落之间的\"翻篇\"仪式；与 shot-transitions 系（镜头交棒）分工——那是\"航拍机移过去\"，这是\"页面自己是实体\"",
+      "duration": "单式 150f（前态建立 30–40f + 转场 24–40f + 跟随与收尾 ≥70f），约 5.0s",
+      "energy": "中高",
+      "source": "references/shots/transition/page-turn-transitions.md",
+      "styles": [
+        {
+          "key": "barn-door-split",
+          "label": "barn-door-split",
+          "description": "整页体块转场——barn-door-split 对开门裂幕（旧页裂两半滑出、新页迎上）",
+          "demo": "demos/transition/page-turn-transitions/BarnDoorSplit.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/barn-door-split.mp4?v=1790980736842"
+        }
+      ]
+    },
+    {
+      "id": "page-waterfall-wall",
+      "category": "ui-entrance",
+      "summary": "页面瀑布墙——真实页面截图切成 3–4 列在 3D 后仰墙面上差速反向无限滚动，视差 + 镜头缓推做\"内容多到流不完\"的一览",
+      "use": "\"多页面/多功能/多模板\"体量感段落；montage 中段铺陈或 intro 后的产品广度镜头",
+      "duration": "4–6s（无限循环体，时长由段落需要裁）",
+      "energy": "中（流动陈列型）",
+      "source": "references/shots/ui-entrance/page-waterfall-wall.md",
+      "styles": [
+        {
+          "key": "page-waterfall-wall",
+          "label": "page-waterfall-wall",
+          "description": "页面瀑布墙——真实页面截图切成 3–4 列在 3D 后仰墙面上差速反向无限滚动，视差 + 镜头缓推做\"内容多到流不完\"的一览",
+          "demo": "demos/ui-entrance/page-waterfall-wall/PageWaterfallWall.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/page-waterfall-wall.mp4?v=1790980736843"
+        }
+      ]
+    },
+    {
+      "id": "panel-grid-moves",
+      "category": "rhythm",
+      "summary": "分格节奏——comic-panel-split 漫画斜格劈出同一主体的三个机位，咔咔咔三格定格后末格斜边吃屏成海报",
+      "use": "把\"格子\"当节奏器：同主体多机位定格并列，逐格踩拍劈出；吃拍点",
+      "duration": "156f ≈5.2s（全屏侧拍 20f + 三刀分格定格 + 吃屏 + 海报 hold）",
+      "energy": "中高",
+      "source": "references/shots/rhythm/panel-grid-moves.md",
+      "styles": [
+        {
+          "key": "comic-panel-split",
+          "label": "comic-panel-split",
+          "description": "分格节奏——comic-panel-split 漫画斜格劈出同一主体的三个机位，咔咔咔三格定格后末格斜边吃屏成海报",
+          "demo": "demos/rhythm/panel-grid-moves/ComicPanelSplit.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/comic-panel-split.mp4?v=1790980736844"
+        }
+      ]
+    },
+    {
+      "id": "paper-title-card",
+      "category": "typography",
+      "summary": "一句话逐词压印上纸、一个词标强调色斜体、短划线收束",
+      "use": "章节转场/价值主张字卡；重要功能出场前的引导卡；全片呼吸位",
+      "duration": "1.7–1.8s（50–55f）",
+      "energy": "低（呼吸位，隔开两段高能镜头）",
+      "source": "references/shots/typography/paper-title-card.md",
+      "styles": [
+        {
+          "key": "paper-title-card",
+          "label": "paper-title-card",
+          "description": "一句话逐词压印上纸、一个词标强调色斜体、短划线收束",
+          "demo": "demos/typography/paper-title-card/PaperTitleCard.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/paper-title-card.mp4?v=1790980736845"
+        }
+      ]
+    },
+    {
+      "id": "picker-carousel-feature-cycle",
+      "category": "interaction",
+      "summary": "移动端风竖向选择器——焦点药丸不动、内容穿过它，每项带明显 outQuint 减速吸附后完全静止，按到中心距离分层控制透明度/字号/灰度，落定时药丸做 scaleY 极轻呼吸",
+      "use": "逐个念出功能名/场景名的列表镜头；\"选一个\"的交互演示；移动端产品的 picker 类控件展示",
+      "duration": "约3.6s（108f@30fps）",
+      "energy": "中（每一次吸附都是一个节拍点，5 拍匀速推进）",
+      "source": "references/shots/interaction/picker-carousel-feature-cycle.md",
+      "styles": [
+        {
+          "key": "picker-carousel-feature-cycle",
+          "label": "picker-carousel-feature-cycle",
+          "description": "移动端风竖向选择器——焦点药丸不动、内容穿过它，每项带明显 outQuint 减速吸附后完全静止，按到中心距离分层控制透明度/字号/灰度，落定时药丸做 scaleY 极轻呼吸",
+          "demo": "demos/interaction/picker-carousel-feature-cycle/PickerCarouselFeatureCycle.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/picker-carousel-feature-cycle.mp4?v=1790980736846"
+        }
+      ]
+    },
+    {
+      "id": "pill-chip-slot-cycle-handled",
+      "category": "typography",
+      "summary": "白底句式 \"Your `chip` Handled\" 里深色胶囊内词竖向滚轮轮换，胶囊宽度按预量文本宽插值平滑伸缩、两侧文字被自然挤开收拢，胶囊上下露出 13% 透明度的灰色幽灵项",
+      "use": "\"我们替你搞定 ___\" 这类句式卖点；SaaS 功能列举的一句话收口；浅底品牌片主视觉一拍",
+      "duration": "约 5.0s（150f@30fps：静置 → 3 次切换（0.25/0.47/0.69）→ 尾部静置）",
+      "energy": "中（三拍稳定节拍，宽度伸缩是唯一的连续运动）",
+      "source": "references/shots/typography/pill-chip-slot-cycle-handled.md",
+      "styles": [
+        {
+          "key": "pill-chip-slot-cycle-handled",
+          "label": "pill-chip-slot-cycle-handled",
+          "description": "白底句式 \"Your `chip` Handled\" 里深色胶囊内词竖向滚轮轮换，胶囊宽度按预量文本宽插值平滑伸缩、两侧文字被自然挤开收拢，胶囊上下露出 13% 透明度的灰色幽灵项",
+          "demo": "demos/typography/pill-chip-slot-cycle-handled/PillChipSlotCycleHandled.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/pill-chip-slot-cycle-handled.mp4?v=1790980736847"
+        }
+      ]
+    },
+    {
+      "id": "pill-slot-cycle",
+      "category": "typography",
+      "summary": "句中词槽轮换——固定句干钉死不动，句尾 pill 徽章每 ~0.7s 老虎机滚一格（旧的上飞加速淡出、新的从下带模糊滑入），连换 N 个功能词后落成完整句子收束",
+      "use": "\"功能列举\"类文案的最优雅解法（比逐条列表快、比字符级滚动有语义）；一句话卖点 + 多个动词短语的段落",
+      "duration": "入场 12f + 每拍 21f × 词数 + 收束 14f + hold；6 词约 6.7s（demo 200f，含 48f 完整句 hold）",
+      "energy": "中（稳定节拍器，无峰值）",
+      "source": "references/shots/typography/pill-slot-cycle.md",
+      "styles": [
+        {
+          "key": "pill-slot-cycle",
+          "label": "pill-slot-cycle",
+          "description": "句中词槽轮换——固定句干钉死不动，句尾 pill 徽章每 ~0.7s 老虎机滚一格（旧的上飞加速淡出、新的从下带模糊滑入），连换 N 个功能词后落成完整句子收束",
+          "demo": "demos/typography/pill-slot-cycle/PillSlotCycle.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/pill-slot-cycle.mp4?v=1790980736848"
+        }
+      ]
+    },
+    {
+      "id": "print-texture-transitions",
+      "category": "transition",
+      "summary": "印刷质感转场——ink-bleed-reveal 墨渗揭示（须状渗边洇开吃掉旧景）",
+      "use": "换景接缝的纸墨审美款；与交棒三式/穿越式并列的第三族——\"介质显影\"型转场",
+      "duration": "4–4.5s（洇开段 55–80f + 静止收尾 ≥30f）",
+      "energy": "中（渐进显形，无冲击拍）",
+      "source": "references/shots/transition/print-texture-transitions.md",
+      "styles": [
+        {
+          "key": "ink-bleed-reveal",
+          "label": "ink-bleed-reveal 墨渗揭示",
+          "description": "印刷质感转场——ink-bleed-reveal 墨渗揭示（须状渗边洇开吃掉旧景）",
+          "demo": "demos/transition/print-texture-transitions/InkBleedReveal.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/ink-bleed-reveal.mp4?v=1790980736849"
+        }
+      ]
+    },
+    {
+      "id": "product-card-progressive-assemble",
+      "category": "ui-entrance",
+      "summary": "详情卡像被逐字段抓取般自建——一枚\"填充光标\"领先跳格，图→标题→分类 pill 依次 pop→原价出现后被划线降级、强调色新价 spring 跳出→正文逐行揭示且高亮块由左向右刷过→色卡点亮→按钮填满，整卡全程极慢 scale 前推",
+      "use": "商品/条目详情页的能力展示；\"结构化抽取\"\"自动填充\"\"数据自己长出来\"类叙事的主镜头",
+      "duration": "约 5.7s（172f@30fps）",
+      "energy": "中（连续小事件密集排布，无单点爆发；靠前推保持推进感）",
+      "source": "references/shots/ui-entrance/product-card-progressive-assemble.md",
+      "styles": [
+        {
+          "key": "product-card-progressive-assemble",
+          "label": "product-card-progressive-assemble",
+          "description": "详情卡像被逐字段抓取般自建——一枚\"填充光标\"领先跳格，图→标题→分类 pill 依次 pop→原价出现后被划线降级、强调色新价 spring 跳出→正文逐行揭示且高亮块由左向右刷过→色卡点亮→按钮填满，整卡全程极慢 scale 前推",
+          "demo": "demos/ui-entrance/product-card-progressive-assemble/ProductCardProgressiveAssemble.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/product-card-progressive-assemble.mp4?v=1790980736850"
+        }
+      ]
+    },
+    {
+      "id": "quad-split-parallel-scenes",
+      "category": "rhythm",
+      "summary": "画面硬切 2×2 四宫格，四个象限并行跑各自的微场景（打字、急推、逐词、交互链），关键节拍错开 3–6 帧制造信息轰炸",
+      "use": "节奏段\"功能很多、同时发生\"的蒙太奇拍；预告片中段的密度峰值",
+      "duration": "90f（3s@30fps：0–62f 并行轰炸 + 28f 终态 hold，全程无转场）",
+      "energy": "高（四线并行 + 错拍冲击，标准的 BGM 副歌位）",
+      "source": "references/shots/rhythm/quad-split-parallel-scenes.md",
+      "styles": [
+        {
+          "key": "quad-split-parallel-scenes",
+          "label": "quad-split-parallel-scenes",
+          "description": "画面硬切 2×2 四宫格，四个象限并行跑各自的微场景（打字、急推、逐词、交互链），关键节拍错开 3–6 帧制造信息轰炸",
+          "demo": "demos/rhythm/quad-split-parallel-scenes/QuadSplitParallelScenes.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/quad-split-parallel-scenes.mp4?v=1790980736851"
+        }
+      ]
+    },
+    {
+      "id": "radial-ripple-phone-chips",
+      "category": "effects",
+      "summary": "暖沙底四层同心圆错相呼吸如水波，中央手机 mockup 屏内 feed 自动缓滚，两侧白色 chip 先后 spring pop 入场并悬浮",
+      "use": "移动端产品的\"这就是它\"定格镜头；功能点分列两侧的介绍段；片头/片尾的产品全景",
+      "duration": "约5.6s（168f@30fps）",
+      "energy": "低（安静、有呼吸感，靠同心圆的持续起伏撑住不冷场）",
+      "source": "references/shots/effects/radial-ripple-phone-chips.md",
+      "styles": [
+        {
+          "key": "radial-ripple-phone-chips",
+          "label": "radial-ripple-phone-chips",
+          "description": "暖沙底四层同心圆错相呼吸如水波，中央手机 mockup 屏内 feed 自动缓滚，两侧白色 chip 先后 spring pop 入场并悬浮",
+          "demo": "demos/effects/radial-ripple-phone-chips/RadialRipplePhoneChips.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/radial-ripple-phone-chips.mp4?v=1790980736852"
+        }
+      ]
+    },
+    {
+      "id": "radial-wave",
+      "category": "ui-entrance",
+      "summary": "17×9 圆点阵列按到波源的欧氏距离错峰点亮，每点 scale 过冲到 1.5 再落回常亮，第一道波扫完后第二道亮蓝脉冲从外圈反向收拢回中心",
+      "use": "产品/品牌开场的\"系统上电\"一拍；也用作数据网格、节点地图、覆盖范围类叙事的建立镜头",
+      "duration": "约 3.8s（114f@30fps）",
+      "energy": "中高（起手爆发一次，波前过后转为常亮低能量底子）",
+      "source": "references/shots/ui-entrance/radial-wave.md",
+      "styles": [
+        {
+          "key": "radial-wave",
+          "label": "radial-wave",
+          "description": "17×9 圆点阵列按到波源的欧氏距离错峰点亮，每点 scale 过冲到 1.5 再落回常亮，第一道波扫完后第二道亮蓝脉冲从外圈反向收拢回中心",
+          "demo": "demos/ui-entrance/radial-wave/RadialWave.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/radial-wave.mp4?v=1790980736853"
+        }
+      ]
+    },
+    {
+      "id": "research-card-stack-scroll",
+      "category": "ui-entrance",
+      "summary": "深色论文卡每 12 帧一张沿右下轴线飞入中心叠压，落位带 1 帧压缩，只有最上一张全清晰渲染标题+作者+摘要，下方卡按堆积深度递增模糊变暗只露标题条，背景横向 grid 同步下移做速度参照",
+      "use": "\"读了大量资料/处理了海量文档\"的量级交代；研究类、检索类、批处理类产品的能力镜头",
+      "duration": "约 4.8s（144f@30fps）",
+      "energy": "中高（匀速高频，无爆发但持续压迫）",
+      "source": "references/shots/ui-entrance/research-card-stack-scroll.md",
+      "styles": [
+        {
+          "key": "research-card-stack-scroll",
+          "label": "research-card-stack-scroll",
+          "description": "深色论文卡每 12 帧一张沿右下轴线飞入中心叠压，落位带 1 帧压缩，只有最上一张全清晰渲染标题+作者+摘要，下方卡按堆积深度递增模糊变暗只露标题条，背景横向 grid 同步下移做速度参照",
+          "demo": "demos/ui-entrance/research-card-stack-scroll/ResearchCardStackScroll.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/research-card-stack-scroll.mp4?v=1790980736854"
+        }
+      ]
+    },
+    {
+      "id": "rhythm-interrupt-moves",
+      "category": "rhythm",
+      "summary": "打断节奏——jump-cut-punch-in 三级跳切推近：同构图三次无补间硬跳放大，逐级逼近目标",
+      "use": "用\"打断连续性\"本身当节奏器：顿挫推近（A）；与 beat-cut-moves（切点排布）互补",
+      "duration": "A 135f ≈4.5s",
+      "energy": "A 中",
+      "source": "references/shots/rhythm/rhythm-interrupt-moves.md",
+      "styles": [
+        {
+          "key": "jump-cut-punch-in",
+          "label": "jump-cut-punch-in",
+          "description": "打断节奏——jump-cut-punch-in 三级跳切推近：同构图三次无补间硬跳放大，逐级逼近目标",
+          "demo": "demos/rhythm/rhythm-interrupt-moves/JumpCutPunchIn.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/jump-cut-punch-in.mp4?v=1790980736855"
+        }
+      ]
+    },
+    {
+      "id": "riso-print-hits",
+      "category": "effects",
+      "summary": "套印错位冲击帧——riso-misregistration-hit 单发：标题撞停瞬间裂成双色 riso 印版，抖两下\"啪\"地套准",
+      "use": "标题/卡片的命中强调，纸墨审美版的\"故障闪\"；全片 1–2 次的单发高潮",
+      "duration": "4s（120f，单发）",
+      "energy": "高",
+      "source": "references/shots/effects/riso-print-hits.md",
+      "styles": [
+        {
+          "key": "misregistration-hit",
+          "label": "misregistration-hit 单发",
+          "description": "套印错位冲击帧——riso-misregistration-hit 单发：标题撞停瞬间裂成双色 riso 印版，抖两下\"啪\"地套准",
+          "demo": "demos/effects/riso-print-hits/RisoMisregistrationHit.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/misregistration-hit.mp4?v=1790980736856"
+        }
+      ]
+    },
+    {
+      "id": "row-embed",
+      "category": "ui-entrance",
+      "summary": "内容行像卡片一样从空中降下、rotateX 收平、嵌入瞬间底边亮一道强调色的缝",
+      "use": "\"结构化数据长进页面\"的详情页/列表镜头；行级内容的批量入场",
+      "duration": "约 2s（12–68f）",
+      "energy": "中",
+      "source": "references/shots/ui-entrance/row-embed.md",
+      "styles": [
+        {
+          "key": "row-embed",
+          "label": "row-embed",
+          "description": "内容行像卡片一样从空中降下、rotateX 收平、嵌入瞬间底边亮一道强调色的缝",
+          "demo": "demos/ui-entrance/row-embed/RowEmbed.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/row-embed.mp4?v=1790980736857"
+        }
+      ]
+    },
+    {
+      "id": "sakuga-timing-shift",
+      "category": "rhythm",
+      "summary": "一拍三转一拍一——元素先以每 3 帧一步的手翻书顿挫移动，高潮瞬间切成逐帧丝滑冲刺，帧率量化的突变本身就是看点",
+      "use": "单元素的强调性位移（卡片入场、指标冲线）；需要\"手工感→高潮爆发\"反差的段落",
+      "duration": "150f（5s）",
+      "energy": "中高",
+      "source": "references/shots/rhythm/sakuga-timing-shift.md",
+      "styles": [
+        {
+          "key": "sakuga-timing-shift",
+          "label": "sakuga-timing-shift",
+          "description": "一拍三转一拍一——元素先以每 3 帧一步的手翻书顿挫移动，高潮瞬间切成逐帧丝滑冲刺，帧率量化的突变本身就是看点",
+          "demo": "demos/rhythm/sakuga-timing-shift/SakugaTimingShift.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/sakuga-timing-shift.mp4?v=1790980736858"
+        }
+      ]
+    },
+    {
+      "id": "scan-bracket-sweep",
+      "category": "effects",
+      "summary": "文档弹到中央，四角落下 L 形取景括号，一条扫描光带拖着渐变尾迹在文档上往复扫 5 趟——文档全程静止，只有光在读它",
+      "use": "\"正在解析/校验这份内容\"的过程镜头；文档类产品的能力演示；上传→分析链路的中段",
+      "duration": "约5.0s（150f@30fps）",
+      "energy": "中低（机械、克制，节奏全在往复扫掠的呼吸上）",
+      "source": "references/shots/effects/scan-bracket-sweep.md",
+      "styles": [
+        {
+          "key": "scan-bracket-sweep",
+          "label": "scan-bracket-sweep",
+          "description": "文档弹到中央，四角落下 L 形取景括号，一条扫描光带拖着渐变尾迹在文档上往复扫 5 趟——文档全程静止，只有光在读它",
+          "demo": "demos/effects/scan-bracket-sweep/ScanBracketSweep.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/scan-bracket-sweep.mp4?v=1790980736859"
+        }
+      ]
+    },
+    {
+      "id": "scanline-annotate-focus",
+      "category": "effects",
+      "summary": "一条扫描线自上而下匀速掠过已存在的页面，越过哪块区块的下缘，哪块就被四角取景框从外扩处弹簧收拢对准（一次过冲），随后贴出一枚逐字打出的机器标签，顶部状态行同步计数 00/06→06/06",
+      "use": "\"AI 正在读你的页面/品牌\"的分析镜头；设计系统/品牌规范的拆解介绍；产品能力的自我说明段",
+      "duration": "约5s（150f@30fps）",
+      "energy": "中（机械冷静，节奏由扫描线匀速推动，标注是节拍点）",
+      "source": "references/shots/effects/scanline-annotate-focus.md",
+      "styles": [
+        {
+          "key": "scanline-annotate-focus",
+          "label": "scanline-annotate-focus",
+          "description": "一条扫描线自上而下匀速掠过已存在的页面，越过哪块区块的下缘，哪块就被四角取景框从外扩处弹簧收拢对准（一次过冲），随后贴出一枚逐字打出的机器标签，顶部状态行同步计数 00/06→06/06",
+          "demo": "demos/effects/scanline-annotate-focus/ScanlineAnnotateFocus.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/scanline-annotate-focus.mp4?v=1790980736860"
+        }
+      ]
+    },
+    {
+      "id": "scanline-assemble-flyin",
+      "category": "effects",
+      "summary": "页面开场是一张只有网格与虚线槽位的蓝图画板，一条亮扫描线自上而下掠过；扫到每个槽位，该处组件就从画外飞入过冲贴合，带方向性残影模糊与落位咬合角标——扫完整页恰好装配完成",
+      "use": "\"页面自己生成\"的开场；AI 建站/自动排版类产品的核心演示；从空白到成品的能力叙事",
+      "duration": "约5.2s（156f@30fps）",
+      "energy": "中高（扫描线是稳的，但每次组件飞入都是一个爆点，密度递进）",
+      "source": "references/shots/effects/scanline-assemble-flyin.md",
+      "styles": [
+        {
+          "key": "scanline-assemble-flyin",
+          "label": "scanline-assemble-flyin",
+          "description": "页面开场是一张只有网格与虚线槽位的蓝图画板，一条亮扫描线自上而下掠过；扫到每个槽位，该处组件就从画外飞入过冲贴合，带方向性残影模糊与落位咬合角标——扫完整页恰好装配完成",
+          "demo": "demos/effects/scanline-assemble-flyin/ScanlineAssembleFlyin.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/scanline-assemble-flyin.mp4?v=1790980736861"
+        }
+      ]
+    },
+    {
+      "id": "scroll-brake-moves",
+      "category": "data",
+      "summary": "长卷急刹两式——changelog-scroll-brake 基本款（高速长卷指数减速精准停位+目标抬升）与 brake-reticle-lock 组合款（急刹帧同帧准星咬合）",
+      "use": "changelog/发布史/长列表段落：\"一直在发货，今天这条最大\"；要给停点更强打击感用 B",
+      "duration": "A 4–5s / B 5s",
+      "energy": "高开中收（速度对比型）",
+      "source": "references/shots/data/scroll-brake-moves.md",
+      "styles": [
+        {
+          "key": "changelog-scroll-brake",
+          "label": "changelog-scroll-brake",
+          "description": "translateY 扫 ~2400px（out exp 指数减速 ~50f），blur 由帧间位移差分驱动（0-6px 自动清零）；停点行 scale 1.03 抬升+阴影+3px 描边，其余 opacity 退 0.38",
+          "demo": "demos/data/scroll-brake-moves/ChangelogScrollBrake.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/changelog-scroll-brake.mp4?v=1790980736862"
+        },
+        {
+          "key": "brake-reticle-lock",
+          "label": "brake-reticle-lock",
+          "description": "滚动三段：sin-in 加速→cubic-out 猛减速冲过头 +30px→回弹落定；blur=v×0.12 封顶 24px；角标从 ±620/±320 画外 Easing.back(2.4) 飞入咬合，高亮 6f 内完成、标签 back(2.6) 弹出",
+          "demo": "demos/data/scroll-brake-moves/BrakeReticleLock.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/brake-reticle-lock.mp4?v=1790980736863"
+        }
+      ]
+    },
+    {
+      "id": "segmented-thumb-hero",
+      "category": "interaction",
+      "summary": "分段控件 thumb 位移当主角特写——超大胶囊 segmented control 弹簧浮入，描边箭头光标画外滑入按下，白 thumb 8f ease-out 滑到另一段，到位瞬间新图标 spring 弹出、旧图标收起",
+      "use": "\"模式切换/二选一\"功能的宣告镜头（demo 的 video-shotcraft Prompt→Film、Chat→Agent 式）；一个 UI 微交互撑一整镜的特写拍法",
+      "duration": "~3.5s（demo 110f：浮入 18f + 光标 24f + 点击 + 滑动 8f + 图标弹出 + hold）",
+      "energy": "中（微交互特写，精致不轰）",
+      "source": "references/shots/interaction/segmented-thumb-hero.md",
+      "styles": [
+        {
+          "key": "segmented-thumb-hero",
+          "label": "segmented-thumb-hero",
+          "description": "分段控件 thumb 位移当主角特写——超大胶囊 segmented control 弹簧浮入，描边箭头光标画外滑入按下，白 thumb 8f ease-out 滑到另一段，到位瞬间新图标 spring 弹出、旧图标收起",
+          "demo": "demos/interaction/segmented-thumb-hero/SegmentedThumbHero.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/segmented-thumb-hero.mp4?v=1790980736864"
+        }
+      ]
+    },
+    {
+      "id": "shot-transitions",
+      "category": "transition",
+      "summary": "镜头交棒三式——推进流白、whip-pan 甩镜（急刹款）、mask-wipe 穿窗（纵深款），按能量落差与接缝语义选型",
+      "use": "任何两镜衔接处（技法卡，分镜阶段排完镜头后逐个接缝选一式）",
+      "duration": "n/a（技法卡；各式占用帧数见参数表，从相邻镜头预算里划）",
+      "energy": "n/a（技法卡，不占能量位）",
+      "source": "references/shots/transition/shot-transitions.md",
+      "styles": [
+        {
+          "key": "flash-cut",
+          "label": "推进流白 flash-cut",
+          "description": "前镜相机推进，切点跨骑一层白闪盖住换页",
+          "demo": "assets/lib/FlashCut.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/flash-cut.mp4?v=1784437314733"
+        },
+        {
+          "key": "whip-pan",
+          "label": "whip-pan 甩镜",
+          "description": "机位一拍横甩到下一场景，中段运动模糊糊到不可辨，借糊帧换景",
+          "demo": "demos/transition/shot-transitions/WhipBrakeReal.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/whip-pan.mp4?v=1790980736865"
+        },
+        {
+          "key": "mask-wipe",
+          "label": "mask-wipe 穿窗",
+          "description": "页面内真实元素（卡片）放大成全屏窗口，新场景从窗内长出接管",
+          "demo": "demos/transition/shot-transitions/PortalWipeV2.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/mask-wipe.mp4?v=1790980736866"
+        }
+      ]
+    },
+    {
+      "id": "slam-entrance-moves",
+      "category": "effects",
+      "summary": "高能砸入三式——kanada-perspective-snap 金田透视急停、score-slam 比分砸落、impact-burst-kit 落点冲击套件（波及邻卡）",
+      "use": "主角卡/KPI 卡的重拳入场；impact-feedback 管落位后的反馈，本卡管入场本身就是冲击",
+      "duration": "单式动作段 6–22f + 冲击余波 ~16f + hold ≥45f（demo：A 120f / B 135f / C 140f）",
+      "energy": "高",
+      "source": "references/shots/effects/slam-entrance-moves.md",
+      "styles": [
+        {
+          "key": "kanada-perspective-snap",
+          "label": "kanada-perspective-snap",
+          "description": "perspective 300→1500px + rotate3d 58°→0 + scale 1.7→1 甩入 18f，末 4f 过冲 +5° 弹平，长斜影收正",
+          "demo": "demos/effects/slam-entrance-moves/KanadaPerspectiveSnap.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/kanada-perspective-snap.mp4?v=1790980736867"
+        },
+        {
+          "key": "score-slam",
+          "label": "score-slam",
+          "description": "卡从 scale 2.5/rotate 5° 六帧 Easing.in(quad) 砸落，落点帧圆环扩散+尘点飞散+震屏同帧",
+          "demo": "demos/effects/slam-entrance-moves/ScoreSlam.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/score-slam.mp4?v=1790980736868"
+        },
+        {
+          "key": "impact-burst-kit",
+          "label": "impact-burst-kit",
+          "description": "B 三件套 + 冲击波前沿按半径-距离精算扫过邻卡帧，邻卡外推 30px + rotate ±3° 阻尼弹回",
+          "demo": "demos/effects/slam-entrance-moves/ImpactBurstKit.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/impact-burst-kit.mp4?v=1790980736869"
+        }
+      ]
+    },
+    {
+      "id": "space-camera-moves",
+      "category": "camera",
+      "summary": "3D 空间化运镜两式——exploded-view 爆炸分解（构件沿 Z 炸开再合体）、drone-dive-landing 无人机俯冲降落",
+      "use": "把平面页面当 3D 实体拍的高光段落；两式都是\"大动作\"，一支片合计 ≤2 次",
+      "duration": "A 170f（5.7s，炸开-悬停-合体-收尾标题全程）；C 105f（3.5s，俯冲 69f + 落定 hold 36f）单向俯冲",
+      "energy": "高",
+      "source": "references/shots/camera/space-camera-moves.md",
+      "styles": [
+        {
+          "key": "exploded-view",
+          "label": "exploded-view",
+          "description": "整页 3D 倾斜后构件沿 Z 轴错峰炸开悬停，一拍后逆序合体震屏收口",
+          "demo": "demos/camera/space-camera-moves/ExplodedView.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/exploded-view.mp4?v=1790980736870"
+        },
+        {
+          "key": "drone-dive-landing",
+          "label": "drone-dive-landing",
+          "description": "近垂直俯角悬停 → 猛扎俯冲 → 气垫减速停在 hero 卡特写",
+          "demo": "demos/camera/space-camera-moves/DroneDiveLanding.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/drone-dive-landing.mp4?v=1790980736871"
+        }
+      ]
+    },
+    {
+      "id": "speed-ramp-freeze",
+      "category": "rhythm",
+      "summary": "帧号非线性 remap 的节奏手法——定格标注（流动→定格圈注→解冻）",
+      "use": "卡片流/长横移中把一个重点\"停下给人看\"；教学解说、评审语境",
+      "duration": "定格标注全程 158f（≈5.3s，定格段 67f ≥45f）",
+      "energy": "中高（速度反差本身即energy beat）",
+      "source": "references/shots/rhythm/speed-ramp-freeze.md",
+      "styles": [
+        {
+          "key": "freeze-annotate",
+          "label": "freeze-annotate",
+          "description": "帧号非线性 remap 的节奏手法——定格标注（流动→定格圈注→解冻）",
+          "demo": "demos/rhythm/speed-ramp-freeze/FreezeAnnotateReal.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/freeze-annotate.mp4?v=1790980736872"
+        }
+      ]
+    },
+    {
+      "id": "spotlight-hero-card",
+      "category": "opening",
+      "summary": "关灯的剧场里一束钨丝聚光（带体积光柱）扫过页面锁定一张卡，斜侧推进后卡片弹起悬浮、香槟色光束沿轮廓两圈、连同 3D 注记一起贴回原位",
+      "use": "\"单一主角\"式产品开场；把一个核心对象（卡片/条目/模块）立成全片主角",
+      "duration": "172f（约 5.7s；锁定 f34 → 触地 f142 → 30f 真静止 hold）",
+      "energy": "中（质感最高的一镜，节奏慢而稳）",
+      "source": "references/shots/opening/spotlight-hero-card.md",
+      "styles": [
+        {
+          "key": "spotlight-hero-card",
+          "label": "spotlight-hero-card",
+          "description": "关灯的剧场里一束钨丝聚光（带体积光柱）扫过页面锁定一张卡，斜侧推进后卡片弹起悬浮、香槟色光束沿轮廓两圈、连同 3D 注记一起贴回原位",
+          "demo": "demos/opening/spotlight-hero-card/SpotlightHeroCard.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/spotlight-hero-card.mp4?v=1790980736873"
+        }
+      ]
+    },
+    {
+      "id": "spotlight-sweep-moves",
+      "category": "effects",
+      "summary": "暗场聚光显影三式——A 醒睡扫过（光到即亮光走即暗）、B 贴边泛光横摇（紫光贴 UI 边缘渗入+聚光匀速右移）、C 角落匀速显影（径向聚光从角落匀速扩张点亮全屏）；黑场里\"光即叙事\"的 UI 展示",
+      "use": "暗色调品牌片里逐个介绍 UI 面板/功能区；黑场开场把界面\"点亮\"登场；段落间光转场",
+      "duration": "单式 3.5–4.5s；A/B 可串联成巡礼段",
+      "energy": "中低（克制、神秘感，爆点在\"亮起\"瞬间）",
+      "source": "references/shots/effects/spotlight-sweep-moves.md",
+      "styles": [
+        {
+          "key": "glow-wake-sleep-panel",
+          "label": "glow-wake-sleep-panel",
+          "description": "醒睡扫过：radial 显影罩跟随光头从左向右匀速移动，贴顶边紫色光线三层辉光同行，经过 logo 描光、到右缘点亮竖直残光，尾段面板沉回黑暗",
+          "demo": "demos/effects/spotlight-sweep-moves/GlowWakeSleepPanel.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/glow-wake-sleep-panel.mp4?v=1790980736874"
+        },
+        {
+          "key": "slide-spotlight-pan",
+          "label": "slide-spotlight-pan",
+          "description": "贴边泛光横摇：光线先绕左上角竖缘、转角后沿顶边横走，紫光晕染渗入 UI 顶部内侧；聚光头匀速右移显影 + 面板匀速左滑＝相机右摇感",
+          "demo": "demos/effects/spotlight-sweep-moves/SlideSpotlightPan.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/slide-spotlight-pan.mp4?v=1790980736875"
+        },
+        {
+          "key": "corner-spotlight-reveal",
+          "label": "corner-spotlight-reveal",
+          "description": "角落匀速显影：左上角径向聚光半径严格 linear 扩张，照到显影照不到沉黑，最终全屏亮起——光即转场",
+          "demo": "demos/effects/spotlight-sweep-moves/CornerSpotlightReveal.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/corner-spotlight-reveal.mp4?v=1790980736876"
+        }
+      ]
+    },
+    {
+      "id": "steep-tilt-glide",
+      "category": "camera",
+      "summary": "固定镜头下直立页面以 60° 强透视侧立（右近左远），页面自身沿其 3D 横面方向滑移掠过镜头（物动镜不动），滑移带速度重影、文字组件悬空贴落、由暗揭亮",
+      "use": "长页面/多区块 UI 的炫技巡览（内容依次滑过固定机位）；暗场霓虹调性；与贴面运镜卡互补的\"侧掠\"机位",
+      "duration": "4s（120f）单镜；页面越宽越可拉长",
+      "energy": "中高（透视炫技+持续运动，但节奏是匀的）",
+      "source": "references/shots/camera/steep-tilt-glide.md",
+      "styles": [
+        {
+          "key": "steep-tilt-glide",
+          "label": "steep-tilt-glide",
+          "description": "固定镜头下直立页面以 60° 强透视侧立（右近左远），页面自身沿其 3D 横面方向滑移掠过镜头（物动镜不动），滑移带速度重影、文字组件悬空贴落、由暗揭亮",
+          "demo": "demos/camera/steep-tilt-glide/SteepTiltGlide.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/steep-tilt-glide.mp4?v=1790980736877"
+        }
+      ]
+    },
+    {
+      "id": "stroke-segment-build",
+      "category": "opening",
+      "summary": "断笔成字——标题拆成十几段互不相连的笔画乱序逐段点亮，前 70% 不可读，末段落位瞬间语义\"啪\"地成立",
+      "use": "开场吊悬念的产品名/大数字揭晓；一支片 ≤1 次；与 type-assembly/draw-svg-trace 分工：那些是\"看着字被组装/描画\"，本卡是\"意义延迟揭晓\"",
+      "duration": "165f（5.5s；揭晓 f105 后 hold 2s）",
+      "energy": "低起中收（悬念型，落位帧是能量点）",
+      "source": "references/shots/opening/stroke-segment-build.md",
+      "styles": [
+        {
+          "key": "stroke-segment-build",
+          "label": "stroke-segment-build",
+          "description": "断笔成字——标题拆成十几段互不相连的笔画乱序逐段点亮，前 70% 不可读，末段落位瞬间语义\"啪\"地成立",
+          "demo": "demos/opening/stroke-segment-build/StrokeSegmentBuild.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/stroke-segment-build.mp4?v=1790980736878"
+        }
+      ]
+    },
+    {
+      "id": "tear-streak-transitions",
+      "category": "transition",
+      "summary": "撕裂转场——glitch-displace 噪声撕裂（16 横条错位抖动中硬切），数字故障语义的条带级撕裂",
+      "use": "高能换页：数字故障/断裂语义；页面完整性不破、能量拉满的条带级撕裂",
+      "duration": "前态 ≥40f + 撕裂 16–24f + 收尾 ≥40f，约 4.5s（135f）",
+      "energy": "高",
+      "source": "references/shots/transition/tear-streak-transitions.md",
+      "styles": [
+        {
+          "key": "glitch-displace",
+          "label": "glitch-displace",
+          "description": "撕裂转场——glitch-displace 噪声撕裂（16 横条错位抖动中硬切），数字故障语义的条带级撕裂",
+          "demo": "demos/transition/tear-streak-transitions/GlitchDisplace.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/glitch-displace.mp4?v=1790980736879"
+        }
+      ]
+    },
+    {
+      "id": "tension-camera-moves",
+      "category": "camera",
+      "summary": "情绪运镜两式——bullet-time 冻结环绕、pull-back 拉远孤立，相机替观众\"感受\"而非\"看\"",
+      "use": "情绪节点（震撼/收束）的运镜语言；与 space-camera-moves 的\"炫技大动作\"互补——这两式动作小、情绪重",
+      "duration": "单式 5–6s（150–170f）；全片合计 ≤2 式（各 ≤1 次）",
+      "energy": "A 高 / B 低收",
+      "source": "references/shots/camera/tension-camera-moves.md",
+      "styles": [
+        {
+          "key": "bullet-time-freeze-orbit",
+          "label": "bullet-time-freeze-orbit 冻结环绕",
+          "description": "图表生长到一半全冻住，相机绕悬停的 UI 平面 rotateY 扫 55° 再回，时间恢复接着长完",
+          "demo": "demos/camera/tension-camera-moves/BulletTimeFreezeOrbit.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/bullet-time-freeze-orbit.mp4?v=1790980736880"
+        },
+        {
+          "key": "pull-back-isolation",
+          "label": "pull-back-isolation 拉远孤立",
+          "description": "从发光主卡特写后拉，兄弟卡按距离错峰熄灭、背景沉黑，孤卡悬在暗场中央",
+          "demo": "demos/camera/tension-camera-moves/PullBackIsolation.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/pull-back-isolation.mp4?v=1790980736881"
+        }
+      ]
+    },
+    {
+      "id": "terminal-3d",
+      "category": "camera",
+      "summary": "三个终端窗散布 3D 空间，相机窗间飞行、途中正弦拉远，每到一窗打字机敲命令、结果逐行滑出——命令执行的空间叙事流",
+      "use": "开发者产品的 CLI/工作流演示：把\"三步命令\"拍成三站空间旅程",
+      "duration": "约 8.2s（246f@30fps；三站各约 2–3s 停留 + 两段 30f 飞行）",
+      "energy": "中（飞行给动感、打字给节奏，整体是沉稳的技术叙事；收在 ● READY 一记亮点）",
+      "source": "references/shots/camera/terminal-3d.md",
+      "styles": [
+        {
+          "key": "terminal-3d",
+          "label": "terminal-3d",
+          "description": "三个终端窗散布 3D 空间，相机窗间飞行、途中正弦拉远，每到一窗打字机敲命令、结果逐行滑出——命令执行的空间叙事流",
+          "demo": "demos/camera/terminal-3d/Terminal3D.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/terminal-3d.mp4?v=1790980736882"
+        }
+      ]
+    },
+    {
+      "id": "text-as-mask",
+      "category": "opening",
+      "summary": "文字视频遮罩——瓷白舞台上切出超粗大标题字，字内部透出缓慢平移的暗色实时产品面板，结尾吸一口气后字形指数冲入放大 46 倍溢出、内部画面接管全屏",
+      "use": "品牌词/口号与产品画面二合一的开场或章节卡；字是门、产品在门里",
+      "duration": "165f（入场 18f + 字内漂移 78f + 吸气 8f + 冲入接管 24f + 落定/hold 37f）",
+      "energy": "中高（漂移段沉稳，接管段一次爆发）",
+      "source": "references/shots/opening/text-as-mask.md",
+      "styles": [
+        {
+          "key": "text-as-mask",
+          "label": "text-as-mask",
+          "description": "文字视频遮罩——瓷白舞台上切出超粗大标题字，字内部透出缓慢平移的暗色实时产品面板，结尾吸一口气后字形指数冲入放大 46 倍溢出、内部画面接管全屏",
+          "demo": "demos/opening/text-as-mask/TextAsMask.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/text-as-mask.mp4?v=1790980736883"
+        }
+      ]
+    },
+    {
+      "id": "text-column-converge",
+      "category": "typography",
+      "summary": "双词对峙合拢——左\"NEW\"右特性词钉死在等屏边距两侧硬切轮换、全程零收缩，换到最后一词才唯一一次 ease-in-out 滑到居中咬合成短语，下方小字近乎硬切浮现；收尾揭晓型文字卡",
+      "use": "特性清单收束到产品名/口号的段落（\"NEW × 一串特性 → NEW <产品名>\"式）；发布会式 recap、版本号揭晓",
+      "duration": "轮换 7–16f/词 × 8–9 词 + 合拢 ~36f + 小字后静置；全段约 5–6s",
+      "energy": "中低（机器节奏、小字规格清单气质，不是砸字）",
+      "source": "references/shots/typography/text-column-converge.md",
+      "styles": [
+        {
+          "key": "text-column-converge",
+          "label": "text-column-converge",
+          "description": "双词对峙合拢——左\"NEW\"右特性词钉死在等屏边距两侧硬切轮换、全程零收缩，换到最后一词才唯一一次 ease-in-out 滑到居中咬合成短语，下方小字近乎硬切浮现；收尾揭晓型文字卡",
+          "demo": "demos/typography/text-column-converge/TextColumnConverge.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/text-column-converge.mp4?v=1790980736884"
+        }
+      ]
+    },
+    {
+      "id": "theme-switch-moves",
+      "category": "interaction",
+      "summary": "主题切换两式——theme-sweep 斜向扫场（边界扫过处就地换肤）与 palette-ripple 组合款（⌘K 面板收缩成点、涟漪从点荡开换肤）",
+      "use": "深色模式/主题功能的叙事段落；同一 UI \"在你眼前变色\"而非切到新场景",
+      "duration": "A 140f（4.7s）/ B 156f（5.2s）",
+      "energy": "A 中 / B 中高（组合款有完整因果链）",
+      "source": "references/shots/interaction/theme-switch-moves.md",
+      "styles": [
+        {
+          "key": "theme-sweep-toggle",
+          "label": "theme-sweep-toggle",
+          "description": "深色版 clip-path polygon 15° 斜边扫场（out poly3 先快后缓 ~38f），边界 4px 白亮线+18px 辉光，扫完 2f 淡出；深版 scale 1→0.995→1 坐实",
+          "demo": "demos/interaction/theme-switch-moves/ThemeSweepToggle.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/theme-sweep-toggle.mp4?v=1790980736885"
+        },
+        {
+          "key": "palette-theme-ripple",
+          "label": "palette-theme-ripple",
+          "description": "面板 back(1.9) 弹落→逐字输入→回车面板 ease-in 收缩到 0 + 白色高光核钉住位置→圆形 clip 半径 12→1250px cubic-out 荡开，边缘 5px 白环双向辉光",
+          "demo": "demos/interaction/theme-switch-moves/PaletteThemeRipple.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/palette-theme-ripple.mp4?v=1790980736886"
+        }
+      ]
+    },
+    {
+      "id": "timeline-travel",
+      "category": "data",
+      "summary": "时间轴横移——镜头沿水平刻度轴加速掠过版本刻度，每过一格卡片弹立短停，末刻度急停推近",
+      "use": "changelog/里程碑/发展史段落（\"我们一直在发货\"的另一种拍法）；与 scroll-brake-moves 分工：那卡是纵向列表急刹，本卡是横向时间旅行",
+      "duration": "4–5s",
+      "energy": "中高（加速→急刹的节奏型镜头）",
+      "source": "references/shots/data/timeline-travel.md",
+      "styles": [
+        {
+          "key": "timeline-travel",
+          "label": "timeline-travel",
+          "description": "时间轴横移——镜头沿水平刻度轴加速掠过版本刻度，每过一格卡片弹立短停，末刻度急停推近",
+          "demo": "demos/data/timeline-travel/TimelineTravel.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/timeline-travel.mp4?v=1790980736887"
+        }
+      ]
+    },
+    {
+      "id": "title-demote-to-label",
+      "category": "typography",
+      "summary": "大标题降格为节标签两式——A 大标题居中显影站稳一拍后连续缩小 0.3x 平移到左上角落成小节标签、内容区在其下生长；B 同套路但登场时带文本选中态高亮块扫入再撤掉",
+      "use": "章节开场（标题先当主角再让位给内容）；教程/功能演示片的小节交接；B 式给\"文字/编辑\"类产品加身份暗示",
+      "duration": "A ~3.7s（112f）/ B ~4.5s（134f）；demo 两式串播 246f",
+      "energy": "低中（版式变换型，氛围镜头）",
+      "source": "references/shots/typography/title-demote-to-label.md",
+      "styles": [
+        {
+          "key": "title-demote-to-label",
+          "label": "title-demote-to-label",
+          "description": "大标题降格为节标签两式——A 大标题居中显影站稳一拍后连续缩小 0.3x 平移到左上角落成小节标签、内容区在其下生长；B 同套路但登场时带文本选中态高亮块扫入再撤掉",
+          "demo": "demos/typography/title-demote-to-label/TitleDemoteToLabel.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/title-demote-to-label.mp4?v=1790980736888"
+        }
+      ]
+    },
+    {
+      "id": "trailer-grammar-moves",
+      "category": "rhythm",
+      "summary": "预告片语法一式——trailer-bumper 前置速剪钩子：三镜 9f 速剪 + 黑场静默一拍，再开场标题",
+      "use": "预告片的开场钩子（cold open）：正片前先塞三个最抓眼的镜头，再静默一拍正式开场",
+      "duration": "A ~4.7s（140f）",
+      "energy": "A 高",
+      "source": "references/shots/rhythm/trailer-grammar-moves.md",
+      "styles": [
+        {
+          "key": "trailer-bumper",
+          "label": "trailer-bumper",
+          "description": "预告片语法一式——trailer-bumper 前置速剪钩子：三镜 9f 速剪 + 黑场静默一拍，再开场标题",
+          "demo": "demos/rhythm/trailer-grammar-moves/TrailerBumper.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/trailer-bumper.mp4?v=1790980736889"
+        }
+      ]
+    },
+    {
+      "id": "transition-hidden-cut",
+      "category": "transition",
+      "summary": "藏切点转场三式——前景遮挡隐形切、对撞开屏、暖色漏光，硬切藏进遮挡/撞击/光峰的 1-3 帧里，观众看不见剪刀",
+      "use": "两镜衔接处需要\"无痕换景\"或\"仪式感开屏\"时（技法卡，与 shot-transitions 三式同层选型）",
+      "duration": "n/a（技法卡；各式占用帧数见参数表，从相邻镜头预算里划）",
+      "energy": "n/a（技法卡，不占能量位）",
+      "source": "references/shots/transition/transition-hidden-cut.md",
+      "styles": [
+        {
+          "key": "invisible-cut",
+          "label": "invisible-cut 前景遮挡隐形切",
+          "description": "一张超画幅卡片带重运动模糊贴脸横扫，糊满全屏的遮挡帧内背景 A→B 硬切，卡片飞出观众以为还是同一镜",
+          "demo": "demos/transition/transition-hidden-cut/InvisibleCut.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/invisible-cut.mp4?v=1790980736890"
+        },
+        {
+          "key": "versus-slam",
+          "label": "versus-slam 对撞开屏",
+          "description": "左右两半屏带斜切边从画外加速对冲撞合，撞击帧白闪+震屏+VS 盖章，切点就是撞击本身",
+          "demo": "demos/transition/transition-hidden-cut/VersusSlam.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/versus-slam.mp4?v=1790980736891"
+        },
+        {
+          "key": "light-leak-burn",
+          "label": "light-leak-burn 琥珀漏光",
+          "description": "三团琥珀柔光沿对角线斜扫，光峰帧吞掉旧页约七成时硬切新页，光退散时新页已就位",
+          "demo": "demos/transition/transition-hidden-cut/LightLeakBurn.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/light-leak-burn.mp4?v=1790980736892"
+        }
+      ]
+    },
+    {
+      "id": "transition-travel",
+      "category": "transition",
+      "summary": "穿越式转场——字腔穿越：巨型章节标题的字形就是一扇窗，镜头钻进字形笔画完成换景",
+      "use": "前后两镜存在\"元素/容器\"级空间关系的接缝（技法卡，与 shot-transitions 三式互补选用）",
+      "duration": "n/a（技法卡；demo 150f，主推动作段 52f，前后 hold 另计，帧数从相邻镜头预算里划）",
+      "energy": "n/a（技法卡，不占能量位）",
+      "source": "references/shots/transition/transition-travel.md",
+      "styles": [
+        {
+          "key": "letterform-zoom",
+          "label": "字腔穿越 letterform-zoom",
+          "description": "穿越式转场——字腔穿越：巨型章节标题的字形就是一扇窗，镜头钻进字形笔画完成换景",
+          "demo": "demos/transition/transition-travel/LetterformZoom.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/letterform-zoom.mp4?v=1790980736893"
+        }
+      ]
+    },
+    {
+      "id": "type-and-filter",
+      "category": "interaction",
+      "summary": "真实 UI 上打字搜索、网格自己收敛成一张卡、点击穿透进详情页",
+      "use": "功能演示的\"操作叙事\"段；搜索/筛选/进入详情的任何交互链路",
+      "duration": "约 2.5s（118–190f）",
+      "energy": "中（发牌高能段之后的从容一拍）",
+      "source": "references/shots/interaction/type-and-filter.md",
+      "styles": [
+        {
+          "key": "type-and-filter",
+          "label": "type-and-filter",
+          "description": "真实 UI 上打字搜索、网格自己收敛成一张卡、点击穿透进详情页",
+          "demo": "demos/interaction/type-and-filter/TypeAndFilter.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/type-and-filter.mp4?v=1790980736894"
+        }
+      ]
+    },
+    {
+      "id": "type-assembly-moves",
+      "category": "typography",
+      "summary": "文字集结三式——split-text-stagger 逐字裂升、letterform-drift-assembly 漂移合拢、text-on-path 沿线流入",
+      "use": "大标题/标语的入场；与 type-entrance-moves、document-typewriter-reveal 同属标题入场大品类，全片 ≤2 种",
+      "duration": "单式 4–5.5s（动作段 A ~56f / B ~104f / C ~110f；demo 全长含 hold：A 130f / B 150f / C 160f，各自导出 `*_DURATION`）",
+      "energy": "A 中 / B 中高 / C 中",
+      "source": "references/shots/typography/type-assembly-moves.md",
+      "styles": [
+        {
+          "key": "split-text-stagger",
+          "label": "split-text-stagger 裂升",
+          "description": "每字 overflow 盒内 translateY(115%→0) 带 10% 过冲，delay i×2f，基线同步生长",
+          "demo": "demos/typography/type-assembly-moves/SplitTextStagger.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/split-text-stagger.mp4?v=1790980736895"
+        },
+        {
+          "key": "drift-assembly",
+          "label": "drift-assembly 漂移合拢",
+          "description": "字符 seed 方向 ±300px + blur 8px 漂入错峰归位，锁定帧加深脉冲，合体后整词呼吸 1.04",
+          "demo": "demos/typography/type-assembly-moves/LetterformDriftAssembly.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/drift-assembly.mp4?v=1790980736896"
+        },
+        {
+          "key": "text-on-path",
+          "label": "text-on-path 沿线流入",
+          "description": "字符沿贝塞尔曲线鱼贯滑入（切线角旋转），到达后 12f 摆正水平",
+          "demo": "demos/typography/type-assembly-moves/TextOnPath.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/text-on-path.mp4?v=1790980736897"
+        }
+      ]
+    },
+    {
+      "id": "type-entrance-moves",
+      "category": "typography",
+      "summary": "标题文字入场一式——letter-drop-physics 字符坠落（重力砸落、弹跳、歪斜站定，最后一拍集体立正归位）",
+      "use": "大标题/章节字卡的入场；与 type-assembly-moves（集结系）、document-typewriter-reveal（打字机）同品类互斥选用",
+      "duration": "单式 5s（含 hold 与静止收尾；动作段 ~116f，demo 150f）",
+      "energy": "中高（物理趣味）",
+      "source": "references/shots/typography/type-entrance-moves.md",
+      "styles": [
+        {
+          "key": "letter-drop-physics",
+          "label": "letter-drop-physics 字符坠落",
+          "description": "标题文字入场一式——letter-drop-physics 字符坠落（重力砸落、弹跳、歪斜站定，最后一拍集体立正归位）",
+          "demo": "demos/typography/type-entrance-moves/LetterDropPhysics.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/letter-drop-physics.mp4?v=1790980736898"
+        }
+      ]
+    },
+    {
+      "id": "type-rhythm-sync",
+      "category": "typography",
+      "summary": "文字随声同步两式——font-weight-pump 字重脉冲（笔画随鼓点变粗弹回）与 karaoke-fill-sync 卡拉OK填色（词随旁白逐个点亮）",
+      "use": "标题/标语与音轨强绑定的段落；A 绑节拍（鼓点），B 绑语音（旁白逐词）",
+      "duration": "A FontWeightPump 165f / B KaraokeFillSync 150f；A 128 BPM 每拍 14f、衰减窗 9–13f，B 每词按语速 18–33f",
+      "energy": "A 高（蹦迪感）/ B 中（跟读引导）",
+      "source": "references/shots/typography/type-rhythm-sync.md",
+      "styles": [
+        {
+          "key": "font-weight-pump",
+          "label": "font-weight-pump 字重脉冲",
+          "description": "命中帧笔画瞬间变粗（stroke+字重跳变），~10f 衰减弹回；重音拍额外撑宽 8%",
+          "demo": "demos/typography/type-rhythm-sync/FontWeightPump.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/font-weight-pump.mp4?v=1790980736899"
+        },
+        {
+          "key": "karaoke-fill-sync",
+          "label": "karaoke-fill-sync 填色随读",
+          "description": "每词深色从左到右填亮，进度跟语速，读完保持；活跃词下带读指下划线",
+          "demo": "demos/typography/type-rhythm-sync/KaraokeFillSync.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/karaoke-fill-sync.mp4?v=1790980736900"
+        }
+      ]
+    },
+    {
+      "id": "typewriter-moves",
+      "category": "typography",
+      "summary": "打字机 error-retype——误删重打的\"改口\"三幕剧：打出平庸词 → 犹豫 → 退格删掉 → 更快打出卖点词",
+      "use": "slogan/卖点字卡、否定式文案；文字自带时间性的入场",
+      "duration": "~5.3s（160f）",
+      "energy": "中低",
+      "source": "references/shots/typography/typewriter-moves.md",
+      "styles": [
+        {
+          "key": "error-retype",
+          "label": "error-retype",
+          "description": "打字机 error-retype——误删重打的\"改口\"三幕剧：打出平庸词 → 犹豫 → 退格删掉 → 更快打出卖点词",
+          "demo": "demos/typography/typewriter-moves/TypewriterErrorRetype.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/error-retype.mp4?v=1790980736901"
+        }
+      ]
+    },
+    {
+      "id": "ui-strip-away-outro",
+      "category": "outro",
+      "summary": "减法式收尾——点击 Publish 后整个编辑器 UI 从外围到中心层层错峰蒸发，黑场上只剩那颗按钮滑到屏心放大，按钮再淡出交棒字标定版",
+      "use": "\"发布/完成\"语义的 outro；想讲\"一键之后一切复杂性消失\"的产品收尾",
+      "duration": "~4.8s（144f：光标就位 34f → 蒸发 ~40f → 按钮独占 → 字标接棒 → 字标 hold ≥1s）",
+      "energy": "中（前段安静操作，中段持续退场，无瞬时冲击）",
+      "source": "references/shots/outro/ui-strip-away-outro.md",
+      "styles": [
+        {
+          "key": "ui-strip-away-outro",
+          "label": "ui-strip-away-outro",
+          "description": "减法式收尾——点击 Publish 后整个编辑器 UI 从外围到中心层层错峰蒸发，黑场上只剩那颗按钮滑到屏心放大，按钮再淡出交棒字标定版",
+          "demo": "demos/outro/ui-strip-away-outro/UiStripAwayOutro.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/ui-strip-away-outro.mp4?v=1790980736902"
+        }
+      ]
+    },
+    {
+      "id": "ui-to-brand-morph",
+      "category": "outro",
+      "summary": "UI 变品牌两式——icon-flip-bloom 图标 Y 轴翻扁成竖线、从竖线撑开成品牌标志（琥珀斜切随后划入）+ wordmark 逐字落定，与 input-morph-assemble 输入框收缩成取景框竖笔、三块图元落进构造槽位拼成完整标志",
+      "use": "品牌收尾/outro 前最后一拍；\"你每天用的那个 UI 就是这个品牌\"的视觉论证",
+      "duration": "A ~4.3s（130f）/ B ~5.6s（168f）",
+      "energy": "中高（收尾点睛，一次完整变形讲完）",
+      "source": "references/shots/outro/ui-to-brand-morph.md",
+      "styles": [
+        {
+          "key": "icon-flip-bloom",
+          "label": "icon-flip-bloom",
+          "description": "图标 anticipation 晃两下→Y 轴 scaleX 压扁成竖线（双层拖影+blur）→最薄处实体交换、spring 展开成 video-shotcraft「镜刻」标志、琥珀斜切第二拍划入→标志左移让位、字标逐字落定",
+          "demo": "demos/outro/ui-to-brand-morph/IconFlipBloomLogo.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/icon-flip-bloom.mp4?v=1790980736903"
+        },
+        {
+          "key": "input-morph-assemble",
+          "label": "input-morph-assemble",
+          "description": "光标点发送→文字飞走→输入框 x/y/w/h/r 五量 spring 插值成标志的竖框→上下横条与琥珀斜切从虚线构造框里依次落位拼成「镜刻」标志→左移让位、字标逐字落定",
+          "demo": "demos/outro/ui-to-brand-morph/InputMorphsIntoLogo.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/input-morph-assemble.mp4?v=1790980736904"
+        }
+      ]
+    },
+    {
+      "id": "value-stagger-gradient",
+      "category": "ui-entrance",
+      "summary": "16 根柱入场时 delay 是时间错峰，同时高度/色相/位移/模糊四个属性各自铺成从首到末的数值梯度；第二拍把错峰原点换成中心，脉冲幅度以中心为最大重新铺开",
+      "use": "技法演示与参数化能力的展示镜头；也可直接当数据/频谱/均衡器类界面的入场",
+      "duration": "约 5.0s（150f@30fps）",
+      "energy": "中高（第一拍是连续铺开，第二拍中心脉冲是明确的一次峰值）",
+      "source": "references/shots/ui-entrance/value-stagger-gradient.md",
+      "styles": [
+        {
+          "key": "value-stagger-gradient",
+          "label": "value-stagger-gradient",
+          "description": "16 根柱入场时 delay 是时间错峰，同时高度/色相/位移/模糊四个属性各自铺成从首到末的数值梯度；第二拍把错峰原点换成中心，脉冲幅度以中心为最大重新铺开",
+          "demo": "demos/ui-entrance/value-stagger-gradient/ValueStaggerGradient.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/value-stagger-gradient.mp4?v=1790980736905"
+        }
+      ]
+    },
+    {
+      "id": "vertical-word-roll-blur-cycle",
+      "category": "typography",
+      "summary": "句尾词换成竖向滚轮，3 次换词各 0.55s（outQuint 七成 + outBack 三成，前快后极慢带微过冲），相邻行按距离上垂直 blur 与灰度，中心词落定瞬间从灰染成强调色",
+      "use": "\"Crafted for ___\" / \"Built for ___\" 这类句干 + 受众/对象列举的一句话卖点；浅底品牌片的干净一拍",
+      "duration": "约 5.0s（150f@30fps：静置 → 3 次换词 → 尾部整组淡出）",
+      "energy": "中（稳定三拍，无峰值）",
+      "source": "references/shots/typography/vertical-word-roll-blur-cycle.md",
+      "styles": [
+        {
+          "key": "vertical-word-roll-blur-cycle",
+          "label": "vertical-word-roll-blur-cycle",
+          "description": "句尾词换成竖向滚轮，3 次换词各 0.55s（outQuint 七成 + outBack 三成，前快后极慢带微过冲），相邻行按距离上垂直 blur 与灰度，中心词落定瞬间从灰染成强调色",
+          "demo": "demos/typography/vertical-word-roll-blur-cycle/VerticalWordRollBlurCycle.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/vertical-word-roll-blur-cycle.mp4?v=1790980736906"
+        }
+      ]
+    },
+    {
+      "id": "voice-waveform-live",
+      "category": "interaction",
+      "summary": "录音胶囊实时声纹——64 根细竖条随\"说话\"起伏，说话时中部高耸、停顿缩成点线，波形从右往左滚动；说→停→说→提交塌缩的完整表演",
+      "use": "语音输入/AI 助手\"正在听你说\"的功能镜头；无 UI 内容可展示但需要持续活性撑画面的段落",
+      "duration": "172f（~5.7s：入场 14f + 说 1.4s + 停 0.8s + 说 1.4s + 提交塌缩 / 收进气泡 0.8s + hold 0.7s）",
+      "energy": "中（功能性活性，不是炫技）",
+      "source": "references/shots/interaction/voice-waveform-live.md",
+      "styles": [
+        {
+          "key": "voice-waveform-live",
+          "label": "voice-waveform-live",
+          "description": "录音胶囊实时声纹——64 根细竖条随\"说话\"起伏，说话时中部高耸、停顿缩成点线，波形从右往左滚动；说→停→说→提交塌缩的完整表演",
+          "demo": "demos/interaction/voice-waveform-live/VoiceWaveformLive.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/voice-waveform-live.mp4?v=1790980736907"
+        }
+      ]
+    },
+    {
+      "id": "wall-reveal-moves",
+      "category": "ui-entrance",
+      "summary": "整墙批量入场两式——bento 逐格点亮、蓝图描线成形，全部原位显形不位移，与 deck-deal-flyin 的飞入位移型互补成品类矩阵",
+      "use": "功能墙/卡片墙/整页界面的整体亮相；内容已在原位、要\"显形\"而非\"涌入\"的段落",
+      "duration": "单式约 5s（A 150f / B 150f @30fps，含建立 hold 与静止收尾）",
+      "energy": "中",
+      "source": "references/shots/ui-entrance/wall-reveal-moves.md",
+      "styles": [
+        {
+          "key": "bento-light-up",
+          "label": "bento-light-up 逐格点亮",
+          "description": "暗场 3×2 bento 墙压暗待命，琥珀流光逐格描边一圈、内容随即提亮上浮，全亮后镜头缓推收住",
+          "demo": "demos/ui-entrance/wall-reveal-moves/BentoLightUp.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/bento-light-up.mp4?v=1790980736908"
+        },
+        {
+          "key": "wireframe-draw-on",
+          "label": "wireframe-draw-on 蓝图描线成形",
+          "description": "界面先以 SVG 细线蓝图分组描画，再一条琥珀发光竖线左→右扫过，扫过处线框实体化成真实界面",
+          "demo": "demos/ui-entrance/wall-reveal-moves/WireframeDrawOn.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/wireframe-draw-on.mp4?v=1790980736909"
+        }
+      ]
+    },
+    {
+      "id": "white-flash-logo-simplify-cut",
+      "category": "transition",
+      "summary": "液态金属质感的彩色词标静置流光，蓄力后从字心炸出一记白闪过曝，曝光回落时同一位置已是扁平版字标——一次闪白完成质感降维",
+      "use": "品牌段落收束（华丽演绎→干净定妆）；情绪从炫技切换到正式宣告的转场拍",
+      "duration": "约 4s（120f@30fps；演出 0–34f · 蓄力 34–46f · 冲白 44–54f · 曝光回落 54–76f · 锁定 72–96f · hold 至 120f）",
+      "energy": "中高（一次脉冲式重音，前后都是静场）",
+      "source": "references/shots/transition/white-flash-logo-simplify-cut.md",
+      "styles": [
+        {
+          "key": "white-flash-logo-simplify-cut",
+          "label": "white-flash-logo-simplify-cut",
+          "description": "液态金属质感的彩色词标静置流光，蓄力后从字心炸出一记白闪过曝，曝光回落时同一位置已是扁平版字标——一次闪白完成质感降维",
+          "demo": "demos/transition/white-flash-logo-simplify-cut/WhiteFlashLogoSimplifyCut.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/white-flash-logo-simplify-cut.mp4?v=1790980736910"
+        }
+      ]
+    },
+    {
+      "id": "wipe-transitions",
+      "category": "transition",
+      "summary": "几何擦除转场——blinds-slice 百叶窗切条（12 根 3D 叶片错峰翻面成波，波扫过后整页由 A 换成 B）",
+      "use": "新旧页都不动、一条几何边界扫过完成交接的通用转场；不依赖构图里有合适元素，哪儿都能用",
+      "duration": "前态 ≥20f + 擦除 ~56f + 收尾 ≥40f，约 4.4s（132f）",
+      "energy": "中",
+      "source": "references/shots/transition/wipe-transitions.md",
+      "styles": [
+        {
+          "key": "blinds-slice",
+          "label": "blinds-slice",
+          "description": "几何擦除转场——blinds-slice 百叶窗切条（12 根 3D 叶片错峰翻面成波，波扫过后整页由 A 换成 B）",
+          "demo": "demos/transition/wipe-transitions/BlindsSlice.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/blinds-slice.mp4?v=1790980736911"
+        }
+      ]
+    },
+    {
+      "id": "word-relay-filmstrip",
+      "category": "typography",
+      "summary": "左列黑白相间等高页面卡步进滚动（焦点卡全亮、邻卡离焦压暗）、右侧衬线大词原位接力（名词恒定+动词轮换）——切词瞬间才滚动一格，词块垂直中心与当前页面卡中点精确对齐",
+      "use": "\"一个主体 × 多种能力\"的枚举段（Shotcraft frames/builds/ships…）；作品集/案例流展示；产品多场景巡礼",
+      "duration": "每词期 ~1.5–2s × 3–4 词；demo 180f（6s）",
+      "energy": "中低（编辑部气质，节奏靠切词的\"咔哒\"感）",
+      "source": "references/shots/typography/word-relay-filmstrip.md",
+      "styles": [
+        {
+          "key": "word-relay-filmstrip",
+          "label": "word-relay-filmstrip",
+          "description": "左列黑白相间等高页面卡步进滚动（焦点卡全亮、邻卡离焦压暗）、右侧衬线大词原位接力（名词恒定+动词轮换）——切词瞬间才滚动一格，词块垂直中心与当前页面卡中点精确对齐",
+          "demo": "demos/typography/word-relay-filmstrip/WordRelayFilmstrip.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/word-relay-filmstrip.mp4?v=1790980736912"
+        }
+      ]
+    },
+    {
+      "id": "word-relay-geometry",
+      "category": "typography",
+      "summary": "三个利益词各带一套专属几何接力——虚线大圆减速自转 + 彗星弧飞跑 → 三实线圆 trim 依次生长后收拢咬紧 → 镀铬金属 sheen 扫过后一拍收成纯白；旧词缩到 0.86 淡出，新词描边→填充揭示",
+      "use": "三点式利益陈述（更快/更好/更强）；品牌价值观段落；需要\"一词一世界\"的中段推进",
+      "duration": "约 6.0s（180f@30fps：三段各 ≈60f，段间重叠 6f）",
+      "energy": "中高（三拍推进 + 全程几何运动 + 背景粒子，无静止帧）",
+      "source": "references/shots/typography/word-relay-geometry.md",
+      "styles": [
+        {
+          "key": "word-relay-geometry",
+          "label": "word-relay-geometry",
+          "description": "三个利益词各带一套专属几何接力——虚线大圆减速自转 + 彗星弧飞跑 → 三实线圆 trim 依次生长后收拢咬紧 → 镀铬金属 sheen 扫过后一拍收成纯白；旧词缩到 0.86 淡出，新词描边→填充揭示",
+          "demo": "demos/typography/word-relay-geometry/WordRelayGeometry.tsx",
+          "previewUrl": "https://vincentwei1021.github.io/video-shotcraft/media/word-relay-geometry.mp4?v=1790980736913"
+        }
+      ]
+    }
+  ]
+}