hyper-animator-codex 0.7.1 → 0.8.0

package/skills/hyper-animator-codex/references/shotcraft/cards/line-boil/README.md

@@ -0,0 +1,52 @@
+---
+name: line-boil
+一句话: 线条沸腾——hold 期间文字/描边轮廓每 3 帧轻微扭动一次，像手绘逐帧重描，静止画面保持"活着"的呼吸感
+适用: 标题字卡/描边元素的长 hold 段（黑场字卡升级首选）；质感层手法，寄生在别的镜头上
+时长: 寄生型——沸腾段随宿主 hold 长度，无自身时长
+能量: 低（底噪级）
+---
+
+## 意图
+库内 R 系判例要求落定后"真静止"，但长字卡（3s+ 的黑场字卡、片尾）
+完全冻结会读作"片子卡了"。本卡给第三种状态：**活着的静止**——轮廓
+每 3 帧被"重描"一次，位置内容全然不动，只有线条边缘在极轻微地呼吸，
+手绘动画 hold 帧的百年惯例。与 noise-drift（被否决）的区别正是可感性：
+漂移是整体 1–3px 位移（肉眼读不出），沸腾是轮廓形变+阶梯跳变（每次
+换 seed 都是一次可见的"重描"）。纸墨审美里这是"手工感"的直接来源。
+
+## 动效核心
+- SVG filter：feTurbulence(fractalNoise, baseFrequency 0.015,
+  numOctaves 2) + feDisplacementMap **scale=8**（原案 3–6 不可感，
+  已加码）作用于文字/描边层
+- **seed = Math.floor(f/3) 阶梯换**——每 3 帧跳一次新形变，
+  10fps 的手翻书质感；逐帧换 seed 读作电噪不是手绘
+- **摘罩命门**（feTurbulence 判例）：沸腾段之外 filter 与 SVG defs
+  根本不渲染（条件挂载），不是 opacity 到 0——否则永不真静止
+- 结构靠对比：demo 用 静止 35f → 沸腾 70f → 摘罩静止 35f 三段
+  自证可感；实战沸腾段直接铺满宿主 hold
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| displacement scale | 8（大字标题）；小字/细线 5–6 | >12 读作故障扭曲；<4 不可感 |
+| seed 节拍 | floor(f/3)，即每 3 帧重描 | /2 太贼、/4 以上读作卡顿跳帧 |
+| baseFrequency | 0.015（形变尺度约字高级） | 0.05+ 变成毛边噪点，不是"重描" |
+| 适用对象 | 大标题、描边框、手绘圈注 | 实心小元素（图标/头像）沸腾读作模糊 |
+| 与 R 系关系 | 沸腾段视作合法 hold；宿主镜头收尾若需绝对静止则提前 ≥15f 摘罩 | 摘罩瞬间轮廓归位本身就是一次收束 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 全片同时沸腾的元素 ≤1 组——标题在沸腾、卡片框也在沸腾，观众
+  找不到该看哪（P4）
+- 与 speed-lines/集中线的"沸腾"（impact-feedback C 式每 2 帧换形态）
+  同族不同职：那是冲击帧的高能沸腾，这是 hold 帧的底噪沸腾，能量
+  档位差两级，别互换参数
+- SVG filter 对大面积层有渲染开销；1920 全幅文字层可接受，整页
+  截图套 boil 渲染时间翻倍且语义不对（页面不是手绘物）
+- paper-title-card/黑场字卡（shot-transitions D 式）是本卡首选宿主，
+  组合时字卡的打字机/压印入场完成后再起沸腾
+
+## 参考实现
+demos/line-boil/
+（LineBoil.tsx）

package/skills/hyper-animator-codex/references/shotcraft/cards/line-carry-transition/README.md

@@ -0,0 +1,52 @@
+---
+name: line-carry-transition
+一句话: 线条接力横移转场——场景 A 的进度条延伸出画，镜头跟线横移，线在移动中拐角围出场景 B 的卡框，全程无剪切
+适用: 两个有图形亲缘的场景之间（进度条→卡框、下划线→图表轴）；一支片子的招牌转场位，Catch Me If You Can 片头的图形接力
+时长: ~5.3s（进度条走满 + 横移 60f + 围框 + 内容淡入 + 静止 36f）
+能量: 中
+---
+
+## 意图
+转场库三大族（穿越/藏切/体块）都在回答"场景怎么换"；本卡的回答是
+**根本不换——一条线牵着你走过去**。进度条走满后末端延伸成长线冲出
+卡缘，镜头跟着线横移 1920px 进入新世界，线在移动中拐直角围出 B 场景
+的卡框，框闭合、内容淡入，从头到尾观众的眼睛没离开过这条线。图形
+连续性本身就是转场。与 match-cut 的区别：那是切点两侧形状对位——
+终究还是切；这是连续绘制——**没有切**。线的身份要有叙事逻辑（进度条
+"走完了"所以延伸出去），无来由的线只是装饰。
+
+## 动效核心
+- 3840 宽世界容器 translateX 当镜头，34–94f 移 1920px，
+  Easing.inOut(cubic)
+- 一条手写折线 path（进度条 560 + 冲出段 + 直角 + 560×330 矩形框，
+  总长 3980）全程 dasharray/dashoffset evolve，分段驱动 drawn 长度
+- **命门：横移段 drawn = 1100 + cam，线生长与镜头位移同速**——笔头
+  钉在画面 x≈1500 偏右，永不出画也永不落后；一旦失速，观众跟丢线
+  就等于跟丢了转场
+- 笔头 r=11 墨点随线走，框闭合后 112–118f 线性消散并条件卸载
+  （摘罩判例）；B 内容 124f 前淡入完，124–160f 真静止 36f
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 线体 | 6px ink 实线 | 太细横移中读丢；虚线读作未完成态 |
+| 横移配比 | 1920px / 60f（32px/f） | 更远的横移等比拉长时长，别提速——>40px/f 笔头开始拖影跟丢 |
+| 笔头位置 | 画面 x≈1500（约 78% 处偏右） | 居中读作"线追镜头"；贴边一颤就出画 |
+| 拐角 | 直角硬拐，不倒圆 | 圆角软拐丢掉制图感，Saul Bass 味就没了 |
+| 框闭合 | 闭合帧起 B 内容再淡入 | 框没闭合内容先出，线的悬念白搭 |
+| 收尾 | 淡入完 ≥36f 真静止 | 笔头墨点必须条件卸载，残留即毁静止 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 与 draw-svg-trace 的关系：那是元素级描边点名（线属于元素），这是
+  场景级线条接力（线属于镜头）——同片可共存，但线的语义要一致：
+  同为 ink 6px 手绘感，或同为几何硬线，混用读作两套美术
+- 全片 ≤1 次——这是招牌转场不是常规转场，第二次出现魔法就穿帮
+- 起点必须是已有图形构件的自然延伸（进度条走满、下划线画完），
+  凭空起线读作屏保
+- 声音：线生长一声持续笔擦、框闭合一声轻叩（sound-design §4.5）
+
+## 参考实现
+demos/line-carry-transition/
+（LineCarryTransition.tsx）

