hyper-animator-codex 0.7.1 → 0.8.0

package/skills/hyper-animator-codex/references/shotcraft/cards/overhead-camera-moves/README.md

@@ -0,0 +1,50 @@
+---
+name: overhead-camera-moves
+一句话: 俯拍揭示两式——tilt-reveal 俯仰抬正揭示、overhead-tabletop-drop 桌面卡阵横滑骤降扎入
+适用: 用"俯仰角"讲故事的开场/转场：单页 establishing 用 A，多页巡视择一扎入用 B
+时长: A ~4.8s / B ~4.7s
+能量: A 中 / B 中高
+---
+
+## 意图
+库内俯拍视角一直空缺——crane-rise 是"平移+缩放"的升起（俯仰角
+不动），space-camera C 式 drone-dive 是俯冲降落一镜到底；这两式让
+**俯仰角本身讲故事**：A 是揭示——整页 rotateX 平躺、开场只见上缘
+一条透视窄带，机位"抬头"回正，内容一排排涌入视野，像掀开桌上的
+图纸；B 是选择——三张页面卡平躺成桌面卡阵，相机俯拍横向滑过依次
+掠过（韦斯·安德森 tabletop），滑到目标页猛地俯冲扎入、抬正成满屏，
+"巡视一圈，就选这张"。选型：单页开场用 A，多页转场/开场用 B。
+
+## 两式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A tilt-reveal | perspective 容器内整页 rotateX -80° 平躺，~43f 抬正，rotateX/scale/translateY 共用 out-cubic，末端轻过冲 | 开场 establishing；单主体 |
+| B overhead-tabletop-drop | 卡阵平躺 rotateX 62°，pan 段只动 translateX 横滑掠过，drop 段角度/缩放/位移三通道同跑扎入落版 | 多页巡视后择一；转场/开场两用 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 俯角 | rotateX 关键帧 [-80, 2.6, -0.9, 0]（f25→68→72→76），transformOrigin 50% 0% | 首版 -55° 太弱：f0 仍见半页，无"窄带"悬念（实渲判例） |
+| A 联动 | perspective 600→1200、perspectiveOrigin 5%→40% 随进度插值；scale 3.2→1 + translateY 200→0 | perspective 不联动则俯角初始见不到"只露顶栏" |
+| A 收尾 | 全部动画 f76 结束，145f 留 69f 真静止 | 过冲幅度 ≤3°，再大读作弹簧不是机位 |
+| B pan 段 | 0–55f 只改 translateX +700→-650（in-out cubic），角度不动 | pan 段动角度 = 两段职责糊掉（判例：pan 巡视、drop 表态） |
+| B drop 段 | 55–85f 三通道同跑：rotateX 62→-1.8→0.6→0（out-cubic 过冲）、scale 1→2.04→2.0、translateX -650→0 | 三通道必须同跑；分先后读作两个动作 |
+| B 卡阵 | 卡片 996×560（16:9 精确比），落版 scale 2.0 恰满屏正视；transform 顺序 translateX→rotateX→scale | 顺序错了 pan 会带出弧线轨迹 |
+| B 地板 | 浅灰网格地板 | 无地板参照，横滑段读不出"相机在动" |
+| B 收尾 | 全部动画 f93 结束，140f 留 47f 真静止 | — |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 大角度透视下卡片必须 backfaceVisibility hidden + translateZ(4px)
+  兜底，否则个别帧背面/深度穿帮
+- A 与 crane-rise-reveal 同片二选一——都是开场揭示，两个"揭示开场"
+  等于没有揭示
+- B pan 段角度锁死是命门（两段职责分离判例）：巡视归巡视、扎入归
+  扎入，混着动观众不知道相机想干嘛
+- 两式都是"相机大动作"，与 space-camera/crane-rise 同屏段落互斥，
+  一个段落只能有一个持镜人
+
+## 参考实现
+demos/overhead-camera-moves/
+（OverheadTabletopDrop.tsx / TiltReveal.tsx）

package/skills/hyper-animator-codex/references/shotcraft/cards/page-turn-transitions/README.md

