dsh-drawai 0.4.2 → 0.4.3

package/lib/motion/shotcraft/upstream/references/shots/opening/icon-field-colorize.md

@@ -1,60 +1,60 @@
----
-name: icon-field-colorize
-一句话: 灰阶小图标点阵错峰浮现铺满全屏，停一拍后多道品牌色横带波纹极快向下扫翻全场——"功能全景先摆满，品牌一瞬间点亮"的开场/收束卡
-适用: 开场铺陈产品能力面（图标=功能宇宙）再一举打上品牌色；功能集合页、生态/集成规模展示、片头 logo 前垫场
-时长: 浮现 ~45f 错峰 + 静置 ~10f + 翻色 12–45f + 终态静置；全段 3–6s（demo 170f：翻色走 30f 档 + 标题落版 + 终态 hold 1s）
-能量: 中（浮现是铺垫，翻色瞬间是唯一爆点）
-标签: ui-entrance、outro
----
-
-## 意图
-先用灰阶把"多"摆足——上百个小图标错峰浮进来铺满画面，灰阶保证
-读作背景纹理不抢戏；停一拍让观众意识到"摆满了"，然后品牌色以
-横带波纹形式极快扫过全场，灰世界一瞬间被点亮。命门在**翻色不是
-同帧硬翻**：原片实测是 ~0.5s 内多道色波依次向下快扫（蓝先覆盖全场，
-橙/绿/红依次覆盖更低行带），终态呈四色横带分层——波纹感让"点亮"
-有方向和速度，硬翻只读作换了张图。
-
-## 动效核心
-- 图标场：150–200 个小图标网格排布（行间半格错位），灰阶 3–4 档
-  随机；mulberry32 定分组/灰度/形状；demo 把图标装进键帽式圆角方块——暗场里
-  灰阶 = "还没通电"的深色键帽（暖黑底、发丝边、顶沿受光、暗灰字形），
-  翻色 = 通电：整块变成发光色块 + 深色字形 + 同色泛光
-- 浮现批次按离画面中心距离（75%）+ 噪声分组，读作从中心向外铺开
-- 浮现：分 10 批错峰淡入（批间 4.4f + 批内 ≤3f 抖动），每个带
-  0.6→1.06→1 微弹（overshoot 一次过冲回落）+ 上浮 10px
-- 静置一拍（~18f）：让"铺满"被读到；最后 10f 整场压暗 12% 作蓄力（吸气），第一道波到达时回满
-- 翻色：多道色波按行推进，行差 ~1.4f + 列微倾 0.25f + 每图标 ≤1.5f
-  抖动（斜切波前沿，不是整行同帧）；每道波从自己的起始行向下覆盖，
-  后波覆盖更低行带 → 终态多色横带
-- 单枚翻色 4f：新色**自上而下 clip 灌满**键帽（与波方向一致，不做透明度混合）+ 1.22x 正弦 pop，
-  灌满后一记 5f 的 screen 白闪 + 泛光过冲，给波前沿"通电"的质感
-- 光溢出：每行亮起后身后舞台染上同色横向光带（强度 = 该行已亮比例），整片原野真的亮起来
-- 落版：光稳定后中心起一层径向暗幕（只压中心，四周光保留），video-shotcraft 字标（眉题位）+ 两行 132px 标题「Every shot, / one place.」逐词升起；第二行别超过暗幕宽度，否则字边压在亮键帽上
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 图标数 | 170（17×10 @1080p，格距 108×106，键帽 66px） | <100 读不出"原野"；>250 单个太小翻色 pop 看不见 |
-| 浮现总长 | ~48f（10 批 × 4.4f + 尾批淡入 7f） | 太快读作闪现；>60f 观众等不及爆点 |
-| 翻色总长 | 原片 ~12f 全场完成；demo ~30f | 越快越爆；教学/慢节奏场合才拉长 |
-| 波数与色 | 4 道，同色系日出渐变（金 → 琥珀 → 橙 → 珊瑚红） | 1 道=单色点亮也成立；四色跨色相（蓝/橙/绿/红）读作彩虹，同色系分段更像品牌 |
-| 行差 | 1.4f/行 + 列 0.25f 微倾 | 行差 >3f 波读作逐行扫描仪；0 = 硬翻 |
-| 翻色 pop | 1.22x 正弦 4f + clip 灌满 | 无 pop 波前沿读不出来；>1.4x 图标互相打架 |
-
-## 已知坑
-- demo 在手绘简笔图标上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 翻色别用透明度交叉淡入：暖色半透明叠在暗底上会过一段橄榄/灰泥色（判例），用 clip 擦入；
-  白闪也要等新色盖满后再起，否则半透明叠层上的白闪发灰
-- **翻色不许同帧硬翻**——原片密帧核实为多道波纹快扫（bear-app
-  25fps 密帧：蓝→橙/绿/红约 0.5s 内完成），硬翻读作换图无"点亮"感
-- 图标需可辨认的实心简笔形（心/星/闪电/对勾…）；抽象色块读不出
-  "功能宇宙"语义
-- 与 theme-switch-moves 分工：那张是 UI 界面明暗主题切换；本卡
-  是装饰性图标场的品牌色点亮，不承载界面语义
-
-## 参考实现
-demos/opening/icon-field-colorize/
-（IconFieldColorize.tsx）
-原片出处：bear-app.mp4 ≈0.0–3.0s
+---
+name: icon-field-colorize
+一句话: 灰阶小图标点阵错峰浮现铺满全屏，停一拍后多道品牌色横带波纹极快向下扫翻全场——"功能全景先摆满，品牌一瞬间点亮"的开场/收束卡
+适用: 开场铺陈产品能力面（图标=功能宇宙）再一举打上品牌色；功能集合页、生态/集成规模展示、片头 logo 前垫场
+时长: 浮现 ~45f 错峰 + 静置 ~10f + 翻色 12–45f + 终态静置；全段 3–6s（demo 170f：翻色走 30f 档 + 标题落版 + 终态 hold 1s）
+能量: 中（浮现是铺垫，翻色瞬间是唯一爆点）
+标签: ui-entrance、outro
+---
+
+## 意图
+先用灰阶把"多"摆足——上百个小图标错峰浮进来铺满画面，灰阶保证
+读作背景纹理不抢戏；停一拍让观众意识到"摆满了"，然后品牌色以
+横带波纹形式极快扫过全场，灰世界一瞬间被点亮。命门在**翻色不是
+同帧硬翻**：原片实测是 ~0.5s 内多道色波依次向下快扫（蓝先覆盖全场，
+橙/绿/红依次覆盖更低行带），终态呈四色横带分层——波纹感让"点亮"
+有方向和速度，硬翻只读作换了张图。
+
+## 动效核心
+- 图标场：150–200 个小图标网格排布（行间半格错位），灰阶 3–4 档
+  随机；mulberry32 定分组/灰度/形状；demo 把图标装进键帽式圆角方块——暗场里
+  灰阶 = "还没通电"的深色键帽（暖黑底、发丝边、顶沿受光、暗灰字形），
+  翻色 = 通电：整块变成发光色块 + 深色字形 + 同色泛光
+- 浮现批次按离画面中心距离（75%）+ 噪声分组，读作从中心向外铺开
+- 浮现：分 10 批错峰淡入（批间 4.4f + 批内 ≤3f 抖动），每个带
+  0.6→1.06→1 微弹（overshoot 一次过冲回落）+ 上浮 10px
+- 静置一拍（~18f）：让"铺满"被读到；最后 10f 整场压暗 12% 作蓄力（吸气），第一道波到达时回满
+- 翻色：多道色波按行推进，行差 ~1.4f + 列微倾 0.25f + 每图标 ≤1.5f
+  抖动（斜切波前沿，不是整行同帧）；每道波从自己的起始行向下覆盖，
+  后波覆盖更低行带 → 终态多色横带
+- 单枚翻色 4f：新色**自上而下 clip 灌满**键帽（与波方向一致，不做透明度混合）+ 1.22x 正弦 pop，
+  灌满后一记 5f 的 screen 白闪 + 泛光过冲，给波前沿"通电"的质感
+- 光溢出：每行亮起后身后舞台染上同色横向光带（强度 = 该行已亮比例），整片原野真的亮起来
+- 落版：光稳定后中心起一层径向暗幕（只压中心，四周光保留），video-shotcraft 字标（眉题位）+ 两行 132px 标题「Every shot, / one place.」逐词升起；第二行别超过暗幕宽度，否则字边压在亮键帽上
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 图标数 | 170（17×10 @1080p，格距 108×106，键帽 66px） | <100 读不出"原野"；>250 单个太小翻色 pop 看不见 |
+| 浮现总长 | ~48f（10 批 × 4.4f + 尾批淡入 7f） | 太快读作闪现；>60f 观众等不及爆点 |
+| 翻色总长 | 原片 ~12f 全场完成；demo ~30f | 越快越爆；教学/慢节奏场合才拉长 |
+| 波数与色 | 4 道，同色系日出渐变（金 → 琥珀 → 橙 → 珊瑚红） | 1 道=单色点亮也成立；四色跨色相（蓝/橙/绿/红）读作彩虹，同色系分段更像品牌 |
+| 行差 | 1.4f/行 + 列 0.25f 微倾 | 行差 >3f 波读作逐行扫描仪；0 = 硬翻 |
+| 翻色 pop | 1.22x 正弦 4f + clip 灌满 | 无 pop 波前沿读不出来；>1.4x 图标互相打架 |
+
+## 已知坑
+- demo 在手绘简笔图标上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 翻色别用透明度交叉淡入：暖色半透明叠在暗底上会过一段橄榄/灰泥色（判例），用 clip 擦入；
+  白闪也要等新色盖满后再起，否则半透明叠层上的白闪发灰
+- **翻色不许同帧硬翻**——原片密帧核实为多道波纹快扫（bear-app
+  25fps 密帧：蓝→橙/绿/红约 0.5s 内完成），硬翻读作换图无"点亮"感
+- 图标需可辨认的实心简笔形（心/星/闪电/对勾…）；抽象色块读不出
+  "功能宇宙"语义
+- 与 theme-switch-moves 分工：那张是 UI 界面明暗主题切换；本卡
+  是装饰性图标场的品牌色点亮，不承载界面语义
+
+## 参考实现
+demos/opening/icon-field-colorize/
+（IconFieldColorize.tsx）
+原片出处：bear-app.mp4 ≈0.0–3.0s

