dsh-drawai 0.4.2 → 0.4.3

package/lib/motion/shotcraft/upstream/references/shots/ui-entrance/list-stack-press.md

@@ -1,43 +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]） | 这是"有重量"的关键一笔，砍掉后堆叠变成简单排版 |
-| 阴影 | 两层 softShadow 随离地高度变化：空中 elevation≈56、落定 3（被压时更贴地）；飞行段按速度加纵向运动模糊 | 阴影随高度收敛，和 deck-deal/spotlight 同一套语言 |
-| 联动高亮 | 落地后滞后 2–4f 在项目名那一行（截图实测卡内 y156–176）长出与项目名等宽的强调色（模板片为琥珀）荧光笔底色，multiply 叠在字下（7f 长 + 5f 淡）；最后一张离切点仅 ~12f，压到 5f 长 + 4f 淡 | 高亮是次级动作（法则 5/8）：在主动作（落地压弹）之后跟进，不与之同帧抢戏；末尾元素的节拍要按剩余帧预算压缩，不能照抄前面的 |
-| glaze 扫光 | 360px 宽、rotate 14°、mixBlendMode soft-light，最后一张落定后帧 74→87 从 −500 扫到 2300，裁进每张卡的圆角内 | 扫光全镜头只此一次、扫整摞不逐卡（Q4） |
-| 计数器（digit-roll 手法） | 连续里程计位置 pos：每张卡落地让 pos 沿数字带 +1 格，单格 8f 滚定，bezier(0.25,0.8,0.25,1)；滚动量=pos·lineH 沿双份 0-9 带连续下滚 | 计数与落地不同步立刻穿帮；**单格滚动必须短于落卡间距（12f）且尾格在镜头收尾前滚定**——以 count 为 key 重挂重滚的写法每次都要从 0 滚 22f，12f 节拍下前一次永远滚不完、尾帧停在 4（PR #40 判例）；数字带双份拼接+overflow hidden+tabular-nums（不开 tabular 会横向抖） |
-| 相机 | zoom 1.35→0.86 一条连续曲线跟随堆叠向下（逐帧喂给 PageCam2D，避免分段关键帧处速度归零） | 正视机位（见已知坑），相机只做纵向跟随 |
-
-## 声音
-每张落地不逐张配长音；计数落定钉 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 倍才通过）——渲染后自查"不逐帧能否看出蓄力"
-
-## 参考实现
-demos/ui-entrance/list-stack-press/ListStackPress.tsx（原 template/src/aifl/live/ScenePapers.tsx）
+---
+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]） | 这是"有重量"的关键一笔，砍掉后堆叠变成简单排版 |
+| 阴影 | 两层 softShadow 随离地高度变化：空中 elevation≈56、落定 3（被压时更贴地）；飞行段按速度加纵向运动模糊 | 阴影随高度收敛，和 deck-deal/spotlight 同一套语言 |
+| 联动高亮 | 落地后滞后 2–4f 在项目名那一行（截图实测卡内 y156–176）长出与项目名等宽的强调色（模板片为琥珀）荧光笔底色，multiply 叠在字下（7f 长 + 5f 淡）；最后一张离切点仅 ~12f，压到 5f 长 + 4f 淡 | 高亮是次级动作（法则 5/8）：在主动作（落地压弹）之后跟进，不与之同帧抢戏；末尾元素的节拍要按剩余帧预算压缩，不能照抄前面的 |
+| glaze 扫光 | 360px 宽、rotate 14°、mixBlendMode soft-light，最后一张落定后帧 74→87 从 −500 扫到 2300，裁进每张卡的圆角内 | 扫光全镜头只此一次、扫整摞不逐卡（Q4） |
+| 计数器（digit-roll 手法） | 连续里程计位置 pos：每张卡落地让 pos 沿数字带 +1 格，单格 8f 滚定，bezier(0.25,0.8,0.25,1)；滚动量=pos·lineH 沿双份 0-9 带连续下滚 | 计数与落地不同步立刻穿帮；**单格滚动必须短于落卡间距（12f）且尾格在镜头收尾前滚定**——以 count 为 key 重挂重滚的写法每次都要从 0 滚 22f，12f 节拍下前一次永远滚不完、尾帧停在 4（PR #40 判例）；数字带双份拼接+overflow hidden+tabular-nums（不开 tabular 会横向抖） |
+| 相机 | zoom 1.35→0.86 一条连续曲线跟随堆叠向下（逐帧喂给 PageCam2D，避免分段关键帧处速度归零） | 正视机位（见已知坑），相机只做纵向跟随 |
+
+## 声音
+每张落地不逐张配长音；计数落定钉 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 倍才通过）——渲染后自查"不逐帧能否看出蓄力"
+
+## 参考实现
+demos/ui-entrance/list-stack-press/ListStackPress.tsx（原 template/src/aifl/live/ScenePapers.tsx）

