dsh-drawai 0.4.2 → 0.4.4

package/lib/motion/shotcraft/upstream/references/shots/ui-entrance/radial-wave.md

@@ -1,49 +1,49 @@
----
-name: radial-wave
-一句话: 17×9 圆点阵列按到波源的欧氏距离错峰点亮，每点 scale 过冲到 1.5 再落回常亮，第一道波扫完后第二道亮蓝脉冲从外圈反向收拢回中心
-适用: 产品/品牌开场的"系统上电"一拍；也用作数据网格、节点地图、覆盖范围类叙事的建立镜头
-时长: 约 3.8s（114f@30fps）
-能量: 中高（起手爆发一次，波前过后转为常亮低能量底子）
----
-
-## 意图
-把"很多点同时存在"这件静态事实，改写成"能量从一个源头扩散到全体"的动态事实。观众
-看到的不是一张点阵图，而是一次通电：中心先亮，亮度像水波推过去，走完之后整张阵列
-留在常亮态——为下一拍要放的内容铺好底。第二道反向波是回执，告诉观众这个系统会回应。
-
-## 动效核心
-- 阵列 17×9 共 153 点，dot 用百分比定位（`left:(c+0.5)/COLS`），因此改变行列数不需要
-  重算坐标；每点预存归一化距离 `dist = hypot(c-cx, r-cy) / maxD`（maxD = hypot(8,4)）
-- 第一道波：`seg(t, dist*0.35, dist*0.35+0.18, E.outCubic)`——起点由距离线性推迟（最外
-  圈延后 0.35），单点自己的行程恒定 0.18；波前是"起点错峰"而不是变速
-- 每点的 scale 不是简单 0→1，而是 `w1*(1+0.5*sin(w1*π))`：中途鼓到约 1.5 再收回 1，
-  正弦包络让过冲发生在行程正中而非落位时
-- 第二道波：`seg(t, 0.62+(1-dist)*0.25, +0.15)` 把偏移量反号（外圈先动），取
-  `sin(w2*π)` 做纯脉冲，叠加 0.8 的 scale 增量与 0.25 的透明度增量，走完不留状态
-- 脉冲峰值处（`pulse2 > 0.3`）硬切成 `#b9f2ff` 并挂 `0 0 12px #7fd8ff` 光晕——只有第二
-  道波带发光，第一道波全程是 `#6c8cff` 常色，两道波在视觉上不会混成一件事
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 阵列规模 | COLS=17 / ROWS=9（153 点） | 点数决定波前的"分辨率"；<8 列时距离分档太粗，波读作三四圈同心环在跳 |
-| 波速系数 | `dist*0.35` | 这个 0.35 就是波速倒数：调大波走得慢、拖尾长；>0.5 时最外圈要等到全片过半才亮 |
-| 单点行程 | 0.18（≈21f） | 决定波前的厚度；<0.1 波前锐利像扫描线，>0.3 全场几乎同时亮，扩散感消失 |
-| 过冲幅度 | `1+0.5*sin(w1*π)` → 峰值 1.5 | 系数 0.5 是"弹一下"的量；去掉正弦项就是平淡的 0→1 淡入，>0.8 点会互相咬边 |
-| 第二道波 | 起点 `0.62+(1-dist)*0.25`，窗 0.15，幅度 0.8 | 0.62 是两波之间的呼吸；提前到 0.5 以下会和第一道波尾巴叠在一起读作一团乱闪 |
-| 常亮底 | `opacity = 0.25 + w1*0.5 + pulse2*0.25` | 0.25 是未点亮点的存在感；调到 0 则波前之外一片黑，阵列的"规模"交代不出来 |
-| 高亮阈值 | `pulse2 > 0.3` 切色 + 光晕 | 阈值越低发光段越长；这是硬切不是渐变，阈值贴近 0 时会看到明显的开关跳变 |
-
-## 已知坑
-- 波源写死在几何中心（`cx=(COLS-1)/2, cy=(ROWS-1)/2`）。要改成从角落或某个"节点"起波，
-  必须同时改 cx/cy 与 maxD，否则归一化距离 >1，最外圈的起点会被推到 t=1 之外永不点亮
-- 末帧不完全静止：中心点（dist=0）的第二道波窗是 0.87→1.02，t=1 时才走到 87%，
-  `pulse2≈0.41` 仍在高亮。要做循环或干净收尾，得把第二道波起点压到 0.85 以内
-- dot 的 `width:10px` 与 `margin:-5px` 是绑定的一对（靠负 margin 居中），改点径必须同步改
-  margin，否则整阵列会朝右下偏半个点径
-- 颜色只有两档（常色 `#6c8cff` / 峰值 `#b9f2ff`），换品牌色要改这两处加光晕色共三处；
-  背景 `#0a0b10` 是发光的前提，白底上这套亮度脉冲基本看不见
-
-## 参考实现
-demos/ui-entrance/radial-wave/
-（RadialWave.tsx）
+---
+name: radial-wave
+一句话: 17×9 圆点阵列按到波源的欧氏距离错峰点亮，每点 scale 过冲到 1.5 再落回常亮，第一道波扫完后第二道亮蓝脉冲从外圈反向收拢回中心
+适用: 产品/品牌开场的"系统上电"一拍；也用作数据网格、节点地图、覆盖范围类叙事的建立镜头
+时长: 约 3.8s（114f@30fps）
+能量: 中高（起手爆发一次，波前过后转为常亮低能量底子）
+---
+
+## 意图
+把"很多点同时存在"这件静态事实，改写成"能量从一个源头扩散到全体"的动态事实。观众
+看到的不是一张点阵图，而是一次通电：中心先亮，亮度像水波推过去，走完之后整张阵列
+留在常亮态——为下一拍要放的内容铺好底。第二道反向波是回执，告诉观众这个系统会回应。
+
+## 动效核心
+- 阵列 17×9 共 153 点，dot 用百分比定位（`left:(c+0.5)/COLS`），因此改变行列数不需要
+  重算坐标；每点预存归一化距离 `dist = hypot(c-cx, r-cy) / maxD`（maxD = hypot(8,4)）
+- 第一道波：`seg(t, dist*0.35, dist*0.35+0.18, E.outCubic)`——起点由距离线性推迟（最外
+  圈延后 0.35），单点自己的行程恒定 0.18；波前是"起点错峰"而不是变速
+- 每点的 scale 不是简单 0→1，而是 `w1*(1+0.5*sin(w1*π))`：中途鼓到约 1.5 再收回 1，
+  正弦包络让过冲发生在行程正中而非落位时
+- 第二道波：`seg(t, 0.62+(1-dist)*0.25, +0.15)` 把偏移量反号（外圈先动），取
+  `sin(w2*π)` 做纯脉冲，叠加 0.8 的 scale 增量与 0.25 的透明度增量，走完不留状态
+- 脉冲峰值处（`pulse2 > 0.3`）硬切成 `#b9f2ff` 并挂 `0 0 12px #7fd8ff` 光晕——只有第二
+  道波带发光，第一道波全程是 `#6c8cff` 常色，两道波在视觉上不会混成一件事
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 阵列规模 | COLS=17 / ROWS=9（153 点） | 点数决定波前的"分辨率"；<8 列时距离分档太粗，波读作三四圈同心环在跳 |
+| 波速系数 | `dist*0.35` | 这个 0.35 就是波速倒数：调大波走得慢、拖尾长；>0.5 时最外圈要等到全片过半才亮 |
+| 单点行程 | 0.18（≈21f） | 决定波前的厚度；<0.1 波前锐利像扫描线，>0.3 全场几乎同时亮，扩散感消失 |
+| 过冲幅度 | `1+0.5*sin(w1*π)` → 峰值 1.5 | 系数 0.5 是"弹一下"的量；去掉正弦项就是平淡的 0→1 淡入，>0.8 点会互相咬边 |
+| 第二道波 | 起点 `0.62+(1-dist)*0.25`，窗 0.15，幅度 0.8 | 0.62 是两波之间的呼吸；提前到 0.5 以下会和第一道波尾巴叠在一起读作一团乱闪 |
+| 常亮底 | `opacity = 0.25 + w1*0.5 + pulse2*0.25` | 0.25 是未点亮点的存在感；调到 0 则波前之外一片黑，阵列的"规模"交代不出来 |
+| 高亮阈值 | `pulse2 > 0.3` 切色 + 光晕 | 阈值越低发光段越长；这是硬切不是渐变，阈值贴近 0 时会看到明显的开关跳变 |
+
+## 已知坑
+- 波源写死在几何中心（`cx=(COLS-1)/2, cy=(ROWS-1)/2`）。要改成从角落或某个"节点"起波，
+  必须同时改 cx/cy 与 maxD，否则归一化距离 >1，最外圈的起点会被推到 t=1 之外永不点亮
+- 末帧不完全静止：中心点（dist=0）的第二道波窗是 0.87→1.02，t=1 时才走到 87%，
+  `pulse2≈0.41` 仍在高亮。要做循环或干净收尾，得把第二道波起点压到 0.85 以内
+- dot 的 `width:10px` 与 `margin:-5px` 是绑定的一对（靠负 margin 居中），改点径必须同步改
+  margin，否则整阵列会朝右下偏半个点径
+- 颜色只有两档（常色 `#6c8cff` / 峰值 `#b9f2ff`），换品牌色要改这两处加光晕色共三处；
+  背景 `#0a0b10` 是发光的前提，白底上这套亮度脉冲基本看不见
+
+## 参考实现
+demos/ui-entrance/radial-wave/
+（RadialWave.tsx）

