hyper-animator-codex 0.7.0 → 0.8.0

package/skills/hyper-animator-codex/references/shotcraft/cards/glow-flyline-moves/README.md

@@ -0,0 +1,51 @@
+---
+name: glow-flyline-moves
+一句话: 暗场光斑与飞线三式——glow-orb-ambient 光斑底噪、flyline-arc 飞线连接、orb-flyline-relay 同帧共振组合
+适用: 全片唯一暗场段落的氛围与数据叙事：铺底噪用 A、讲数据流向用 B、要背景给前景搭腔用 C；Linear 官网味
+时长: A ~5s / B ~4.7s / C ~5.2s
+能量: A 低（底噪级）/ B 中 / C 中高
+---
+
+## 意图
+这是库内第一张整卡住在**暗场**的卡。白底提亮不可见判例反过来读就是：
+要玩光，先去暗场。A 是空间的呼吸——近黑底三团重 blur 光斑有机漂移，
+中央深卡边缘随最近光斑靠近而泛光，背景不再是死的；B 是数据的动词——
+发光弧线从 A 卡"打"到 B 卡，亮点头领跑、渐隐光尾，落点描边脉冲点亮，
+指标关联第一次有了方向；C 是 A+B 的焊接——飞线落点帧邻近光斑同帧
+涨亮一拍，氛围层与事件层**同帧共振**，互相搭腔而非各演各的（组合命门：
+拆开共振帧就退化成两张卡并置）。
+
+## 三式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A glow-orb-ambient | 三团 500–700px radial 光斑 + blur(100px)，双正弦漂移；卡缘辉光按光斑距离 [180,720]px→[1,0] 加权取 max 驱动 | 暗场段落铺底；卡呼吸感 |
+| B flyline-arc | 手写 bezier 100 段采样，22f out-cubic 生长；光头条件挂载领跑，段 opacity 按离头距离渐隐；落点描边脉冲，可接力 | 数据流向/指标关联；dashboard 叙事 |
+| C orb-flyline-relay | A+B 焊接：光斑 surge 与卡脉冲共用落点帧，涨亮 1+1.6×surge、5f 起升 15f 消散 | 暗场高光段；三卡接力收束 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 光斑 | 峰值 opacity 0.32/0.22/0.18；漂移振幅合计 ≥240px、周期 92–134f 交叉不等 | 同周期漂移读作整体晃动不是"有机" |
+| A 卡缘辉光 | box-shadow 0→28px 白 0.25 | 无辉光光斑与卡互不认识 |
+| A 收敛 | 90–120f out-sine 收敛冻结（起始斜率≈0.94 近似连续），末 30f 真静止 | 硬停一帧读作卡死；缓动收敛才有真静止 |
+| B 线体 | 白线 4.5px + 9px 深色衬底；暗场版可去衬底 | 浅底无衬底白线直接消失（demo 判例） |
+| B 光头 | 白点 9px + halo，仅生长期条件挂载 | opacity 到 0 不算摘罩，永不真静止 |
+| B 脉冲 | 描边扩散 out-cubic 6f / 消散线性 12f | 白底禁提亮——用加深罩 0.16 替代 |
+| C 共振 | 落点帧同帧起 surge；卡 8f 亮到 1 + 描边脉冲残余 0.3 | 错 2f 以上共振读不出"搭腔" |
+| C 时间轴 | 动作 f98 前结束、光斑 f120 冻结，末 35f 真静止 | 氛围层最后冻，事件层先收 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 暗场段与纸墨浅底主视觉切换成本高——全片暗场段 ≤1 段，进出
+  用 shot-transitions 藏切族垫，别生切明暗
+- 光斑漂移末段**必须**缓动收敛到静止再冻结——匀速漂移直接 clamp
+  是一次可见的急刹（A 式 out-sine 收敛判例）
+- 实战品牌色版：光斑用品牌色对（如蓝紫），灰阶参数只保证明度关系，
+  色相对比要重调
+- B 接力线 ≥3 条时改用 C——纯飞线连打读作大屏模板，共振才有作者感
+- 声音：B/C 每次落点一声轻打点，A 无声（sound-design §4.5）
+
+## 参考实现
+demos/glow-flyline-moves/
+（FlylineArc.tsx / GlowOrbAmbient.tsx / OrbFlylineRelay.tsx）

package/skills/hyper-animator-codex/references/shotcraft/cards/gradient-word-sweep/README.md