package/lib/motion/shotcraft/upstream/references/shots/ui-entrance/neon-frame-forerun.md

@@ -1,55 +1,55 @@
----
-name: neon-frame-forerun
-一句话: 强透视直角霓虹框自左缘两头奔画先行成型，页面在框内由暗转亮，同时框内组件/文字从 3D 上空带同形软影错峰贴落、随页面点亮同步完成贴合，背景霓虹群（demo 为同形框纵深回声隧道）终段熄灭让位
-适用: 暗场品牌片里给 UI 面板做"登场仪式"（框先到、内容后落）；功能区首次亮相；霓虹/赛博调性的段落开场
-时长: 框奔画 ~0.7s + 点亮&贴落 ~2.7s + 背景熄灭收束 ~1s；全段 4–4.7s（demo 140f）
-能量: 中高（三层动作叠进，但都服务同一次登场）
-标签: effects
----
-
-## 意图
-先立框后填肉：霓虹线框像跑道灯一样两头奔画圈出位置，宣告
-"这里要出现东西"；页面在框内由暗转亮的同时，组件从空中带影
-贴落——观众看见界面被"安放"进框里。三层动作（框奔画/页面点亮/
-组件贴落）必须**同步咬合**：贴落进程与点亮进程同步推进、稍滞后
-收尾，框光最终并入面板辉光。背景霓虹管群终段熄灭，把亮度让给
-主角完成收束。
-
-## 动效核心
-- 霓虹框：强透视直角框，自左缘中点两颗白热亮头上下分头奔画（20f，swift 起步快、
-  在右缘中点制动相撞并闪一下）；灯管用四层描边叠辉光（宽软晕 / 中晕 / 色芯 / 白热芯），
-  不用模糊滤镜，便宜且锐；成型后芯线退成发丝、框光并入面板 rim 辉光
-- 页面点亮：框合拢后页面才从黑里浮出（16–30f），再由暗转亮（24–84f smooth），
-  同时一层冷紫暗罩自左缘向右退去，读作"霓虹把页面点亮"
-- 组件贴落：**真 3D 悬空**——面板与组件都在 preserve-3d 里，组件 translateZ 120–170px，
-  面板上落同形剪影软影（越高越大越虚越淡、偏向右下）；亮度用叶子节点 brightness，
-  不在 3D 父级上加 filter/opacity（会把 3D 压平）。每件 24f 加速下落 + 软着陆，
-  落点 54→104f 按"侧栏自上而下 → 主区自上而下"错峰（先密后疏），比点亮晚 ~20f 收尾
-- 背景：同一个框在纵深里的 5 层回声（translateZ 递退、逐层放大）组成霓虹隧道，
-  框合拢后由近到远逐层"打火"（荧光管启辉的确定性闪烁）；终段中段先熄、两端后熄（94–118f）
-- 机位：rotateY −30° → −12°（0–96f EASE.out 长减速），hold 段再极缓转 1.5°
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 框奔画 | 20f 两头对奔（swift） | 单头描画读作画图；>30f 观众等不及内容 |
-| 悬浮高度 | translateZ 120–170px、影随高度收敛 | 判例：高度过小+启动过早=影子不可感（v3 第 1 轮返工加大 1.7x 并延后） |
-| 贴落窗口 | 每件 24f；落点 54→104f，比点亮晚 ~20f 收尾 | 贴落先于点亮完＝黑屋子里落家具；滞后太多读作两段戏 |
-| 错峰 | 错开起点、下落重叠并行（EASE.out 分布，先密后疏） | 串行等待被裁（掉落节奏通用判例） |
-| 背景熄灭 | 中亮尾熄，每层 6f 闪烁熄灭、层间隔 7f | 不熄灭主角不突出；同帧全熄读作断电 |
-| 贴落粒度 | 卡/行级（品牌、4 项导航、问候、3 张数字卡、4 行任务） | 粒度越细越贵；元素越少每件越大越好读 |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 悬空贴落=clickup 语言核心签名（已验证的口味信号），本卡
-  与 graze-face-tour 共用 FloatWrap 模式——影子不可感等于没做
-- 与 brand-frame-snap 分工：那张是品牌框咔哒定位的
-  节拍戏；本卡是框先行+内容贴落的登场仪式，框只是序幕
-- 衍生方向备忘：视角旋转变体（镜头左→右弧线旋转+同时贴落）
-  曾被裁"改改再看"（要求所有组件同时贴落），已收敛进 neon-frame-orbit-drop 卡
-
-## 参考实现
-demos/ui-entrance/neon-frame-forerun/
-（NeonFrameForerun.tsx）
-原片出处：clickup-30.mp4
+---
+name: neon-frame-forerun
+一句话: 强透视直角霓虹框自左缘两头奔画先行成型，页面在框内由暗转亮，同时框内组件/文字从 3D 上空带同形软影错峰贴落、随页面点亮同步完成贴合，背景霓虹群（demo 为同形框纵深回声隧道）终段熄灭让位
+适用: 暗场品牌片里给 UI 面板做"登场仪式"（框先到、内容后落）；功能区首次亮相；霓虹/赛博调性的段落开场
+时长: 框奔画 ~0.7s + 点亮&贴落 ~2.7s + 背景熄灭收束 ~1s；全段 4–4.7s（demo 140f）
+能量: 中高（三层动作叠进，但都服务同一次登场）
+标签: effects
+---
+
+## 意图
+先立框后填肉：霓虹线框像跑道灯一样两头奔画圈出位置，宣告
+"这里要出现东西"；页面在框内由暗转亮的同时，组件从空中带影
+贴落——观众看见界面被"安放"进框里。三层动作（框奔画/页面点亮/
+组件贴落）必须**同步咬合**：贴落进程与点亮进程同步推进、稍滞后
+收尾，框光最终并入面板辉光。背景霓虹管群终段熄灭，把亮度让给
+主角完成收束。
+
+## 动效核心
+- 霓虹框：强透视直角框，自左缘中点两颗白热亮头上下分头奔画（20f，swift 起步快、
+  在右缘中点制动相撞并闪一下）；灯管用四层描边叠辉光（宽软晕 / 中晕 / 色芯 / 白热芯），
+  不用模糊滤镜，便宜且锐；成型后芯线退成发丝、框光并入面板 rim 辉光
+- 页面点亮：框合拢后页面才从黑里浮出（16–30f），再由暗转亮（24–84f smooth），
+  同时一层冷紫暗罩自左缘向右退去，读作"霓虹把页面点亮"
+- 组件贴落：**真 3D 悬空**——面板与组件都在 preserve-3d 里，组件 translateZ 120–170px，
+  面板上落同形剪影软影（越高越大越虚越淡、偏向右下）；亮度用叶子节点 brightness，
+  不在 3D 父级上加 filter/opacity（会把 3D 压平）。每件 24f 加速下落 + 软着陆，
+  落点 54→104f 按"侧栏自上而下 → 主区自上而下"错峰（先密后疏），比点亮晚 ~20f 收尾
+- 背景：同一个框在纵深里的 5 层回声（translateZ 递退、逐层放大）组成霓虹隧道，
+  框合拢后由近到远逐层"打火"（荧光管启辉的确定性闪烁）；终段中段先熄、两端后熄（94–118f）
+- 机位：rotateY −30° → −12°（0–96f EASE.out 长减速），hold 段再极缓转 1.5°
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 框奔画 | 20f 两头对奔（swift） | 单头描画读作画图；>30f 观众等不及内容 |
+| 悬浮高度 | translateZ 120–170px、影随高度收敛 | 判例：高度过小+启动过早=影子不可感（v3 第 1 轮返工加大 1.7x 并延后） |
+| 贴落窗口 | 每件 24f；落点 54→104f，比点亮晚 ~20f 收尾 | 贴落先于点亮完＝黑屋子里落家具；滞后太多读作两段戏 |
+| 错峰 | 错开起点、下落重叠并行（EASE.out 分布，先密后疏） | 串行等待被裁（掉落节奏通用判例） |
+| 背景熄灭 | 中亮尾熄，每层 6f 闪烁熄灭、层间隔 7f | 不熄灭主角不突出；同帧全熄读作断电 |
+| 贴落粒度 | 卡/行级（品牌、4 项导航、问候、3 张数字卡、4 行任务） | 粒度越细越贵；元素越少每件越大越好读 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 悬空贴落=clickup 语言核心签名（已验证的口味信号），本卡
+  与 graze-face-tour 共用 FloatWrap 模式——影子不可感等于没做
+- 与 brand-frame-snap 分工：那张是品牌框咔哒定位的
+  节拍戏；本卡是框先行+内容贴落的登场仪式，框只是序幕
+- 衍生方向备忘：视角旋转变体（镜头左→右弧线旋转+同时贴落）
+  曾被裁"改改再看"（要求所有组件同时贴落），已收敛进 neon-frame-orbit-drop 卡
+
+## 参考实现
+demos/ui-entrance/neon-frame-forerun/
+（NeonFrameForerun.tsx）
+原片出处：clickup-30.mp4