package/lib/motion/shotcraft/upstream/references/shots/ui-entrance/research-card-stack-scroll.md

@@ -1,57 +1,57 @@
----
-name: research-card-stack-scroll
-一句话: 深色论文卡每 12 帧一张沿右下轴线飞入中心叠压，落位带 1 帧压缩，只有最上一张全清晰渲染标题+作者+摘要，下方卡按堆积深度递增模糊变暗只露标题条，背景横向 grid 同步下移做速度参照
-适用: "读了大量资料/处理了海量文档"的量级交代；研究类、检索类、批处理类产品的能力镜头
-时长: 约 4.8s（144f@30fps）
-能量: 中高（匀速高频，无爆发但持续压迫）
----
-
-## 意图
-要说的是"数量"，但一次给 13 张卡会读成一堵墙。改成流水线：卡一张一张进，每张都被
-读过（最上一张永远是全文渲染的那张），读完就沉进堆里变模糊。观众感受到的是持续不断
-的吞吐量，而不是一个静态的堆。背景 grid 同速下移是速度参照——没有它，堆积会读作
-"卡在原地缩小"。
-
-## 动效核心
-- 时间轴用真实帧号而非归一化 t：内部 `F=144`，每张卡的本地时间 `e = t*144 - i*12`，
-  一切编排（入场、堆积、深度）都以 `PER=12` 帧为节拍单位写死
-- 入场是 6 帧短促动作：`seg(clamp((e+6)/6), 0, 1, E.outCubic)`——注意起点是 `e=-6`，
-  即卡在自己的节拍到达前 6 帧就开始飞，`translateY(-40→0)` + `scale(0.94→1)`
-- 落位 squash：`e ∈ [0, 1.6)` 时 y 轴 scale 额外乘 0.97，只压 1.6 帧——短到读不出是
-  变形，只读作"砸实了"
-- 堆积漂移：落位后 `drift = e/12*30`，每个节拍向下 30px、向右 `XOFF=9`px，形成微微
-  向右下的轴线；轴线的存在让 13 张卡不是同心叠放而是有厚度的一叠
-- 深度衰减：`depth = min(1, drift/(30*3))`——三个节拍内衰减到底，`blur(depth*4)` +
-  `brightness(1-depth*0.25)`；再往下 `(drift-30*3.2)/(30*1.6)` 把 opacity 拉到 0 回收
-- 焦点唯一：`focus = floor(f/12)`，只有 `i === focus` 的卡显示 body（作者行 + 4 条摘要
-  骨架），其余卡的 body 直接 `opacity:0` 只留标题——"正在读的那一张"永远只有一张
-- 背景 grid：`translateY((f/12*30*S) % 24)`，位移量与卡的 drift 用同一个 `GAP=30`
-  推导，所以 grid 与卡堆严格同速；对 24px 取模让它无缝循环
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 节拍 | PER=12 帧/张，13 张 | 12f 是"紧但看得清"的下限；<8f 标题来不及读，>20f 量级感垮掉变成逐张展示 |
-| 入场行程 | 6 帧（outCubic），提前量 -6 帧 | 行程只有节拍的一半 → 每张在下一张来之前已经落定；行程 ≥ PER 时会有两张同时在飞 |
-| 入场位移/缩放 | `translateY(-40→0)`、`scale 0.94→1` | 40px 相对 96px 卡高是小幅——卡是"落进去"不是"飞进来"；缩放差只有 0.06，再大就读作弹窗 |
-| 落位压缩 | 1.6 帧，y 轴 ×0.97 | 3% 是刚好能感知的量；>6% 或时长 >3f 会看出橡皮变形 |
-| 堆积轴线 | 每节拍 y+30px、x+9px | 9/30 的比值决定轴线斜度；x 归零会变成正下方同心叠压，厚度感消失 |
-| 深度衰减 | `depth = drift/90`，blur 0→4px、brightness 1→0.75 | 90px（3 个节拍）内衰减完 → 画面里始终只有约 3 张是"半清晰"的；衰减距离拉长会让下方糊卡堆太厚，画面变脏 |
-| 回收窗 | `drift > 96px` 起淡出，48px 内到 0 | 回收太早会看到卡在画面中央消失；太晚 13 张全在场，DOM 与 blur 开销都上去 |
-| 内容坐标系 | 逻辑 420×250，整体 `scale(min(W/420, H/250))` | 所有像素值写在逻辑坐标系里，改画布尺寸不用重排；卡 296×96、字号 9.5px 都是逻辑值 |
-
-## 已知坑
-- 卡数与节拍是绑定的：`13 张 × 12 帧 = 156 帧 > F=144`，末两张在 t=1 时仍在入场途中，
-  末帧不是干净的静态。要做定格结尾，把卡数压到 `F/PER - 1` 以内（12 帧节拍下 ≤11 张）
-- `focus = floor(f/12)` 会超出卡数上界（f=144 时 focus=12，正好是最后一张）——加卡数
-  或改节拍后要确认 focus 不会长期指向不存在的索引，否则出现"没有任何一张是清晰的"
-- 全部时间常量都写死在 144 帧的假设上（`F=144`, `fr=f/F`）。改时长必须同时改 F，
-  否则节拍会随时长伸缩，12 帧的紧凑感丢失
-- 标题是 13 条真实感的论文标题占位、`preprint:24xx` 编号由索引生成，落地要换成项目
-  真实文档标题；`rand(i*5+k)` 生成的摘要骨架条宽度是确定性伪随机，不要换成 Math.random
-- 深色卡（`INK` 底 + `#2A2A2A` 描边）压在 `#FAFAFA` 浅底上是这套对比度的前提；卡色
-  改浅后 `brightness(0.75)` 的深度衰减几乎看不出来，需要改用 opacity 或灰度衰减
-
-## 参考实现
-demos/ui-entrance/research-card-stack-scroll/
-（ResearchCardStackScroll.tsx）
+---
+name: research-card-stack-scroll
+一句话: 深色论文卡每 12 帧一张沿右下轴线飞入中心叠压，落位带 1 帧压缩，只有最上一张全清晰渲染标题+作者+摘要，下方卡按堆积深度递增模糊变暗只露标题条，背景横向 grid 同步下移做速度参照
+适用: "读了大量资料/处理了海量文档"的量级交代；研究类、检索类、批处理类产品的能力镜头
+时长: 约 4.8s（144f@30fps）
+能量: 中高（匀速高频，无爆发但持续压迫）
+---
+
+## 意图
+要说的是"数量"，但一次给 13 张卡会读成一堵墙。改成流水线：卡一张一张进，每张都被
+读过（最上一张永远是全文渲染的那张），读完就沉进堆里变模糊。观众感受到的是持续不断
+的吞吐量，而不是一个静态的堆。背景 grid 同速下移是速度参照——没有它，堆积会读作
+"卡在原地缩小"。
+
+## 动效核心
+- 时间轴用真实帧号而非归一化 t：内部 `F=144`，每张卡的本地时间 `e = t*144 - i*12`，
+  一切编排（入场、堆积、深度）都以 `PER=12` 帧为节拍单位写死
+- 入场是 6 帧短促动作：`seg(clamp((e+6)/6), 0, 1, E.outCubic)`——注意起点是 `e=-6`，
+  即卡在自己的节拍到达前 6 帧就开始飞，`translateY(-40→0)` + `scale(0.94→1)`
+- 落位 squash：`e ∈ [0, 1.6)` 时 y 轴 scale 额外乘 0.97，只压 1.6 帧——短到读不出是
+  变形，只读作"砸实了"
+- 堆积漂移：落位后 `drift = e/12*30`，每个节拍向下 30px、向右 `XOFF=9`px，形成微微
+  向右下的轴线；轴线的存在让 13 张卡不是同心叠放而是有厚度的一叠
+- 深度衰减：`depth = min(1, drift/(30*3))`——三个节拍内衰减到底，`blur(depth*4)` +
+  `brightness(1-depth*0.25)`；再往下 `(drift-30*3.2)/(30*1.6)` 把 opacity 拉到 0 回收
+- 焦点唯一：`focus = floor(f/12)`，只有 `i === focus` 的卡显示 body（作者行 + 4 条摘要
+  骨架），其余卡的 body 直接 `opacity:0` 只留标题——"正在读的那一张"永远只有一张
+- 背景 grid：`translateY((f/12*30*S) % 24)`，位移量与卡的 drift 用同一个 `GAP=30`
+  推导，所以 grid 与卡堆严格同速；对 24px 取模让它无缝循环
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 节拍 | PER=12 帧/张，13 张 | 12f 是"紧但看得清"的下限；<8f 标题来不及读，>20f 量级感垮掉变成逐张展示 |
+| 入场行程 | 6 帧（outCubic），提前量 -6 帧 | 行程只有节拍的一半 → 每张在下一张来之前已经落定；行程 ≥ PER 时会有两张同时在飞 |
+| 入场位移/缩放 | `translateY(-40→0)`、`scale 0.94→1` | 40px 相对 96px 卡高是小幅——卡是"落进去"不是"飞进来"；缩放差只有 0.06，再大就读作弹窗 |
+| 落位压缩 | 1.6 帧，y 轴 ×0.97 | 3% 是刚好能感知的量；>6% 或时长 >3f 会看出橡皮变形 |
+| 堆积轴线 | 每节拍 y+30px、x+9px | 9/30 的比值决定轴线斜度；x 归零会变成正下方同心叠压，厚度感消失 |
+| 深度衰减 | `depth = drift/90`，blur 0→4px、brightness 1→0.75 | 90px（3 个节拍）内衰减完 → 画面里始终只有约 3 张是"半清晰"的；衰减距离拉长会让下方糊卡堆太厚，画面变脏 |
+| 回收窗 | `drift > 96px` 起淡出，48px 内到 0 | 回收太早会看到卡在画面中央消失；太晚 13 张全在场，DOM 与 blur 开销都上去 |
+| 内容坐标系 | 逻辑 420×250，整体 `scale(min(W/420, H/250))` | 所有像素值写在逻辑坐标系里，改画布尺寸不用重排；卡 296×96、字号 9.5px 都是逻辑值 |
+
+## 已知坑
+- 卡数与节拍是绑定的：`13 张 × 12 帧 = 156 帧 > F=144`，末两张在 t=1 时仍在入场途中，
+  末帧不是干净的静态。要做定格结尾，把卡数压到 `F/PER - 1` 以内（12 帧节拍下 ≤11 张）
+- `focus = floor(f/12)` 会超出卡数上界（f=144 时 focus=12，正好是最后一张）——加卡数
+  或改节拍后要确认 focus 不会长期指向不存在的索引，否则出现"没有任何一张是清晰的"
+- 全部时间常量都写死在 144 帧的假设上（`F=144`, `fr=f/F`）。改时长必须同时改 F，
+  否则节拍会随时长伸缩，12 帧的紧凑感丢失
+- 标题是 13 条真实感的论文标题占位、`preprint:24xx` 编号由索引生成，落地要换成项目
+  真实文档标题；`rand(i*5+k)` 生成的摘要骨架条宽度是确定性伪随机，不要换成 Math.random
+- 深色卡（`INK` 底 + `#2A2A2A` 描边）压在 `#FAFAFA` 浅底上是这套对比度的前提；卡色
+  改浅后 `brightness(0.75)` 的深度衰减几乎看不出来，需要改用 opacity 或灰度衰减
+
+## 参考实现
+demos/ui-entrance/research-card-stack-scroll/
+（ResearchCardStackScroll.tsx）

