dsh-drawai 0.4.2 → 0.4.3

package/lib/motion/shotcraft/upstream/references/shots/rhythm/trailer-grammar-moves.md

@@ -1,38 +1,38 @@
----
-name: trailer-grammar-moves
-一句话: 预告片语法一式——trailer-bumper 前置速剪钩子：三镜 9f 速剪 + 黑场静默一拍，再开场标题
-适用: 预告片的开场钩子（cold open）：正片前先塞三个最抓眼的镜头，再静默一拍正式开场
-时长: A ~4.7s（140f）
-能量: A 高
-标签: opening、transition
----
-
-## 意图
-库内节奏卡各管一段：beat-cut 管切点排布、rhythm-interrupt 管打断。
-本卡管**预告片的结构性时刻**——不是某个
-镜头怎么动，是整片的关节怎么接：A 是开场钩——正片前 0.9 秒塞
-三个最抓眼镜头速剪 + 黑场静默一拍再开场，预告片的"预告"。
-
-## 式选型
-| 式 | 做法 | 适用 |
-|----|------|------|
-| A trailer-bumper | 三镜头各 9f 等长硬切（0/9/18），每镜内部 scale 1→1.04 微推保活；27–33f 纯黑静默，33f 起标题 16f 淡入 + 44px out-cubic 微升（demo 标题是 video-shotcraft 字标 + 品牌 tagline） | 正片开场前的钩子；cold open |
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| A 速剪 | 三镜等长 9f，零过渡；镜头 3 对焦中列 Top pages 卡放大 2.2x 怼脸特写（CSS zoom，字不糊） | 节拍感靠等长；三镜构图必须明显不同 |
-| A 微推 | 每镜内部 scale 1→1.04 线性 | 静帧三连读作幻灯片——命门 |
-| A 黑场 | 27–33f 纯黑 #000 空 div，6f | 黑场里放任何东西都毁掉"静默一拍" |
-| 收尾 | A 静止 77f（≥40f） | 字距收拢完（63f）后整帧冻结，真静止 |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- A 黑场必须纯黑无物（drop-blackout 判例同族）——黑场是喘息，
-  不是又一张字卡
-- A 三连切每切一声打点、黑场全消音（sound-design §4.5）
-
-## 参考实现
-demos/rhythm/trailer-grammar-moves/
-（TrailerBumper.tsx）
+---
+name: trailer-grammar-moves
+一句话: 预告片语法一式——trailer-bumper 前置速剪钩子：三镜 9f 速剪 + 黑场静默一拍，再开场标题
+适用: 预告片的开场钩子（cold open）：正片前先塞三个最抓眼的镜头，再静默一拍正式开场
+时长: A ~4.7s（140f）
+能量: A 高
+标签: opening、transition
+---
+
+## 意图
+库内节奏卡各管一段：beat-cut 管切点排布、rhythm-interrupt 管打断。
+本卡管**预告片的结构性时刻**——不是某个
+镜头怎么动，是整片的关节怎么接：A 是开场钩——正片前 0.9 秒塞
+三个最抓眼镜头速剪 + 黑场静默一拍再开场，预告片的"预告"。
+
+## 式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A trailer-bumper | 三镜头各 9f 等长硬切（0/9/18），每镜内部 scale 1→1.04 微推保活；27–33f 纯黑静默，33f 起标题 16f 淡入 + 44px out-cubic 微升（demo 标题是 video-shotcraft 字标 + 品牌 tagline） | 正片开场前的钩子；cold open |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 速剪 | 三镜等长 9f，零过渡；镜头 3 对焦中列 Top pages 卡放大 2.2x 怼脸特写（CSS zoom，字不糊） | 节拍感靠等长；三镜构图必须明显不同 |
+| A 微推 | 每镜内部 scale 1→1.04 线性 | 静帧三连读作幻灯片——命门 |
+| A 黑场 | 27–33f 纯黑 #000 空 div，6f | 黑场里放任何东西都毁掉"静默一拍" |
+| 收尾 | A 静止 77f（≥40f） | 字距收拢完（63f）后整帧冻结，真静止 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- A 黑场必须纯黑无物（drop-blackout 判例同族）——黑场是喘息，
+  不是又一张字卡
+- A 三连切每切一声打点、黑场全消音（sound-design §4.5）
+
+## 参考实现
+demos/rhythm/trailer-grammar-moves/
+（TrailerBumper.tsx）

package/lib/motion/shotcraft/upstream/references/shots/transition/bottom-push-stack-wipe.md