package/skills/hyper-animator-codex/references/shotcraft/cards/list-stack-press/README.md

@@ -0,0 +1,43 @@
+---
+name: list-stack-press
+一句话: 列表卡从画面底部逐张飞上摞起，每张落地压弹整摞、计数器同步跳一格
+适用: feed/雷达/收件箱类"每天有新东西"的镜头；强调持续积累的资产列表
+时长: 约 3s（18–88f）
+能量: 中
+---
+
+## 意图
+"堆叠有重量"：每张新卡落上来，已落定的整摞被压下再弹回——观众从物理反馈里读出"这是实打实攒下来的东西"。计数器同步跳格把数量感钉死。
+
+## 动效核心
+- **预备拍（anticipation，借鉴迪士尼法则 2）**：首张升入前给一拍段落级预备——计数器先于首卡 4–6f 亮起归零/微缩 scale(0.96)→1，把视线引到堆叠区，再让首卡入画。只做段落级一次，不逐卡加
+- 卡从画面下方升入，交替微倾斜收平，等距节拍逐张摞起
+- 每张到场压下整摞 6px、8f 弹回（stackPress 脉冲——即法则 5 的 follow-through：新卡的动能传给整摞再缓冲耗散，这一笔就是"有重量"的来源）
+- 落地后按拖拽层级依次收尾（法则 5）：卡体先停 → 整摞弹回 → 高亮条再长出（滞后 2–4f）——三者同帧发生读作贴图切换
+- 收尾一道 glaze 扫光掠过整摞
+- 屏幕空间 DigitRoll 计数器落一张滚一格；相机跟随堆叠向下
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 节拍 | CUES=[18,30,42,54,66]（12f 等距），每张飞 22f，bezier(0.45,0.05,0.25,1.12) 末端过冲 | 少量卡（5 张）可以等距；大批量入场才需要递加速（对照 deck-deal 的 R2） |
+| 入场 | 从下方 600px 升入，交替 ±2° tilt 收平，scale 1.06→1 | 交替倾斜打破对称；同向倾斜读作复制粘贴 |
+| 堆叠压感 | 后一张到场时整摞压下 6px、8f 弹回（脉冲 [cue,cue+4,cue+8]→[0,6,0]） | 这是"有重量"的关键一笔，砍掉后堆叠变成简单排版 |
+| 阴影 | 空中 `0 32px 64px`、落定 `0 2px 8px` | 阴影随高度收敛，和 deck-deal/spotlight 同一套语言 |
+| 联动高亮 | 落地后滞后 2–4f 于 72% 高度处长出 40% 宽强调色（模板片为琥珀）底色（7f 长 + 5f 淡）；最后一张离切点仅 ~12f 需压缩节拍 | 高亮是次级动作（法则 5/8）：在主动作（落地压弹）之后跟进，不与之同帧抢戏；末尾元素的节拍要按剩余帧预算压缩，不能照抄前面的 |
+| glaze 扫光 | 420px 宽、rotate 14°、mixBlendMode overlay，帧 82→96 从 −700 扫到 2600 | 扫光全镜头只此一次、扫整摞不逐卡（Q4） |
+| 计数器（digit-roll 手法） | DigitRoll 以 landedCount 为 key 强制重滚，落一张跳一格；每位 delay=i·4、22f 滚定，bezier(0.25,0.8,0.25,1)；滚动量=(10+target)·lineH 先滚过完整一条 0-9 带再落位 | 计数与落地不同步立刻穿帮，key 重滚最省事；"转过一圈"保证任何目标位都有滚感；数字带双份拼接+overflow hidden+tabular-nums（不开 tabular 会横向抖）；滚动必须在所属画面淡出前落定（曾专修过此时点） |
+| 相机 | zoom 1.35→0.9 五键跟随堆叠向下 | 正视机位（见已知坑），相机只做纵向跟随 |
+
+## 声音
+每张落地不逐张配长音；计数落定钉 click-camera（模板片钉在 f648）、段落切入钉 transition-soft（f623）。若逐张配 pop 参照 S2 三招防机枪。
+
+## 已知坑
+- 堆叠/列表信息镜头必须正视（Q6）——全片倾斜化时本镜头曾被单独回滚回正视；风格化机位逐镜头验证，不全局套用
+- 逐卡 glint 高亮扫过被否两次（Q4），高亮用静态强调色底色条即可，动感交给压弹
+- 与 history-list-stack（document-typewriter-reveal 卡尾段）是同一动作词汇——全片同一手法只当一次主角（P4），两处并用时一处必须降为配角
+- anticipation/拖拽层级参数借鉴自迪士尼 12 法则（pixel2motion skill 内置提炼版），非用户判例——是默认建议不是令；与判例冲突时判例优先
+- 预备动作幅度必须过肉眼阈值（deck-deal 判例 2026-07-09：小幅度用户完全无感，放大 12 倍才通过）——渲染后自查"不逐帧能否看出蓄力"
+
+## 参考实现
+template/src/aifl/live/ScenePapers.tsx