package/lib/motion/shotcraft/upstream/references/shots/ui-entrance/row-embed.md

@@ -1,36 +1,36 @@
----
-name: row-embed
-一句话: 内容行像卡片一样从空中降下、rotateX 收平、嵌入瞬间底边亮一道强调色的缝
-适用: "结构化数据长进页面"的详情页/列表镜头；行级内容的批量入场
-时长: 约 2s（12–68f）
-能量: 中
----
-
-## 意图
-详情页的行不是"显示出来"而是"长进去"——每一行从空中降下并严丝合缝嵌入页面布局，嵌入瞬间的强调色缝是"咔哒"扣上的视觉拟音。
-
-## 动效核心
-- 行按越落越快的节拍逐条从上空飞入（末段带速度砸进槽位 + 纵向运动模糊），rotateX 从仰角收平，scale 略过冲后 press 回弹
-- 行位先盖页面真实底色补丁 + 极淡虚线槽位框占位，落地后补丁消失让纹理透出；槽位接触影随行接近收紧变实
-- 嵌入瞬间行底边一道 2px 强调色缝从中心向两侧展开后淡出
-- 相机同时缓缓下摇并微推近，行雨与运镜并行；取景全程被页面铺满
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 节拍 | cue = 12/22/31/39/46（间隔 10→7 递减），飞行 12f，最后一行 58f 落地、强调色缝 66f 收尾 ≤ 镜头 68f 预算 | 先算"最后一行何时落地"再定 cue 间隔——节拍×行数要对预算（同 document-typewriter-reveal 卡的核心算术） |
-| 飞行姿态 | `perspective(900px) translateY(−120·air) rotateX(16°·air)`，进度缓动 bezier(.5,0,.8,.75)（末段仍有速度），scale 1.06→0.995 再 4f press-bounce 回 1 | rotateX 收平是"嵌入"的关键读感；纯垂直下落读作贴纸 |
-| 飞行体 | backgroundImage 取整页截图、backgroundPosition 负偏移裁出该行 | 纹理裁片不重绘内容（Q1）——重绘的行和页面字体渲染有肉眼可见差异 |
-| 空槽补丁 | 行位先盖页面真实底色 #f9f6f1 patch（逐像素采样，偏白会读成一整块白板）+ 20% 虚线槽位框，落地后 2f 消失 | 无补丁时纹理里烤入的行会先透出来，飞入变成"重影" |
-| 嵌入闪光 | 底边 2px 强调色缝（两端羽化）从中心向两侧 5f 展开（Easing.out cubic）、8f 淡出，带 7px 辉光 | 缝只在底边、只闪一次；四边都闪读作选中框 |
-| 相机 | cy 500→740、zoom 1.12→1.25，68f 缓动下摇 + 微推 | 运镜与行雨并行制造"边看边长"的感觉；相机若等行落完再动，镜头会拖；起止两端都要让页面铺满画框，露出页顶/页底外就是空白死区 |
-
-## 声音
-段落切入钉 transition-soft（模板片钉在 f475）；行落地不逐条配音——行数多、间隔匀时逐条 pop 会机枪化，靠画面的强调色缝做"视觉拟音"即可（S2 反面自检）。
-
-## 已知坑
-- 飞入终点必须是页面布局真实槽位、落地即嵌入（Q9）——要"从空中飞入，嵌入 dashboard"；悬浮其上不落地会显得假
-- 强调色缝等光效必须裁进承载元素圆角边界内（Q4 判例），光溢出圆角是廉价感典型来源
-
-## 参考实现
-demos/ui-entrance/row-embed/RowEmbed.tsx（原 template/src/aifl/live/SceneDetail.tsx）
+---
+name: row-embed
+一句话: 内容行像卡片一样从空中降下、rotateX 收平、嵌入瞬间底边亮一道强调色的缝
+适用: "结构化数据长进页面"的详情页/列表镜头；行级内容的批量入场
+时长: 约 2s（12–68f）
+能量: 中
+---
+
+## 意图
+详情页的行不是"显示出来"而是"长进去"——每一行从空中降下并严丝合缝嵌入页面布局，嵌入瞬间的强调色缝是"咔哒"扣上的视觉拟音。
+
+## 动效核心
+- 行按越落越快的节拍逐条从上空飞入（末段带速度砸进槽位 + 纵向运动模糊），rotateX 从仰角收平，scale 略过冲后 press 回弹
+- 行位先盖页面真实底色补丁 + 极淡虚线槽位框占位，落地后补丁消失让纹理透出；槽位接触影随行接近收紧变实
+- 嵌入瞬间行底边一道 2px 强调色缝从中心向两侧展开后淡出
+- 相机同时缓缓下摇并微推近，行雨与运镜并行；取景全程被页面铺满
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 节拍 | cue = 12/22/31/39/46（间隔 10→7 递减），飞行 12f，最后一行 58f 落地、强调色缝 66f 收尾 ≤ 镜头 68f 预算 | 先算"最后一行何时落地"再定 cue 间隔——节拍×行数要对预算（同 document-typewriter-reveal 卡的核心算术） |
+| 飞行姿态 | `perspective(900px) translateY(−120·air) rotateX(16°·air)`，进度缓动 bezier(.5,0,.8,.75)（末段仍有速度），scale 1.06→0.995 再 4f press-bounce 回 1 | rotateX 收平是"嵌入"的关键读感；纯垂直下落读作贴纸 |
+| 飞行体 | backgroundImage 取整页截图、backgroundPosition 负偏移裁出该行 | 纹理裁片不重绘内容（Q1）——重绘的行和页面字体渲染有肉眼可见差异 |
+| 空槽补丁 | 行位先盖页面真实底色 #f9f6f1 patch（逐像素采样，偏白会读成一整块白板）+ 20% 虚线槽位框，落地后 2f 消失 | 无补丁时纹理里烤入的行会先透出来，飞入变成"重影" |
+| 嵌入闪光 | 底边 2px 强调色缝（两端羽化）从中心向两侧 5f 展开（Easing.out cubic）、8f 淡出，带 7px 辉光 | 缝只在底边、只闪一次；四边都闪读作选中框 |
+| 相机 | cy 500→740、zoom 1.12→1.25，68f 缓动下摇 + 微推 | 运镜与行雨并行制造"边看边长"的感觉；相机若等行落完再动，镜头会拖；起止两端都要让页面铺满画框，露出页顶/页底外就是空白死区 |
+
+## 声音
+段落切入钉 transition-soft（模板片钉在 f475）；行落地不逐条配音——行数多、间隔匀时逐条 pop 会机枪化，靠画面的强调色缝做"视觉拟音"即可（S2 反面自检）。
+
+## 已知坑
+- 飞入终点必须是页面布局真实槽位、落地即嵌入（Q9）——要"从空中飞入，嵌入 dashboard"；悬浮其上不落地会显得假
+- 强调色缝等光效必须裁进承载元素圆角边界内（Q4 判例），光溢出圆角是廉价感典型来源
+
+## 参考实现
+demos/ui-entrance/row-embed/RowEmbed.tsx（原 template/src/aifl/live/SceneDetail.tsx）