package/lib/motion/shotcraft/upstream/references/shots/ui-entrance/neon-frame-orbit-drop.md

@@ -1,51 +1,51 @@
----
-name: neon-frame-orbit-drop
-一句话: 霓虹框先行描框后，镜头绕页面左→右弧线旋转，页面全部组件/文字**同帧**从空中往下贴合（同形软影同步收敛）——整体登场式的框内安放
-适用: 单页 UI 的一次性隆重登场（与巡礼/逐区亮相相对）；暗场霓虹调性段落的主视觉揭幕；neon-frame-forerun 的姊妹镜
-时长: 描框 ~0.5s + 旋转&同时贴落 ~2.5s + 落定 ~1s；全段 ~4.7s（140f，旋转到 128f 收住后留落定）
-能量: 中高（一次性的大动作，落定即静）
-标签: effects、camera
----
-
-## 意图
-neon-frame-forerun 的孪生变体：同样框先行、内容后落，但镜头
-不是固定的——从页面左侧视角连续弧线旋转到右侧视角，旋转进行
-的同时全部组件从空中贴落。命门是**同时贴合**：所有组件和文字
-同帧起落、同帧贴合、软影同步消失——这是"整体登场"的语法
-（判例：错峰版被裁"应该是所有组件和文字同时从空中往下贴合"）。
-错峰贴落属于巡礼镜（graze-face-tour），一页一次性亮相
-必须齐落，节奏语义不能混用。
-
-## 动效核心
-- 霓虹描框：渐变霓虹框 ~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/ui-entrance/neon-frame-orbit-drop/
-（NeonFrameForerunOrbit.tsx）
-原片出处：无对应原段
+---
+name: neon-frame-orbit-drop
+一句话: 霓虹框先行描框后，镜头绕页面左→右弧线旋转，页面全部组件/文字**同帧**从空中往下贴合（同形软影同步收敛）——整体登场式的框内安放
+适用: 单页 UI 的一次性隆重登场（与巡礼/逐区亮相相对）；暗场霓虹调性段落的主视觉揭幕；neon-frame-forerun 的姊妹镜
+时长: 描框 ~0.5s + 旋转&同时贴落 ~2.5s + 落定 ~1s；全段 ~4.7s（140f，旋转到 128f 收住后留落定）
+能量: 中高（一次性的大动作，落定即静）
+标签: effects、camera
+---
+
+## 意图
+neon-frame-forerun 的孪生变体：同样框先行、内容后落，但镜头
+不是固定的——从页面左侧视角连续弧线旋转到右侧视角，旋转进行
+的同时全部组件从空中贴落。命门是**同时贴合**：所有组件和文字
+同帧起落、同帧贴合、软影同步消失——这是"整体登场"的语法
+（判例：错峰版被裁"应该是所有组件和文字同时从空中往下贴合"）。
+错峰贴落属于巡礼镜（graze-face-tour），一页一次性亮相
+必须齐落，节奏语义不能混用。
+
+## 动效核心
+- 霓虹描框：渐变霓虹框 ~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/ui-entrance/neon-frame-orbit-drop/
+（NeonFrameForerunOrbit.tsx）
+原片出处：无对应原段