package/skills/hyper-animator-codex/references/shotcraft/cards/magician-card-flourish/README.md

@@ -0,0 +1,63 @@
+---
+name: magician-card-flourish
+一句话: 纯黑场上蓝色星芒闪现 0.3s（X 形针状光束旋转 90°+中心辉光放射小光芒），卡片从闪光点弹射而出——极速自旋弧线飞向镜头、自旋随靠近衰减、瞬间硬定格近满幅、定格后 sheen 扫光
+适用: 单张卡片/海报/封面的魔术性登场（片头主视觉、产品卡揭晓）；纯黑暗场；需要"变出来"仪式感的爆点
+时长: 闪光 0.3s + 飞行 ~1.7s + 定格展示+扫光 ~2s；全段 4.2s
+能量: 高（一次性爆点，定格后即静）
+---
+
+## 意图
+魔术师甩牌：一道蓝色星芒闪过，卡片仿佛从光里被变出来——从画面
+中心极远处（视觉上一个小点）弹射而出，沿弧线极速自旋飞向镜头，
+到达中心瞬间硬定格成近满幅展示。三个魔术感命门：**闪光先行**
+（光是"变"的仪式，0.3s 短促干脆）、**弹射节奏**（起飞慢速蓄力→
+急加速踢出→弧线段减速抵达，slow-in→burst→decelerating arc）、
+**定格即静**（无减速尾巴无回弹，13 整圈自旋保证定格恰为正面）。
+
+## 动效核心
+- 开场星芒（用户参考图 IMG_2505 逐轮收敛的最终形态）：
+  - X 形**对角**针状光束（-38°/52° 起始），闪光期间整体**动态旋转
+    90°**（easeInOut）；长轴 840/短轴 420（比例 2:1）
+  - 光束纯饱和蓝（#3f9bff→#2277f2 贯穿全长，白段只留根部 5%），
+    每轴三层：宽糊辉光包层 + 明亮主束 + 过曝细芯
+  - 中心**不是白球**：极小亮点（26px）+ 蓝辉光晕（140px）+ 一圈
+    10 根长短相间放射短刺（随星芒反向缓转）
+  - 节奏：渐亮 2.5f → 微闪 → 坍缩，9f（0.3s）完
+- 弹射飞行：中心极远（scale≈0.06）出发，真透视 scale=F/(F+z)
+  （z 14000→0）；行程曲线 slow-in（前 14% 时间走 6%）→斜率跳变
+  弹射→easeOut(cubic) 减速；正弦单拱弧线荡出收回中心
+- 自旋：沿卡片对角线轴 13 整圈；前 40% 行程近匀速极快，后 60%
+  角速度 2.4 次幂衰减（越近镜头转越慢），整圈数保证定格正面
+- 定格：f=TAKEOFF+50 全量冻结，卡高 ≈94% 画面高（贴上下界）
+- 扫光：定格稳 8f 后 sheen 斜带左→右一次扫过（overlay+screen
+  双层+整卡亮度微抬）
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 闪光时长 | 9f（0.3s，用户精确定值；曾 1.5s→0.8s→0.5s 逐轮压短） | 光是仪式不是主角；>15f 抢卡片的戏 |
+| 星芒旋转 | 闪光期间动态转 90°（判例：静态摆角被裁"没看到旋转"） | 旋转要逐帧可见；>120° 读作螺旋桨 |
+| 光束颜色 | 纯饱和蓝贯穿全长 | 白段过长/衰减过快被裁"不够还原"；青蓝偏灰被裁"要蓝色的" |
+| 中心 | 小亮点+辉光+放射短刺 | **白色圆球被裁**——中心是光学辉光不是实体球 |
+| 弹射曲线 | slow-in 14%→burst→减速弧线 | 直接匀速/纯 easeOut 没有"弹射"的蓄力感 |
+| 自旋衰减 | 后 60% 行程 2.4 次幂减速 | 匀速到底被裁"靠近镜头时应随距离衰减"；整圈数=定格正面的保证 |
+| 定格尺寸 | 卡高 94% 画面高 | 初版 1.0x 被裁"更近更大基本靠近上下界" |
+| 硬定格 | 全量冻结零回弹 | 魔术感=瞬间静止；回弹读作物理玩具 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- **光效质感判例链**（本卡贡献的全局方法论）：几何色块被裁"5毛
+  特效"→光学实感重做→游戏感+真实→用户给参考图一轮收敛。
+  质感类意见文字损耗大，**主动请用户丢参考图**
+- 工程坑：细针光束**不能放进 CameraMotionBlur**——旋转被模糊采样
+  拆成条纹分身（"廉价感"的隐性来源）；闪光层独立于运动模糊渲染
+- 工程坑：星芒 SVG viewBox 要 ≥ 光束长+旋转扫掠半径，否则端点
+  被裁出直边
+- 与 card-flip-reveal/deck-deal-flyin 分工：那两张是翻牌/发牌的
+  多卡节奏戏；本卡是单卡"变出来"的魔术仪式，一次只变一张
+
+## 参考实现
+demos/magician-card-flourish/
+（MagicianCardFlourish.tsx）
+原片出处：无（用户口述定制，多轮迭代收敛）

package/skills/hyper-animator-codex/references/shotcraft/cards/marker-underline-title/README.md