@@ -0,0 +1,48 @@
+---
+name: page-turn-transitions
+一句话: 整页体块转场两式——cube-rotate 立方体翻转（两页贴盒子相邻面转 90°）与 barn-door-split 对开门裂幕（旧页裂两半滑出、新页迎上）
+适用: 章节级换页：两个并列大段落之间的"翻篇"仪式；与 shot-transitions 系（镜头交棒）分工——那是"航拍机移过去"，这是"页面自己是实体"
+时长: 单式 前态建立 30f + 转场 20–38f + 收尾 ≥40f，约 4.4–4.7s
+能量: 中高
+---
+
+## 意图
+shot-transitions 六式和 transition-travel/hidden-cut 都把页面当"场景"
+——相机在场景间移动。本卡把页面当**实体**：它有厚度、有重量、会翻面
+会裂开。体块隐喻的仪式感更强，适合章节级大换页（功能 A 讲完→功能 B）
+而非镜头级小交棒。A 立方体是"空间上并列"——两页是盒子的两面，
+暗示同级关系；B 对开门是"旧的让位"——旧页从正中撕开滑走、新页
+从底下迎上来，暗示取代关系。按语义选：并列翻篇用 A，新旧交替用 B。
+
+## 两式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A cube-rotate | 两页贴立方体相邻面（rotateY 0/90° + translateZ W/2），场景层转 -90°；旧面转出压暗、新面转进变亮，45° 时两面夹一条暗棱 | 并列章节翻篇；产品两大功能区切换 |
+| B barn-door-split | 旧页两个 960px overflow 容器对位拼合，同时向外 Easing.in(cubic) 滑出画外；裂缝内边缘亮线+投影，新页底层 scale 1.06→1 迎上 | 新旧交替：改版前后、方案 A→方案 B |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 结构命门 | 场景层 `translateZ(−W/2) rotateY(θ)` 把正面拉回 z=0 | 少了这层 hold 段页面尺度不对（被 perspective 推远） |
+| A 转速 | θ 0→−90° / 38f inOut cubic；中段叠 blur 1.5px 落定摘 | <28f 读不出体块感；>50f 读作慢慢挪 |
+| A 亮度对切 | 旧面 1→0.55、新面 0.55→1 + 接缝竖向渐变阴影 sin(pπ) | 无明暗对切两面读作同一张图在转 |
+| B 预告 | 裂前中缝 2px 细线闪现两次（18–22/25–29f） | 直接裂开观众没看到裂点在哪 |
+| B 滑出 | 各 translateX ∓980px / 20f Easing.in(cubic) 加速 | ease-out 滑出是"被推走"，ease-in 才是"让位" |
+| B 撕裂边 | 内边缘 3px G.ink 亮线 + 8px 投影 | 无边线两半读作普通左右擦除 |
+| 收尾 | 新页落定真静止 ≥40f | R1 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 一缝一式规矩同 shot-transitions；体块转场比镜头交棒更重，
+  **全片 ≤2 次**，连续两缝都用体块读作 PPT 翻页
+- A 式官方 `@remotion/transitions` cube() 是付费件——本卡是 CSS 自实现，
+  backlog 已有"评估官方转场原语"待选项，若引入官方件可对照
+- B 式两半必须**对位拼合无缝**（右半内层 translateX(−960px)）——
+  静止时看出接缝就穿帮；真实截图注意奇数宽度取整
+- 转场前后两页都要有 ≥30f 静止建立/收尾——两端都在动，体块感被
+  运动淹没
+
+## 参考实现
+demos/page-turn-transitions/
+（BarnDoorSplit.tsx / CubeRotate.tsx）

package/skills/hyper-animator-codex/references/shotcraft/cards/page-waterfall-wall/README.md

@@ -0,0 +1,52 @@
+---
+name: page-waterfall-wall
+一句话: 页面瀑布墙——真实页面截图切成 3–4 列在 3D 后仰墙面上差速反向无限滚动，视差 + 镜头缓推做"内容多到流不完"的一览
+适用: "多页面/多功能/多模板"体量感段落；montage 中段铺陈或 intro 后的产品广度镜头
+时长: 4–6s（无限循环体，时长由段落需要裁）
+能量: 中（流动陈列型）
+---
+
+## 意图
+流动式一览：让观众在几秒内"看到很多页面流过"，读感是体量而非细节。
+与 outro-group-photo-launch 分工：那是**聚拢式**一览（元素飞来围住
+字标定格合影，语义"属于同一产品"），本卡是**流动式**一览（内容持续
+流过不定格，语义"还有很多没给你看完"）。与 odometer-digit-roll 分工：
+那是有终值的机械滚轮（逐位停稳读数字），本卡无终值无限循环。
+与 wall-reveal-moves 分工：那是整墙**入场动作**，本卡是墙的**持续状态**，
+可用那卡入场后交棒本卡续流。
+
+## 动效核心
+- lib 组件 `assets/lib/VerticalTicker.tsx`：父层 perspective(1000px)
+  rotateX(20°) scale(1.2) 后仰成墙；每列 [...items,...items] 翻倍 +
+  progress 取模 translateY 0→-50% 无缝循环；上下渐变遮罩收边
+- 差速反向是视差命门：3 列 loop 时长错开（如 12/9/14s），中列反向——
+  等速同向读作一张大图在滚，差速反向才读出"独立的列"
+- 镜头缓推寄生在外层（scale 1→1.06 线性铺满全镜），墙自身循环、
+  镜头单向，两个运动源方向不同不打架
+- 素材：真实页面截图切片（Q1 脱敏后），卡片级切块比整页长图好——
+  整页切片滚动时观众来不及读，卡片块有完整轮廓可辨识
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 列数 | 3（1080p）/ 4（超宽） | 2 列读不出"墙"，5 列单列过窄纹理糊 |
+| loop 时长 | 相邻列差 ≥25%（12/9/14s） | 差速太小视差读不出；最快列 <7s 开始读作"刷屏" |
+| 方向 | 中列反向（-1,1,-1 或交替） | 全同向=一张大图；反向列是"独立列"的最强证据 |
+| 倾角/透视 | rotateX 20° / perspective 1000px | >25° 顶部行文字透视压糊（Q2）；<12° 读不出墙面后仰 |
+| scale | 1.2 基础 + 缓推至 ~1.26 | 1.2 是补透视收缩的底值，低于它四角露底 |
+| 遮罩高度 | 200px | 太矮行硬进硬出；太高可视区剩不下 2 行 |
+| 循环周期 | -50% 位移必须恰等于单副本周期（内容高+n·gap） | lib 已用 marginBottom 保证；自写实现用 flex gap 会差 gap/2 跳帧 |
+
+## 已知坑
+- **参数借鉴自外部实现（remotion-3d-ticker），非实战定稿；
+  首次实战须以真实素材回验**
+- 每列 items 总高必须 ≥ 视口有效高（否则同屏见同一切片两次，穿帮）；
+  列间切片不要复用同一张图，同图同时出现在两列读作素材穷
+- 本卡是氛围/铺陈镜头不是信息镜头：切片上文字只求"看得出是真页面"
+  不求读完；想让观众读某一块，交棒 spotlight-hero-card 单主角处理
+- P4 去重：与 outro 合影同片共存没问题（一流动一聚拢），但全片
+  瀑布墙只出现一次，二次出现读作凑时长
+
+## 参考实现
+assets/lib/VerticalTicker.tsx（核心组件）；
+demo 见 demos/page-waterfall-wall/（PageWaterfallWall.tsx / VerticalTicker.tsx）。