package/lib/motion/shotcraft/upstream/references/shots/ui-entrance/value-stagger-gradient.md

@@ -1,64 +1,64 @@
----
-name: value-stagger-gradient
-一句话: 16 根柱入场时 delay 是时间错峰，同时高度/色相/位移/模糊四个属性各自铺成从首到末的数值梯度；第二拍把错峰原点换成中心，脉冲幅度以中心为最大重新铺开
-适用: 技法演示与参数化能力的展示镜头；也可直接当数据/频谱/均衡器类界面的入场
-时长: 约 5.0s（150f@30fps）
-能量: 中高（第一拍是连续铺开，第二拍中心脉冲是明确的一次峰值）
----
-
-## 意图
-stagger 通常只被用来错开时间。这张卡要说的是它还能错开**值**——同一个索引既决定
-"什么时候动"，也决定"动到多少"。两拍是一组对照实验：第一拍原点在首位（梯度从左到
-右单调铺开），第二拍原点换到中心（梯度以中轴对称铺开）。观众看到的不是两个动画，
-而是同一个配方换了一个参数。屏幕上的代码字幕同步换成对应的 stagger 调用，明说这件事。
-
-## 动效核心
-- 核心工具是一个 8 行的 `staggerVal(i, n, a, b, ease)`：把索引归一化成 `k = i/(n-1)`
-  再 `lerp(k, a, b)`——等价 anime.js 的 `stagger([a, b])` 值模式，可选 ease 让梯度非线性
-- 静态梯度（写在 setup 里，一次算完）：色相 `staggerVal(i,N,200,320)`、
-  最大高度 `staggerVal(i,N,92,32)`——16 根柱天生是一道从蓝到紫、从高到矮的斜坡
-- 动态梯度（每帧用）：位移量 `staggerVal(i,N,46,14)`、模糊量 `staggerVal(i,N,8,2)`
-  ——首位柱要走 46px、糊 8px，末位只走 14px、糊 2px。**同一次入场里每根柱的行程都不同**
-- 第一拍时间错峰：`d = i*0.02`，`e = seg(t, 0.06+d, 0.28+d, E.outCubic)`——从首位起，
-  16 根摊在 0.3 的窗上；`opacity = e`、`filter = blur((1-e)*b0)`、
-  `translateY((1-e)*y0)` + 高度 `hMax*e`（底部锚定按 height 生长，圆角不被 scaleY 压扁），三者都被同一个 e 驱动
-- 第二拍换原点：`distC = |i - 7.5| / 7.5` 是到中心的归一化距离，
-  `w = seg(t, 0.56 + distC*0.13, +0.18)`——中心柱先动，波向两端扩，这就是 `from:'center'`
-- 第二拍的幅度也是梯度：`amp = lerp(1-distC, 0.06, 0.42)`，中心柱脉冲 42%、末端只有 6%；
-  `pulse = sin(w*π)` 是纯脉冲，同时叠进高度 `hMax*e*(1+pulse*amp)` 与
-  `brightness(1+pulse*0.55)`
-- 代码字幕是一条语法着色的代码条，在 t≈0.52 用约 5f 上下交叉换句（旧句上移淡出、新句自下替入），从 `scale: stagger([1, 0.35])  hue: stagger([200, 320])`
-  换成 `pulse: stagger([.06, .42], { from: 'center' })`——正好卡在两拍之间
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 柱数 | N=16（`left: 8+i*5.4%`，宽 3.4%） | 16 根让梯度有足够分档；<8 根梯度读作"每根都不一样"而非一道斜坡，>24 根柱间距要重算 |
-| 时间错峰 | `d = i*0.02`（≈3f/根，总 0.3） | 3f 是连绵的铺开；>0.05 会变成逐根点名，梯度的"整体感"丢失 |
-| 单柱行程 | 窗 0.22（≈33f，outCubic） | 行程是总错峰的 0.73 倍 → 大部分时间十来根同时在动；行程 < 错峰总量时变成一根接一根 |
-| 高度梯度 | `stagger([92, 32])`px | 首末 2.9 倍差是明确斜坡；比值 <1.5 读不出梯度，>4 末端柱矮到看不见 |
-| 色相梯度 | `stagger([200, 320])` | 120° 跨度（蓝→紫）；跨度 <40° 时色相白给，>200° 会绕回红色让斜坡读作环形 |
-| 位移/模糊梯度 | `stagger([46,14])`px / `stagger([8,2])`px | 这两条是本卡的"值 stagger"主证据——把它们改成常量，动效立刻退化成普通的 stagger 入场 |
-| 第二拍原点 | `from:'center'`，`distC*0.13` | 0.13 是从中心到端点的传播延迟（≈4f）；归零则整排同时脉冲，`from` 参数就没有意义了 |
-| 脉冲幅度梯度 | `lerp(1-distC, 0.06, 0.42)` | 中心 42% / 端点 6% 是 7 倍差，波形明显；两端也给大幅度会读作整排一起鼓，中心原点看不出 |
-| 亮度脉冲 | `brightness(1 + pulse*0.55)` | 55% 提亮让脉冲在暗底上可读；这一项没做梯度（全柱同幅），是有意的——太多梯度叠一起观众读不清哪个是主角 |
-
-## 已知坑
-- 第一拍与第二拍首尾相接：末柱入场结束于 `0.28+15*0.02 = 0.58`，而中心柱的脉冲在 0.56
-  就起。加柱数或加大时间错峰会让入场吃进脉冲段，两拍糊成一件事——加柱必须把 0.56 后推
-- 端点柱的第二拍窗口是 `0.69→0.87`，之后到 t=1 有约 0.13（20f）的完全静止。这是给
-  观众看清"终态梯度"的时间，不是空白
-- `distC` 的分母 `C=(N-1)/2` 在 N=1 时会除零；`staggerVal` 里已用 `n<=1 ? 0` 兜住，
-  但 `distC` 没有——柱数改成 1 会 NaN
-- 柱位 `left: 8+i*5.4%` 与宽 `3.4%` 是为 N=16 手配的（末柱右缘 8+15*5.4+3.4 = 92.4%）。
-  改柱数必须重算这两个百分比，否则柱会溢出或挤在左半边
-- 字幕是 anime.js 的 API 调用字符串，本质是**技法说明**而不是内容。用在真实成片里
-  要么换成有语义的标题，要么去掉——否则观众读到的是代码
-- 底部的 16 个小圆点（`bottom:17%`，opacity .35）是静态装饰，不参与任何动画；它们的
-  `left` 偏移 `+1.2%` 是与柱宽 3.4% 手对的居中量，改柱宽要一起改
-- 深底（`#0a0b10`）+ 高饱和柱（85%/66%）+ 12px 光晕是一套；浅色主题下光晕与
-  brightness 脉冲都失效，需要改用 saturate 或阴影表达脉冲
-
-## 参考实现
-demos/ui-entrance/value-stagger-gradient/
-（ValueStaggerGradient.tsx）
+---
+name: value-stagger-gradient
+一句话: 16 根柱入场时 delay 是时间错峰，同时高度/色相/位移/模糊四个属性各自铺成从首到末的数值梯度；第二拍把错峰原点换成中心，脉冲幅度以中心为最大重新铺开
+适用: 技法演示与参数化能力的展示镜头；也可直接当数据/频谱/均衡器类界面的入场
+时长: 约 5.0s（150f@30fps）
+能量: 中高（第一拍是连续铺开，第二拍中心脉冲是明确的一次峰值）
+---
+
+## 意图
+stagger 通常只被用来错开时间。这张卡要说的是它还能错开**值**——同一个索引既决定
+"什么时候动"，也决定"动到多少"。两拍是一组对照实验：第一拍原点在首位（梯度从左到
+右单调铺开），第二拍原点换到中心（梯度以中轴对称铺开）。观众看到的不是两个动画，
+而是同一个配方换了一个参数。屏幕上的代码字幕同步换成对应的 stagger 调用，明说这件事。
+
+## 动效核心
+- 核心工具是一个 8 行的 `staggerVal(i, n, a, b, ease)`：把索引归一化成 `k = i/(n-1)`
+  再 `lerp(k, a, b)`——等价 anime.js 的 `stagger([a, b])` 值模式，可选 ease 让梯度非线性
+- 静态梯度（写在 setup 里，一次算完）：色相 `staggerVal(i,N,200,320)`、
+  最大高度 `staggerVal(i,N,92,32)`——16 根柱天生是一道从蓝到紫、从高到矮的斜坡
+- 动态梯度（每帧用）：位移量 `staggerVal(i,N,46,14)`、模糊量 `staggerVal(i,N,8,2)`
+  ——首位柱要走 46px、糊 8px，末位只走 14px、糊 2px。**同一次入场里每根柱的行程都不同**
+- 第一拍时间错峰：`d = i*0.02`，`e = seg(t, 0.06+d, 0.28+d, E.outCubic)`——从首位起，
+  16 根摊在 0.3 的窗上；`opacity = e`、`filter = blur((1-e)*b0)`、
+  `translateY((1-e)*y0)` + 高度 `hMax*e`（底部锚定按 height 生长，圆角不被 scaleY 压扁），三者都被同一个 e 驱动
+- 第二拍换原点：`distC = |i - 7.5| / 7.5` 是到中心的归一化距离，
+  `w = seg(t, 0.56 + distC*0.13, +0.18)`——中心柱先动，波向两端扩，这就是 `from:'center'`
+- 第二拍的幅度也是梯度：`amp = lerp(1-distC, 0.06, 0.42)`，中心柱脉冲 42%、末端只有 6%；
+  `pulse = sin(w*π)` 是纯脉冲，同时叠进高度 `hMax*e*(1+pulse*amp)` 与
+  `brightness(1+pulse*0.55)`
+- 代码字幕是一条语法着色的代码条，在 t≈0.52 用约 5f 上下交叉换句（旧句上移淡出、新句自下替入），从 `scale: stagger([1, 0.35])  hue: stagger([200, 320])`
+  换成 `pulse: stagger([.06, .42], { from: 'center' })`——正好卡在两拍之间
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 柱数 | N=16（`left: 8+i*5.4%`，宽 3.4%） | 16 根让梯度有足够分档；<8 根梯度读作"每根都不一样"而非一道斜坡，>24 根柱间距要重算 |
+| 时间错峰 | `d = i*0.02`（≈3f/根，总 0.3） | 3f 是连绵的铺开；>0.05 会变成逐根点名，梯度的"整体感"丢失 |
+| 单柱行程 | 窗 0.22（≈33f，outCubic） | 行程是总错峰的 0.73 倍 → 大部分时间十来根同时在动；行程 < 错峰总量时变成一根接一根 |
+| 高度梯度 | `stagger([92, 32])`px | 首末 2.9 倍差是明确斜坡；比值 <1.5 读不出梯度，>4 末端柱矮到看不见 |
+| 色相梯度 | `stagger([200, 320])` | 120° 跨度（蓝→紫）；跨度 <40° 时色相白给，>200° 会绕回红色让斜坡读作环形 |
+| 位移/模糊梯度 | `stagger([46,14])`px / `stagger([8,2])`px | 这两条是本卡的"值 stagger"主证据——把它们改成常量，动效立刻退化成普通的 stagger 入场 |
+| 第二拍原点 | `from:'center'`，`distC*0.13` | 0.13 是从中心到端点的传播延迟（≈4f）；归零则整排同时脉冲，`from` 参数就没有意义了 |
+| 脉冲幅度梯度 | `lerp(1-distC, 0.06, 0.42)` | 中心 42% / 端点 6% 是 7 倍差，波形明显；两端也给大幅度会读作整排一起鼓，中心原点看不出 |
+| 亮度脉冲 | `brightness(1 + pulse*0.55)` | 55% 提亮让脉冲在暗底上可读；这一项没做梯度（全柱同幅），是有意的——太多梯度叠一起观众读不清哪个是主角 |
+
+## 已知坑
+- 第一拍与第二拍首尾相接：末柱入场结束于 `0.28+15*0.02 = 0.58`，而中心柱的脉冲在 0.56
+  就起。加柱数或加大时间错峰会让入场吃进脉冲段，两拍糊成一件事——加柱必须把 0.56 后推
+- 端点柱的第二拍窗口是 `0.69→0.87`，之后到 t=1 有约 0.13（20f）的完全静止。这是给
+  观众看清"终态梯度"的时间，不是空白
+- `distC` 的分母 `C=(N-1)/2` 在 N=1 时会除零；`staggerVal` 里已用 `n<=1 ? 0` 兜住，
+  但 `distC` 没有——柱数改成 1 会 NaN
+- 柱位 `left: 8+i*5.4%` 与宽 `3.4%` 是为 N=16 手配的（末柱右缘 8+15*5.4+3.4 = 92.4%）。
+  改柱数必须重算这两个百分比，否则柱会溢出或挤在左半边
+- 字幕是 anime.js 的 API 调用字符串，本质是**技法说明**而不是内容。用在真实成片里
+  要么换成有语义的标题，要么去掉——否则观众读到的是代码
+- 底部的 16 个小圆点（`bottom:17%`，opacity .35）是静态装饰，不参与任何动画；它们的
+  `left` 偏移 `+1.2%` 是与柱宽 3.4% 手对的居中量，改柱宽要一起改
+- 深底（`#0a0b10`）+ 高饱和柱（85%/66%）+ 12px 光晕是一套；浅色主题下光晕与
+  brightness 脉冲都失效，需要改用 saturate 或阴影表达脉冲
+
+## 参考实现
+demos/ui-entrance/value-stagger-gradient/
+（ValueStaggerGradient.tsx）