@@ -0,0 +1,48 @@
+---
+name: marker-underline-title
+一句话: 大标题落定后，关键词下方马克笔下划线从左到右快速描画——变宽笔形、毛糙边缘、微上斜跟随斜体字势，贴着字底
+适用: 标题里强调单个关键词（new/free/AI…）；手写感/人味的品牌调性；正文标注式强调
+时长: 标题落定 +4~8f 后起笔，划线 8–12f，总 1–1.5s
+能量: 低（一笔点睛，不抢标题的戏）
+---
+
+## 意图
+打印体标题里突然出现一笔手绘马克笔，用材质反差把一个词从
+排版里拎出来——像人拿笔在海报上圈重点。命门有三：**快**
+（8–12f 一笔呵成，慢了读作加载条）、**近**（贴着字底，离远了
+读作分隔线不是强调）、**跟字势**（斜体词的划线必须左低右高
+微上斜——斜向画反是最容易犯且一眼假的错，判例见已知坑）。
+
+## 动效核心
+- SVG path 描画（strokeDashoffset 或裁剪窗），从左到右 8–12f，
+  ease-out 微收尾（起笔快收笔略缓＝手劲）
+- 笔形：路径变宽（中段最宽）、边缘毛糙（轻微噪声扰动/粗糙笔刷
+  贴图），首尾略细＝起笔收笔
+- 位置：贴字底（bottom 偏移 ≈ -0.1em），中轴微上斜跟随斜体字势
+- 时机：标题完全落定后 +4~8f 起笔——划线是"看完标题后的强调"，
+  与标题同动就抢戏
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 划线时长 | 10f（原片实测节奏；14f 版被裁偏慢） | >14f 读作进度条；<6f 看不见笔迹方向 |
+| 字底距离 | ≈-0.1em（从 -40 收到 -20@1080p 才贴住字势） | 离远读作分隔线；碰到字底降部又乱 |
+| 斜向 | 左低右高微上斜（跟斜体） | **画反（左高右低）一眼假**——返工判例 |
+| 笔宽 | 中段 ~0.12em，首尾 ~0.6x | 等宽读作机器线；差异>2x 读作书法 |
+| 毛糙度 | 边缘轻噪声 | 太糙读作故障；全平滑读作 CSS border |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 与 draw-svg-trace 撞领域（有意单列为两卡）：那张是通用
+  SVG 描画（图标/插画/任意线稿）；本卡专做**文字强调**的马克笔
+  质感（变宽+毛糙+跟字势），做图形描画去用那张
+- 斜向判例：v1 左高右低被比对环节抓出——划线斜向必须跟字势，
+  正体字则水平微抖
+- 残余差距：原片（notion-ai）笔头飞白颗粒感更细碎，实战可加
+  更细的笔刷噪点
+
+## 参考实现
+demos/marker-underline-title/
+（MarkerUnderlineTitle.tsx）
+原片出处：notion-ai.mp4

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

@@ -0,0 +1,55 @@
+---
+name: montage-rhythm-moves
+一句话: 蒙太奇节奏三式——drop-blackout-slam 黑场蓄爆、wright-triple-cut 三连咔哒特写、domino-cascade 多米诺连锁入场
+适用: 段落级节奏设计：蓄力爆发（A）、流程速写（B）、开场连锁（C）；与 beat-cut-moves（切点排布）互补——这三式管"段落的呼吸形状"
+时长: A 4.3s / B 4.3s / C 5s
+能量: 高
+---
+
+## 意图
+beat-cut-moves 管切点间隔怎么排，这三式管更大一层的节奏叙事：
+A 是"静默即蓄力"——drop 前一拍切全黑死寂憋一整拍，爆开才够响
+（EDM 演出 blackout 惯例），给全片最高潮的前一秒用；B 是"流程三连"
+——三个超近特写咔哒咔哒咔哒连打（按下/拨动/翻牌），第三声甩回全景
+亮结果，Edgar Wright 式把"操作很简单"剪成肌肉记忆；C 是"动量传递"
+——标题砸落震起卡片、卡片落地撞进侧边栏，每个元素的入场由上一个的
+撞击触发，Rube Goldberg 式把一页内容的入场讲成连锁反应。
+
+## 三式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A drop-blackout-slam 黑场蓄爆 | 正常播放中一帧切纯黑死寂 12f，然后主视觉带震屏+亮环砸入 | 全片唯一最高潮的前一拍；发布口号/大字的登场 |
+| B wright-triple-cut 三连特写 | 三个 10f 超近特写硬切连打（各"静4-动3-静3"），第三声甩回全景亮结果 | "操作流程"速写：三步设置、一键完成类叙事 |
+| C domino-cascade 连锁入场 | 标题砸落→震波弹起卡片列→末卡撞滑侧边栏进场，动量方向逐级传递 | 开场整页入场的叙事化版本；替代平铺直叙的逐个 fade-in |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 铺垫 | 前段画面轻微 scale 呼吸 1.0↔1.02 + 节拍点每 12f 闪 | 必须先让"片子在正常播"可感，黑掉才有落差 |
+| A 黑场 | 一帧直切纯黑（#0c0c0c），12f **完全无物** | 命门：黑场里放任何东西（logo/微光）都在泄压——死寂才是蓄力 |
+| A 爆入 | 主视觉 scale 1.35→1.0（5f out cubic）+ 10px 震屏 exp(-t/2.5) 12f 收干 + 亮环 80→900px 16f 消散 | 三件事同帧起爆；震屏 t≥14 强制归零保真静止 |
+| B 特写结构 | 每个 10f：静 4f + 动作 3f + 静 3f；动作用 p<0.5 二值跳变保干脆 | 动作 3f 是"咔哒"的物理时长；拉长成 6f 就是普通交互动画 |
+| B 构图统一 | 三特写同倍率感、主体都在屏心 | 构图乱跳读作三段素材硬拼，连切节奏散 |
+| B 甩回 | 6f whip（Easing.poly(5) out）+ 2 层错帧副本（opacity 0.35/0.18）模拟糊 | 甩回落点的"结果"要提亮泛光——三连咔哒的答案必须亮着 |
+| C 动量链 | 每级 startFrame = 上一级 impact 帧；初速方向继承上一撞击方向 | 命门：竖砸→竖弹→（末卡歪 3° 给出横向）→横滑，方向没有出处则"连锁"读作巧合 |
+| C 撞击震动 | 4f 衰减序列 [A,-0.6A,0.3A,-0.12A,0]，两次幅度 10/6px 递减 | 幅度递减表现能量损耗；等幅两震读作重复播放 |
+| C 卡片弹跳 | 依次隔 5f 各弹 60px 抛物线 12f | 40px/3f 间隔在正常速度下读不清传递感（本批实渲加码） |
+| 收尾 | A 爆入后 ≥50f / B 甩回后 ≥45f / C 全链落定后 ≥50f 真静止 | 三式都是重拳，hold 按平常两倍给（同 beat-cut B 判例） |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- A 式全片 ≤1 次且必须配声design：黑场同帧音频也切静、爆开同帧音爆
+  （sound-design §4.5）——无声版黑场读作播放器卡了 12 帧
+- A 的震屏与 impact-feedback、C 的震动与 domino 内部震动都属震屏族，
+  同一镜头只能有一个震源
+- B 式三个特写 10f/个节奏很快是设计意图（已验证可读），但特写内容换成
+  真实 UI 后若操作复杂（不是一眼动作），拉到 12–14f
+- B 式甩回与 shot-transitions E 式甩镜同技术根——B 的 whip 是镜内收尾
+  不是转场，别在 B 之后再接 E 式（连甩读作晕）
+- C 式链最多三级（标题→卡片→侧栏）；四级以上观众跟不住因果链，
+  后面的入场退化回普通错峰
+
+## 参考实现
+demos/montage-rhythm-moves/
+（DominoCascade.tsx / DropBlackoutSlam.tsx / WrightTripleCut.tsx）