package/lib/motion/shotcraft/upstream/references/shots/opening/letterspace-materialize.md

@@ -1,57 +1,57 @@
----
-name: letterspace-materialize
-一句话: 大字距字标全字符并行连续描画结晶——所有字母同帧起笔、笔画像手写一样连续生长、同帧齐收成词；氛围底景上的品牌字标显影
-适用: 片尾/片头品牌字标登场（大字距细骨架字标；demo 为 video-shotcraft 全小写）；章节题字；needs 静谧/高级感的收束帧
-时长: 静置 ~15f + 描画 ~50f + 终态静置 ≥30f；全段 3–4s
-能量: 低（静谧仪式感，一次呼吸完成）
-标签: typography、outro
----
-
-## 意图
-字标不是淡入也不是打字机，而是"结晶"：全部字母的笔画同时
-开始连续生长，像一只看不见的手同时写所有字母，同一瞬间齐收
-成词。两个命门：**连续**（笔画必须是连续画出的过程，不许遮罩
-分段——先半截再另半截会被读穿；任何中间帧都该像"写到一半"）；
-**同步**（所有字母同帧起笔、同帧完成——逐字错峰是打字机语义，
-这里是整词一体的仪式感）。
-
-## 动效核心
-- 每个字符用骨架笔画 SVG path（单线条字形），pathLength 归一 +
-  strokeDashoffset 从 1→0 连续描画
-- 全字符共享同一进度 p：同帧起笔、pathLength 归一保证不同笔画
-  长度的字母同帧齐收（不做 per-char delay/jitter）
-- 字形比例：方正略宽（字面宽高比 ≈1.07，实测判例：竖长字形被
-  裁"太竖长"）；细笔画+大字距（letterSpacing ≈0.6em）。demo 字标是
-  video-shotcraft（品牌规范要求全小写）：几何小写单线体，字碗为正圆，
-  64 高视框里基线 59 / x 高 22 / 升部 5，整体 ×1.3 放大、笔画反向缩放保持 5.5px
-- 描画曲线：整体 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（现成字体轮廓是双线勾边，描画观感不同）；
-  demo 的 13 个小写字形（v i d e o - s h t c r a f）每个带自己的宽度 w，
-  实战优先复用 demo 里的字形库；多子笔画字母（i 的点、t/f 的横）按
-  描画顺序排在路径末尾，pathLength 归一后仍同帧齐收
-- 原片（superhuman-promo）底景是实拍暮色山景+水面倒影；demo 为
-  渐变近似，实战建议用实拍/AI 生成空镜
-
-## 参考实现
-demos/opening/letterspace-materialize/
-（LetterspaceMaterialize.tsx）
-原片出处：superhuman-promo.mp4 ≈4.5–6.5s
+---
+name: letterspace-materialize
+一句话: 大字距字标全字符并行连续描画结晶——所有字母同帧起笔、笔画像手写一样连续生长、同帧齐收成词；氛围底景上的品牌字标显影
+适用: 片尾/片头品牌字标登场（大字距细骨架字标；demo 为 video-shotcraft 全小写）；章节题字；needs 静谧/高级感的收束帧
+时长: 静置 ~15f + 描画 ~50f + 终态静置 ≥30f；全段 3–4s
+能量: 低（静谧仪式感，一次呼吸完成）
+标签: typography、outro
+---
+
+## 意图
+字标不是淡入也不是打字机，而是"结晶"：全部字母的笔画同时
+开始连续生长，像一只看不见的手同时写所有字母，同一瞬间齐收
+成词。两个命门：**连续**（笔画必须是连续画出的过程，不许遮罩
+分段——先半截再另半截会被读穿；任何中间帧都该像"写到一半"）；
+**同步**（所有字母同帧起笔、同帧完成——逐字错峰是打字机语义，
+这里是整词一体的仪式感）。
+
+## 动效核心
+- 每个字符用骨架笔画 SVG path（单线条字形），pathLength 归一 +
+  strokeDashoffset 从 1→0 连续描画
+- 全字符共享同一进度 p：同帧起笔、pathLength 归一保证不同笔画
+  长度的字母同帧齐收（不做 per-char delay/jitter）
+- 字形比例：方正略宽（字面宽高比 ≈1.07，实测判例：竖长字形被
+  裁"太竖长"）；细笔画+大字距（letterSpacing ≈0.6em）。demo 字标是
+  video-shotcraft（品牌规范要求全小写）：几何小写单线体，字碗为正圆，
+  64 高视框里基线 59 / x 高 22 / 升部 5，整体 ×1.3 放大、笔画反向缩放保持 5.5px
+- 描画曲线：整体 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（现成字体轮廓是双线勾边，描画观感不同）；
+  demo 的 13 个小写字形（v i d e o - s h t c r a f）每个带自己的宽度 w，
+  实战优先复用 demo 里的字形库；多子笔画字母（i 的点、t/f 的横）按
+  描画顺序排在路径末尾，pathLength 归一后仍同帧齐收
+- 原片（superhuman-promo）底景是实拍暮色山景+水面倒影；demo 为
+  渐变近似，实战建议用实拍/AI 生成空镜
+
+## 参考实现
+demos/opening/letterspace-materialize/
+（LetterspaceMaterialize.tsx）
+原片出处：superhuman-promo.mp4 ≈4.5–6.5s