@@ -0,0 +1,49 @@
+---
+name: gradient-word-sweep
+一句话: 黑底标语里关键词被渐变彩光从左到右快速扫过"充能"——波前字符辉光最强向后衰减，填满后字符间勾连细紫红闪电、整词稳态泛光呼吸
+适用: 标语里给单个动词/卖点词充能（Supercharged/faster/AI…）；能量高潮段的文字戏；黑场品牌片的口号帧
+时长: 扫充 ~15–20f（要快）+ 稳态闪电呼吸 1–2s；全段 2.5–3.5s
+能量: 高（一词爆点，前后都该让位）
+---
+
+## 意图
+整句白字里只有关键词被"通电"：渐变彩光从左到右快速扫过字符，
+像能量注入——扫过的瞬间最亮（波前尾迹），随后衰减到稳态；
+填满后字符之间跳起勾连的细闪电，词保持泛光呼吸。三个命门：
+**快**（扫充 15–20f，慢了读作进度条）、**波前最亮**（刚点亮的
+字符效果最强，没有这个梯度就是静态渐变裁切）、**辉光克制**
+（AE 式多层泛光但别糊成一团，闪电细而稀疏才是点缀）。
+
+## 动效核心
+- 渐变填充：关键词做双层文字（白/渐变彩），彩层用从左到右推进的
+  mask 揭开；斜切 mask 边缘略糊（~8% 词宽）
+- 波前尾迹增亮：跟随 mask 前沿一条 ~34% 词宽的增亮带，波前处
+  辉光最强、向后衰减；填充结束后 ~10f 淡出到稳态
+- 辉光：4 层泛光（环境大柔光+中晕+近核+亮核），稳态 opacity
+  0.55–0.72 档（实测：0.75–0.95 档被裁"泛光感有点强"）
+- 闪电：填满后字符间勾连细闪电，紫红系三层描边（外晕 6/中 2.4/
+  亮核 1.4），mulberry32 种子随机跳位闪烁，稀疏零星（不是持续电弧）
+- 禁：填充过程不带跟随移动的光点/星光（实测判例：跟随白色光点读作廉价装饰，删）
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 扫充时长 | 15–20f | 原片"速度很快"；>28f 读作进度条 |
+| 波前增亮带 | ~34% 词宽，波前最亮向后衰减 | 无梯度＝静态渐变；带太宽＝整词一起亮没有"注入"感 |
+| 稳态泛光 | 4 层 opacity 0.55/0.55/0.62/0.72 | 0.75+ 档被裁太强；辉光层数<3 读作纯色 |
+| 闪电线宽 | 外 6/中 2.4/核 1.4 @1080p | 加倍即被裁"粗"；颜色偏紫红（magenta 216,60,190 系） |
+| 闪电频率 | 稀疏零星（同屏 ≤2 道，间歇 >8f） | 频率高读作电弧故障；实测 demo 仍略密于原片 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 判例三条（用户逐字意见沉淀）：①填充过程禁跟随光点；②闪电
+  必须紫红+细；③泛光宁弱勿强，波前梯度补足冲击力
+- 与 type-rhythm-sync/cel-flash-stomp 分工：那些是节拍/砸字；
+  本卡是单词"充能"的能量语义，词必须是句中卖点词
+- 关键词外的正文保持纯白静止——全句都动就没有"只有它通电"的戏
+
+## 参考实现
+demos/gradient-word-sweep/
+（GradientWordSweep.tsx）
+原片出处：clickup-30.mp4

package/skills/hyper-animator-codex/references/shotcraft/cards/graze-face-tour/README.md

@@ -0,0 +1,56 @@
+---
+name: graze-face-tour
+一句话: 大倾角贴面游走特写——镜头贴着 UI 表面低飞掠过（侧栏树/顶栏/列表当地形），页面文字初始悬浮在界面上空带同形软影，随镜头行进先后加速贴落回界面
+适用: 功能区巡礼（把 UI 当地景飞掠）；配合暗场+霓虹缘光做产品"内部世界"段落；界面内容逐区登场
+时长: 单段 4–5s；可多段接力延长
+能量: 中高（运镜持续推进+元素连续落位，信息密度高）
+---
+
+## 意图
+把 UI 拍成地形：大倾角特写让侧栏树、导航、列表行变成掠过的地貌，
+浅景深强化"贴面"。戏眼是**文字空中贴落**：文字/组件不是原地淡入，
+而是悬浮在界面上空（3D z 轴抬高），在空中时往界面投同形软影，
+随镜头行进先后加速贴落、影子随高度收敛消失——观众看见界面在
+镜头经过时"完成自己"。影子是可感命门：没有影子，悬浮读作
+普通位移入场；有影子，空间关系瞬间成立。
+
+## 动效核心
+- 机位：CSS perspective + rotateX/rotateY 大倾角（面几乎侧掠），
+  沿界面一条路径持续推进；浅景深＝远处 blur 渐强
+- 悬浮元素：初始悬浮高度 H≈120–180px（沿面法线方向抬起），
+  easeFall 加速下落+软着陆（落地不回弹或极微回弹）
+- 同形软影：元素原位渲染模糊压暗投影，blur/offset/opacity 全部
+  随当前悬浮高度变化（高＝影大而糊而淡，落地＝影与本体重合消失）
+- 错峰贴落：各元素落地时刻按镜头行进方向排布（先经过的先落），
+  界面在镜头前"依次完成"
+- 长镜可拆段接力：段间用相邻段交叉淡化（判例：透明度窗口不重叠
+  会产生黑闪帧）
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 悬浮高度 | 120–180px | <80px 影子和位移都读不出；>250px 落地砸得太重 |
+| 影子参数 | blur/offset/opacity 随高度线性收敛 | 影子恒定不随高度变＝贴纸感；落地影必须归零 |
+| 贴落错峰 | 按镜头行进方向 0.2→0.85 归一化排布 | 同帧齐落读作开关；乱序落读作 bug；**错峰=错开起点但下落过程重叠并行**，串行等待（一个落完另一个才开始）被裁（runway 判例） |
+| 下落曲线 | easeFall 加速+软着陆 | ease-out 下落读作气球飘落，重力感靠加速 |
+| 段间接力 | 相邻段交叉淡化 ≥8f | 透明度窗口不搭接会黑闪（返工判例 f100 纯黑帧） |
+| 景深 | 远处 blur 渐强 | 全清晰读作平面滚动，浅景深才有"贴面"体感 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 悬空元素别被环境压黑带吞掉（邻候选 runway 判例）：空中元素
+  需追光/提亮 ~1.3x，否则悬浮状态不可感等于没做
+- 与 space-camera-moves/tension-camera-moves 分工：那两张是相机
+  语言本身；本卡=贴面机位 **+ 元素贴落** 的组合签名，缺一半就
+  改用相机卡
+- **贴落节奏语义判例**（与 neon-frame-orbit-drop 互为反例）：
+  本卡巡礼镜=错峰并行；整体登场镜必须全体同帧齐落（那张卡的
+  错峰版被裁）。选错语法两边都会被裁
+- 原片（clickup-30）是一条连续上行长镜；复刻用三段接力，段落
+  切换藏在交叉淡化里——实战若做真单长镜，路径规划成本高得多
+
+## 参考实现
+demos/graze-face-tour/
+（GrazeFaceTour.tsx）
+原片出处：clickup-30.mp4