package/skills/hyper-animator-codex/references/shotcraft/cards/morph-from-primitive/README.md

@@ -0,0 +1,51 @@
+---
+name: morph-from-primitive
+一句话: 原型变形——正圆呼吸一拍（anticipation）后 SVG path 插值 24f 长成圆角卡轮廓，内容淡入
+适用: 图形/图标/卡轮廓类主体的入场；logo→UI 容器的经典原语
+时长: ~4.7s（呼吸 20f + 变形 24f + 内容淡入 12f）
+能量: 中低
+---
+
+## 意图
+入场库全是"从外面进来"——飞入、砸落、翻面，主体都预先存在于画外；
+本卡是**就地长出来**：画面中心一个描边正圆先鼓一口气（scale
+1→1.12→1），随即轮廓连续变形为圆角矩形卡片，内容再淡入。原型
+停留加呼吸这一拍就是预备动作——迪士尼 anticipation 的图形学翻译：
+圆先"吸气"，观众就知道它要变，变形本身因此不需要任何解释。
+仅适用图形/图标/卡轮廓类主体——位图截图不能 morph。
+
+## 动效核心
+- **圆与圆角矩形写成同构 path**：M + 8 段 cubic（4 直边段三等分点
+  做退化 cubic + 4 圆角段 kappa 公式 k=4/3·tan(Δθ/4)），逐命令
+  数值 lerp 生成 d 字符串，帧驱动全确定性
+- 圆锚点取矩形锚点同方位角，保证 t=0 是标准正圆、中途无自交
+- 呼吸拍 scale 1→1.12→1（spec 1.06 看不清，加码后可感——可感性
+  判例同族）；呼吸与变形都用 Easing.inOut(cubic)，interpolate 全 clamp
+- 内容是 HTML 层叠在 SVG 上，变形完成后 12f 淡入，不做 path 内嵌
+- 时间轴 140f：0–10 静置｜10–30 呼吸｜30–54 变形｜56–68 内容
+  淡入｜68–140 真静止 72f
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 呼吸幅度 | 1→1.12→1，20f inOut cubic | <1.1 读不出"吸气"；>1.2 像要爆炸不是要变形 |
+| 原型停留 | 静置 10f + 呼吸 20f，合计 30f 才起变形 | 停留 <15f 读不出"预备"，变形显得突兀 |
+| 变形时长 | 24f | 太快像切换、太慢像融化；24f 是"生长"的速度 |
+| 目标形态 | 520×300 圆角矩形卡（demo 值） | 圆角越大与圆同构性越好、中段越顺 |
+| 内容淡入 | 变形落定后 2f 起，12f 淡入 | 变形没完就进内容 = 内容跟着轮廓扭 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- **变形中途别叠其他动画**——morph 本身就是全部信息，同时飞入/
+  变色/晃动会把"长出来"稀释成"乱动"
+- 位图截图不能 morph：本卡只对矢量轮廓成立，页面截图请回
+  入场库常规手法
+- path 插值两端命令数必须严格同构（同为 M+8C），命令数不齐
+  中途会闪跳；改目标形状时先对齐锚点数再调参
+- 变形中段呈"桶形"过渡是正常形态（QA 判例），不是穿帮；
+  出现自交/尖刺才是锚点方位角没对齐
+
+## 参考实现
+demos/morph-from-primitive/
+（MorphFromPrimitive.tsx）

package/skills/hyper-animator-codex/references/shotcraft/cards/neon-frame-forerun/README.md