@@ -1,63 +1,63 @@
----
-name: bottom-push-stack-wipe
-一句话: 底边上推换章——新场景连底色整屏从底边向上推入，把旧场景物理顶出画外，连推数章各配一种饱和底色，内容钉死在各自色底坐标系里随底色走
-适用: 多章节产品片的换章骨架（每章一个卖点一种底色）；需要"翻页节奏感"贯穿全片的段落切换
-时长: demo 三连推 170f（~5.7s）；单次推入 26f + 章内 hold ~1.2s
-能量: 中
----
-
-## 意图
-wipe-transitions 是一条边界扫过、新旧页都不动；page-turn 是旧页对开门
-裂开滑出。本卡是第三种物性：**新章把旧章顶出去**——两屏刚性接触、同速
-同向位移，像自动售货机压栈。命门是"连底色整屏走"：底色+窗口卡+装饰
-条焊成一块整料从底边推入，观众读到"换了个世界"而不是"换了张卡"。
-重 ease-out（快进慢停）给推入一个"哐"的落位感；上缘 40px 接缝阴影
-是两屏物理接触的证据。连推三章且底色饱和度拉满，换章本身就成了全片
-的节拍器——slack 原片全片就靠这一招做骨架。
-
-## 动效核心
-- 每章一个整屏层：`translateY` 从 +1080 推到 0，旧章同步被顶到
-  −1080——两层位移严格同步同缓动，任何速差都读作"滑动穿模"
-- 推入缓动 = 重 ease-out `cubic-bezier(0.12, 0.9, 0.2, 1)`（快进
-  慢停），26f 完成（~12f 已到 95%）；第 i 章的 y = (1−自己推入进度)×H
-  − 下一章推入进度×H，一条式子管进也管出；整摞按速度做纵向方向性模糊
-- 新章上缘带 56px 渐变接缝阴影（用新章的带色相深色 0.42→透明，压在
-  旧章上）+ 新章上缘 2px 受光边，落定后归零——"顶出"的物理接触感全靠它
-- demo 是「瑞士海报」式（产品 video-shotcraft，一章一个卖点）：第 0 章近黑开场，三章钴蓝 #2d4cff / 朱橙
-  #ff4d1f / 酸柠 #cdf23a（深色字），色相拉开 120° 级；每章左栏眉题 +
-  116px 超粗两行标题 + 40px 说明，右栏一张为镜头设计的大字 UI 卡
-  （和 agent 对话 / 踩点时间线 / 交付流水线），色板左上受光、右下压暗，与卡片阴影同一光向
-- 章内动画全部错开推入：标题在推入开始后 12f（已到 95%）才从线下升起，
-  UI 小动作（打字中→消息弹入 / 声波与当前镜头交接 / 交付步骤逐个打勾）放在 hold
-- 推入间隔 ~44f（demo 22/66/110f 起推）；出画的层及时卸载；尾段 28f
-  极缓推近 1.5%
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 推入时长 | 26f，重 ease-out | <20f 读作闪切；线性匀速读作卷帘门，"哐"感全无 |
-| 章间 hold | ~18f 静止 + 推入尾段，章内总停留 ~44f | 章内是内容表演区，<25f 观众没看清就被顶走 |
-| 接缝阴影 | 上缘 56px，章色深档 0.42 渐变 + 2px 受光边 | 去掉后两屏像叠影滑动；>80px 读作新章自带黑边 |
-| 底色 | 每章一种饱和色，相邻章色相拉开 | 相邻章同色系则"换章"读作"微调"；灰阶章只能当第 0 章 |
-| 内容钉死 | 窗口卡/装饰条用章内绝对坐标 | 内容若相对视口定位就会"漂"在推入动画上，穿帮 |
-| 连推次数 | 2–4 章 | 1 次不成节奏；>4 次观众开始数底色，疲劳 |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 与 wipe-transitions 分工：那卡新旧页都不动、一条几何边界扫过交接
-  （中性、哪儿都能用）；本卡两页都在动、刚性顶出（有物性、自带章节
-  节奏）——单次接缝用那卡，全片骨架用本卡
-- 与 shot-transitions 三式同层选型：本卡能量中档、方向固定向上，
-  需要能量落差大的接缝（如进 outro）让位给流白
-- 方向统一是骨架感的来源：全片所有章都从底边推，中途换成左推/顶推
-  节拍器就散了——要变方向就别当骨架用
-- 推入进行中两章同屏，都是满屏层——章内动画（卡片入场等）避开推入
-  的 26f 窗口（至少等到 95% 落位），不然两章都在动，视线没有锚点
-- 实战底色用品牌色板的饱和档；底色饱和度不足时窗口卡"钉在色底上"
-  的从属关系读不出来，会退化成"卡片各自换背景"
-
-## 参考实现
-demos/transition/bottom-push-stack-wipe/
-（BottomPushStackWipe.tsx）
-原片出处：slack-promo 22–27s
+---
+name: bottom-push-stack-wipe
+一句话: 底边上推换章——新场景连底色整屏从底边向上推入，把旧场景物理顶出画外，连推数章各配一种饱和底色，内容钉死在各自色底坐标系里随底色走
+适用: 多章节产品片的换章骨架（每章一个卖点一种底色）；需要"翻页节奏感"贯穿全片的段落切换
+时长: demo 三连推 170f（~5.7s）；单次推入 26f + 章内 hold ~1.2s
+能量: 中
+---
+
+## 意图
+wipe-transitions 是一条边界扫过、新旧页都不动；page-turn 是旧页对开门
+裂开滑出。本卡是第三种物性：**新章把旧章顶出去**——两屏刚性接触、同速
+同向位移，像自动售货机压栈。命门是"连底色整屏走"：底色+窗口卡+装饰
+条焊成一块整料从底边推入，观众读到"换了个世界"而不是"换了张卡"。
+重 ease-out（快进慢停）给推入一个"哐"的落位感；上缘 40px 接缝阴影
+是两屏物理接触的证据。连推三章且底色饱和度拉满，换章本身就成了全片
+的节拍器——slack 原片全片就靠这一招做骨架。
+
+## 动效核心
+- 每章一个整屏层：`translateY` 从 +1080 推到 0，旧章同步被顶到
+  −1080——两层位移严格同步同缓动，任何速差都读作"滑动穿模"
+- 推入缓动 = 重 ease-out `cubic-bezier(0.12, 0.9, 0.2, 1)`（快进
+  慢停），26f 完成（~12f 已到 95%）；第 i 章的 y = (1−自己推入进度)×H
+  − 下一章推入进度×H，一条式子管进也管出；整摞按速度做纵向方向性模糊
+- 新章上缘带 56px 渐变接缝阴影（用新章的带色相深色 0.42→透明，压在
+  旧章上）+ 新章上缘 2px 受光边，落定后归零——"顶出"的物理接触感全靠它
+- demo 是「瑞士海报」式（产品 video-shotcraft，一章一个卖点）：第 0 章近黑开场，三章钴蓝 #2d4cff / 朱橙
+  #ff4d1f / 酸柠 #cdf23a（深色字），色相拉开 120° 级；每章左栏眉题 +
+  116px 超粗两行标题 + 40px 说明，右栏一张为镜头设计的大字 UI 卡
+  （和 agent 对话 / 踩点时间线 / 交付流水线），色板左上受光、右下压暗，与卡片阴影同一光向
+- 章内动画全部错开推入：标题在推入开始后 12f（已到 95%）才从线下升起，
+  UI 小动作（打字中→消息弹入 / 声波与当前镜头交接 / 交付步骤逐个打勾）放在 hold
+- 推入间隔 ~44f（demo 22/66/110f 起推）；出画的层及时卸载；尾段 28f
+  极缓推近 1.5%
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 推入时长 | 26f，重 ease-out | <20f 读作闪切；线性匀速读作卷帘门，"哐"感全无 |
+| 章间 hold | ~18f 静止 + 推入尾段，章内总停留 ~44f | 章内是内容表演区，<25f 观众没看清就被顶走 |
+| 接缝阴影 | 上缘 56px，章色深档 0.42 渐变 + 2px 受光边 | 去掉后两屏像叠影滑动；>80px 读作新章自带黑边 |
+| 底色 | 每章一种饱和色，相邻章色相拉开 | 相邻章同色系则"换章"读作"微调"；灰阶章只能当第 0 章 |
+| 内容钉死 | 窗口卡/装饰条用章内绝对坐标 | 内容若相对视口定位就会"漂"在推入动画上，穿帮 |
+| 连推次数 | 2–4 章 | 1 次不成节奏；>4 次观众开始数底色，疲劳 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 与 wipe-transitions 分工：那卡新旧页都不动、一条几何边界扫过交接
+  （中性、哪儿都能用）；本卡两页都在动、刚性顶出（有物性、自带章节
+  节奏）——单次接缝用那卡，全片骨架用本卡
+- 与 shot-transitions 三式同层选型：本卡能量中档、方向固定向上，
+  需要能量落差大的接缝（如进 outro）让位给流白
+- 方向统一是骨架感的来源：全片所有章都从底边推，中途换成左推/顶推
+  节拍器就散了——要变方向就别当骨架用
+- 推入进行中两章同屏，都是满屏层——章内动画（卡片入场等）避开推入
+  的 26f 窗口（至少等到 95% 落位），不然两章都在动，视线没有锚点
+- 实战底色用品牌色板的饱和档；底色饱和度不足时窗口卡"钉在色底上"
+  的从属关系读不出来，会退化成"卡片各自换背景"
+
+## 参考实现
+demos/transition/bottom-push-stack-wipe/
+（BottomPushStackWipe.tsx）
+原片出处：slack-promo 22–27s