package/skills/hyper-animator-codex/references/shotcraft/cards/hashtag-to-pill-materialize/README.md

@@ -0,0 +1,57 @@
+---
+name: hashtag-to-pill-materialize
+一句话: 话题词打字实体化——居中打出 "#word"（红实心光标恒亮），1 帧硬切变成宽大胶囊标签，hold 后缩小左移落到页面标签位，再 1 帧硬切揭示成品页；"两次硬切一次滑动"的节奏骨架
+适用: 标签/分类/关键词功能的演示段（笔记 app 打 tag、话题聚合）；"输入 → 变成 UI 实体 → 归位到成品"的三段式叙事
+时长: 打字 ~40f + 硬切胶囊 hold ~18f + 缩移 ~14f + 硬切揭示后静置；全段约 3.5s（原片 18–21.5s）
+能量: 中（干脆利落，靠硬切给劲，不靠弹跳）
+---
+
+## 意图
+文字变实体的常规做法是渐变/morph/展开，原片帧级拆解证明 Bear 反着
+来：**实体化是 1 帧硬切**——上一帧还是文字+光标，下一帧就是完整
+胶囊，无展开无 cross-fade 无回弹。硬切给的是"啪、成了"的确定感，
+任何渐变都会把"实体"软化成"特效"。全段骨架是**两次硬切夹一次
+滑动**：硬切实体化 → 平滑缩移归位 → 硬切揭示成品页。唯一的连续
+运动（缩移）被两记硬切框住，才显得又快又稳。这个节奏骨架是命门，
+三段挪动任何一段的性质（把硬切改渐变、把滑动改硬切）整卡就塌。
+
+## 动效核心
+- 打字段：几何无衬线（Futura 气质）居中打 "#word"，**红实心光标
+  恒亮不闪**（原片实测，别加 blink）；人手节奏 4–6f/字带确定性抖动
+- **实体化 = 1 帧硬切**：文字+光标整层消失，同帧出现无描边浅灰
+  胶囊 + 图标 + 词（字号不变、原位等大，# 被图标替换）；仅允许
+  3f 1.03→1 微落定防死板
+- 胶囊 hold ~0.6s → 一段 bezier easeInOut 缩小左移（~0.55x、
+  ~14f）落到页面标签位，位置/缩放同曲线同起止，中途不分段
+- 落位后**再 1 帧硬切**揭示成品页：底色/标题/正文/胶囊配色同帧
+  全变，之后真静止收尾
+- 实现要点：胶囊按大字号绘制、整体 transform 缩放，且
+  transformOrigin 必须 0 0 + translate 先行，否则落位中心漂移
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 打字节奏 | 4–6f/字（原片 ~6 字/秒），mulberry32 抖动 | 均匀间隔读作机打；光标必须恒亮（**原片实测**不闪烁） |
+| 实体化 | **1 帧硬切**（原片帧级实测无任何过渡）+ 3f 1.03→1 微落定 | 加淡入/展开立刻降级成普通 morph；微落定 >4f 读作弹跳 |
+| 胶囊几何 | 740×236@1920（**原片实测** 493×157@720p ×1.5），无描边 | 胶囊要"宽大过头"才有实体感；加描边读作按钮 |
+| hold | ~18f（0.6s，**原片实测**） | <12f 观众没看清胶囊长啥样就飞了 |
+| 缩移 | ~0.55x（**原片实测** 273/493）、14f、bezier(0.5,0,0.25,1) | 缩放与位移必须同曲线；分开调会读作两个动画 |
+| 揭示 | 落位 +3f 再 1 帧硬切全页 | 揭示若做转场，第二记硬切没了，骨架塌一半 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 与 typewriter-moves/ai-stream-response（打字呈现）、
+  morph-from-primitive（图元渐变成形）撞领域：本卡命门是**硬切
+  实体化非渐变变形**——只要你想加过渡，就该去用那几张卡而不是改这张
+- 早期版本曾杜撰"胶囊飞入下方滑入笔记卡"段，原片对照证伪已砍；
+  别复活飞行段
+- transformOrigin 默认 50% 50% 会让缩放落位中心漂移 (1−s)×半宽，
+  必须 origin 0 0 + translate 到目标中心再 scale（demo 内注释）
+- 与原片残余差距：音符图标手绘 SVG 曲线、Futura 回退字重、揭示帧
+  正文间距 ~10px 级别偏差；节奏与硬切时点已密帧对齐
+
+## 参考实现
+demos/hashtag-to-pill-materialize/
+（HashtagToPillMaterialize.tsx）
+原片出处：bear-app.mp4 18–21.5s

package/skills/hyper-animator-codex/references/shotcraft/cards/hires-rasterize-3d-text/README.md