package/skills/hyper-animator-codex/references/shotcraft/cards/panel-grid-moves/README.md

@@ -0,0 +1,52 @@
+---
+name: panel-grid-moves
+一句话: 分格节奏三式——grid-flash-mosaic 九宫格闪切填墙吞屏、flip-grid-reflow 网格集体重排、comic-panel-split 漫画斜格三机位并列
+适用: 把"格子"当节奏器：逐格踩拍亮相（A）、节拍点集体换位（B）、同主体多机位定格并列（C）；三式都吃拍点
+时长: A ~4.7s / B ~4.8s / C ~5s
+能量: A 高 / B 中 / C 中高
+---
+
+## 意图
+与 wall-reveal-moves 的区别是本卡的定位锚：那是"整墙怎么入场"
+（一次性揭示），这是"格子怎么当节奏器"——分格、重排、并列都发生
+在节拍上，格变即鼓点。A 是填：3×3 格按十六分音符乱序逐格啪啪硬入，
+填满停一拍，中心格放大吞掉全屏——功能矩阵一秒全亮相；B 是移：6 张卡
+在节拍点集体直线换位（横排→3×2 网格），半秒落定 + 加深脉冲收束——
+布局重排本身当一个鼓点；C 是并：画面咔咔切成 3 个斜线分格，同一产品
+三种机位同时定格，停半拍后一格斜边扩张吃掉全屏——Scott Pilgrim 的
+分屏语言。按需选：多功能亮相用 A，布局叙事用 B，单品多视角用 C。
+
+## 三式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A grid-flash-mosaic | 3×3 格每 2f 一格按 h(i) 乱序条件挂载硬入（入格 3f scale 1.18→1 + 2f 加深脉冲），满墙呼吸一拍，中心格 14f Easing.in(cubic) 放大 3.28x 吞屏 | 功能矩阵一秒全亮相；高潮前铺排 |
+| B flip-grid-reflow | 预写两套坐标表（横排/3×2 网格），每卡 delay=i×1.5f、16f inOut cubic 直线飞行 + scale 1→1.28 带 1.02 过冲；落定后 6f brightness 0.78 全画面脉冲 | 布局叙事：并列→分组的语义换挡 |
+| C comic-panel-split | 三格各一份整页 clip-path 12° 斜边裁切 + translate/scale 摆机位（1x/1.9x/2.6x），逐格 2f 间隔弹入；定格 18f 各格缓推保活，末格斜边 12f out-cubic 扩张吃屏 | 同一主体多视角并列；漫画感段落 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 硬入 | 未到拍点直接不渲染（条件挂载），零淡化 | 逐格硬入无淡化——命门；淡入就不是"啪" |
+| A 描边 | 每格 3px 深色描边（border-box） | 白底提亮不可见判例的反向应用：白卡靠描边分格 |
+| A 吞屏 | 中心格塞 0.3125x 整页，放大 3.28（>3.2）让描边滑出画外 | 描边残在收尾满屏上就穿帮 |
+| B 坐标 | 两套表预写（行 y=330 / 网格列 571.6/960/1348.4、行 416.2/663.8），纯 transform | 免真 FLIP 量测；帧确定无随机 |
+| B 交错 | 偶数索引上排、奇数下排，轨迹互不对穿 | 乱排轨迹会恶性穿帮 |
+| B 脉冲 | f58–64 brightness 0.78，filter 仅窗口内条件挂载 | 摘罩判例；窗口外挂 filter 毁真静止 |
+| C 斜缝 | SVG 双线：16px 墨 #2f2f2f 底 + 10px 白核，12° 斜角 | 斜缝白线是漫画感命门；直缝读作分屏工具 |
+| C 保活 | 定格 18f 各格 scale 缓推 +3%/+5.5%/+8% | 三格全静读作截图拼贴 |
+| 收尾 | A 68f / B 81f / C 93f 真静止（≥40f） | R1；C 摘罩帧与扩张终值对齐防跳变 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- C 三格必须是**同一主体的不同机位**——三格塞不同内容读作 bento
+  排版不是漫画分格，语义就散了
+- 三式都吃拍点、声音强依赖：A 逐格一声啪、B 起飞与脉冲各一声、
+  C 逐格咔咔三声（sound-design §4.5）；不踩拍的分格只是布局动画
+- 同片分格系 ≤1 段——格子语言辨识度太强，两段就撞
+- A 与 wall-reveal-moves 别同片连用（都是"墙"，观众分不出
+  入场还是节奏器）
+
+## 参考实现
+demos/panel-grid-moves/
+（ComicPanelSplit.tsx / FlipGridReflow.tsx / GridFlashMosaic.tsx）