package/lib/motion/shotcraft/upstream/references/shots/transition/card-flip-reveal.md

@@ -1,57 +1,57 @@
----
-name: card-flip-reveal
-一句话: 功能卡 3D 翻面揭示——卡片沿 Y 轴翻 180°，正面 UI 翻到侧棱最薄处掠过一道随角度移动的受光，背面揭出大号结论数字，逐张错峰扫过整排
-适用: "功能→成果"的成对叙事：一排功能卡逐张翻出各自的指标/结论；元素级转场卡
-时长: 全程 150f（~5s，含 hold）；单卡 4f 预备 + 16f 翻 + ~10f 弹簧落定，三卡错峰 12f
-能量: 中高
-标签: data
----
-
-## 意图
-库内"翻"字辈已有 wipe-transitions 百叶窗（叶片逐条翻面，讲换页）。
-本卡是**语义翻面**：一张卡的正反两面是一对因果——正面是功能界面，
-背面是它带来的数字结论。翻面动作本身
-就是"所以呢？"的回答，Apple bento 段落的标准语法。逐张错峰 10f 扫过
-一排，三张卡三个数字节奏读作"成果连报"。
-
-## 动效核心
-- perspective 1600px + transformStyle preserve-3d；双面各自
-  backfaceVisibility hidden，背面预转 rotateY(180°)
-- 翻转三段：4f 预备（反向后仰 −10°，ease-out）→ 16f
-  bezier(0.55,0,0.3,1) 加速翻到 194°（14° 过冲）→ 物理弹簧
-  （damping 15）回落 180°；翻转中 translateZ 抬起 60px（sin 包络）
-- **受光**：面按偏离正面的角度着色（`(1−|cos θ|)` 压暗，暗面 0.55 /
-  亮面 0.4）；侧棱 56°→124° 区间一道窄受光带随角度从卡左扫到右，
-  强度三角包络在 90°（最薄瞬间）达峰——高光与角度联动才读作"光扫过
-  转动的面"，它是物理光照，不是额外的 glint 特效
-- **正反反相**：demo 正面是暗色功能卡（graphite 暗场），背面是瓷白
-  结论卡——翻面 = 从暗到亮，三张翻完画面从一排暗卡变成一排白色数字
-  海报；背面 158px 数字落定时 1.08→1 收拢，结论标签晚 4f 升起，上方
-  「之前 / 用上之后」对照条在落定后收短
-- 空间：卡片立在暗色镜面地板上，每张卡有一份同步翻转的竖直镜像倒影
-  （遮罩渐隐 26%、opacity 0.22），接地影宽度跟投影宽度 |cos θ| 收放
-- 错峰 delay 12f/卡；全部翻完真静止 ≥40f（demo 72f 后 hold 78f），
-  相机全程 1→1.03 极缓推近
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 翻转时长 | 4f 预备 + 16f 翻 + ~10f 弹簧 | <14f 看不到侧棱瞬间；>28f 读作慢慢转；砍掉预备读作被弹开而不是"翻" |
-| 过冲 | 194°→180°（14°），spring damping 15 | 无过冲落定读作生硬停表；damping <12 回弹两次读作果冻 |
-| 受光 | 面压暗 ≤0.55 + 侧棱窄带峰值 @90° | 峰值错开 90° 读作贴图错误；只有扫光没有面压暗读作贴了一道白条 |
-| 错峰 | 12f/卡，≤4 卡 | 同时翻读作整墙翻面，"成果连报"的逐张节奏就没了 |
-| 背面内容 | 大号数字（150–170px 级）+ 一行标签 + 至多一组对照条 | 背面塞完整 UI 读不完——翻面后只有一拍注意力；数字超 160px 时 "−41%" 这类宽字会顶出卡边 |
-| 收尾 | 末卡落定真静止 ≥40f | R1 |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 正反两面必须语义成对（界面→它的成果）；翻出无关内容，翻面就
-  只是花哨的换图
-- 真实素材正面用截图时注意 backface 渲染开销，三卡以上分 Sequence
-- 声音候选位：每卡翻停帧一声轻"啪"（sound-design §4.5），三连啪
-  节奏感翻倍
-
-## 参考实现
-demos/transition/card-flip-reveal/
-（CardFlipReveal.tsx）
+---
+name: card-flip-reveal
+一句话: 功能卡 3D 翻面揭示——卡片沿 Y 轴翻 180°，正面 UI 翻到侧棱最薄处掠过一道随角度移动的受光，背面揭出大号结论数字，逐张错峰扫过整排
+适用: "功能→成果"的成对叙事：一排功能卡逐张翻出各自的指标/结论；元素级转场卡
+时长: 全程 150f（~5s，含 hold）；单卡 4f 预备 + 16f 翻 + ~10f 弹簧落定，三卡错峰 12f
+能量: 中高
+标签: data
+---
+
+## 意图
+库内"翻"字辈已有 wipe-transitions 百叶窗（叶片逐条翻面，讲换页）。
+本卡是**语义翻面**：一张卡的正反两面是一对因果——正面是功能界面，
+背面是它带来的数字结论。翻面动作本身
+就是"所以呢？"的回答，Apple bento 段落的标准语法。逐张错峰 10f 扫过
+一排，三张卡三个数字节奏读作"成果连报"。
+
+## 动效核心
+- perspective 1600px + transformStyle preserve-3d；双面各自
+  backfaceVisibility hidden，背面预转 rotateY(180°)
+- 翻转三段：4f 预备（反向后仰 −10°，ease-out）→ 16f
+  bezier(0.55,0,0.3,1) 加速翻到 194°（14° 过冲）→ 物理弹簧
+  （damping 15）回落 180°；翻转中 translateZ 抬起 60px（sin 包络）
+- **受光**：面按偏离正面的角度着色（`(1−|cos θ|)` 压暗，暗面 0.55 /
+  亮面 0.4）；侧棱 56°→124° 区间一道窄受光带随角度从卡左扫到右，
+  强度三角包络在 90°（最薄瞬间）达峰——高光与角度联动才读作"光扫过
+  转动的面"，它是物理光照，不是额外的 glint 特效
+- **正反反相**：demo 正面是暗色功能卡（graphite 暗场），背面是瓷白
+  结论卡——翻面 = 从暗到亮，三张翻完画面从一排暗卡变成一排白色数字
+  海报；背面 158px 数字落定时 1.08→1 收拢，结论标签晚 4f 升起，上方
+  「之前 / 用上之后」对照条在落定后收短
+- 空间：卡片立在暗色镜面地板上，每张卡有一份同步翻转的竖直镜像倒影
+  （遮罩渐隐 26%、opacity 0.22），接地影宽度跟投影宽度 |cos θ| 收放
+- 错峰 delay 12f/卡；全部翻完真静止 ≥40f（demo 72f 后 hold 78f），
+  相机全程 1→1.03 极缓推近
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 翻转时长 | 4f 预备 + 16f 翻 + ~10f 弹簧 | <14f 看不到侧棱瞬间；>28f 读作慢慢转；砍掉预备读作被弹开而不是"翻" |
+| 过冲 | 194°→180°（14°），spring damping 15 | 无过冲落定读作生硬停表；damping <12 回弹两次读作果冻 |
+| 受光 | 面压暗 ≤0.55 + 侧棱窄带峰值 @90° | 峰值错开 90° 读作贴图错误；只有扫光没有面压暗读作贴了一道白条 |
+| 错峰 | 12f/卡，≤4 卡 | 同时翻读作整墙翻面，"成果连报"的逐张节奏就没了 |
+| 背面内容 | 大号数字（150–170px 级）+ 一行标签 + 至多一组对照条 | 背面塞完整 UI 读不完——翻面后只有一拍注意力；数字超 160px 时 "−41%" 这类宽字会顶出卡边 |
+| 收尾 | 末卡落定真静止 ≥40f | R1 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 正反两面必须语义成对（界面→它的成果）；翻出无关内容，翻面就
+  只是花哨的换图
+- 真实素材正面用截图时注意 backface 渲染开销，三卡以上分 Sequence
+- 声音候选位：每卡翻停帧一声轻"啪"（sound-design §4.5），三连啪
+  节奏感翻倍
+
+## 参考实现
+demos/transition/card-flip-reveal/
+（CardFlipReveal.tsx）