@@ -0,0 +1,34 @@
+---
+name: hires-rasterize-3d-text
+一句话: 3D 透视下 UI 文字发糊的根治法——高分辨率栅格化 + 布局级 CSS zoom，纹理从高清源向下采样
+适用: 一切 2.5D/3D 页面推进、卡片特写镜头（Chromium/Remotion 渲染环境）
+时长: n/a（技法卡，不占时长）
+能量: n/a（技法卡，不占时长）
+---
+
+## 意图
+这是全库"最贵的知识"：经历多轮"文字模糊"追打、四连击排查才找到根因的技法。凡是把 UI 截图放进 3D 变换再放大的镜头，迟早撞上它。
+
+## 动效核心
+- 根因：Chromium 对 3D 合成层按 1920 布局宽栅格化再 GPU 放大——内容先降采样后放大必糊，与相机/景深参数无关
+- 解法：放大量不走 `transform: scale(zoom)` 而走 CSS `zoom` 属性（布局级缩放），让 Chromium 按放大后的设备尺寸栅格化纹理，从高清源向下采样
+- 配套：hero 元素单独做更高倍率的元素级截图，在推进期交叉淡入盖住低倍页面纹理
+- DoF 只是辅助氛围，永远不是清晰度问题的解法
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 纹理源倍率 | 全页 2x（deviceScaleFactor: 2），hero 元素 4x（card4-hires.png，1432px 源） | 纹理源分辨率 ≥ 显示尺寸 2 倍是底线（Q2 自检项）；显示越大截越高，先查这一环再动别的 |
+| 布局级缩放 | CSS `zoom` 属性替代 transform scale；坐标换算 Tx = 960/zoom − cx | 换算公式保证与平面模式取景数学一致（PageCam.tsx:100-114 注释有完整推导）；漏换算会跑焦点 |
+| 交叉淡入 | hero 4x 截图在推进期 6f 交叉淡入盖住 2x 页面纹理 | 淡入太长会看到两层错位；6f 在运动中无感（推测） |
+| DoF | 顶部渐变带 backdropFilter blur，focusY 240、strength 峰值 9 后归零 | DoF 调焦平面治不了糊（实证无效）——它只做氛围，别拿它救清晰度 |
+
+## 声音
+技法卡，无声音段。若镜头因此换纹理/改坐标导致时间线变动，SFX 全表重对（S3）。
+
+## 已知坑
+- 排查顺序是关键（Q2）：文字糊 → 先查纹理源分辨率链路（截图倍率→栅格化路径→缩放方式），最后才考虑相机——正确顺序是先调 DoF（治标无效）→ 4x 元素截图（仍糊）→ 原生尺寸栅格化 → CSS zoom 布局级推广（根治），四连击的前两击都打偏了
+- 验证方式：逐帧截图放大看文字边缘有无像素方块（P1 的像素级自检；配一个裁剪放大工具）——肉眼看缩略图发现不了
+
+## 参考实现
+template/src/aifl/live/PageCam.tsx；配套 hero 双层交叉淡入见 template/src/aifl/live/SceneOpen.tsx

package/skills/hyper-animator-codex/references/shotcraft/cards/icon-field-colorize/README.md

@@ -0,0 +1,53 @@
+---
+name: icon-field-colorize
+一句话: 灰阶小图标点阵错峰浮现铺满全屏，停一拍后多道品牌色横带波纹极快向下扫翻全场——"功能全景先摆满，品牌一瞬间点亮"的开场/收束卡
+适用: 开场铺陈产品能力面（图标=功能宇宙）再一举打上品牌色；功能集合页、生态/集成规模展示、片头 logo 前垫场
+时长: 浮现 ~45f 错峰 + 静置 ~10f + 翻色 12–45f + 终态静置；全段 3–4s
+能量: 中（浮现是铺垫，翻色瞬间是唯一爆点）
+---
+
+## 意图
+先用灰阶把"多"摆足——上百个小图标错峰浮进来铺满画面，灰阶保证
+读作背景纹理不抢戏；停一拍让观众意识到"摆满了"，然后品牌色以
+横带波纹形式极快扫过全场，灰世界一瞬间被点亮。命门在**翻色不是
+同帧硬翻**：原片实测是 ~0.5s 内多道色波依次向下快扫（蓝先覆盖全场，
+橙/绿/红依次覆盖更低行带），终态呈四色横带分层——波纹感让"点亮"
+有方向和速度，硬翻只读作换了张图。
+
+## 动效核心
+- 图标场：150–200 个小图标网格排布（行间半格错位），灰阶 3–4 档
+  随机；mulberry32 定分组/灰度/形状
+- 浮现：分 ~10 批错峰淡入（批间 4f + 批内 ≤3f 抖动），每个带
+  0.55→1.07→1 微弹（ease-out 入 + 7% 过冲回落）
+- 静置一拍（~10f）：让"铺满"被读到，翻色前的蓄力
+- 翻色：多道色波按行推进，行差 ~1.4f + 列微倾 0.25f + 每图标 ≤1.5f
+  抖动（斜切波前沿，不是整行同帧）；每道波从自己的起始行向下覆盖，
+  后波覆盖更低行带 → 终态多色横带
+- 翻色瞬间该图标 1.22x pop（正弦鼓包 3f），给波前沿加"啪"的质感
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 图标数 | 170（17×10 @1080p，CELL 110px） | <100 读不出"原野"；>250 单个太小翻色 pop 看不见 |
+| 浮现总长 | ~45f（10 批 × 4f + 尾批淡入 8f） | 太快读作闪现；>60f 观众等不及爆点 |
+| 翻色总长 | 原片 ~12f 全场完成；demo 45f | 越快越爆；教学/慢节奏场合才拉长 |
+| 波数 | 4 道（对应终态色带数） | 1 道=单色点亮也成立；波色=品牌色板 |
+| 行差 | 1.4f/行 + 列 0.25f 微倾 | 行差 >3f 波读作逐行扫描仪；0 = 硬翻 |
+| 翻色 pop | 1.22x 正弦 3f | 无 pop 波前沿读不出来；>1.4x 图标互相打架 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- **翻色不许同帧硬翻**——原片密帧核实为多道波纹快扫（bear-app
+  25fps 密帧：蓝→橙/绿/红约 0.5s 内完成），硬翻读作换图无"点亮"感
+- 图标需可辨认的实心简笔形（心/星/闪电/对勾…）；抽象色块读不出
+  "功能宇宙"语义
+- 与 bubble-swarm-takeover 分工：那张是气泡群涌入接管
+  画面的运动戏；本卡运动极克制，戏眼在灰→彩的瞬间翻色
+- 与 theme-switch-moves 分工：那张是 UI 界面明暗主题切换；本卡
+  是装饰性图标场的品牌色点亮，不承载界面语义
+
+## 参考实现
+demos/icon-field-colorize/
+（IconFieldColorize.tsx）
+原片出处：bear-app.mp4 ≈0.0–3.0s