package/skills/hyper-animator-codex/references/shotcraft/cards/paper-craft-moves/README.md

@@ -0,0 +1,46 @@
+---
+name: paper-craft-moves
+一句话: 纸艺两式——masking-tape-slap 纸胶带拍定（悬浮微晃被"啪啪"按死）与 popup-book-rise 立体书立起（卡片沿底边错峰立墙）
+适用: 纸墨主视觉片的实体材料语言：单卡定妆入场用 A、整版 dashboard 开场建立用 B；与纸墨+强调色的主视觉（模板片为纸/墨/琥珀）天然同源
+时长: A 3–4s / B 4–5.5s
+能量: A 中（两拍打击）/ B 中高（立墙有纵深冲击）
+---
+
+## 意图
+Wes Anderson 手账美术与立体书纸艺的 UI 翻译。A：卡片轻飘入位后
+悬着微晃（未固定的纸），两条撕边半透明胶带"啪、啪"先后拍在对角，
+第二条拍下**同帧**卡片停晃、投影变薄、整卡下沉——"按死"的定妆
+一瞬是主角，两声"啪"是天然音效点。B：整页平躺如摊开书页（俯视），
+卡片像贴在页上的纸片沿各自底边错峰立起成墙，立到 95° 回弹 90°
+（纸的韧性），根部投影随立起收窄。
+
+## 两式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A masking-tape-slap | 晃动=幅度包络×正弦（rot ±1.5°/bob ±5px）；胶带扑入 6f：scale 1.45→1 + rotate 欠 16°→过冲 7°→回正 + 落帧 scaleY 0.72 一帧压扁；撕边 14 点 clipPath 锯齿 | 单卡/徽章的定妆入场；文案重音对齐 |
+| B popup-book-rise | 双层 3D：场景 rotateX 75° 俯视（persp 2600），每卡 rotateX 0→-90° spring（damping 11 过冲 -95°），origin 底边，preserve-3d 贯通；远排先近排后错峰 7f | 整版 dashboard 开场；"系统被搭建起来" |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 按死三件套 | 同帧：晃动 2f 归零 + 投影 34px→8px + 全卡下沉 2px | 三件拆帧就没有"按死"感；第一条胶带只把包络衰到 0.45（半死） |
+| A 胶带质感 | 半透明 + 锯齿撕边 + 落点故意歪 2–3° | 歪斜是设计的手工感；直挺挺读作 UI 元素 |
+| B 立起方向 | rotateX 0→**-90°**（向观众立起） | demo 判例：方向写反卡片往画面里倒被底板裁切 |
+| B 根部投影 | blur 矩形不随卡立起，高 104→14px、透明度 0.26→0.1 随角度插值 | 无投影纸片浮空；投影跟着立起来穿帮 |
+| B 收尾 | 全部站定后场景 75°→68° 轻回正（in-out cubic） | 直接定住少一口呼吸 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- A 的晃动是"未固定"的叙事铺垫不是手持抖动（Q3 边界）：
+  振幅包络必须最终归零，全片只在被按死前存在
+- B 与 tilt-reveal 分工：tilt 是**机位**抬头看静止页面，
+  本卡机位基本不动、**构件自己**站起来
+- B 立墙后卡片呈 90° 侧立态，文字不可读——立墙是构图动作，
+  信息交给立起后的正视段落（Q6 同源）
+- 声音：A 两声"啪"（纸拍击拟音）；B 每排立起一声轻纸响，
+  错峰对齐（S2/S4 同源）
+
+## 参考实现
+demos/paper-craft-moves/
+（MaskingTapeSlap.tsx / PopupBookRise.tsx）

package/skills/hyper-animator-codex/references/shotcraft/cards/paper-plane-messenger/README.md