package/lib/motion/shotcraft/upstream/references/shots/transition/card-flock-tumble.md

@@ -1,63 +1,63 @@
----
-name: card-flock-tumble
-一句话: 三张 UI 页卡从侧棱薄边 3D 翻飞成阶梯站定（全程清晰、样条连续丝滑），站定后保持慢转不停，快速收束吸入中心，炸出单个湍流烟雾环扩散，巨字横贯收场
-适用: 能量高潮段（功能页群→品牌口号的爆点转场）；霓虹/极光暗场调性；"多页面能力"收束成一句话的段落
-时长: 翻飞 ~1.5s + 慢转展示 ~0.3s + 收束 0.3s + 烟环+巨字 ~2s；全段 4.5s
-能量: 极高（全片能量顶点用）
----
-
-## 意图
-三张页卡像被甩出的扑克在 3D 空间翻飞列队，站定亮相后被瞬间
-吸入中心，炸出一圈烟雾环，品牌巨字穿环而出——"能力展示→能量
-坍缩→口号爆发"一气呵成。命门有三：**丝滑**（侧棱→翻飞→站定
-一条 Catmull-Rom 样条导数连续，分段插值的顿挫会被读出来）、
-**不许停**（站定后保持低角速度慢转到收束，静止段被裁"不要停住，
-保持旋转"——高潮段没有静帧）、**全程清晰**（motion blur/景深糊
-全删，被裁"不要加模糊效果"）。
-
-## 动效核心
-- 翻飞：三卡各自 k0（近 90° 侧棱薄边）→k1（翻飞中段）→k2（阶梯
-  站定）Catmull-Rom 样条，Easing.out(cubic) 驱动，~44f
-- 站定慢转：idle 漂移 ry +0.34°/f、rx -0.1°/f、rz +0.05°/f（14f
-  平方缓入避免与样条衔接顿挫），到收束时刻不停
-- 收束：10f Easing.in(quad) 从慢转姿态直接加速吸入中心缩小，
-  透明度前 60% 满格（"吸入"运动要清晰可读）
-- 闪核：吸入到点同一帧（70f）中心一团白热核 + 全屏 12% 微曝，6f
-  指数衰减，环从闪核里长出——补上收束与巨字之间的能量断档；只用
-  径向光，不画几何描边环、不加粒子（两者都在判例里被裁过）
-- 烟雾环：**单个**（多圈被裁），feTurbulence 三组位移（絮边/亮斑/
-  暗斑）+ 顶部奶桃 → 粉 → 紫渐变（aurora 色带），screen 叠加——破碎絮边、
-  明暗斑块、减速外扩缓慢长大、衰减极慢驻留，中心无水面光；粒子零残留
-- 巨字：收束后 4f（74f）就"砸"进来——14f snappy 从 1.22 缩到 1、字距
-  由 +0.06em 收到 −0.025em，之后极缓长大不停；实心白热芯→淡紫竖向
-  渐变填充 + 粉紫双层泛光（落地瞬间更亮再回落），282px 斜体横贯约 80%
-  画宽；环心内上方眉题（demo：video-shotcraft 标志描出 + 小写字标）、
-  下方 44px 标语（品牌短句）错峰升起，尾帧是发布海报
-- 背景：两行 300px 单色淡紫描边字墙反向缓移 + 卡后一团极光主光托起
-  卡片群；收束时字墙随吸入向心收缩淡出。卡片群与收束点、环心、巨字
-  共用一个中心（画面中心下移 30px）
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 三卡间距/大小 | 大幅重叠成一叠阶梯、scale 1.6–1.74 | 两轮加码判例："再靠近一些，再大些"——阶梯要读作一组不是三张 |
-| 站定慢转 | ry ~0.34°/f 连续 | **不许静止**（判例）；>1°/f 读作还没站定 |
-| 收束时长 | 10f ease-in | 22f 版被裁"要快"；透明度早退=吸入不可读（返工判例） |
-| 烟雾环 | 单圈、湍流絮边、衰减极慢 | 多圈被裁；平滑霓虹圈/粒子版被裁——对照原片密帧做湍流质感 |
-| 模糊 | 全程零 blur | 翻飞/收束加 blur 均被裁 |
-| 样条 | 一条 Catmull-Rom 贯穿 | 分段 lerp 有速度台阶，"丝滑流畅"是裁决原话 |
-| 巨字入场 | 收束到点后 4f、14f snappy 1.22→1 + 字距收拢 | 原版等 14f 才出字，中间一段只有小环的黑场，高潮断气；慢放大（0.7→1 / 34f）读作淡入而不是砸 |
-| 闪核 | 径向白热核 + 全屏 12% 微曝，6f 衰减 | 去掉后环像凭空冒出；加描边亮环立刻廉价（判例同烟雾环） |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 烟雾环质感判例：干净图形环（描边圆/同心波）三轮被裁，最终版
-  feTurbulence 湍流絮边对照原片密帧逐格校——"要一样"；残余差距
-  是噪声场静态（整体旋转+长大），无逐帧湍流滚动，极近看流动感弱
-- 烟雾环是能量坍缩的余波，不是庆祝打击点——禁加粒子礼花
-
-## 参考实现
-demos/transition/card-flock-tumble/
-（CardFlockTumble.tsx）
-原片出处：clickup-30.mp4
+---
+name: card-flock-tumble
+一句话: 三张 UI 页卡从侧棱薄边 3D 翻飞成阶梯站定（全程清晰、样条连续丝滑），站定后保持慢转不停，快速收束吸入中心，炸出单个湍流烟雾环扩散，巨字横贯收场
+适用: 能量高潮段（功能页群→品牌口号的爆点转场）；霓虹/极光暗场调性；"多页面能力"收束成一句话的段落
+时长: 翻飞 ~1.5s + 慢转展示 ~0.3s + 收束 0.3s + 烟环+巨字 ~2s；全段 4.5s
+能量: 极高（全片能量顶点用）
+---
+
+## 意图
+三张页卡像被甩出的扑克在 3D 空间翻飞列队，站定亮相后被瞬间
+吸入中心，炸出一圈烟雾环，品牌巨字穿环而出——"能力展示→能量
+坍缩→口号爆发"一气呵成。命门有三：**丝滑**（侧棱→翻飞→站定
+一条 Catmull-Rom 样条导数连续，分段插值的顿挫会被读出来）、
+**不许停**（站定后保持低角速度慢转到收束，静止段被裁"不要停住，
+保持旋转"——高潮段没有静帧）、**全程清晰**（motion blur/景深糊
+全删，被裁"不要加模糊效果"）。
+
+## 动效核心
+- 翻飞：三卡各自 k0（近 90° 侧棱薄边）→k1（翻飞中段）→k2（阶梯
+  站定）Catmull-Rom 样条，Easing.out(cubic) 驱动，~44f
+- 站定慢转：idle 漂移 ry +0.34°/f、rx -0.1°/f、rz +0.05°/f（14f
+  平方缓入避免与样条衔接顿挫），到收束时刻不停
+- 收束：10f Easing.in(quad) 从慢转姿态直接加速吸入中心缩小，
+  透明度前 60% 满格（"吸入"运动要清晰可读）
+- 闪核：吸入到点同一帧（70f）中心一团白热核 + 全屏 12% 微曝，6f
+  指数衰减，环从闪核里长出——补上收束与巨字之间的能量断档；只用
+  径向光，不画几何描边环、不加粒子（两者都在判例里被裁过）
+- 烟雾环：**单个**（多圈被裁），feTurbulence 三组位移（絮边/亮斑/
+  暗斑）+ 顶部奶桃 → 粉 → 紫渐变（aurora 色带），screen 叠加——破碎絮边、
+  明暗斑块、减速外扩缓慢长大、衰减极慢驻留，中心无水面光；粒子零残留
+- 巨字：收束后 4f（74f）就"砸"进来——14f snappy 从 1.22 缩到 1、字距
+  由 +0.06em 收到 −0.025em，之后极缓长大不停；实心白热芯→淡紫竖向
+  渐变填充 + 粉紫双层泛光（落地瞬间更亮再回落），282px 斜体横贯约 80%
+  画宽；环心内上方眉题（demo：video-shotcraft 标志描出 + 小写字标）、
+  下方 44px 标语（品牌短句）错峰升起，尾帧是发布海报
+- 背景：两行 300px 单色淡紫描边字墙反向缓移 + 卡后一团极光主光托起
+  卡片群；收束时字墙随吸入向心收缩淡出。卡片群与收束点、环心、巨字
+  共用一个中心（画面中心下移 30px）
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 三卡间距/大小 | 大幅重叠成一叠阶梯、scale 1.6–1.74 | 两轮加码判例："再靠近一些，再大些"——阶梯要读作一组不是三张 |
+| 站定慢转 | ry ~0.34°/f 连续 | **不许静止**（判例）；>1°/f 读作还没站定 |
+| 收束时长 | 10f ease-in | 22f 版被裁"要快"；透明度早退=吸入不可读（返工判例） |
+| 烟雾环 | 单圈、湍流絮边、衰减极慢 | 多圈被裁；平滑霓虹圈/粒子版被裁——对照原片密帧做湍流质感 |
+| 模糊 | 全程零 blur | 翻飞/收束加 blur 均被裁 |
+| 样条 | 一条 Catmull-Rom 贯穿 | 分段 lerp 有速度台阶，"丝滑流畅"是裁决原话 |
+| 巨字入场 | 收束到点后 4f、14f snappy 1.22→1 + 字距收拢 | 原版等 14f 才出字，中间一段只有小环的黑场，高潮断气；慢放大（0.7→1 / 34f）读作淡入而不是砸 |
+| 闪核 | 径向白热核 + 全屏 12% 微曝，6f 衰减 | 去掉后环像凭空冒出；加描边亮环立刻廉价（判例同烟雾环） |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 烟雾环质感判例：干净图形环（描边圆/同心波）三轮被裁，最终版
+  feTurbulence 湍流絮边对照原片密帧逐格校——"要一样"；残余差距
+  是噪声场静态（整体旋转+长大），无逐帧湍流滚动，极近看流动感弱
+- 烟雾环是能量坍缩的余波，不是庆祝打击点——禁加粒子礼花
+
+## 参考实现
+demos/transition/card-flock-tumble/
+（CardFlockTumble.tsx）
+原片出处：clickup-30.mp4