package/skills/hyper-animator-codex/references/shotcraft/cards/icon-performance-moves/README.md

@@ -0,0 +1,46 @@
+---
+name: icon-performance-moves
+一句话: 图标表演两式——pop-burst-confirm 爆花确认（对勾蓄力弹大+炸粒子+扩散环）与 attention-bounce 求关注弹跳（图标连跳递增+落地压扁+镜头被吸引）
+适用: 半屏级 icon 特写段落；A "完成/成功"的标点符号，B 新功能引出
+时长: A 3–4s / B 4–5s
+能量: A 高潮点缀 / B 蓄势引入
+---
+
+## 意图
+库内图标动画品类首批入库：icon 是镜头怼着拍的表演者，不是 UI 角落的
+微交互。A 是确认时刻的三连爆——大对勾先缩 0.6x 蓄力 3f、弹 1.35x 过冲
+落回，同帧中心射出 10 根短线粒子+一圈描边环从边缘扩到 2.5 倍直径淡出，
+"部署成功"不是画出来的是炸出来的；B 是 macOS Dock 语汇——app 图标
+原地连跳 4 次一次比一次高（0.5→1.2 倍 icon 高），每次落地压扁
+（宽 1.2x 高 0.8x）+溅尘点，跳最高那下镜头向它轻推 8%（被吸引），
+落定后弹开功能面板——把"用户注意力"剪进叙事。
+
+## 两式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A pop-burst-confirm | scale 蓄力-过冲-落回 spring + N 条径向 line translate + 圆环 scale/opacity，全程 ~20f，随后标签弹出 | 任务完成/部署成功/打勾时刻，卡点音效 |
+| B attention-bounce | translateY 弹跳缓动递增 + 落地帧 scaleX/Y 挤压 + 尘点，峰值帧镜头 scale 1.08 推近，落定触发面板卡弹出 | 新功能引出："看我"→镜头看它→它开面板 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| icon 尺寸 | 400–500px 高（半屏特写） | 角落小图标做表演没人看见——表演者必须占 C 位 |
+| A 蓄力 | 缩 0.6x 停 3f | anticipation：无蓄力的弹出没有"爆"感 |
+| A 粒子/环 | 10 根短线飞 40–60px + 环扩 2.5 倍 | 三件套同帧齐发是"爆花"成立条件 |
+| B 递增弹跳 | 4 跳 0.5→1.2 倍 icon 高 | 等高连跳读作 loading；递增才是"越喊越大声" |
+| B 落地挤压 | 宽 1.2x 高 0.8x（1–2f） | squash 缺席=没有重量 |
+| B 镜头推近 | 峰值帧 8% | 镜头动作把"被吸引"的观众视角演出来 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 同批 bell-swing-alert（铃铛甩摆）淘汰无附言——挂点摆动型 icon
+  表演相性存疑，做新 icon 表演优先弹跳/爆发型
+- A 与 particle-celebrate-hits 同属爆发点缀，同一段落二选一
+- B 首版曾出画框（末跳最高点顶出），弹跳高度与画面上留白先算像素
+- 声音：A 蓄力静默→爆发帧"pop"+粒子细响；B 每次落地一声"duk"
+  音调递升，面板弹出一声轻"叮"
+
+## 参考实现
+demos/icon-performance-moves/
+（AttentionBounce.tsx / PopBurstConfirm.tsx）

package/skills/hyper-animator-codex/references/shotcraft/cards/impact-feedback/README.md