@@ -0,0 +1,62 @@
+---
+name: paper-plane-messenger
+一句话: 纸飞机信使转场——点击"发送"后镜头拉远脱离窗口 A，折纸飞机沿贝塞尔弧线飞出（俯仰跟随切线），镜头伴飞穿过多层视差道具，飞抵窗口 B 门前落定，B 放大接管全屏
+适用: "发送/邀请/分享"动作连接两个人物/场景视角的叙事转场；抽象动作需要一个隐喻实体当转场载具时
+时长: ~5s（150f：点击 12f → 拉远 16–42f → 飞行 34–104f → B 接管 112–146f）
+能量: 中
+---
+
+## 意图
+transition-travel 是镜头钻进画面里的既有元素换景；本卡反过来——从
+动作里**放出一个语义信使**，让镜头跟着它飞去下一个场景。"发送"这个
+抽象动作被实体化成折纸飞机，A/B 两窗的空间关系被飞行轨迹真实丈量
+过，观众对"消息去了哪"有了身体感。命门是 2.5D 相机管线：所有元素
+挂在同一世界坐标系上，镜头中心 A→跟飞机→B、变焦拉远再推近，视差
+道具按 depth 乘相机位移——重 3D 原片降级成一台"假三维"，成本掉一个
+量级而纵深感保留。飞机俯仰角跟随弧线切线是"它在飞"而非"它在平移"
+的全部区别。
+
+## 动效核心
+- 世界坐标系相机：`screen = 960 + (world − camCenter) × zoom × depth`；
+  镜头中心 A(520,560) → 跟飞机 → B(3200,600)，变焦 1.55（贴脸 A）
+  → 0.62（拉远伴飞）→ 3.1（B 接管全屏）
+- 飞机三次贝塞尔：A 发送按钮 → 高抛控制点（y=−80）→ 下压控制点 →
+  B 门前；朝向 = bez(t) 与 bez(t+0.012) 的 atan2 切线角
+- 飞行整体缓动 Easing.bezier(0.45,0.05,0.25,1)（起飞加速、落定
+  减速）70f；途中 scale 放大 1.7 倍保可读，落定收回 1.1
+- 视差道具 16 件（圆环/圆角方块，seed 随机）分 depth 0.45/0.75/1.3
+  三层，远层 blur3、近层 blur8 焦外；各带正弦漂浮
+- 飞机 = SVG 三块折面（白/浅灰/深灰示折痕）+ 描边；入场
+  Easing.back(1.6) 弹出，B 接管期 opacity 淡出不留残影
+- 点击脉冲：按钮 scale ×1.22 + 扩散圈（CLICK 12f 起 3f 峰值）
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 变焦三段 | 1.55 → 0.62 → 3.1 | 不先拉远直接跟飞，观众不知道 B 在哪个方位；拉远 <0.7 才装得下旅程感 |
+| 飞行时长 | 70f，ease-in-out | <45f 读作弹射；匀速读作拖拽平移 |
+| 切线采样 | dt = 0.012 | 太大角度滞后、太小抖动；俯仰角是"飞"的命门，删掉立即变贴图滑动 |
+| 途中放大 | ×1.7（0.25–0.75 区间），落定 ×1.1 | 拉远后飞机只剩几十像素，不放大就丢主角 |
+| 视差层 | depth 0.45/0.75/1.3，远 blur3 近 blur8 | 全同 depth 就没有穿越感；近景不虚会抢飞机视线 |
+| B 接管 | 112–146f，变焦推到 3.1，道具/飞机同步淡出 | 道具不淡出会在推近时变成巨大糊块扫过全屏 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 与 transition-travel 分工：那卡钻进**画面里既有的**元素/容器完成
+  换景（空间早已在构图里）；本卡**放出一个新实体**连接画外的第二场景
+  ——A/B 无既有空间关系时才轮到本卡
+- 与 glow-flyline-moves B（flyline-arc）分工：飞线是暗场数据流向的
+  抽象示意（线是主角），本卡是明场叙事旅程（信使是主角、镜头伴飞）
+  ——讲数据用飞线，讲人与人用信使
+- 信使实体必须来自动作语义（发送→纸飞机、上传→气球、部署→火箭），
+  随便找个吉祥物飞一趟读不出因果
+- 相机三段（拉远/伴飞/接管）的切换帧上中心与变焦都要连续——demo 里
+  zBase/zTake 在 TAKEOVER[0] 处相等（0.62）才不跳帧，改时间轴先查这点
+- 2.5D 的极限：道具只能是剪影级形状，写实道具会暴露"没有真透视"；
+  要重 3D 质感请回原片路线（成本高一档）
+
+## 参考实现
+demos/paper-plane-messenger/
+（PaperPlaneMessenger.tsx）
+原片出处：pitch-app 77–82s（重 3D 原版的 2.5D 降级）

package/skills/hyper-animator-codex/references/shotcraft/cards/paper-title-card/README.md

@@ -0,0 +1,36 @@
+---
+name: paper-title-card
+一句话: 一句话逐词压印上纸、一个词标强调色斜体、短划线收束
+适用: 章节转场/价值主张字卡；重要功能出场前的引导卡；全片呼吸位
+时长: 1.7–1.8s（50–55f）
+能量: 低（呼吸位，隔开两段高能镜头）
+---
+
+## 意图
+在两段产品画面之间给观众一句话的喘息：说清"接下来看什么、它值什么"。letterpress 压印质感让字卡与纸墨风格的产品画面同属一个世界。
+
+## 动效核心
+- 单句文案逐词入场：scale 从大压到 1 + blur→0 + opacity（letterpress 压印配方）
+- 每句恰好一个重点词：italic + 强调色（模板片为琥珀）
+- 强调色短下划线 scaleX 0→1 收束
+- 尾部整卡淡出交棒；可挂 mono 小字副行 + DigitRoll 数字
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 逐词入场 | 第 i 词 delay = 4 + i·4、9f，bezier(0.2,0.75,0.3,1)；scale 1.28→1 + blur 7px→0 + opacity | scale 起点 1.28 是"压印"读感的甜点——对照暗场版 TitleCard 用 40px 上移+blur 10，同配方明暗两版 |
+| 重点词 | italic + 强调色 oklch(52% 0.115 65)，一句恰好一个 accent | 两个 accent 等于没有 accent；重点词选功能名/收益词（C2） |
+| 下划线 | 16→34f scaleX 0→1，220×6px 强调色 | 下划线是收束信号，出现即预告本卡快结束 |
+| 时长 | 全片 4 张字卡均 50–55f（≈1.8s） | 字卡时长定式化——观众读一句话的时间，长了拖节奏短了读不完 |
+| 版式 | 字号 116/serif；纸底 oklch(97.5% 0.008 82) + 中心暖光 radial；尾部 8f 淡出 | 纸底+暖光与产品画面同色系，字卡才不像广告插播 |
+| 副行 | mono 小字 + DigitRoll（如 "5 of 31 fetched today"）；digit-roll 参数见 list-stack-press 卡计数器行 | 副行给具体数字最有说服力；数字滚动必须在本卡淡出前落定（教训）——排节拍从本卡淡出帧倒推 |
+
+## 声音
+字卡出场统一钉 swoosh-quick（模板片四张字卡钉在 f220/565/725/885 同音）——同类元素同音是词汇表纪律（S2）；字卡本身无落地重音，能量留给前后镜头。
+
+## 已知坑
+- 文案要具体：带产品功能名+具体收益，抽象隐喻词被用户逐字改掉（C2——"one board"→"one place to go"、加 "Paper Radar"）；文案在画面锁定后按最终镜头重写一遍（C1）
+- 重要功能出场前要有引导字卡（C2 判例：文档镜头前应加一句引导，如 "Every project, linked to your weekly report"）——字卡不是装饰，是章节路标
+
+## 参考实现
+template/src/aifl/PaperTitleCard.tsx