package/lib/motion/shotcraft/upstream/references/shots/ui-entrance/page-waterfall-wall.md

@@ -1,51 +1,51 @@
----
-name: page-waterfall-wall
-一句话: 页面瀑布墙——真实页面截图切成 3–4 列在 3D 后仰墙面上差速反向无限滚动，视差 + 镜头缓推做"内容多到流不完"的一览
-适用: "多页面/多功能/多模板"体量感段落；montage 中段铺陈或 intro 后的产品广度镜头
-时长: 4–6s（无限循环体，时长由段落需要裁）
-能量: 中（流动陈列型）
----
-
-## 意图
-流动式一览：让观众在几秒内"看到很多页面流过"，读感是体量而非细节。
-与 outro-group-photo-launch 分工：那是**聚拢式**一览（元素飞来围住
-字标定格合影，语义"属于同一产品"），本卡是**流动式**一览（内容持续
-流过不定格，语义"还有很多没给你看完"）。
-与 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 是补透视收缩的底值，低于它四角露底；demo 把放大与缓推放到外层 CSS zoom（布局级缩放），切片文字不被放大发软（Q2） |
-| 遮罩高度 | 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/ui-entrance/page-waterfall-wall/（PageWaterfallWall.tsx / VerticalTicker.tsx）。
+---
+name: page-waterfall-wall
+一句话: 页面瀑布墙——真实页面截图切成 3–4 列在 3D 后仰墙面上差速反向无限滚动，视差 + 镜头缓推做"内容多到流不完"的一览
+适用: "多页面/多功能/多模板"体量感段落；montage 中段铺陈或 intro 后的产品广度镜头
+时长: 4–6s（无限循环体，时长由段落需要裁）
+能量: 中（流动陈列型）
+---
+
+## 意图
+流动式一览：让观众在几秒内"看到很多页面流过"，读感是体量而非细节。
+与 outro-group-photo-launch 分工：那是**聚拢式**一览（元素飞来围住
+字标定格合影，语义"属于同一产品"），本卡是**流动式**一览（内容持续
+流过不定格，语义"还有很多没给你看完"）。
+与 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 是补透视收缩的底值，低于它四角露底；demo 把放大与缓推放到外层 CSS zoom（布局级缩放），切片文字不被放大发软（Q2） |
+| 遮罩高度 | 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/ui-entrance/page-waterfall-wall/（PageWaterfallWall.tsx / VerticalTicker.tsx）。