@@ -0,0 +1,50 @@
+---
+name: impact-feedback
+一句话: 命中反馈两式——hit-counter 连招计数（顿帧+伤害数字+combo 跳字）、anime-impact 动漫打击帧（负片+集中线+色散）
+适用: 元素落位/撞击的"命中一瞬"——给砸入、撞停加游戏级手感；按强度阶梯选式
+时长: n/a（元素级技法，寄生在落位动作上；各式占用帧数见参数表）
+能量: 高（瞬时冲击）
+---
+
+## 意图
+元素砸到位却没有"砸到了"的一瞬，落位读作 PPT 飞入。游戏 juice
+（Vlambeer screenshake 理论）与动漫演出 impact frames 给了同一答案：
+命中的那几帧把时间咬住，冲量才传到观众手上。两式是一条强度阶梯：
+B 用局部顿帧叠伤害数字和 combo 跳字，把功能清单剪成一套连招，
+叙事感最强；C 是最重的一拳——撞停 3 帧翻负片炸集中线，强调级最高、
+最风格化。
+
+## 两式选型表
+| 式 | 做法 | 适用 |
+|----|------|------|
+| B hit-counter 连招计数 | 三卡接连砸入，每命中 = 顿帧 2f + 伤害数字上浮 + ×N 计数跳字逐次加码 | 功能点连打段——"功能很多"用连招讲；游戏化语言浓 |
+| C anime-impact 打击帧 | crash-zoom 撞停的 3f 整幅负片反色 + 放射集中线 + 红青色散，第 4f 全撤 | 全片唯一高潮的那一拳；强调级封顶 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| B 节奏 | 三卡各隔 30f，命中前 10f ease-in(quad) 砸落；每命中全局冻结 2f | 间隔均匀才有"连招"节拍感 |
+| B 伤害数字 | 落点 scale 1.4→1 + 上浮 40–60px + 12f 渐隐 | 渐隐 >16f 拖泥带水，遮住下一击 |
+| B 计数器 | 脉冲峰值 1.3/1.45/1.6、rotate −2/−4/−6°、字号递增，`exp(−t/2.4)` 回落 | 逐次加码是命门——三次一样大读不出"越打越狠" |
+| C 急推撞停 | crash-zoom 6f ease-in(cubic) 推到 2.4x，卡心收敛到画面正中 | 急推参数走 crash-zoom-punch 卡 |
+| C 冲击帧 | 撞停起 3f：`invert(1) grayscale(1)` + 30 根楔形集中线（每 1–2f 换形态）+ 红/青负片副本 screen 叠加 ±8px 错位；第 4f 全撤 | 3f 是甜点——4f 起观众开始"看清"负片，魔术就穿帮 |
+| C 恢复震屏 | 第 4f 起 6px 指数衰减（τ≈2.2f），~12f 收干 | 幅度须过肉眼阈值（可感性判例） |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- B 式顿帧**必须全局**——背景滚动也要一起冻，否则读不出"时间被
+  咬住"，只像那张卡掉帧。demo 用统一 remap 帧 df 驱动所有层是命门；
+  唯闪白等"冻结期间也要发生"的效果用真实帧 f 驱动
+- 帧 remap 与 speed-ramp-freeze 同技术根，同一镜头别叠用两卡——
+  两套 remap 互相打架，节奏读作故障
+- C 式负片帧在纸墨审美的片子里非常抢戏——限高潮一次，且必须与
+  impact 音效同帧落地（拟音走 sound-design），无声的负片帧读作闪坏
+- B 式游戏化语言浓（伤害数字/combo 是明晃晃的游戏梗），产品调性
+  偏严肃时慎用
+- B 式多次顿帧后真实帧比动画时间多出累计冻结帧，排镜头预算时
+  按 `真实命中帧 = 动画命中帧 + 已冻结帧数` 折算（demo HITS_REAL）
+
+## 参考实现
+demos/impact-feedback/
+（AnimeImpact.tsx / HitCounter.tsx）

package/skills/hyper-animator-codex/references/shotcraft/cards/input-trigger-moves/README.md

@@ -0,0 +1,49 @@
+---
+name: input-trigger-moves
+一句话: 输入触发两式——cursor-performance 光标表演点击推近、keycap-smash-cut 键帽引信引爆猛切
+适用: 发布片的第一人称段落：演示核心交互、开场即高潮；观众"在用"而不是"在看"产品
+时长: A ~5s / C ~5s
+能量: A 中 / C 高
+---
+
+## 意图
+发布片的第一人称语法——观众不是在"看"产品，是在"用"产品：光标
+是手、键帽是指尖、触发即叙事。两式共同点：**交互动作当扳机，产品
+画面当枪响**。A 是慢扳机——放大光标带性格地滑入点击，镜头以点击点
+推近再缓退，有去有回（区别 crash-zoom：慢速、锚定光标、会回来）；
+C 是引信——假 3D 键帽（⌘K）呼吸悬浮，3f 压扁+底部亮环溢出当引信，
+按下引爆 30f 满屏轰鸣，最高潮一帧猛切成整齐静止全景，
+按下→爆发→定论。选型：演示交互用 A，开场即高潮用 C。
+
+## 两式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A cursor-performance | 光标三次贝塞尔弧线滑入+末端甩腕过冲，悬停提亮，点击帧按钮下陷+涟漪+推近 1.4x 停两拍缓退 | 核心按钮/交互的演示特写 |
+| C keycap-smash-cut | 键帽呼吸悬浮→3f 压扁+亮环引信 + 30f 卡片四面冲镜持续加速轰鸣 + 动势最猛一帧硬切静止全景、键帽嵌顶栏 | 全片开场定论；能量最高 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 甩腕 | 贝塞尔 t 到 f24 过冲 1.05 再 6f 拐回 | 无过冲的直线滑入没有"性格" |
+| A 悬停提亮 | 深底 #2f2f2f→#555553（4f）+ scale 1.05 | 白底提亮不可见（提亮判例），深色底才成立 |
+| A 涟漪 | 直径 60→380 out-cubic 22f 扩散 / opacity 0.9→0 线性 26f 消散，解耦；f66 条件卸载 | 扩散消散同曲线读作一坨淡出 |
+| A 推近 | f40–52 scale 1→1.4（与点击同帧起跳）→停 20f→18f inOut 退回；origin 钉点击点 | 光标与按钮必须同缩放层，否则推近漂移 |
+| C 引信压扁 | box-shadow 厚度 12→3px、3f 完成 + 下沉 14px + 键面变暗；亮环 out-cubic 90→560px 扩散、线性消散解耦 | 厚度被压扁的 3f 是灵魂——命门；无厚度差只是变色 |
+| C 轰鸣 | 28–58f 六物两轮 pass（第二轮更短）Easing.in(quad) 加速 + scale 1.5→3 + blur 1→5px 速度门控 | 全程必须一直在加速，匀速轰鸣泄劲 |
+| C 猛切 | f58 一帧 return 静止 JSX，键帽 44px 嵌顶栏，死寂 ≥82f | 切后画面不能有任何随帧属性 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 全片输入触发 ≤2 次——每次都该是段落级开关；连按三次键帽
+  观众就知道这只是转场花活，扳机失效
+- A/C 声音强依赖：click 采样/键击采样与触发帧同帧
+  （sound-design §4.5）；无声的按下读作画面自己动了
+- C 的猛切后键帽必须在新场景里回收（嵌顶栏呼应引信）——否则
+  只是两个手法排队，不是组合——组合命门
+- C 的轰鸣段与 smash-cut 卡（trailer-grammar-moves C 式）同源，
+  同片二选一
+
+## 参考实现
+demos/input-trigger-moves/
+（CursorPerformancePunchIn.tsx / KeycapSmashCut.tsx）