package/skills/hyper-animator-codex/references/shotcraft/cards/particle-celebrate-hits/README.md

@@ -0,0 +1,42 @@
+---
+name: particle-celebrate-hits
+一句话: 庆祝粒子两式——confetti-crossfire 双侧礼炮（里程碑揭晓帧双炮交叉彩屑弹幕）与 counter-tick-sparks 数字溅火（计数器每破整千顶部迸火星）
+适用: 里程碑数字/KPI 揭晓/成就段落；A 一次性大庆祝，B 持续小打点
+时长: A 3–4s / B 4–5s
+能量: 高潮点缀型（爆发后必须落回纯净静止）
+---
+
+## 意图
+给"数字揭晓"配可听感的视觉打点：A 是揭晓瞬间的句号——画面左下右下
+两门炮同帧开火，上百颗翻转彩屑抛物线交叉飞过全屏再落出画外，纯庆祝
+语义；B 是过程中的逗号——计数器每跳过一个整千，数字顶部"叮"地溅一撮
+小火星坠落熄灭，终值那跳翻倍爆一大撮+数字弹 1.1x。两式都是闭式弹道
+（初速+重力+衰减逐帧公式），免物理引擎、帧确定。
+
+## 两式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A confetti-crossfire | 双炮各 50 颗矩形彩屑：初速 90–150px/f（decay 0.9 下总程 ~900–1500px 才能交叉过中线）、spread 55°、每帧翻转 8–15°；~90f 全部落出画外后条件卸载 | 终值揭晓/发布宣言的一次性高潮 |
+| B counter-tick-sparks | tick 帧由计数器同一 interpolate 派生；每 tick 6–10 颗 2px 火星（初速向上 4–6px/f、重力 12–18f 坠灭），终值跳翻倍 20 颗+数字弹 1.1x | 计数爬升过程的节奏打点 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 初速 | 90–150px/f | 词汇原案 18px/f 在 decay 下只飞 180px 不可感——弹道类幅度按总位移倒推 |
+| A 配色 | 灰阶为主 + 1/3 强调色 | 全彩读作 B 端不合品牌；全灰读不出庆祝 |
+| B 火星量 | 常规 6–10、终值 20 | 默认档最含蓄，嫌弱可 3 倍量做极端版 |
+| 弹道 | 闭式公式（seed 伪随机初速角度） | 每帧独立可算，禁 Math.random |
+| 收尾 | 粒子寿命耗尽条件卸载 | 结尾必须真静止，残留粒子=脏帧 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 同批组合款 ring-confetti-blowout（合环×礼炮）、lights-out-tick-burst
+  （灭灯×溅火）双双淘汰——**爆发×爆发同质叠加读作过载**；
+  本卡两式与其他爆发型手法（slam/impact 系）同帧叠用需谨慎
+- A 只配"值得开炮"的时刻，一片一次；连开读作廉价
+- 声音：A 双炮"砰砰"错开 1–2f 更有层次；B 每 tick 一声细"叮"
+
+## 参考实现
+demos/particle-celebrate-hits/
+（ConfettiCrossfire.tsx / CounterTickSparks.tsx）

package/skills/hyper-animator-codex/references/shotcraft/cards/particle-sand-fill/README.md

@@ -0,0 +1,39 @@
+---
+name: particle-sand-fill
+一句话: 粒子落斗成柱——柱状图不长高而是"下雨下出来"：方点粒子逐颗坠落堆积成柱，堆满凝成实体+数值弹出
+适用: 柱状图/量级对比入场；讲"积累/汇聚"语义的数据段落
+时长: 4–5s
+能量: 中高（构筑感入场）
+---
+
+## 意图
+把柱状图入场从"长高动画"换成"落体堆积"：每根柱上方下一场方块雨，
+粒子逐颗坠落（重力加速）、触堆积面即停+15% 回弹，一层压一层堆到目标
+高度后粒子面淡出换实体柱、顶部数值标签弹出。数据的"量"变成看得见的
+"一颗一颗攒出来"——与 unit-dot-swarm-regroup（点群平面迁徙聚形）
+分工：那是同一批点改队形，这是落体材料筑成图形。
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 粒径 | 14px 方点 | 词汇原案 4px 不可感，QA 中加码 3.5 倍 |
+| 每柱粒子数 | ~50 颗 | 太少堆积感稀疏，太多单颗不可辨 |
+| 坠落 | 重力加速，落地帧闭式预解析 | 堆积高度=已落数×粒径，禁真碰撞模拟 |
+| 回弹 | 触面 15% 单次回弹 | 无回弹读作贴图；多次回弹拖节奏 |
+| 柱间错峰 | 6f 逐柱启动 | 齐落读作机械；错峰有"雨势推移"感 |
+| 收束 | 堆满→粒子面淡出→实体柱+标签 back-out 弹出 | 粒子态直接定格显脏，必须凝成实体 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 落地帧全部闭式预解析（每颗粒子的落点/落帧编译期可算），
+  帧确定性是渲染正确的前提——禁逐帧状态累积
+- 只适合 3–5 根柱的量级对比；十几根柱的密集图表用常规入场
+  （雨帘太多读作噪声）
+- 与"碎块解体"否决判例的界限：这是构筑（从无到有堆出图形），
+  不是破坏（把完整图形打碎）——方向语义相反，别做反向播放变体
+- 声音：细密颗粒落地声铺底，每柱堆满一声轻"叩"，标签弹出一声 tick
+
+## 参考实现
+demos/particle-sand-fill/
+（ParticleSandFill.tsx）