@@ -0,0 +1,50 @@
+---
+name: neon-frame-forerun
+一句话: 强透视直角霓虹框自左缘两头奔画先行成型，页面在框内由暗转亮，同时框内组件/文字从 3D 上空带同形软影错峰贴落、随页面点亮同步完成贴合，背景霓虹管群终段熄灭让位
+适用: 暗场品牌片里给 UI 面板做"登场仪式"（框先到、内容后落）；功能区首次亮相；霓虹/赛博调性的段落开场
+时长: 框奔画 ~0.6s + 点亮&贴落 ~2s + 背景熄灭收束 ~0.8s；全段 4–4.5s
+能量: 中高（三层动作叠进，但都服务同一次登场）
+---
+
+## 意图
+先立框后填肉：霓虹线框像跑道灯一样两头奔画圈出位置，宣告
+"这里要出现东西"；页面在框内由暗转亮的同时，组件从空中带影
+贴落——观众看见界面被"安放"进框里。三层动作（框奔画/页面点亮/
+组件贴落）必须**同步咬合**：贴落进程与点亮进程同步推进、稍滞后
+收尾，框光最终并入面板辉光。背景霓虹管群终段熄灭，把亮度让给
+主角完成收束。
+
+## 动效核心
+- 霓虹框：强透视直角框（梯形），自左缘中点两头同时奔画（描边
+  动画），带辉光亮头；成型后框光渐并入面板辉光
+- 页面点亮：框内面板由暗灰到亮的显影推进（lit 窗口 ~54f）
+- 组件贴落：框内全部元素套 FloatWrap（graze-face-tour 同款模式）：
+  初始抬高 100–150px、easeFall 加速贴落、同形软影随高度收敛、
+  侧栏自上而下/主区自上而下错峰落位；贴落窗口与点亮窗口同步
+  推进、稍滞后 ~20f 收尾
+- 背景：大霓虹管群先亮衬气氛，终段中亮尾熄（先中间后两端熄灭）
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 框奔画 | ~18f 两头对奔 | 单头描画读作画图；>30f 观众等不及内容 |
+| 悬浮高度 | 100–150px、影随高度收敛 | 判例：高度过小+启动过早=影子不可感（v3 第 1 轮返工加大 1.7x 并延后） |
+| 贴落窗口 | 与点亮窗口同步、滞后 ~20f 收尾 | 贴落先于点亮完＝黑屋子里落家具；滞后太多读作两段戏 |
+| 错峰 | 错开起点、下落重叠并行 | 串行等待被裁（掉落节奏通用判例） |
+| 背景熄灭 | 终段中亮尾熄 ~22f | 不熄灭主角不突出；同帧全熄读作断电 |
+| 贴落粒度 | 行/卡级（原片为逐 UI 卡片级，更细） | 粒度越细越贵；行级已验证可读 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 悬空贴落=clickup 语言核心签名（已验证的口味信号），本卡
+  与 graze-face-tour 共用 FloatWrap 模式——影子不可感等于没做
+- 与 brand-frame-snap 分工：那张是品牌框咔哒定位的
+  节拍戏；本卡是框先行+内容贴落的登场仪式，框只是序幕
+- 衍生方向备忘：视角旋转变体（镜头左→右弧线旋转+同时贴落）
+  曾被裁"改改再看"（要求所有组件同时贴落），已收敛进 neon-frame-orbit-drop 卡
+
+## 参考实现
+demos/neon-frame-forerun/
+（NeonFrameForerun.tsx）
+原片出处：clickup-30.mp4

package/skills/hyper-animator-codex/references/shotcraft/cards/neon-frame-orbit-drop/README.md

@@ -0,0 +1,50 @@
+---
+name: neon-frame-orbit-drop
+一句话: 霓虹框先行描框后，镜头绕页面左→右弧线旋转，页面全部组件/文字**同帧**从空中往下贴合（同形软影同步收敛）——整体登场式的框内安放
+适用: 单页 UI 的一次性隆重登场（与巡礼/逐区亮相相对）；暗场霓虹调性段落的主视觉揭幕；neon-frame-forerun 的姊妹镜
+时长: 描框 ~0.5s + 旋转&同时贴落 ~2.5s + 落定 ~1s；全段 4–4.5s
+能量: 中高（一次性的大动作，落定即静）
+---
+
+## 意图
+neon-frame-forerun 的孪生变体：同样框先行、内容后落，但镜头
+不是固定的——从页面左侧视角连续弧线旋转到右侧视角，旋转进行
+的同时全部组件从空中贴落。命门是**同时贴合**：所有组件和文字
+同帧起落、同帧贴合、软影同步消失——这是"整体登场"的语法
+（判例：错峰版被裁"应该是所有组件和文字同时从空中往下贴合"）。
+错峰贴落属于巡礼镜（graze-face-tour/runway），一页一次性亮相
+必须齐落，节奏语义不能混用。
+
+## 动效核心
+- 霓虹描框：渐变霓虹框 ~14f 奔画成型（同 neon-frame-forerun）
+- 视角弧线：rotateY +38° → -26° 连续弧线（透视原点 30%→64% 随动
+  近似相机环绕），贯穿全片
+- 同时贴落：全部元素统一 LAND 时刻（归一化 ~0.52）——同帧离地
+  悬空、同帧空中下降、同帧贴合；FloatWrap 同形软影（blur/offset/
+  opacity 随高度）全体同步收敛
+- 背景霓虹管框群衬场，主面板落定后让位
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 贴落同时性 | 全元素同帧起落（零错峰） | **命门**；任何错峰都会读成巡礼语法（判例裁决原话见上） |
+| 视角弧线 | rotateY +38°→-26°、透视原点随动 | 弧度小读作抖动；只转不落=空转 |
+| 旋转×贴落耦合 | 贴落窗口居中于旋转行程 | 旋转完才落=两段戏；落完还在转=收不了尾 |
+| 悬浮高度/软影 | 同 graze-face-tour（100–180px、影随高度） | 影不可感=没做（累计判例） |
+| 描框 | ~14f 奔画 | 同 neon-frame-forerun |
+
+## 已知坑
+- 参数经占位素材两轮调校通过，非实战定稿，首次实战须以真实素材回验
+- **贴落节奏语义判例**（本卡与 graze-face-tour 互为反例）：
+  巡礼镜=错开起点+重叠并行下落；整体登场镜=全体同帧。选错语法
+  两边都会被裁
+- 与 neon-frame-forerun 分工：那张镜头固定、错峰贴落+页面点亮
+  三层咬合；本卡镜头旋转+同帧齐落。同段落二选一，别连用（同框
+  语言重复）
+- 弧线旋转是透视原点近似而非真实 3D 相机环绕，极端角度下框辉光
+  形变略平——实战若需大角度环绕考虑真 3D 场景
+
+## 参考实现
+demos/neon-frame-orbit-drop/
+（NeonFrameForerunOrbit.tsx）
+原片出处：无对应原段

package/skills/hyper-animator-codex/references/shotcraft/cards/neon-triple-marquee/README.md