package/lib/motion/shotcraft/upstream/references/shots/ui-entrance/product-card-progressive-assemble.md

@@ -1,56 +1,56 @@
----
-name: product-card-progressive-assemble
-一句话: 详情卡像被逐字段抓取般自建——一枚"填充光标"领先跳格，图→标题→分类 pill 依次 pop→原价出现后被划线降级、强调色新价 spring 跳出→正文逐行揭示且高亮块由左向右刷过→色卡点亮→按钮填满，整卡全程极慢 scale 前推
-适用: 商品/条目详情页的能力展示；"结构化抽取""自动填充""数据自己长出来"类叙事的主镜头
-时长: 约 5.7s（172f@30fps）
-能量: 中（连续小事件密集排布，无单点爆发；靠前推保持推进感）
----
-
-## 意图
-一张详情卡直接淡入，观众只看到"有一张卡"。逐字段落位则把卡变成一份**正在被填写的
-表单**：每个字段各自到位，观众的注意力被牵着走一遍卡的信息结构——图在哪、标题在哪、
-价格在哪、正文重点在哪。价格划线降级是全片唯一的语义事件（不是"出现"而是"改变"），
-所以它被安排在中段最显眼的位置。
-
-## 动效核心
-（demo：瓷白 look，原生 1920 坐标；1520×840 详情卡占画宽 79%，商品是 video-shotcraft 自己：棚拍图里放标志，标题 Shotcraft、卖点与色卡都是它的）
-- 字段时间表直接用 30fps 帧号：光标到达 图 8 / 标题 20 / pill 30 / 价格 42 / 正文 76 / 色卡 96 / 按钮 114，
-  字段在光标到达后 2f 开始落位；同组内部间隔 3f（pill、正文行、色卡），跨组间隔 10–20f——间隔的疏密就是信息分组
-- 填充光标：钴蓝 2.5px 描边框 + 外圈 6px 淡光 + AUTOFILL 小签，在相邻两个字段框之间用不对称 in-out
-  （`cubic-bezier(.4,0,.2,1)`，6f）同时插值位置与宽高；最后收进按钮（ease-in 8f 淡出）。这是全片唯一的光效
-- 骨架槽位：字段落位前槽位里是浅灰骨架条，落位时骨架随进度淡出——"表单正在被填"不是"元素在出现"
-- 两种落位：`rise`（上移 10–26px + 6px→0 失焦淡入，expo-out 14f）给图/标题/价格/正文；`pop`
-  （物理弹簧 damping 13，scale 0.4→1 一次可见过冲）给 pill 与色卡；小件 pop、大件 rise
-- 价格降级 f62（$449 完整落位后 hold 18f）：6f 内同窗"scale 1→0.46 + 变灰 + 9px 删除线从左划过"，
-  f63 起钴蓝新价 Free（Apache-2.0 开源）弹簧（damping 14）从 1.18 收到 1，OPEN SOURCE chip f69 滑入
-- 马克笔高亮：钴蓝 16% 底块 `scaleX 0→1`（origin 左），f86 / f90 起各 6f——比字段落位还快，读作"笔一划过去"
-- 按钮：墨黑底色 f116 起 12f 由左向右填满，文案 f122 淡入
-- 整卡呼吸：`scale 1→1.035`（不对称 in-out）摊在 0–132f；入场 0–14f scale .96→1 + 上移 30px；末段 40f 静止定格
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 字段时间表 | 光标 8/20/30/42/76/96/114，落位 +2f | 同类字段间隔 3 帧、跨类间隔 10–20 帧；全部改成等间隔会读作机械点名 |
-| 光标跳格 | 6f，swift in-out，框形同步变形 | <4f 读作闪现；>10f 光标拖在字段后面，"领先抓取"变成"事后框选" |
-| 单字段行程 | 14f expo-out | 行程远大于组内间隔 → 同组几个字段同时在动，画面是"涌"而非"点" |
-| rise 位移 | 10–26px（按字号） | 大标题位移大、小字位移小；>40px 会与整卡前推的方向感打架 |
-| pop | 弹簧 damping 13，0.4→1 | pill 与色卡尺寸小，过冲不会撞到邻居，大件用 pop 就会显得廉价 |
-| 价格降级点 | f62（价格落位后 hold 18f） | 必须留出"先看清原价"的时间，紧贴落位会读作从来就是打折价 |
-| 新价 spring | damping 14，1.18→1 | 全片唯一的放大回弹事件；阻尼调小会抖两下，与旁边的划线动作抢注意力 |
-| 高亮刷过 | 6f，`scaleX` 从左 | 5–6f 是马克笔速度；>12f 读作背景色渐变而不是划线 |
-| 整卡前推 | `scale 1→1.035`，0–132f | 摊在 4.4s 上是纯呼吸；>8% 卡会撞到画框 |
-
-## 已知坑
-- 字段框（光标落点）是写死的绝对坐标：改字号或文案后要同步改 `F` 表里的 box，否则光标框不住字段
-- 最后一个字段在 ~f128 落定，之后 ~1.3s 只有极缓前推——给观众通读整卡的时间，别当成 bug 砍掉
-- 三行正文 `white-space: nowrap` 写死不换行（34px，行宽 ≤ 700px）。换更长文案或中文时会溢出卡边，
-  落地必须重新配字号与行长
-- 新价与折扣 chip 是绝对定位（按 112px 粗体数字宽度估的 x），换价格位数要重排，否则 chip 压字
-- 内容是 video-shotcraft 的示例填法（$449 划掉→Free、卖点文案、品牌四色色卡；$449 只是示意原价），字段结构本身才是可复用的部分。
-  换成真实商品数据后字段数量往往变化，时间表要按新的字段分组重排间隔
-- 高亮的起点（f86/90）晚于所在行开始落位（f78/81）8–9f；改行落位时间必须同步改高亮，否则出现"高亮先到、文字后来"
-- `BLUE`（钴蓝）是全卡唯一色相来源（光标 + 新价 + chip + 高亮），换品牌色改 look 的 accent 即可；其余全是中性色
-
-## 参考实现
-demos/ui-entrance/product-card-progressive-assemble/
-（ProductCardProgressiveAssemble.tsx）
+---
+name: product-card-progressive-assemble
+一句话: 详情卡像被逐字段抓取般自建——一枚"填充光标"领先跳格，图→标题→分类 pill 依次 pop→原价出现后被划线降级、强调色新价 spring 跳出→正文逐行揭示且高亮块由左向右刷过→色卡点亮→按钮填满，整卡全程极慢 scale 前推
+适用: 商品/条目详情页的能力展示；"结构化抽取""自动填充""数据自己长出来"类叙事的主镜头
+时长: 约 5.7s（172f@30fps）
+能量: 中（连续小事件密集排布，无单点爆发；靠前推保持推进感）
+---
+
+## 意图
+一张详情卡直接淡入，观众只看到"有一张卡"。逐字段落位则把卡变成一份**正在被填写的
+表单**：每个字段各自到位，观众的注意力被牵着走一遍卡的信息结构——图在哪、标题在哪、
+价格在哪、正文重点在哪。价格划线降级是全片唯一的语义事件（不是"出现"而是"改变"），
+所以它被安排在中段最显眼的位置。
+
+## 动效核心
+（demo：瓷白 look，原生 1920 坐标；1520×840 详情卡占画宽 79%，商品是 video-shotcraft 自己：棚拍图里放标志，标题 Shotcraft、卖点与色卡都是它的）
+- 字段时间表直接用 30fps 帧号：光标到达 图 8 / 标题 20 / pill 30 / 价格 42 / 正文 76 / 色卡 96 / 按钮 114，
+  字段在光标到达后 2f 开始落位；同组内部间隔 3f（pill、正文行、色卡），跨组间隔 10–20f——间隔的疏密就是信息分组
+- 填充光标：钴蓝 2.5px 描边框 + 外圈 6px 淡光 + AUTOFILL 小签，在相邻两个字段框之间用不对称 in-out
+  （`cubic-bezier(.4,0,.2,1)`，6f）同时插值位置与宽高；最后收进按钮（ease-in 8f 淡出）。这是全片唯一的光效
+- 骨架槽位：字段落位前槽位里是浅灰骨架条，落位时骨架随进度淡出——"表单正在被填"不是"元素在出现"
+- 两种落位：`rise`（上移 10–26px + 6px→0 失焦淡入，expo-out 14f）给图/标题/价格/正文；`pop`
+  （物理弹簧 damping 13，scale 0.4→1 一次可见过冲）给 pill 与色卡；小件 pop、大件 rise
+- 价格降级 f62（$449 完整落位后 hold 18f）：6f 内同窗"scale 1→0.46 + 变灰 + 9px 删除线从左划过"，
+  f63 起钴蓝新价 Free（Apache-2.0 开源）弹簧（damping 14）从 1.18 收到 1，OPEN SOURCE chip f69 滑入
+- 马克笔高亮：钴蓝 16% 底块 `scaleX 0→1`（origin 左），f86 / f90 起各 6f——比字段落位还快，读作"笔一划过去"
+- 按钮：墨黑底色 f116 起 12f 由左向右填满，文案 f122 淡入
+- 整卡呼吸：`scale 1→1.035`（不对称 in-out）摊在 0–132f；入场 0–14f scale .96→1 + 上移 30px；末段 40f 静止定格
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 字段时间表 | 光标 8/20/30/42/76/96/114，落位 +2f | 同类字段间隔 3 帧、跨类间隔 10–20 帧；全部改成等间隔会读作机械点名 |
+| 光标跳格 | 6f，swift in-out，框形同步变形 | <4f 读作闪现；>10f 光标拖在字段后面，"领先抓取"变成"事后框选" |
+| 单字段行程 | 14f expo-out | 行程远大于组内间隔 → 同组几个字段同时在动，画面是"涌"而非"点" |
+| rise 位移 | 10–26px（按字号） | 大标题位移大、小字位移小；>40px 会与整卡前推的方向感打架 |
+| pop | 弹簧 damping 13，0.4→1 | pill 与色卡尺寸小，过冲不会撞到邻居，大件用 pop 就会显得廉价 |
+| 价格降级点 | f62（价格落位后 hold 18f） | 必须留出"先看清原价"的时间，紧贴落位会读作从来就是打折价 |
+| 新价 spring | damping 14，1.18→1 | 全片唯一的放大回弹事件；阻尼调小会抖两下，与旁边的划线动作抢注意力 |
+| 高亮刷过 | 6f，`scaleX` 从左 | 5–6f 是马克笔速度；>12f 读作背景色渐变而不是划线 |
+| 整卡前推 | `scale 1→1.035`，0–132f | 摊在 4.4s 上是纯呼吸；>8% 卡会撞到画框 |
+
+## 已知坑
+- 字段框（光标落点）是写死的绝对坐标：改字号或文案后要同步改 `F` 表里的 box，否则光标框不住字段
+- 最后一个字段在 ~f128 落定，之后 ~1.3s 只有极缓前推——给观众通读整卡的时间，别当成 bug 砍掉
+- 三行正文 `white-space: nowrap` 写死不换行（34px，行宽 ≤ 700px）。换更长文案或中文时会溢出卡边，
+  落地必须重新配字号与行长
+- 新价与折扣 chip 是绝对定位（按 112px 粗体数字宽度估的 x），换价格位数要重排，否则 chip 压字
+- 内容是 video-shotcraft 的示例填法（$449 划掉→Free、卖点文案、品牌四色色卡；$449 只是示意原价），字段结构本身才是可复用的部分。
+  换成真实商品数据后字段数量往往变化，时间表要按新的字段分组重排间隔
+- 高亮的起点（f86/90）晚于所在行开始落位（f78/81）8–9f；改行落位时间必须同步改高亮，否则出现"高亮先到、文字后来"
+- `BLUE`（钴蓝）是全卡唯一色相来源（光标 + 新价 + chip + 高亮），换品牌色改 look 的 accent 即可；其余全是中性色
+
+## 参考实现
+demos/ui-entrance/product-card-progressive-assemble/
+（ProductCardProgressiveAssemble.tsx）