package/skills/hyper-animator-codex/references/shotcraft/cards/pill-slot-cycle/README.md

@@ -0,0 +1,57 @@
+---
+name: pill-slot-cycle
+一句话: 句中词槽轮换——固定句干钉死不动，句尾 pill 徽章每 ~0.7s 老虎机滚一格（旧的上飞加速淡出、新的从下带模糊滑入），连换 N 个功能词后落成完整句子收束
+适用: "功能列举"类文案的最优雅解法（比逐条列表快、比乱码解码有语义）；一句话卖点 + 多个动词短语的段落
+时长: 入场 12f + 每拍 21f × 词数 + 收束 14f + hold；6 词约 5.8s（demo 175f）
+能量: 中（稳定节拍器，无峰值）
+---
+
+## 意图
+罗列六个功能，列表要六行、逐条淡入要六拍还占满屏。词槽轮换把它们
+塞进**一句话的一个槽位**里：句干 "One AI tool to ___" 是承诺，槽里
+滚过的每个 pill 是证据，最后 pill 飞走、"do it all." 落位——证据
+列举完毕，结论盖章。结构自带三幕：承诺→列举→收束。命门是句干
+**纹丝不动**：观众的眼睛全程钉在槽位上，句干一晃列举感就散。
+
+## 动效核心
+- 句干绝对定位左端锚死——**不能用 flex 居中**，pill 宽度变化会带着
+  句干重排（首轮踩过的坑，已是判例）
+- 每拍 21f（~0.7s），前 8f 完成换位、后 13f 静置——静置段是给观众
+  读词的，读不完的拍子等于没换
+- 入场：translateY 120→0 + blur 14→4→0，Easing.out(cubic)；
+  离场：translateY 0→-130 + blur 0→10，Easing.in(cubic) 加速飞出
+  ——新来的减速落定、旧的加速逃走，方向感是"向上翻页"
+- 槽内用隐形占位 pill（visibility hidden）撑宽度，新旧两枚绝对定位
+  叠放——槽宽随当前词自然变化但不抖
+- 收束拍：末 pill 上飞（7f ease-in），"do it all." 从下 90px 带
+  Easing.back(1.4) 过冲落位——全片唯一一次过冲，留给结论
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 拍长 | 21f/词，5–7 词 | <16f 读不完短语；>28f 节拍器感散掉；8+ 词观众开始数数 |
+| 换位窗 | 拍内前 8f | 拉长到 12f+ 新旧同屏太久，读作两个 pill 打架 |
+| 飞行距离 | 入 +120 / 出 -130px | <80px 读作原地闪换；入出不对称（出略远）让离场更决绝 |
+| 运动模糊 | 入 14→0 / 出 0→10px blur | 去掉 blur 换位读作硬弹；>20px 中间帧糊成色块 |
+| 收束过冲 | Easing.back(1.4)，14f | >2 结论落位像卡通；无过冲结论与列举没有档次差 |
+| 收尾 hold | 完整句静置 ≥45f | 这句话是全段目的，不 hold 等于白列举 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 与 odometer-digit-roll / split-flap-title 分工：那两卡是字符/数位级
+  机械滚动（无语义），本卡是整词级 pill 轮换且嵌在活句子里——文案是
+  "句干+动词短语"结构才用本卡，纯数字/纯标题词别硬套
+- 与 typewriter-moves 分工：打字机是"一个字一个字造句"，本卡是
+  "句子造好了换零件"——同片可共存但别在同一句文案上连用
+- 与 type-rhythm-sync 分工：那是既有文字随音轨变属性（不换内容），
+  本卡换内容——绑音轨时本卡拍点对鼓点即可，别再叠字重脉冲
+- pill 短语长度要接近（demo 最长 "Draft an agenda"）——长短差 >2 倍
+  槽宽跳变太猛，句子重心左右甩
+- 收束句与句干字号字重必须完全一致（demo 都是 96px/800）——
+  "do it all." 若比句干大，读作新标题而非句子补完
+
+## 参考实现
+demos/pill-slot-cycle/
+（PillSlotCycle.tsx）
+原片出处：notion-ai 4.5–8.5s

package/skills/hyper-animator-codex/references/shotcraft/cards/print-texture-transitions/README.md