@@ -0,0 +1,55 @@
+---
+name: neon-triple-marquee
+一句话: 三行对向霓虹跑马灯 recap——BETTER/FASTER/STRONGER 空心描边巨字上中下排满全屏，奇偶行反向匀速无限横滚，三行按 1/3 相位轮流亮起，结尾整组淡出
+适用: 片尾主题词复读机段落；三连词口号的"余韵"拍法（cel-flash-stomp 砸完之后的低一档收尾）；音乐段无旁白铺陈
+时长: 4–5s（demo 150f：10f 淡入 + 循环体 + 20f 淡出）
+能量: 中高（持续流动 + 逐行脉冲，无瞬时冲击）
+---
+
+## 意图
+一行 marquee 只是网页装饰；三行叠起来、奇偶反向、再让亮度按相位轮流
+走，就成了"主题词在观众眼前列队巡游"。命门是**明暗轮唱**：任一时刻
+只有一行是霓虹主角，其余压暗成细描边背景——三行全亮是灯牌事故，
+轮流亮才是 recap。反向对滚制造"包围感"：上下行向右、中行向左，
+视线被夹在中间，词从两侧源源不断流过，读作"这三个词说不完"。
+
+## 动效核心
+- 无缝回绕：副本按固定 unitW 等距绝对定位，`(frame*speed) % unitW`
+  取模平移——匀速 linear（marquee 类是库内 linear 豁免项）
+- 空心描边字：`-webkit-text-stroke`，color transparent；亮度脉冲
+  同时驱动三件事——描边宽 5→8px、opacity 0.35→1、双层 drop-shadow
+  辉光（8→30px + 20→70px）——只调 opacity 不调辉光读不出"霓虹通电"
+- 轮唱相位：周期 45f，行间相位差 15f（周期/3），余弦软包络且每行
+  只占周期前 1/3 亮、后 2/3 归零——保证"一亮俩暗"永远成立
+- 三行配色蓝/粉/琥珀（#4d9fff/#ff4dd2/#ffb347），深底 #050308；
+  中行反向且略快（14/17/14 px/f）——同速对滚读作镜像，破掉
+- 词尾加分隔点（•）撑词间距，unitW = 估宽 + 1.3 倍字号空隙
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 字号/行距 | 300px，行距 350px 排满 1080 | 行间留白 >80px 读作三条横幅广告而非一面词墙 |
+| 滚速 | 14/17/14 px/f，中行反向 | >25 读不清词只见光带；三行同速同向读作整版平移 |
+| 脉冲周期 | 45f，相位差 15f | 周期 <30f 三行抢闪读作故障；>70f 轮唱感断掉 |
+| 亮度区间 | opacity 0.35→1 + stroke 5→8px | 暗态 <0.25 暗行消失，"三行"结构丢了 |
+| 辉光 | 双层 drop-shadow，亮态 30/70px | 单层或 <20px 读作普通描边字不读作霓虹 |
+| 淡入淡出 | 入 10f / 出 20f 整组 opacity | 循环体无始无终，掐头去尾全靠这两端；硬切进出读作素材没铺满 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 与 page-waterfall-wall 分工：那卡是页面截图纵向瀑布做"内容体量感"，
+  本卡是文字行横向对滚做"主题词余韵"——素材是词不是页，位置在片尾不在中段
+- 与 outro-group-photo-launch 分工：全家福是峰值终镜（元素合影+发布会收场），
+  本卡是终镜前的 recap 铺垫或低成本备选终镜，两者可串（本卡→淡出→全家福）不可叠
+- 与 cel-flash-stomp 同吃"三连词口号"文案：那卡逐词砸（高能宣告），
+  本卡整组滚（余韵复读）——同一组词全片最多各用一次，先砸后滚顺序不可反
+- 副本数按 `ceil(1920/unitW)+3` 留冗余——短词（≤4 字符）unitW 小，
+  副本不足会在回绕瞬间露右侧空缺
+- 实战品牌色版：三行可统一品牌色靠明暗区分，但辉光对比须 ≥ demo 的
+  0.35→1 幅度，不然轮唱读不出来
+
+## 参考实现
+demos/neon-triple-marquee/
+（NeonTripleMarquee.tsx）
+原片出处：clickup-30 61–64.5s

package/skills/hyper-animator-codex/references/shotcraft/cards/odometer-digit-roll/README.md