package/lib/motion/shotcraft/upstream/references/shots/ui-entrance/wall-reveal-moves.md

@@ -1,47 +1,47 @@
----
-name: wall-reveal-moves
-一句话: 整墙批量入场两式——bento 逐格点亮、蓝图描线成形，全部原位显形不位移，与 deck-deal-flyin 的飞入位移型互补成品类矩阵
-适用: 功能墙/卡片墙/整页界面的整体亮相；内容已在原位、要"显形"而非"涌入"的段落
-时长: 单式约 5s（A 150f / B 150f @30fps，含建立 hold 与静止收尾）
-能量: 中
----
-
-## 意图
-"一墙内容怎么出场"库内此前只有 deck-deal-flyin 一个答案——高能量、位移型、
-"东西涌进来"。但不是每面墙都该涌：品牌段要庄重、
-"从设计到实物"要讲工序。这两式共同点是**非位移批量入场**——元素原地显形，
-版式从第一帧就成立，观众看的是"状态变化的波前扫过一面墙"而不是"物体飞行"。
-选型先问一句：这面墙该"涌进来"还是"亮起来"？前者去 deck-deal-flyin，后者进本卡。
-
-## 两式选型
-| 式 | 做法 | 适用 |
-|----|------|------|
-| A bento-light-up 逐格点亮 | 暗场 3×2 bento 墙（两行宽窄互补 600/420/420 ↔ 420/420/600，暗色卡面）压暗待命，强调色彗星流光逐格描边一圈、内容随即提亮上浮，全亮后镜头缓推收住；墙上方眉标是 video-shotcraft 标志 + 字标，主标题「Every shot, tuned in one place.」 | 内容庄重/暗场品牌段；节奏沉稳的功能总览 |
-| B wireframe-draw-on 蓝图描线成形 | 界面先以 SVG 细线蓝图分组描画，再一条强调色发光竖线左→右扫过，扫过处线框实体化成真实界面（demo 里是 video-shotcraft 工作台，侧栏 logo 方块内描出镜刻标志） | "从设计到实物/从想法到产品"叙事；产品首次整体亮相 |
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| A 节拍 | hold 20f → 每格间隔 12f 依次激活（六格 ~96f 全亮）→ scale 1→1.04 缓推 25f（bezier 0.33,0,0.2,1）→ 静止收尾 | 12f 级联是"逐格可辨"与"整墙拖沓"的平衡点；格数增多可压到 8–10f，但间隔均匀本身就是这一式的庄重感来源，别学发牌加速 |
-| A 单格 | 暗态 opacity 0.18 + translateY 20px；SVG rect pathLength=100 描边 8f：22% 周长的彗星段（#e8b45e 6px 高斯辉光 + #ffe3ae 2.5px 亮芯）领跑，身后留 1.5px 细边；描边过半（+6f）内容 back-out(0.3,1.4,0.5,1) 弹出 8f 提亮归位；描完 +12f 流光退火到 0.4 常亮细边 | 描边与内容弹出要**接力不同步**——同帧起读作整格闪现；点亮中段辉光脉冲用 lit·(1−lit)·4 抛物线，峰值幅度按格 seed 微差（正弦哈希，禁真随机） |
-| B 描线 | hold 20f → 分组错峰各 30f 描完：侧栏 20f 起/顶栏 30f 起/6 卡 40+i*3f 起/折线图 52f 起；SVG pathLength=1 + dashoffset 1→0，蓝图冷灰蓝 #6c7894（外框 1.6px / 内件 1.25px）round，淡蓝 24px 点阵底 + 卡角裁切标记 | 分组错峰是"手在画"的感觉来源，全部同帧起笔读作打印机；卡内占位线再按 +3f 细错峰，长短用 seed 哈希微差 |
-| B 实体化 | 88–118f 实体层 clip-path inset(0 right% 0 0) 从左向右展开 30f，bezier(0.55,0,0.25,1)；前沿跟 4px 强调色竖线（#ffc46b + 双层辉光 boxShadow），86–92f 淡入、112–120f 淡出；竖线身后 260px 一段渐隐暖光（刚显影的余温） | 竖线位置与 clip 前沿必须同一个 scan 值驱动，异步读作穿帮；描线段与扫描段之间留 ~6f 喘息（82→88f），线框画完立刻扫读作赶工 |
-| 静止收尾 | 两式动作全部落定后真静止 ≥15f（A 在缓推结束后、B 在扫描线淡出后起算） | R1 呼吸判例：静止期一切属性锁死，包括辉光/阴影/高光残留 |
-
-## 已知坑
-- **demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验**
-- A/B 的强调色描边/扫描线属"单点高质量光效"范畴（Q4 三约束内合规），但一支片
-  整墙点亮 ≤1 次（P4 手法去重）——A 和 B 同片共用即算两次整墙光效，选一
-- B 式线框几何必须与实体层布局逐像素对位（demo 里按 FakeDashboard A 手排），
-  换素材要重排线框——对不齐则扫描线扫过瞬间元素跳位，一眼穿帮；改了品牌名 / logo
-  也算换素材（字宽变了，面包屑后面的元素会整组右移），线长要按实体层实测字宽重对
-- 两式都是"原位显形"，别混入位移入场（如逐格点亮时再加 translateX 飞入）——
-  位移需求去 deck-deal-flyin，杂交会两头不像
-- A 式暗态 opacity 0.18 依赖暗底（#2a2a28）成立，亮底下压暗读作褪色故障
-
-## 参考实现
-demos/ui-entrance/wall-reveal-moves/
-（BentoLightUp.tsx / WireframeDrawOn.tsx）
-
-实现状态：两式均有参考实现与 Gallery 动态样片。
+---
+name: wall-reveal-moves
+一句话: 整墙批量入场两式——bento 逐格点亮、蓝图描线成形，全部原位显形不位移，与 deck-deal-flyin 的飞入位移型互补成品类矩阵
+适用: 功能墙/卡片墙/整页界面的整体亮相；内容已在原位、要"显形"而非"涌入"的段落
+时长: 单式约 5s（A 150f / B 150f @30fps，含建立 hold 与静止收尾）
+能量: 中
+---
+
+## 意图
+"一墙内容怎么出场"库内此前只有 deck-deal-flyin 一个答案——高能量、位移型、
+"东西涌进来"。但不是每面墙都该涌：品牌段要庄重、
+"从设计到实物"要讲工序。这两式共同点是**非位移批量入场**——元素原地显形，
+版式从第一帧就成立，观众看的是"状态变化的波前扫过一面墙"而不是"物体飞行"。
+选型先问一句：这面墙该"涌进来"还是"亮起来"？前者去 deck-deal-flyin，后者进本卡。
+
+## 两式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A bento-light-up 逐格点亮 | 暗场 3×2 bento 墙（两行宽窄互补 600/420/420 ↔ 420/420/600，暗色卡面）压暗待命，强调色彗星流光逐格描边一圈、内容随即提亮上浮，全亮后镜头缓推收住；墙上方眉标是 video-shotcraft 标志 + 字标，主标题「Every shot, tuned in one place.」 | 内容庄重/暗场品牌段；节奏沉稳的功能总览 |
+| B wireframe-draw-on 蓝图描线成形 | 界面先以 SVG 细线蓝图分组描画，再一条强调色发光竖线左→右扫过，扫过处线框实体化成真实界面（demo 里是 video-shotcraft 工作台，侧栏 logo 方块内描出镜刻标志） | "从设计到实物/从想法到产品"叙事；产品首次整体亮相 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 节拍 | hold 20f → 每格间隔 12f 依次激活（六格 ~96f 全亮）→ scale 1→1.04 缓推 25f（bezier 0.33,0,0.2,1）→ 静止收尾 | 12f 级联是"逐格可辨"与"整墙拖沓"的平衡点；格数增多可压到 8–10f，但间隔均匀本身就是这一式的庄重感来源，别学发牌加速 |
+| A 单格 | 暗态 opacity 0.18 + translateY 20px；SVG rect pathLength=100 描边 8f：22% 周长的彗星段（#e8b45e 6px 高斯辉光 + #ffe3ae 2.5px 亮芯）领跑，身后留 1.5px 细边；描边过半（+6f）内容 back-out(0.3,1.4,0.5,1) 弹出 8f 提亮归位；描完 +12f 流光退火到 0.4 常亮细边 | 描边与内容弹出要**接力不同步**——同帧起读作整格闪现；点亮中段辉光脉冲用 lit·(1−lit)·4 抛物线，峰值幅度按格 seed 微差（正弦哈希，禁真随机） |
+| B 描线 | hold 20f → 分组错峰各 30f 描完：侧栏 20f 起/顶栏 30f 起/6 卡 40+i*3f 起/折线图 52f 起；SVG pathLength=1 + dashoffset 1→0，蓝图冷灰蓝 #6c7894（外框 1.6px / 内件 1.25px）round，淡蓝 24px 点阵底 + 卡角裁切标记 | 分组错峰是"手在画"的感觉来源，全部同帧起笔读作打印机；卡内占位线再按 +3f 细错峰，长短用 seed 哈希微差 |
+| B 实体化 | 88–118f 实体层 clip-path inset(0 right% 0 0) 从左向右展开 30f，bezier(0.55,0,0.25,1)；前沿跟 4px 强调色竖线（#ffc46b + 双层辉光 boxShadow），86–92f 淡入、112–120f 淡出；竖线身后 260px 一段渐隐暖光（刚显影的余温） | 竖线位置与 clip 前沿必须同一个 scan 值驱动，异步读作穿帮；描线段与扫描段之间留 ~6f 喘息（82→88f），线框画完立刻扫读作赶工 |
+| 静止收尾 | 两式动作全部落定后真静止 ≥15f（A 在缓推结束后、B 在扫描线淡出后起算） | R1 呼吸判例：静止期一切属性锁死，包括辉光/阴影/高光残留 |
+
+## 已知坑
+- **demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验**
+- A/B 的强调色描边/扫描线属"单点高质量光效"范畴（Q4 三约束内合规），但一支片
+  整墙点亮 ≤1 次（P4 手法去重）——A 和 B 同片共用即算两次整墙光效，选一
+- B 式线框几何必须与实体层布局逐像素对位（demo 里按 FakeDashboard A 手排），
+  换素材要重排线框——对不齐则扫描线扫过瞬间元素跳位，一眼穿帮；改了品牌名 / logo
+  也算换素材（字宽变了，面包屑后面的元素会整组右移），线长要按实体层实测字宽重对
+- 两式都是"原位显形"，别混入位移入场（如逐格点亮时再加 translateX 飞入）——
+  位移需求去 deck-deal-flyin，杂交会两头不像
+- A 式暗态 opacity 0.18 依赖暗底（#2a2a28）成立，亮底下压暗读作褪色故障
+
+## 参考实现
+demos/ui-entrance/wall-reveal-moves/
+（BentoLightUp.tsx / WireframeDrawOn.tsx）
+
+实现状态：两式均有参考实现与 Gallery 动态样片。