package/skills/hyper-animator-codex/references/shotcraft/cards/integration-hub-map/README.md

@@ -0,0 +1,54 @@
+---
+name: integration-hub-map
+一句话: 旧页面一次性快翻 180°（侧棱瞬间亮闪）落成新中枢页，五个集成 app 图标同帧弹现、随即五条彩虹光管同帧齐连，光管内输送脉冲持续流动——"翻开新一页，生态一齐接入"
+适用: 集成/生态能力段（一个产品连一切）；版本翻新叙事（旧页翻成新页）；暗场霓虹调性的功能高潮
+时长: 前摇 ~0.5s + 快翻 ~1.2s + 图标齐现 → 光管齐连两拍 ~0.7s + 输送呼吸 ≥1.5s；全段 4.5–5s
+能量: 中高（翻面是爆点，输送段是余韵）
+---
+
+## 意图
+翻面是"换时代"：旧文档页整个翻转 180° 得到新中枢页——必须是
+完整翻面不是转个角度（判例），翻的动作**快翻+尾段减速**、一口气
+完成无分段停顿（"匀速"判例：用户说的匀速=无停顿，不是字面
+linear；90° 侧棱停顿版被裁）。侧棱时刻只"闪一下"（1–3f 脉冲，
+长光晕平台被裁）。接入是**两拍制**：五图标同帧弹现（第一拍）→
+五管同帧起画齐连（第二拍）——齐，才读作"生态一次到位"；错峰
+逐个连读作逐个谈判（两轮被裁）。连通后光管内亮脉冲沿图标→中枢
+方向持续循环，"输送感"是终态的生命。
+
+## 动效核心
+- 翻面：rotateY 0→180°，35f，Easing.out(cubic)（前 41% 时间完成
+  80% 角度，尾段长减速缓着陆），双面卡（正面旧页/背面新页）
+- 侧棱瞬闪：~90° 时刻 2f 脉冲 bloom（0→1→0.25→0，4f 内归零）
+- 两拍制接入：五图标 tIcon 同帧（翻面落定 +3f）弹现；+10f 五管
+  tPipe 同帧起画，9f 齐长全亮
+- 输送脉冲：光管 dash 亮斑沿图标→中枢方向循环（速度 ~4.6px/f，
+  各管相位错开），全连通后中枢页轻呼吸
+- 背景：暗紫底噪 + 霓虹矩形浮现衬场
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 翻面时长 | 35f（曾 70f 被裁"再快1倍"） | <24f 读不出双面；尾段减速比例 ~60% 时间走 20% 角度 |
+| 翻面曲线 | ease-out 单调无停顿 | 侧棱停顿/分段被裁；严格 linear 起停生硬也被裁——快翻尾缓 |
+| 侧棱闪 | 2f 脉冲、4f 归零 | 长光晕平台被裁"闪一下就行" |
+| 接入节奏 | 两拍制：图标同帧 → +10f 光管同帧 | 错峰逐连两轮被裁"同时出现，然后同时连接"；两拍间隔 <6f 读作一拍 |
+| 光管生长 | 9f 齐长 | 18f 版偏慢；各管长度不同但同帧到达（按各自 len 归一） |
+| 输送脉冲 | ~4.6px/f 循环、相位错开 | 静态连线=没有"输送的感觉"（判例）；同相位读作闪烁 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 时序判例链完整记录在案：错峰连入 ×2 被裁 → 管齐图标错峰被裁 →
+  两拍制过关。"同时"是这张卡的节奏身份
+- 与 glow-flyline-moves 分工：那张是飞线本身的光效戏；本卡是
+  翻面+两拍接入+输送的叙事结构，光管只是元素
+- 与 canvas-materialize-moves 分工：那张是画布元素实体化；本卡
+  核心是"旧页翻成新页"的换代语义
+- 双面卡实现：水平/垂直线 bbox=0 会使 SVG filter/渐变失效（三管
+  消失判例），管线渐变用 userSpaceOnUse 每管独立定义
+
+## 参考实现
+demos/integration-hub-map/
+（IntegrationHubMap.tsx）
+原片出处：clickup-30.mp4

package/skills/hyper-animator-codex/references/shotcraft/cards/letterspace-materialize/README.md