package/lib/motion/shotcraft/upstream/references/shots/opening/magician-card-flourish.md

@@ -1,73 +1,73 @@
----
-name: magician-card-flourish
-一句话: 午夜蓝暗场上蓝色星芒闪现 0.3s（X 形针状光束旋转 90°+中心辉光放射小光芒），卡片从闪光点弹射而出——极速自旋弧线飞向镜头、自旋随靠近衰减、瞬间硬定格（卡高 86% 画高）、光脉冲 + sheen 扫光，右侧文案随后逐行揭示
-适用: 单张卡片/海报/封面的魔术性登场（片头主视觉、产品卡揭晓）；纯黑暗场；需要"变出来"仪式感的爆点
-时长: 156f（闪光 0.3s + 飞行 1.6s + 定格/扫光/文案揭示 + hold 3.3s；全段 5.2s）
-能量: 高（一次性爆点，定格后即静）
-标签: ui-entrance、effects
----
-
-## 意图
-魔术师甩牌：一道蓝色星芒闪过，卡片仿佛从光里被变出来——从画面
-中心极远处（视觉上一个小点）弹射而出，沿弧线极速自旋飞向镜头，
-到达中心瞬间硬定格成近满幅展示。三个魔术感命门：**闪光先行**
-（光是"变"的仪式，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）完
-- 弹射飞行：闪光点 = 落点（画面左 1/3，cx=700）极远（scale≈0.11）出发，
-  真透视 scale=F/(F+z)（z 14000→0）；行程曲线 slow-in（前 14% 时间走 6%）
-  →斜率跳变弹射→easeOut(cubic) 减速；正弦单拱弧线向右上荡出（经过日后
-  文案的位置）再收回落点；飞行中卡带一圈蓝色辉光，被运动模糊拖成光尾
-- 自旋：沿卡片对角线轴 13 整圈；前 40% 行程近匀速极快，后 60%
-  角速度 2.4 次幂衰减（越近镜头转越慢），整圈数保证定格正面
-- 定格：f=57（TAKEOFF+48）全量冻结，卡高 ≈86% 画面高；落定瞬间一圈与卡同形的
-  蓝色光脉冲从卡边外扩淡出（22f），卡后背光与舞台主光同时亮起（闪光期舞台压暗，
-  让星芒是唯一光源）
-- 扫光：定格稳 8f 后 sheen 斜带左→右一次扫过（screen 叠加，裁进圆角）
-- 卡面：深海军蓝 video-shotcraft「Launch Film」首映票——品牌行（标志 + 小写字标）、中心
-  video-shotcraft 标志托在同心细环 + 交叉针线上（开场星芒"留在卡上"；环与针线从标志外缘
-  起，不从取景框开口里穿过）、58px 大字标题（定格后 ≈100px）、mono 票根行；徽记区一层
-  全息箔垫在标志下面，色相随自旋角滚动（飞行中流光、定格即冻结）；卡背中心也是标志
-- 右侧文案（定格后）：眉题 NOW SHOWING 字距收拢 63f → 132px 标题「Craft / the shot.」两行升起 67/74f →
-  36px 副文「Cinematic product videos, crafted by your agent.」逐词 86f
-- 卡片按定格尺寸（×1.72）布局、CSS zoom 栅格化，飞行只做缩小——定格帧文字锐利（Q2）
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 闪光时长 | 9f（0.3s，用户精确定值；曾 1.5s→0.8s→0.5s 逐轮压短） | 光是仪式不是主角；>15f 抢卡片的戏 |
-| 星芒旋转 | 闪光期间动态转 90°（判例：静态摆角被裁"没看到旋转"） | 旋转要逐帧可见；>120° 读作螺旋桨 |
-| 光束颜色 | 纯饱和蓝贯穿全长 | 白段过长/衰减过快被裁"不够还原"；青蓝偏灰被裁"要蓝色的" |
-| 中心 | 小亮点+辉光+放射短刺 | **白色圆球被裁**——中心是光学辉光不是实体球 |
-| 弹射曲线 | slow-in 14%→burst→减速弧线 | 直接匀速/纯 easeOut 没有"弹射"的蓄力感 |
-| 自旋衰减 | 后 60% 行程 2.4 次幂减速 | 匀速到底被裁"靠近镜头时应随距离衰减"；整圈数=定格正面的保证 |
-| 定格尺寸 | 卡高 86% 画面高（右侧留给文案） | 初版 1.0x 被裁"更近更大基本靠近上下界"；单卡居中无文案时可回到 94% |
-| 硬定格 | 全量冻结零回弹 | 魔术感=瞬间静止；回弹读作物理玩具 |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- **光效质感判例链**（本卡贡献的全局方法论）：几何色块被裁"5毛
-  特效"→光学实感重做→游戏感+真实→用户给参考图一轮收敛。
-  质感类意见文字损耗大，**主动请用户丢参考图**
-- 工程坑：细针光束**不能放进 CameraMotionBlur**——旋转被模糊采样
-  拆成条纹分身（"廉价感"的隐性来源）；闪光层独立于运动模糊渲染
-- 工程坑：星芒 SVG viewBox 要 ≥ 光束长+旋转扫掠半径，否则端点
-  被裁出直边
-- 与 card-flip-reveal/deck-deal-flyin 分工：那两张是翻牌/发牌的
-  多卡节奏戏；本卡是单卡"变出来"的魔术仪式，一次只变一张
-
-## 参考实现
-demos/opening/magician-card-flourish/
-（MagicianCardFlourish.tsx）
-原片出处：无（用户口述定制，多轮迭代收敛）
+---
+name: magician-card-flourish
+一句话: 午夜蓝暗场上蓝色星芒闪现 0.3s（X 形针状光束旋转 90°+中心辉光放射小光芒），卡片从闪光点弹射而出——极速自旋弧线飞向镜头、自旋随靠近衰减、瞬间硬定格（卡高 86% 画高）、光脉冲 + sheen 扫光，右侧文案随后逐行揭示
+适用: 单张卡片/海报/封面的魔术性登场（片头主视觉、产品卡揭晓）；纯黑暗场；需要"变出来"仪式感的爆点
+时长: 156f（闪光 0.3s + 飞行 1.6s + 定格/扫光/文案揭示 + hold 3.3s；全段 5.2s）
+能量: 高（一次性爆点，定格后即静）
+标签: ui-entrance、effects
+---
+
+## 意图
+魔术师甩牌：一道蓝色星芒闪过，卡片仿佛从光里被变出来——从画面
+中心极远处（视觉上一个小点）弹射而出，沿弧线极速自旋飞向镜头，
+到达中心瞬间硬定格成近满幅展示。三个魔术感命门：**闪光先行**
+（光是"变"的仪式，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）完
+- 弹射飞行：闪光点 = 落点（画面左 1/3，cx=700）极远（scale≈0.11）出发，
+  真透视 scale=F/(F+z)（z 14000→0）；行程曲线 slow-in（前 14% 时间走 6%）
+  →斜率跳变弹射→easeOut(cubic) 减速；正弦单拱弧线向右上荡出（经过日后
+  文案的位置）再收回落点；飞行中卡带一圈蓝色辉光，被运动模糊拖成光尾
+- 自旋：沿卡片对角线轴 13 整圈；前 40% 行程近匀速极快，后 60%
+  角速度 2.4 次幂衰减（越近镜头转越慢），整圈数保证定格正面
+- 定格：f=57（TAKEOFF+48）全量冻结，卡高 ≈86% 画面高；落定瞬间一圈与卡同形的
+  蓝色光脉冲从卡边外扩淡出（22f），卡后背光与舞台主光同时亮起（闪光期舞台压暗，
+  让星芒是唯一光源）
+- 扫光：定格稳 8f 后 sheen 斜带左→右一次扫过（screen 叠加，裁进圆角）
+- 卡面：深海军蓝 video-shotcraft「Launch Film」首映票——品牌行（标志 + 小写字标）、中心
+  video-shotcraft 标志托在同心细环 + 交叉针线上（开场星芒"留在卡上"；环与针线从标志外缘
+  起，不从取景框开口里穿过）、58px 大字标题（定格后 ≈100px）、mono 票根行；徽记区一层
+  全息箔垫在标志下面，色相随自旋角滚动（飞行中流光、定格即冻结）；卡背中心也是标志
+- 右侧文案（定格后）：眉题 NOW SHOWING 字距收拢 63f → 132px 标题「Craft / the shot.」两行升起 67/74f →
+  36px 副文「Cinematic product videos, crafted by your agent.」逐词 86f
+- 卡片按定格尺寸（×1.72）布局、CSS zoom 栅格化，飞行只做缩小——定格帧文字锐利（Q2）
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 闪光时长 | 9f（0.3s，用户精确定值；曾 1.5s→0.8s→0.5s 逐轮压短） | 光是仪式不是主角；>15f 抢卡片的戏 |
+| 星芒旋转 | 闪光期间动态转 90°（判例：静态摆角被裁"没看到旋转"） | 旋转要逐帧可见；>120° 读作螺旋桨 |
+| 光束颜色 | 纯饱和蓝贯穿全长 | 白段过长/衰减过快被裁"不够还原"；青蓝偏灰被裁"要蓝色的" |
+| 中心 | 小亮点+辉光+放射短刺 | **白色圆球被裁**——中心是光学辉光不是实体球 |
+| 弹射曲线 | slow-in 14%→burst→减速弧线 | 直接匀速/纯 easeOut 没有"弹射"的蓄力感 |
+| 自旋衰减 | 后 60% 行程 2.4 次幂减速 | 匀速到底被裁"靠近镜头时应随距离衰减"；整圈数=定格正面的保证 |
+| 定格尺寸 | 卡高 86% 画面高（右侧留给文案） | 初版 1.0x 被裁"更近更大基本靠近上下界"；单卡居中无文案时可回到 94% |
+| 硬定格 | 全量冻结零回弹 | 魔术感=瞬间静止；回弹读作物理玩具 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- **光效质感判例链**（本卡贡献的全局方法论）：几何色块被裁"5毛
+  特效"→光学实感重做→游戏感+真实→用户给参考图一轮收敛。
+  质感类意见文字损耗大，**主动请用户丢参考图**
+- 工程坑：细针光束**不能放进 CameraMotionBlur**——旋转被模糊采样
+  拆成条纹分身（"廉价感"的隐性来源）；闪光层独立于运动模糊渲染
+- 工程坑：星芒 SVG viewBox 要 ≥ 光束长+旋转扫掠半径，否则端点
+  被裁出直边
+- 与 card-flip-reveal/deck-deal-flyin 分工：那两张是翻牌/发牌的
+  多卡节奏戏；本卡是单卡"变出来"的魔术仪式，一次只变一张
+
+## 参考实现
+demos/opening/magician-card-flourish/
+（MagicianCardFlourish.tsx）
+原片出处：无（用户口述定制，多轮迭代收敛）