@@ -0,0 +1,40 @@
+---
+name: print-texture-transitions
+一句话: 印刷质感转场——ink-bleed-reveal 墨渗揭示（须状渗边洇开吃掉旧景）
+适用: 换景接缝的纸墨审美款；与交棒六式/穿越三式并列的第三族——"介质显影"型转场
+时长: 4–4.5s（洇开段 55–80f + 静止收尾 ≥30f）
+能量: 中（渐进显形，无冲击拍）
+---
+
+## 意图
+转场语言已有交棒（shot-transitions 六式）和穿越（transition-travel）
+，都是空间/光学隐喻。本式开第三族：**介质隐喻**——新画面不是"到来"
+而是"印染"出来的，直接调用库内纸墨审美的物理想象：像一滴墨落在
+宣纸上洇开吃掉旧景，有机、书写感。天然亲和 paper/ink 调性的片子，
+是 light-leak-burn（强调色漏光）之外的另一个"介质系"接缝选择。
+
+## 单式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| B ink-bleed-reveal 墨渗揭示 | 新页透过须状渗边的有机圆形遮罩从落墨点洇开，快慢不匀吃掉旧景 | 旧景→新景替换；书写感、叙事调性 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 渗边 | SVG mask 白圆挂 `feTurbulence(fractalNoise, baseFrequency 0.02, octaves 3, seed 固定)` + `feDisplacementMap scale 60→160 随帧涨` | filter 只揉遮罩形状、内容始终清晰；seed 必须写死（确定性） |
+| 洇开 | 半径 [20,98f]→[0,1450px] Easing.out(quad)，乘 `1+0.08·sin(0.32f)·env` 快慢不匀扰动（env 末 20f 衰减归零） | 匀速圆扩张读作普通 iris——扰动即"墨的脾气" |
+| 收尾摘罩 | 洇满后（帧 ~100）摘掉 SVG mask 直接铺新景 | feTurbulence 有亚像素抖动，不摘则结尾永不真静止（本批实渲判例） |
+| 收尾 | 新景就位后真静止 ≥30f | R1 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 一缝一式规矩同 shot-transitions：介质转场不与白闪/震屏叠加；
+  本式与 light-leak-burn 介质系同片合计 ≤2 次，多了片子读作印刷厂宣传
+- 洇开中段旧景内容会透过噪声孔洞碎片式短暂露出——读作墨渍肌理
+  属可接受有机效果，但旧景若是人脸/logo 等高辨识元素会读作故障，避开
+- 慢转场（55–80f 动作段），高节奏连打段落别用——那里去 E 式甩镜
+
+## 参考实现
+demos/print-texture-transitions/
+（InkBleedReveal.tsx）

package/skills/hyper-animator-codex/references/shotcraft/cards/rhythm-interrupt-moves/README.md

@@ -0,0 +1,44 @@
+---
+name: rhythm-interrupt-moves
+一句话: 打断节奏两式——jump-cut-punch-in 三级跳切推近、strobe-black-frames 频闪黑帧
+适用: 用"打断连续性"本身当节奏器：顿挫推近（B）、窒息逼近（C）；与 beat-cut-moves（切点排布）、montage-rhythm（段落呼吸）互补
+时长: B ~4.5s / C ~4.5s
+能量: B 中 / C 高
+---
+
+## 意图
+库内节奏卡管的都是"怎么切、切多密"；这两式管**怎么断**——观众预期
+连续，你偏打断，打断方式即表达：B 是空间断——同构图三次无补间跳大
+（1x→1.6x→2.6x），戈达尔跳切的顿挫，比连续推近更有"看这里、再近点、
+就是它"的指令感；C 是存在断——画面与纯黑交替频闪且间隔收紧，
+高潮前的窒息倒数。选型：强制聚焦指标用 B，高潮前蓄压用 C。
+
+## 两式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| B jump-cut-punch-in | transform-origin 钉目标中心，三档 scale 阶梯跳变（零补间），每跳 2f 加深脉冲当 tick | 逐级逼近核心指标；纪录片式盯住 |
+| C strobe-black-frames | 全屏黑帧按写死帧号表闪现（每次 2f，间隔 8f→3f 收敛），末闪掀开即硬切放大落定 | 全片最高潮前的倒数蓄压 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| B 跳挡 | 1.0→1.6→2.6，各 hold ≥35f | 挡差 <1.5× 读作画面抖了一下 |
+| B tick | 跳变帧起 2f brightness 0.92 全画面脉冲 | 无 tick 的跳切读作丢帧 |
+| C 帧号表 | [40,48,55,61,66,70,73,76,79] 各 2f 纯黑 | 间隔必须收敛；等距频闪只是闪没有"逼近" |
+| C 落锤 | 末闪掀开一帧到位 scale 1.35 + 2f 加深脉冲 | 掀开后还在原构图，频闪就白憋了 |
+| 收尾 | B 末挡 ≥45f / C 硬切后 ≥50f 真静止 | 打断系事后 hold 从重给 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 两式与 speed-ramp-freeze 都动"时间轴"，同一镜头只能有一个时间
+  操纵者
+- C 式**光敏警示**：频闪画面需注意光敏性癫痫观众提示；且必须配乐
+  渐强同步（无声频闪读作信号故障），全片 ≤1 次
+- B 式三挡构图必须同 origin（钉死目标中心）——每挡重新构图就是
+  三个镜头，不是跳切
+- 声音强依赖：B 每跳一声 tick、C 每闪一声打点（sound-design §4.5）
+
+## 参考实现
+demos/rhythm-interrupt-moves/
+（JumpCutPunchIn.tsx / StrobeBlackFrames.tsx）