@@ -0,0 +1,52 @@
+---
+name: letterspace-materialize
+一句话: 大字距字标全字符并行连续描画结晶——所有字母同帧起笔、笔画像手写一样连续生长、同帧齐收成词；氛围底景上的品牌字标显影
+适用: 片尾/片头品牌字标登场（SUPERHUMAN 式大字距全大写）；章节题字；needs 静谧/高级感的收束帧
+时长: 静置 ~15f + 描画 ~50f + 终态静置 ≥30f；全段 3–4s
+能量: 低（静谧仪式感，一次呼吸完成）
+---
+
+## 意图
+字标不是淡入也不是打字机，而是"结晶"：全部字母的笔画同时
+开始连续生长，像一只看不见的手同时写所有字母，同一瞬间齐收
+成词。两个命门：**连续**（笔画必须是连续画出的过程，不许遮罩
+分段——先半截再另半截会被读穿；任何中间帧都该像"写到一半"）；
+**同步**（所有字母同帧起笔、同帧完成——逐字错峰是打字机语义，
+这里是整词一体的仪式感）。
+
+## 动效核心
+- 每个字符用骨架笔画 SVG path（单线条字形），pathLength 归一 +
+  strokeDashoffset 从 1→0 连续描画
+- 全字符共享同一进度 p：同帧起笔、pathLength 归一保证不同笔画
+  长度的字母同帧齐收（不做 per-char delay/jitter）
+- 字形比例：方正略宽（字面宽高比 ≈1.07，实测判例：竖长字形被
+  裁"太竖长"）；细笔画+大字距（letterSpacing ≈0.6em）
+- 描画曲线：整体 ease-in-out，中段略快首尾略缓（起笔收笔的手感）
+- 底景：氛围渐变/实拍空镜（暮色山景类），字标是画面唯一动作
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 描画时长 | ~50f（f16 起 f68 收 @30fps） | <30f 读不出"画"的过程；>80f 拖 |
+| 同步性 | 全字符同帧起收、零错峰 | 判例：逐字错峰版被裁"所有字母是在同一个时间完成书写" |
+| 连续性 | pathLength 连续生长、无分段跳变 | 判例：遮罩分段版被裁"应该是连续的笔画画出来" |
+| 字形 | 骨架单线、字面宽高比 ~1.07、笔画细 | 竖长（比 <0.8）被裁；粗笔画丢结晶感 |
+| 字距 | ~0.6em | 大字距是本卡身份；<0.3em 改用普通描画卡 |
+| 终态静置 | ≥30f | 结晶完成后必须让观众读一次整词 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 与 draw-svg-trace 分工：那张是通用描画（图标/插画/单元素）；
+  本卡命门是**全字符同步**的整词结晶仪式，且限品牌字标语境
+- 与 type-assembly-moves 分工：那张是字块组装（位移拼合）；
+  本卡笔画从无到有生长，字符不位移
+- 骨架字形需手绘 path（现成字体轮廓是双线勾边，描画观感不同）；
+  9 字形工作量 ≈1h，实战优先复用 demo 里的字形库
+- 原片（superhuman-promo）底景是实拍暮色山景+水面倒影；demo 为
+  渐变近似，实战建议用实拍/AI 生成空镜
+
+## 参考实现
+demos/letterspace-materialize/
+（LetterspaceMaterialize.tsx）
+原片出处：superhuman-promo.mp4 ≈4.5–6.5s

package/skills/hyper-animator-codex/references/shotcraft/cards/light-play-moves/README.md

@@ -0,0 +1,49 @@
+---
+name: light-play-moves
+一句话: 光效三式——spotlight-sweep 聚光扫字、sheen 单点扫光、halation-bloom 撞停晕染
+适用: 把光当第四种笔触（扫/擦/晕）：暗场标题揭示（A）、主角卡加冕（B）、撞停帧冲击（D）
+时长: A ~5.3s / B ~4.7s / D ~4.8s
+能量: A 中 / B 低 / D 高
+---
+
+## 意图
+库内"光"一直只有 spotlight-hero-card 一个点射手法；这三式把光做成
+体系，三种笔触三种职责：A 是**扫**——暗场里几乎不可见的标题被锥形
+光摆动扫亮，光到哪哪亮，与 spotlight-hero-card 的区别是那个打卡片、
+这个扫文字；B 是**擦**——深墨主角卡上一道 45° 高光带缓扫一次，被
+圆角裁住，无声的加冕；D 是**晕**——白字撞停帧一圈柔晕猛涨炸开再
+回落成驻留呼吸光，与 B 的区别是 B 移动扫过、D 驻留在高光边缘。
+全部深底或深主角——**白底上提亮不可见**（判例）是这整张卡的地基。
+
+## 三式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A spotlight-sweep | 双层同文本：暗版 0.07 常驻，亮版 radial mask 随光斑走，锥形光摆两个来回后全亮定格 | 暗场大标题揭示开场 |
+| B sheen-sweep | 深墨卡上 45° 高光带 translateX 扫一次，overflow hidden 圆角裁剪 | 主角卡静止段的一次加冕 |
+| D halation-bloom | 文字复制底层 blur+brightness 当晕层，撞停帧起猛涨一圈回落成稳态柔光 | crash-zoom 撞停帧的冲击加成 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 反差 | 暗版 0.07 vs 全亮 1.0，白 #f5f5f3 对 #2a2a28 暗场 | 反差是本式全部；暗版 >0.15 就没有"点亮"了 |
+| A 光斑 | circle 380px（0.95 硬芯+柔边），x = 960+560·sin(2πf/55)，两来回至 f110 | f110–125 全亮 out-cubic、光效线性消散（扩散/消散解耦判例） |
+| B 高光带 | 宽 1.6×卡宽，115° 渐变峰值 rgba(255,255,255,0.32)，40–68f inOut cubic 扫一次 | 0.32 在深墨底上足够响；双向 clamp 保证只扫一次 |
+| D 晕层 | blur 22px + brightness 1.8；scale 1→1.3 用 6f out-cubic 猛涨，opacity 20f 线性回落 0.35 再 15f 缓收 0.22 稳态 | 扩散 out-cubic/消散线性解耦（判例）；同快涨快消读作闪光灯 |
+| 摘罩 | 三式光效层全部条件挂载，扫完/消散完即卸载 | opacity 0 残留 = 永不真静止（feTurbulence 摘罩判例同族） |
+| 收尾 | A 35f / B 72f / D 89f 真静止 | — |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- **全片光效合计 ≤2 次**——光是最快掉价的手法，每个卡都闪一下
+  等于廉价模板
+- B 式是高标准重试通过：旧否决（2026-07-13 判例）针对当时实现不好看，
+  非路径不可行；四约束 = 单点+主角+圆角裁剪+只扫一次，违反任何
+  一条回到否决区
+- 深底是地基：三式全部依赖深底/深主角，白底上做光效直接跳过本卡
+- D 与 crash-zoom-punch 撞停帧天然联动（撞停即起晕）；A 与
+  spotlight-hero-card 同片二选一，都是"聚光"语汇
+
+## 参考实现
+demos/light-play-moves/
+（HalationBloom.tsx / SheenSweepRetry.tsx / SpotlightSweepReveal.tsx）