package/lib/motion/shotcraft/upstream/references/shots/opening/orbit-ring-title-open.md

@@ -1,87 +1,87 @@
----
-name: orbit-ring-title-open
-一句话: 石墨暗场上八张 16:9 暗色内容卡按 45° 均布在 720×380 椭圆上匀速公转（卡身永不倾斜，纵深只由 sin θ 给出 ±12% 缩放、z 序与远处压暗失焦），环撑开期间卡内容冻结首帧、f24 之后八张一起开播；居中两级标题逐字解糊下沉落定，关键词到位那一刻荧光马克块自左横扫铺满、扫过处字反白为墨，mono 副行随后浮出；可选末段整行失焦淡出、环继续转着交棒下一镜
-适用: 开场第一镜 = 「这个产品有一整套东西」；素材库/模板库/功能矩阵/案例集的门面拍；需要用真实运动的产品画面托住一句主张，而不是把截图摆成静态九宫格
-时长: 150f（5s@30fps；马克块 f64 落定后 2.9s 稳态巡回 + 极缓推近；开 HANDOFF_EXIT 时 f118 起退场交棒）
-能量: 中（唯一的持续运动是匀速公转，全片只有马克块横扫一次冲击）
-标签: ui-entrance
----
-
-## 意图
-开场想说"我们有一整套东西"，最常见的做法是把截图排成网格——但网格是静止的，观众
-读到的是"一堆图片"，不是"一套会动的产品"。这张卡把陈列改成**环形巡回**：八张卡沿
-椭圆匀速公转，永远有卡在进画、有卡在出画，画面自带"还有更多"的暗示，而标题稳稳
-钉在正中间不受影响。
-
-关键的取舍是**卡内容要真的在播**。静态截图上环，观众只会认出"轮播图"；卡里跑着真
-动效，同一个环立刻变成"产品在工作"。但八张卡同时开播会八个动效抢戏，谁也读不进去
-——所以入场期把卡内容**冻结在首帧**，等环撑开、标题起手之后再统一开播。观众的注意
-力顺序因此是：先认出这是一圈产品画面 → 读标题 → 才注意到卡里都在动。
-
-## 动效核心
-- **环上定位**：`θ = -π/2 + i·2π/8 + t·0.3`，`x = 960 + cos θ·RX·ringScale`、
-  `y = 540 + sin θ·RY·ringScale`。RY/RX ≈ 0.53 的椭圆读作"俯视的环"；正圆会读作转盘。
-  椭圆轨道本身画成一圈 16% 透明度的强调色发丝线，入场 0–30f 用 pathLength 描出来
-- **卡身永不倾斜**：卡只跟着 θ 换位置，自身 transform 只有缩放，没有任何旋转。
-  纵深完全交给 `depth = sin θ`（+1 = 画面下方，近；−1 = 上方，远）：
-  `scale = 1 + 0.12·depth`、`zIndex = 10 + round(depth·5)`；远处（depth<0）再叠
-  `blur(1.6·|depth|px)` + 压暗层（景深 + 空气透视），近处带一点顶光。缩放、z 序、
-  明暗必须由同一个 depth 驱动，否则会出现"远处的卡压住近处的卡"
-- **环入场**：f0–24 `ringScale 0.62→1`（expo-out，前 1/3 时间走完八成）从中心撑开；
-  同时逐卡淡入，第 i 张从 `2+1.5i` 帧起 11f 淡入并 0.9→1 长大。撑开与淡入叠在一起，
-  读作"环长出来"而不是"卡片一张张贴上来"
-- **冻结首帧再开播**：卡内容包在 `<Freeze frame={max(0, frame - 24)}>` 里。f24 之前
-  八张卡都停在自己的第 0 帧，f24 起同时进入正常时间轴
-- **卡内坐标解耦**：卡内容按 960×540 作画，外层用 `scale((CW·s)/960)` 缩到卡宽 +
-  `transform-origin: top left`。内容组件不需要知道自己被缩小了，落地换成真实截图或
-  库内其他镜头卡组件时不用改一行。描线类卡用 `pathLength={1}` 做 dash，路径长短不影响首帧
-- **两级标题 blur-slide 逐字**：上行 64px 次级灰（f10 起、错峰 1f、单字 27f），下行
-  156px 主角大字（f18 起、错峰 2f、单字 32f——更重更慢）。每字两条通道同起不同终：
-  解糊走满单字时长（`blur (1-p)·fontSize/6`），下沉只占前 1/3（`translateY (1-p)·fontSize·0.22`），
-  缓动 quint-out。位移先停、模糊后停，字才有"落定后继续对上焦"的手感
-- **马克块横扫 + 反白**：`spring(frame-50, damping 20, stiffness 190)` 驱动 `scaleX`
-  （封顶 1.03），`transform-origin: left center`，块比字宽出左右各 0.14em 垫在字底下。
-  字画两层：白字层裁掉块前沿左侧、墨字层（onAccent）裁掉前沿右侧，前沿位置按
-  `(m·(W+0.28em) − 0.14em)/W` 换算到字盒——扫过即反白，读作"被荧光笔划过"
-- **标题 scrim**：卡层之上、字层之下垫一团暗色径向 scrim，近处卡从标题背后经过时被压暗
-- **hold**：f40–150 整个画面 smooth 推近 2.5%，环继续匀速公转
-- **退场（可选，HANDOFF_EXIT）**：f118 起 10f 整行 `opacity 1→0` + `blur 0→6.5px`，
-  之后只有环在转——成片里接 crash-zoom / 穿浅场直切时打开；单镜头演示停在完整海报
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 椭圆半径 | RX=720 / RY=380（卡 400×225） | RY/RX≈0.53 是"俯视环"的甜点；比值 →1 读作正圆转盘，→0.3 卡会在上下缘挤成一条 |
-| 卡数 | 8（方位角间隔 45°） | 8 张在这个半径上任意转角互不遮挡；≥10 张必须同步加大 RX/RY，否则近处卡压边 |
-| 公转速度 | 0.3 rad/s（5s 转约 86°） | **别因为"看起来慢"就调快**：>0.5 rad/s 时卡扫过画面边缘会有频闪感，且喧宾夺主 |
-| 环入场 | f0–24，scale .62→1，expo-out | <15f 像弹窗；>30f 标题起手时环还在长，两件事互相盖 |
-| 逐卡淡入 | 第 i 张 `2+1.5i` 帧起 11f | 步长 1.5f 刚够读出"依次"；>3f 最后一张会晚到标题之后 |
-| 开播帧 | PLAY_START=24f | 必须 ≥ 环撑开结束帧；提前会让八个动效在入场期一起抢戏 |
-| 纵深 | 缩放 ±12%，远处失焦 ≤1.6px + 压暗 | 缩放 >15% 顶部卡会缩成图标，环读作"透视隧道"；失焦 >3px 远处卡读作脏 |
-| 标题 | 上行 64px/500 灰 + 下行 156px/600 白 | 环一直在动，主角行必须够大够重才压得住；两行同字号会失去层级 |
-| 逐字节奏 | 上行错峰 1f/单字 27f；下行错峰 2f/单字 32f | 错峰 1–2f 是"整体解糊"的手感；≥3f 会读成逐字打字机 |
-| 马克块 | f50 起，spring damping 20，荧光黄绿 #c6f432 | damping <14 会回弹出色块边缘；暗场里它是唯一高饱和色块，别给第二处 |
-| 副行 | video-shotcraft 标志 + 小写字标 30px + mono 26px「SHOT RECIPE CARDS」（字距 0.2em），f60 起 16f 浮出 | 大字距 mono 是"产品代号"的读法；跟标题同字体会读作第二行标题；别写卡片数这类会过时的数字 |
-| 退场（可选） | f118–128，blur 0→6.5px | 整行统一失焦；**逐字退场会读作第二次入场** |
-## 已知坑
-- **卡不能跟着 θ 倾斜**。给卡加 `rotate(θ)` 后环立刻从"陈列"变成"过山车"，而且卡内
-  文字会歪，可读性直接归零。卡只换位置，不换角度
-- 卡内容首帧必须自带静态骨架（底色/边框/标签/暗底轨迹）。冻结期显示的就是第 0 帧，
-  如果卡的动效是"从零画出来"，入场那 24f 就是八张空白卡。demo 里每个占位卡都补了
-  暗底 sparkline / 淡稿线 / 常驻提示符，就是为了让首帧不空
-- `zIndex` 必须跟着 depth 走。只做缩放不排 z 序时，DOM 顺序会让后面的卡压住前面的，
-  近大远小的立体感当场作废
-- 马克色块和字的层级是一对：色块 `zIndex:0` + 字 `position:relative; zIndex:1`。漏掉
-  字上的 relative，色块会盖住字（stacking context 里 static 元素排在 positioned 之后）
-- 标题 `white-space: nowrap` 是马克块的前提——块的左右外扩 0.14em 与反白裁切都假设高亮
-  词组在同一行盒里。换行后色块会跨行断裂成两截。改了高亮词的字数要同步改前沿换算里的 W
-- 环是背景层但它一直在动，所以**不要在环上再叠第二个动的东西**（粒子、扫光、渐变
-  呼吸）。已经有一个持续运动在场，第二个会让画面读不出主次
-- 与 `carousel-3d` 的分工：那张卡是真 3D（`rotateY + translateZ` + backface-hidden），
-  卡会转到环背面，适合无缝 loop 的纯陈列；这张卡是 2D 椭圆伪纵深，卡永远正面朝观众，
-  适合"环托底 + 前景标题"的开场。要卡片翻面用前者，要标题压得住用后者
-- demo 的八张卡是原创通用 DOM 占位（暗色产品卡 + 唯一荧光强调色，卡框阴影/明暗随纵深变化），不含任何产品截图；
-  落地时整块替换成你自己的镜头卡组件或真实页面截图即可，环的语法一行都不用改
-
-## 参考实现
-demos/opening/orbit-ring-title-open/
-（OrbitRingTitleOpen.tsx）
+---
+name: orbit-ring-title-open
+一句话: 石墨暗场上八张 16:9 暗色内容卡按 45° 均布在 720×380 椭圆上匀速公转（卡身永不倾斜，纵深只由 sin θ 给出 ±12% 缩放、z 序与远处压暗失焦），环撑开期间卡内容冻结首帧、f24 之后八张一起开播；居中两级标题逐字解糊下沉落定，关键词到位那一刻荧光马克块自左横扫铺满、扫过处字反白为墨，mono 副行随后浮出；可选末段整行失焦淡出、环继续转着交棒下一镜
+适用: 开场第一镜 = 「这个产品有一整套东西」；素材库/模板库/功能矩阵/案例集的门面拍；需要用真实运动的产品画面托住一句主张，而不是把截图摆成静态九宫格
+时长: 150f（5s@30fps；马克块 f64 落定后 2.9s 稳态巡回 + 极缓推近；开 HANDOFF_EXIT 时 f118 起退场交棒）
+能量: 中（唯一的持续运动是匀速公转，全片只有马克块横扫一次冲击）
+标签: ui-entrance
+---
+
+## 意图
+开场想说"我们有一整套东西"，最常见的做法是把截图排成网格——但网格是静止的，观众
+读到的是"一堆图片"，不是"一套会动的产品"。这张卡把陈列改成**环形巡回**：八张卡沿
+椭圆匀速公转，永远有卡在进画、有卡在出画，画面自带"还有更多"的暗示，而标题稳稳
+钉在正中间不受影响。
+
+关键的取舍是**卡内容要真的在播**。静态截图上环，观众只会认出"轮播图"；卡里跑着真
+动效，同一个环立刻变成"产品在工作"。但八张卡同时开播会八个动效抢戏，谁也读不进去
+——所以入场期把卡内容**冻结在首帧**，等环撑开、标题起手之后再统一开播。观众的注意
+力顺序因此是：先认出这是一圈产品画面 → 读标题 → 才注意到卡里都在动。
+
+## 动效核心
+- **环上定位**：`θ = -π/2 + i·2π/8 + t·0.3`，`x = 960 + cos θ·RX·ringScale`、
+  `y = 540 + sin θ·RY·ringScale`。RY/RX ≈ 0.53 的椭圆读作"俯视的环"；正圆会读作转盘。
+  椭圆轨道本身画成一圈 16% 透明度的强调色发丝线，入场 0–30f 用 pathLength 描出来
+- **卡身永不倾斜**：卡只跟着 θ 换位置，自身 transform 只有缩放，没有任何旋转。
+  纵深完全交给 `depth = sin θ`（+1 = 画面下方，近；−1 = 上方，远）：
+  `scale = 1 + 0.12·depth`、`zIndex = 10 + round(depth·5)`；远处（depth<0）再叠
+  `blur(1.6·|depth|px)` + 压暗层（景深 + 空气透视），近处带一点顶光。缩放、z 序、
+  明暗必须由同一个 depth 驱动，否则会出现"远处的卡压住近处的卡"
+- **环入场**：f0–24 `ringScale 0.62→1`（expo-out，前 1/3 时间走完八成）从中心撑开；
+  同时逐卡淡入，第 i 张从 `2+1.5i` 帧起 11f 淡入并 0.9→1 长大。撑开与淡入叠在一起，
+  读作"环长出来"而不是"卡片一张张贴上来"
+- **冻结首帧再开播**：卡内容包在 `<Freeze frame={max(0, frame - 24)}>` 里。f24 之前
+  八张卡都停在自己的第 0 帧，f24 起同时进入正常时间轴
+- **卡内坐标解耦**：卡内容按 960×540 作画，外层用 `scale((CW·s)/960)` 缩到卡宽 +
+  `transform-origin: top left`。内容组件不需要知道自己被缩小了，落地换成真实截图或
+  库内其他镜头卡组件时不用改一行。描线类卡用 `pathLength={1}` 做 dash，路径长短不影响首帧
+- **两级标题 blur-slide 逐字**：上行 64px 次级灰（f10 起、错峰 1f、单字 27f），下行
+  156px 主角大字（f18 起、错峰 2f、单字 32f——更重更慢）。每字两条通道同起不同终：
+  解糊走满单字时长（`blur (1-p)·fontSize/6`），下沉只占前 1/3（`translateY (1-p)·fontSize·0.22`），
+  缓动 quint-out。位移先停、模糊后停，字才有"落定后继续对上焦"的手感
+- **马克块横扫 + 反白**：`spring(frame-50, damping 20, stiffness 190)` 驱动 `scaleX`
+  （封顶 1.03），`transform-origin: left center`，块比字宽出左右各 0.14em 垫在字底下。
+  字画两层：白字层裁掉块前沿左侧、墨字层（onAccent）裁掉前沿右侧，前沿位置按
+  `(m·(W+0.28em) − 0.14em)/W` 换算到字盒——扫过即反白，读作"被荧光笔划过"
+- **标题 scrim**：卡层之上、字层之下垫一团暗色径向 scrim，近处卡从标题背后经过时被压暗
+- **hold**：f40–150 整个画面 smooth 推近 2.5%，环继续匀速公转
+- **退场（可选，HANDOFF_EXIT）**：f118 起 10f 整行 `opacity 1→0` + `blur 0→6.5px`，
+  之后只有环在转——成片里接 crash-zoom / 穿浅场直切时打开；单镜头演示停在完整海报
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 椭圆半径 | RX=720 / RY=380（卡 400×225） | RY/RX≈0.53 是"俯视环"的甜点；比值 →1 读作正圆转盘，→0.3 卡会在上下缘挤成一条 |
+| 卡数 | 8（方位角间隔 45°） | 8 张在这个半径上任意转角互不遮挡；≥10 张必须同步加大 RX/RY，否则近处卡压边 |
+| 公转速度 | 0.3 rad/s（5s 转约 86°） | **别因为"看起来慢"就调快**：>0.5 rad/s 时卡扫过画面边缘会有频闪感，且喧宾夺主 |
+| 环入场 | f0–24，scale .62→1，expo-out | <15f 像弹窗；>30f 标题起手时环还在长，两件事互相盖 |
+| 逐卡淡入 | 第 i 张 `2+1.5i` 帧起 11f | 步长 1.5f 刚够读出"依次"；>3f 最后一张会晚到标题之后 |
+| 开播帧 | PLAY_START=24f | 必须 ≥ 环撑开结束帧；提前会让八个动效在入场期一起抢戏 |
+| 纵深 | 缩放 ±12%，远处失焦 ≤1.6px + 压暗 | 缩放 >15% 顶部卡会缩成图标，环读作"透视隧道"；失焦 >3px 远处卡读作脏 |
+| 标题 | 上行 64px/500 灰 + 下行 156px/600 白 | 环一直在动，主角行必须够大够重才压得住；两行同字号会失去层级 |
+| 逐字节奏 | 上行错峰 1f/单字 27f；下行错峰 2f/单字 32f | 错峰 1–2f 是"整体解糊"的手感；≥3f 会读成逐字打字机 |
+| 马克块 | f50 起，spring damping 20，荧光黄绿 #c6f432 | damping <14 会回弹出色块边缘；暗场里它是唯一高饱和色块，别给第二处 |
+| 副行 | video-shotcraft 标志 + 小写字标 30px + mono 26px「SHOT RECIPE CARDS」（字距 0.2em），f60 起 16f 浮出 | 大字距 mono 是"产品代号"的读法；跟标题同字体会读作第二行标题；别写卡片数这类会过时的数字 |
+| 退场（可选） | f118–128，blur 0→6.5px | 整行统一失焦；**逐字退场会读作第二次入场** |
+## 已知坑
+- **卡不能跟着 θ 倾斜**。给卡加 `rotate(θ)` 后环立刻从"陈列"变成"过山车"，而且卡内
+  文字会歪，可读性直接归零。卡只换位置，不换角度
+- 卡内容首帧必须自带静态骨架（底色/边框/标签/暗底轨迹）。冻结期显示的就是第 0 帧，
+  如果卡的动效是"从零画出来"，入场那 24f 就是八张空白卡。demo 里每个占位卡都补了
+  暗底 sparkline / 淡稿线 / 常驻提示符，就是为了让首帧不空
+- `zIndex` 必须跟着 depth 走。只做缩放不排 z 序时，DOM 顺序会让后面的卡压住前面的，
+  近大远小的立体感当场作废
+- 马克色块和字的层级是一对：色块 `zIndex:0` + 字 `position:relative; zIndex:1`。漏掉
+  字上的 relative，色块会盖住字（stacking context 里 static 元素排在 positioned 之后）
+- 标题 `white-space: nowrap` 是马克块的前提——块的左右外扩 0.14em 与反白裁切都假设高亮
+  词组在同一行盒里。换行后色块会跨行断裂成两截。改了高亮词的字数要同步改前沿换算里的 W
+- 环是背景层但它一直在动，所以**不要在环上再叠第二个动的东西**（粒子、扫光、渐变
+  呼吸）。已经有一个持续运动在场，第二个会让画面读不出主次
+- 与 `carousel-3d` 的分工：那张卡是真 3D（`rotateY + translateZ` + backface-hidden），
+  卡会转到环背面，适合无缝 loop 的纯陈列；这张卡是 2D 椭圆伪纵深，卡永远正面朝观众，
+  适合"环托底 + 前景标题"的开场。要卡片翻面用前者，要标题压得住用后者
+- demo 的八张卡是原创通用 DOM 占位（暗色产品卡 + 唯一荧光强调色，卡框阴影/明暗随纵深变化），不含任何产品截图；
+  落地时整块替换成你自己的镜头卡组件或真实页面截图即可，环的语法一行都不用改
+
+## 参考实现
+demos/opening/orbit-ring-title-open/
+（OrbitRingTitleOpen.tsx）