package/lib/motion/shotcraft/upstream/references/shots/transition/circle-match-iris.md

@@ -1,58 +1,58 @@
----
-name: circle-match-iris
-一句话: 圆心匹配光圈切——光圈从页面上圆形元素的圆心炸开，圈内新页的圆形图表接在同一个圆上；匹配剪辑给光圈一个语义锚点
-适用: 前景有圆形元素（头像/图标/圆钮）、后景有圆形主体（donut 图/圆环进度）的接缝；转场技法卡
-时长: 5.5s / 165f（入场+定睛 40f + 蓄力 7f + 接圆开圈 37f + sweep 58f + 静止 47f）
-能量: 中高
----
-
-## 意图
-普通 iris 光圈（词汇表原条目）从任意点开圈，观众只读到"换页了"。
-本卡把它和 match-cut 焊死：光圈必须从前景一个**真实圆形元素**的圆心
-炸开，圈内长出的新页里有个圆形图表恰好接在同一个圆上——观众看到的
-是"头像的圆变成了图表的圆"，圆形本身完成叙事（这个人→这个人的数据）。
-这是 match-cut 在 UI 语境里的落地形态：不靠构图巧合，靠语义圆对圆。
-与穿越三式同属"后景在前景里预先在场"，但锚点是抽象形状而非容器。
-
-## 动效核心
-- **两景的圆严格同心是命门**：锚点圆心写死为一组常量（demo：CX=540,
-  CY=540，= 榜单行左缘 + 内边距 + 名次列 + 头像半径），头像、涟漪、
-  clip-path circle、新景圆环、刻度盘全部引用同一组常量——坐标各算各的必然错心
-- 定睛引导：其余行压到 ~32% 亮度、锚点所在行抬亮；头像两次放大脉冲 +
-  两道扩散光环（18f / 30f）；相机以锚点为 transform-origin 缓推 3%
-  （锚点在屏幕上不动），40–47f 头像收到 0.9 做预备
-- **接圆 = 实心圆镂空成圆环**：开圈瞬间新景圆环的描边宽 = 直径（看上去
-  就是那颗实心头像），28f 内半径 36→300、描边收到 44px（expo-out），
-  颜色由荧光实心退成暗轨；光圈半径 = 圆环外沿 + 一段 ease-in 加速外扩
-  （54–84f 加 2400px），所以是"圆环把光圈撑开"——接圆必然发生在吃满屏之前
-- 旧页同时以锚点为心放大 1.03→1.22 并压暗（ease-in），光圈外沿一圈落影 +
-  一道只在开圈初段出现的荧光受光环——新景"压"在旧页之上
-- 圆环 sweep：strokeDasharray = sweep×周长，rotate(-90) 从顶部起笔，
-  60–118f 慢起长尾到 87%，中央 200px 数字随 sweep 同步计数，弧头柔光跟笔尖
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 锚点脉冲 | 2 次 scale 1→1.16 + 光环扩两道（18f / 30f 起，各 22f） | 没有定睛引导，开圈瞬间观众找不到圆心 |
-| 接圆 | 实心盘→圆环：r 36→300、描边 72→44px / 28f expo-out | 圆环与光圈各长各的，"头像变成图表"就读不出来 |
-| 光圈扩张 | 圆环外沿 + 0→2400px / 30f bezier(.62,0,.32,1) | 快于 20f 接圆读不到；圆心偏移 >10px 一眼穿帮 |
-| 旧页推远 | scale 1.03→1.22 + 亮度 1→0.45 / 34f ease-in | 旧页不动，新景像贴在上面的圆形贴纸 |
-| sweep | 60–118f 到 87%，bezier(.4,0,.12,1)，数字同步计数 | 数字与 sweep 异步读作两个动画；太快（<40f）数字读不出在爬 |
-| 收尾 | sweep 完成后静止 47f（只留刻度盘 0.06°/f 慢转 + 弧光呼吸） | R1 |
-
-## 已知坑
-- demo 是手搓的 video-shotcraft 出片周榜（暗场荧光绿；景 A 创作者排行 → 景 B 本周出片目标圆环）——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 真实素材上锚点坐标从截图量测（devtools/标尺），量到的是元素盒不是
-  视觉圆心——带内边距的头像取内容圆心；量完渲一帧对不齐就调常量，
-  别信第一次量的数（同 transition-travel A 字腔穿越的腔心判例）
-- 前景锚点必须是**真圆**：圆角方块（border-radius < 50%）当锚点，
-  开圈瞬间方圆错型一眼假；真实截图里锚点是圆角方块时，先用同色补丁盖住再叠真圆
-- 语义要成对：头像→个人数据、产品图标→产品指标——圆对圆只是形，
-  "这个圆的内容变成它的展开"才是匹配剪辑成立的因
-- 一缝一式规矩同 shot-transitions；本卡自带图表生长段，圈内新景
-  别再叠入场动效
-
-## 参考实现
-demos/transition/circle-match-iris/
-（CircleMatchIris.tsx）
+---
+name: circle-match-iris
+一句话: 圆心匹配光圈切——光圈从页面上圆形元素的圆心炸开，圈内新页的圆形图表接在同一个圆上；匹配剪辑给光圈一个语义锚点
+适用: 前景有圆形元素（头像/图标/圆钮）、后景有圆形主体（donut 图/圆环进度）的接缝；转场技法卡
+时长: 5.5s / 165f（入场+定睛 40f + 蓄力 7f + 接圆开圈 37f + sweep 58f + 静止 47f）
+能量: 中高
+---
+
+## 意图
+普通 iris 光圈（词汇表原条目）从任意点开圈，观众只读到"换页了"。
+本卡把它和 match-cut 焊死：光圈必须从前景一个**真实圆形元素**的圆心
+炸开，圈内长出的新页里有个圆形图表恰好接在同一个圆上——观众看到的
+是"头像的圆变成了图表的圆"，圆形本身完成叙事（这个人→这个人的数据）。
+这是 match-cut 在 UI 语境里的落地形态：不靠构图巧合，靠语义圆对圆。
+与穿越三式同属"后景在前景里预先在场"，但锚点是抽象形状而非容器。
+
+## 动效核心
+- **两景的圆严格同心是命门**：锚点圆心写死为一组常量（demo：CX=540,
+  CY=540，= 榜单行左缘 + 内边距 + 名次列 + 头像半径），头像、涟漪、
+  clip-path circle、新景圆环、刻度盘全部引用同一组常量——坐标各算各的必然错心
+- 定睛引导：其余行压到 ~32% 亮度、锚点所在行抬亮；头像两次放大脉冲 +
+  两道扩散光环（18f / 30f）；相机以锚点为 transform-origin 缓推 3%
+  （锚点在屏幕上不动），40–47f 头像收到 0.9 做预备
+- **接圆 = 实心圆镂空成圆环**：开圈瞬间新景圆环的描边宽 = 直径（看上去
+  就是那颗实心头像），28f 内半径 36→300、描边收到 44px（expo-out），
+  颜色由荧光实心退成暗轨；光圈半径 = 圆环外沿 + 一段 ease-in 加速外扩
+  （54–84f 加 2400px），所以是"圆环把光圈撑开"——接圆必然发生在吃满屏之前
+- 旧页同时以锚点为心放大 1.03→1.22 并压暗（ease-in），光圈外沿一圈落影 +
+  一道只在开圈初段出现的荧光受光环——新景"压"在旧页之上
+- 圆环 sweep：strokeDasharray = sweep×周长，rotate(-90) 从顶部起笔，
+  60–118f 慢起长尾到 87%，中央 200px 数字随 sweep 同步计数，弧头柔光跟笔尖
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 锚点脉冲 | 2 次 scale 1→1.16 + 光环扩两道（18f / 30f 起，各 22f） | 没有定睛引导，开圈瞬间观众找不到圆心 |
+| 接圆 | 实心盘→圆环：r 36→300、描边 72→44px / 28f expo-out | 圆环与光圈各长各的，"头像变成图表"就读不出来 |
+| 光圈扩张 | 圆环外沿 + 0→2400px / 30f bezier(.62,0,.32,1) | 快于 20f 接圆读不到；圆心偏移 >10px 一眼穿帮 |
+| 旧页推远 | scale 1.03→1.22 + 亮度 1→0.45 / 34f ease-in | 旧页不动，新景像贴在上面的圆形贴纸 |
+| sweep | 60–118f 到 87%，bezier(.4,0,.12,1)，数字同步计数 | 数字与 sweep 异步读作两个动画；太快（<40f）数字读不出在爬 |
+| 收尾 | sweep 完成后静止 47f（只留刻度盘 0.06°/f 慢转 + 弧光呼吸） | R1 |
+
+## 已知坑
+- demo 是手搓的 video-shotcraft 出片周榜（暗场荧光绿；景 A 创作者排行 → 景 B 本周出片目标圆环）——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 真实素材上锚点坐标从截图量测（devtools/标尺），量到的是元素盒不是
+  视觉圆心——带内边距的头像取内容圆心；量完渲一帧对不齐就调常量，
+  别信第一次量的数（同 transition-travel A 字腔穿越的腔心判例）
+- 前景锚点必须是**真圆**：圆角方块（border-radius < 50%）当锚点，
+  开圈瞬间方圆错型一眼假；真实截图里锚点是圆角方块时，先用同色补丁盖住再叠真圆
+- 语义要成对：头像→个人数据、产品图标→产品指标——圆对圆只是形，
+  "这个圆的内容变成它的展开"才是匹配剪辑成立的因
+- 一缝一式规矩同 shot-transitions；本卡自带图表生长段，圈内新景
+  别再叠入场动效
+
+## 参考实现
+demos/transition/circle-match-iris/
+（CircleMatchIris.tsx）