@@ -0,0 +1,54 @@
+---
+name: odometer-digit-roll
+一句话: 里程表数字滚动大字报——全屏巨号指标每个数位像老虎机滚轮独立纵向滚动带残影，从左到右逐位过冲停稳，全部锁定瞬间整体加深脉冲
+适用: 单个王牌指标的全屏亮相（"10x"/"99.98%"级）；与 impact-feedback B 式（伤害数字弹出）分工——那是元素级配菜，这是全屏级主菜
+时长: 滚动+逐位锁定 ~63f + 脉冲 8f + hold ≥45f，约 5s
+能量: 中高
+---
+
+## 意图
+王牌数字的登场库内有"砸"（score-slam）和"弹"（damage-number），
+都是位移系。本卡是**机械系**：数字不是飞进来的，是"算出来的"——
+每位一条 0–9 滚轮高速转动，从左到右逐位减速、过冲半格、咔哒锁定，
+Vercel Ship/Stripe Sessions 指标段的标准语法。滚动过程自带悬念
+（它会停在几？），逐位锁定自带节奏（哒、哒、哒、哒），比直接显示
+终值多一整拍的期待感。与 VerticalTicker（backlog 待选）的区别：
+有终值、逐位停稳，不是无限滚动墙。
+
+## 动效核心
+- 每位一个 overflow:hidden 数位盒 + 0–9×2 纵列 strip，
+  `translateY = −(pos % 10) × 行高`，posAt(f, i) 纯帧函数
+- 位 i 于 20+i×7f 开始 16f Easing.out(cubic) 减速至目标 +0.5 行
+  **过冲半格**，再 6f 弹回整数锁定——锁定帧即各位的"哒"
+- 滚动期每位叠 2 个错帧残影副本（translateY ±行高×0.5，
+  opacity 0.25/0.12），按相邻帧速度门控，停稳自动摘——纵向拖影
+  与 smear-multiples 同理（可数残影不是模糊）
+- 全体锁定帧：整体 ink→#000→ink 加深脉冲 8f + 1.035 微缩放 +
+  下方标签条淡入——"合计确认"的句号
+- 小数点与 % 等非数字位全程驻场不滚
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 字号/字体 | 190px fw800 + fontVariantNumeric: tabular-nums | 非等宽数字每滚一格整行抖动（同 scramble 等宽判例） |
+| 错峰 | 20+i×7f 起停，从左到右 | 从右往左停读作倒着算；同时停失去"哒哒哒" |
+| 过冲 | +0.5 行再 6f 弹回 | 无过冲读作滑到即停，机械感减半 |
+| 残影 | 2 副本 0.25/0.12，速度门控 | 3+ 副本高速下糊成一条（行高小于卡片场景） |
+| 终值脉冲 | 加深 + 1.035 缩放 8f | 只加深不缩放在 190px 黑字上不可感（实渲加码） |
+| 收尾 | 脉冲归零后真静止 ≥45f | R1 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 数位 ≤6（含小数点前后）——每多一位多 7f 错峰，8 位滚完 >2.5s
+  观众等不起；大数换缩写（12.4M 不是 12,400,000）
+- 与 impact-feedback B（伤害数字）同片可共存但分工要清：全屏主菜
+  一次（本卡），卡片配菜多次（B 式）——两处都全屏就是两次主菜
+- 滚动的数字必须是**真值的各位**——终值 99.98 就滚 9/9/9/8，
+  中途乱数会被暂停党抓到"假滚动"
+- 声音强依赖候选位：逐位锁定"哒"×N + 终值确认一声低音
+  （sound-design §4.5），无声版成立但少一半爽感
+
+## 参考实现
+demos/odometer-digit-roll/
+（OdometerDigitRoll.tsx）

package/skills/hyper-animator-codex/references/shotcraft/cards/outro-group-photo-launch/README.md

@@ -0,0 +1,39 @@
+---
+name: outro-group-photo-launch
+一句话: 全片元素从四面八方飞来围住字标合影，crane 落机位+舞台光+金尘做成发布会收场
+适用: outro/品牌收尾；多功能产品的"全家福"式终镜
+时长: 约 4.8s（145f）
+能量: 峰值（全片最高点）
+---
+
+## 意图
+把看过的每个功能各抽一个代表元素叫回来合影，字标压轴登场——观众离场前最后记住的是"这些东西属于同一个产品"。规格必须是发布会级：能量推到全片最高。
+
+## 动效核心
+- 9 个页面元素（nav/卡片/内容条/搜索框/统计条/文档头）从四方带旋转飞入，落地强调色（模板片为琥珀）glow
+- 字标 letterpress 逐字登场，全员"退后排"让主角；rule 长出、延长线射出
+- crane 运镜：合影层整体 rotateX 4°→0 + scale 落下，之后缓推
+- 发布会氛围三件套：开场光带扫过、字标背后舞台光、金尘上飘
+- 背景页面 blur 化作景深
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 元素飞入 | 9 元素 cue 从 4 起每 3f 一个，各飞 12f；起点偏移 ±360–500px；渲染顺序=cue 顺序，后到者叠上 | 每个已展示过的功能都要有代表元素（Q8 自检项），缺谁观众都会察觉 |
+| 飞入缓动 | bezier(0.34,1.4,0.44,1) | 代码注释点名教训：旧 bezier(0.25,0.9,0.3,1) "never crossed 1" 没有真过冲——落地要弹 y1 必须 >1 |
+| 飞行姿态 | 飞行中 rot×2→settled rot（±5° 内）、scale ×1.12→1；ghost 残影滞后 8% blur 8px；落地强调色 glow 6f（0.35→0）multiply | 落定角度收进 ±5° 内——合影要整齐但不刻板 |
+| 退后排 | 字标登场时 42–50f 全员 opacity −12%、saturate −8% | 主角登场配角必须让位，不让位字标压不住 9 个元素 |
+| crane 运镜 | `perspective(1400px) rotateX(4°→0) scale(1.06→1)` 前 40f 落下，之后缓推 +0.035 | crane 幅度就这么小（4°）已经够"落机位"读感，大了会晕（推测） |
+| 氛围三件套 | 光带 2–14f（600px 宽 overlay 峰值 opacity 0.12）；舞台光 42→50→58f 0→0.5→0.25；金尘 20 颗 2–3px、opacity 0.15–0.35、全参数 index 派生确定性 | 粒子/光效参数必须确定性派生（硬规则：渲染必须可复现）；金尘超过 30 颗开始像雪（推测） |
+| 字标 | 字母 delay=42+i·1.8、8f；rule 58→70f 长出、两端 190px 延长线 8f 射出 6f 淡去；字距 62–66f 呼吸；背景页 24f 内 blur 0→14；落定后 sign-off hold 30f | 字标落定 hold 满 1 秒（R1 定案）；outro 不加解说 caption 保持干净（C1 例外项） |
+
+## 声音
+固定三拍句式：riser-cine 铺进组装（模板片钉在 f945）→ impact-cine 钉字标 stamp（f980，vol 0.55 全片峰值）→ sparkle 点 rule（f1005）。这是模板片定稿后唯一从未改动的段落句式（S2；详见 sound-design 4.3）。
+
+## 已知坑
+- 初版收尾几乎总是偏保守（Q8：安静签名式→合影→发布会三级加码）——起稿就按"像一个产品发布"的规格给足 crane/舞台光/粒子
+- 结构先于特效：先有"四方飞入合影"结构再加码氛围；直接堆特效没有骨架
+- outro tagline 与字标下方文案查重（P4 dedupe 判例），同一句话全片只出现一次
+
+## 参考实现
+template/src/aifl/live/SceneOutroLive.tsx（30f sign-off hold 时长见 template/src/aifl/Main.tsx 时间线）