dsh-drawai 0.4.2 → 0.4.4

package/lib/motion/shotcraft/upstream/references/shots/ui-entrance/doc-park-left-pill-deal.md

@@ -1,62 +1,62 @@
----
-name: doc-park-left-pill-deal
-一句话: 文档不淡出而是向左滑出只露约 35% 宽并微缩到 0.92，右侧按旁白节奏慢速发牌三张白底描边药丸（outBack 弹入），每张落定后其下方字幕逐词加深、下一张到来前整句淡出，左侧文档全程极缓慢自动滚动保持"正在被读"
-适用: 旁白驱动的"分析结论逐条给出"段落；文档理解、推荐理由、审阅意见类产品的核心说明镜头
-时长: 约 5.8s（174f@30fps）
-能量: 低（慢发牌节奏，全片无峰值；靠自动滚动维持活性）
----
-
-## 意图
-结论要一条一条给，观众才记得住。但如果把来源文档淡出，结论就变成了空中楼阁——观众
-不知道这些话从哪来。这张卡的解法是**让来源留在画面里**：文档靠左驻留只露一截，还在
-缓慢滚动（说明它正在被读），右侧的每条结论都是从这份文档里长出来的。发牌节奏刻意慢，
-是为了给旁白留出说完一句的时间。
-
-## 动效核心
-- 驻留（park）不是淡出：`seg(t, 0.06, 0.24, E.inOutCubic)` 驱动
-  `translateX(0→-55%) scale(1→0.92)`，`transform-origin: 0% 50%` 让缩放以左边缘为锚，
-  文档缩小时不会离开画框左侧——最终只露约 35% 宽
-- 常驻自动滚动：`translateY(-t * 120)` 连续匀速（≈0.7px/f），内容比容器长 140px 以上。
-  旧写法 `-(t*3 % 1) * 40` 取模，非周期内容每 1/3 片长整页回跳 40px，肉眼可见，已弃用
-- 慢发牌：三张药丸起点写死在 `T0 = [0.26, 0.48, 0.70]`——间隔 0.22（约 38f / 1.27s），
-  这是一句短旁白的长度，不是 UI 常规的 stagger
-- 每张药丸两条曲线并行：`o = seg(t, f, f+0.035, E.outQuad)` 管透明度（快，约 6f），
-  `b = seg(t, f, f+0.062, E.outBack)` 管 `translateY(14→0) scale(0.94→1)`（慢，约 11f
-  且带过冲）——先看见、再落定，比单曲线更有"接住"的手感
-- 字幕四段编排：起点 `cs = f+0.05`（药丸落定后约 3 帧），`show` 用 0.02 的窗快速出现，
-  `inn` 逐词加深摊在 `(ce-cs)*0.7` 上，`ce` 是下一张的起点减 0.03（末张 ce=0.98），
-  `out` 在 `ce-0.05→ce` 淡出——每句字幕在下一张药丸入场前就已清场，画面永远只有一句
-- 药丸终态是静态列表（`top = 54 + k*48`），三张全部落位后一直留在画面上，读作
-  "结论清单已成形"
-- 依据联动：每张药丸落定后，文档里对应的依据句被荧光笔自左向右划出（f+0.06→0.13），
-  一条强调色细线从该句行尾连到药丸左缘（f+0.04→0.11 draw-on），随该句字幕退场淡出
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 发牌起点 | `T0 = [0.26, 0.48, 0.70]`，间隔 0.22（≈38f） | 间隔就是旁白句长；压到 0.12 以下字幕的"逐词加深"来不及走完，读作字幕闪一下就没了 |
-| 驻留窗 | 0.06→0.24（inOutCubic） | 必须在首张药丸（0.26）之前收住；重叠会出现"文档还在滑、药丸已在发"的浑浊 |
-| 驻留幅度 | `translateX -55%` + `scale 0.92`，露约 35% | 露太少（<25%）文档变成装饰失去"来源"语义；露太多右侧放不下 172px 宽的药丸 |
-| 药丸透明度窗 | 0.035（≈6f，outQuad） | 比位移窗短是有意的——先实后稳；两窗等长会读作普通淡入 |
-| 药丸位移窗 | 0.062（≈11f，outBack），y 14→0、scale 0.94→1 | outBack 的过冲是"发牌落桌"的手感；换 outCubic 会变成平淡的浮上来 |
-| 字幕延迟 | `cs = f + 0.05`（≈9f） | 药丸落定（0.062）之后才起字幕；提前会出现字幕先于结论出现 |
-| 字幕加深行程 | `(ce-cs)*0.7` | 占该句可见时长的 70%，末 30% 是全实态的静置阅读时间；调到 1.0 则字幕刚读完就被淡出 |
-| 自动滚动 | `-t × 120px` 连续匀速 | 5.8s 上约 0.7px/f，是"正在读"的暗示级速度；>3px/f 会抢注意力变成滚动展示 |
-
-## 已知坑
-- 自动滚动是连续位移而非取模循环（取模只有在内容本身严格周期时才不回跳）；改时长或
-  行程时要保证文档内容比容器长出至少整段行程，否则末段会滚出空白
-- 末张字幕的 `ce = 0.98` 意味着它在 0.93→0.98 淡出，末帧只剩三张药丸没有字幕。若要
-  末句留到底，把末张的 `ce` 改成 >1 并去掉 out
-- 药丸位置写死为 `left:214px, top:54+k*48`、宽 172px，是 480 宽画布下与驻留后文档
-  （露出约 87px）配套的一组数字。改文档驻留幅度必须同步改 PX，否则两者重叠
-- 三条药丸文案（demo 里是 video-shotcraft 宣传片简报推荐的三张镜头卡 Crash Zoom / Deck Deal / Logo Sting）与三句字幕都是示意，且字幕
-  长度直接影响"逐词加深"读起来快慢——换真实文案后要按新句长重调 `inn` 行程
-- 药丸数写死为 3（`T0` 的长度）。加到 4 条时间就不够：末张起点会超过 0.9，字幕根本
-  走不完；4 条以上应考虑缩短单句而不是硬塞
-- 字幕的 `ce` 依赖 `T0[k+1]`，改任一张的起点都会连带改变前一张字幕的可见时长——这
-  是有意的联动（字幕永远填满到下一张之前），但调参时要意识到不是独立参数
-
-## 参考实现
-demos/ui-entrance/doc-park-left-pill-deal/
-（DocParkLeftPillDeal.tsx）
+---
+name: doc-park-left-pill-deal
+一句话: 文档不淡出而是向左滑出只露约 35% 宽并微缩到 0.92，右侧按旁白节奏慢速发牌三张白底描边药丸（outBack 弹入），每张落定后其下方字幕逐词加深、下一张到来前整句淡出，左侧文档全程极缓慢自动滚动保持"正在被读"
+适用: 旁白驱动的"分析结论逐条给出"段落；文档理解、推荐理由、审阅意见类产品的核心说明镜头
+时长: 约 5.8s（174f@30fps）
+能量: 低（慢发牌节奏，全片无峰值；靠自动滚动维持活性）
+---
+
+## 意图
+结论要一条一条给，观众才记得住。但如果把来源文档淡出，结论就变成了空中楼阁——观众
+不知道这些话从哪来。这张卡的解法是**让来源留在画面里**：文档靠左驻留只露一截，还在
+缓慢滚动（说明它正在被读），右侧的每条结论都是从这份文档里长出来的。发牌节奏刻意慢，
+是为了给旁白留出说完一句的时间。
+
+## 动效核心
+- 驻留（park）不是淡出：`seg(t, 0.06, 0.24, E.inOutCubic)` 驱动
+  `translateX(0→-55%) scale(1→0.92)`，`transform-origin: 0% 50%` 让缩放以左边缘为锚，
+  文档缩小时不会离开画框左侧——最终只露约 35% 宽
+- 常驻自动滚动：`translateY(-t * 120)` 连续匀速（≈0.7px/f），内容比容器长 140px 以上。
+  旧写法 `-(t*3 % 1) * 40` 取模，非周期内容每 1/3 片长整页回跳 40px，肉眼可见，已弃用
+- 慢发牌：三张药丸起点写死在 `T0 = [0.26, 0.48, 0.70]`——间隔 0.22（约 38f / 1.27s），
+  这是一句短旁白的长度，不是 UI 常规的 stagger
+- 每张药丸两条曲线并行：`o = seg(t, f, f+0.035, E.outQuad)` 管透明度（快，约 6f），
+  `b = seg(t, f, f+0.062, E.outBack)` 管 `translateY(14→0) scale(0.94→1)`（慢，约 11f
+  且带过冲）——先看见、再落定，比单曲线更有"接住"的手感
+- 字幕四段编排：起点 `cs = f+0.05`（药丸落定后约 3 帧），`show` 用 0.02 的窗快速出现，
+  `inn` 逐词加深摊在 `(ce-cs)*0.7` 上，`ce` 是下一张的起点减 0.03（末张 ce=0.98），
+  `out` 在 `ce-0.05→ce` 淡出——每句字幕在下一张药丸入场前就已清场，画面永远只有一句
+- 药丸终态是静态列表（`top = 54 + k*48`），三张全部落位后一直留在画面上，读作
+  "结论清单已成形"
+- 依据联动：每张药丸落定后，文档里对应的依据句被荧光笔自左向右划出（f+0.06→0.13），
+  一条强调色细线从该句行尾连到药丸左缘（f+0.04→0.11 draw-on），随该句字幕退场淡出
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 发牌起点 | `T0 = [0.26, 0.48, 0.70]`，间隔 0.22（≈38f） | 间隔就是旁白句长；压到 0.12 以下字幕的"逐词加深"来不及走完，读作字幕闪一下就没了 |
+| 驻留窗 | 0.06→0.24（inOutCubic） | 必须在首张药丸（0.26）之前收住；重叠会出现"文档还在滑、药丸已在发"的浑浊 |
+| 驻留幅度 | `translateX -55%` + `scale 0.92`，露约 35% | 露太少（<25%）文档变成装饰失去"来源"语义；露太多右侧放不下 172px 宽的药丸 |
+| 药丸透明度窗 | 0.035（≈6f，outQuad） | 比位移窗短是有意的——先实后稳；两窗等长会读作普通淡入 |
+| 药丸位移窗 | 0.062（≈11f，outBack），y 14→0、scale 0.94→1 | outBack 的过冲是"发牌落桌"的手感；换 outCubic 会变成平淡的浮上来 |
+| 字幕延迟 | `cs = f + 0.05`（≈9f） | 药丸落定（0.062）之后才起字幕；提前会出现字幕先于结论出现 |
+| 字幕加深行程 | `(ce-cs)*0.7` | 占该句可见时长的 70%，末 30% 是全实态的静置阅读时间；调到 1.0 则字幕刚读完就被淡出 |
+| 自动滚动 | `-t × 120px` 连续匀速 | 5.8s 上约 0.7px/f，是"正在读"的暗示级速度；>3px/f 会抢注意力变成滚动展示 |
+
+## 已知坑
+- 自动滚动是连续位移而非取模循环（取模只有在内容本身严格周期时才不回跳）；改时长或
+  行程时要保证文档内容比容器长出至少整段行程，否则末段会滚出空白
+- 末张字幕的 `ce = 0.98` 意味着它在 0.93→0.98 淡出，末帧只剩三张药丸没有字幕。若要
+  末句留到底，把末张的 `ce` 改成 >1 并去掉 out
+- 药丸位置写死为 `left:214px, top:54+k*48`、宽 172px，是 480 宽画布下与驻留后文档
+  （露出约 87px）配套的一组数字。改文档驻留幅度必须同步改 PX，否则两者重叠
+- 三条药丸文案（demo 里是 video-shotcraft 宣传片简报推荐的三张镜头卡 Crash Zoom / Deck Deal / Logo Sting）与三句字幕都是示意，且字幕
+  长度直接影响"逐词加深"读起来快慢——换真实文案后要按新句长重调 `inn` 行程
+- 药丸数写死为 3（`T0` 的长度）。加到 4 条时间就不够：末张起点会超过 0.9，字幕根本
+  走不完；4 条以上应考虑缩短单句而不是硬塞
+- 字幕的 `ce` 依赖 `T0[k+1]`，改任一张的起点都会连带改变前一张字幕的可见时长——这
+  是有意的联动（字幕永远填满到下一张之前），但调参时要意识到不是独立参数
+
+## 参考实现
+demos/ui-entrance/doc-park-left-pill-deal/
+（DocParkLeftPillDeal.tsx）

package/lib/motion/shotcraft/upstream/references/shots/ui-entrance/draw-svg-trace.md

@@ -1,55 +1,55 @@
----
-name: draw-svg-trace
-一句话: 描边生长圈注——一条带笔头的墨线沿元素轮廓跑一圈把它"画"出来，闭合瞬间闪黑交棒、内容淡入；同套路可给标题画下划线
-适用: 单个卡片/图表/标题的被点名入场；元素级手法（整页级蓝图描线归 wall-reveal-moves B 式）
-时长: 132f（预告 10f + 描边 40f + 闪黑交棒 16f + 下划线 18f + hold 40f，约 4.4s）
-能量: 中
-标签: typography
----
-
-## 意图
-"画出来"是纸墨审美里最顺手的入场隐喻：元素不是飞进来也不是淡进来，
-而是被一支看不见的笔当场描出来。库内 wall-reveal-moves B 式已有整页
-蓝图版（全屏线框逐段画+区域点亮），本卡是它的**元素级特写版**——
-一条线、一个主体、一次闭合，笔头可见、方向可读，适合"接下来讲它"
-的点名时刻。第二用法是标题下划线生长：同一套路 18f 短版，给重点词
-一笔手绘强调，与马克笔审美 token 天然同族。
-
-## 动效核心
-- **免测周长**：SVG rect/path 设 `pathLength={1}`，strokeDasharray="1"，
-  dashoffset 1→0（40f Easing.inOut(cubic)）——不用 getTotalLength
-- **笔头**：同一路径再叠三段渐细短 dash（0.04/6.4px → 0.024/8px → 0.011/9.6px），dashoffset = 笔头长 − p，
-  天然跑在最前；再加一颗按圆角矩形弧长精确定位的实心笔尖（带落影）；
-  没有笔头就只是"边框在变长"，有笔头才是"有人在画"
-- 预告：开场 0–12f 四角先长出裁切标记（印刷对位线，错峰 2f），底下是一层中心清晰、四周隐去的绘图纸点阵——
-  第 1 帧就有画面，观众先知道"这里要画一个东西"；闭合时裁切标记外弹 22px 并淡出
-- 闭合闪：50–52f 描边冲纯黑 + 6→11px 加粗，52–58f out 回落
-  ——白底上加深加粗，不用发光（判例）
-- 交棒：56–66f 描边层淡出、元素自身发丝边淡入；50f 起卡底上墨、卡片从贴地升起（阴影长出来），
-  内容自上而下 3f 错峰由虚到实 + 上浮，柱图错峰 1.5f 从基线长出——闭合即"画完了"，内容跟着"上色"
-- 第二用法：74–92f 给重点词「100%」画一笔朱红马克笔下划线（略带弧度的手绘路径，笔头跟随），画完常驻
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 描边速度 | 一整圈 40f（10→50f，inOut cubic 起收有呼吸） | <28f 读不出"在画"，>60f 读作加载中 |
-| 主线 / 笔头 | 主线 6px；笔头三段渐细最粗 9.6px、笔尖 r 7.5 | 笔头≤主线粗细就消失在主线里 |
-| 闭合闪 | 2f 冲黑 + 加粗到 11px，6f 回落 | 没有这一下，"画完"没有句号 |
-| 主体尺寸 | 1120×660、圆角 28（描边 rx 同值） | 主体占画宽 ~58%，描边一圈才有"画了一个大东西"的分量；描边 rx 必须等于卡片圆角 |
-| 下划线版 | 18f out cubic 单向生长，12px 朱红、路径带 ±5px 手绘弧度，画完常驻 | 用在单个重点词；一屏 ≥2 条读作装饰线 |
-| 收尾 | 交棒完成后 hold 40f（92→132f），只留 0.9% 极缓推近 | R1 |
-
-## 已知坑
-- demo 用手搓的 video-shotcraft 渲染报告卡（paper 纸墨 look，「Cuts on the beat / 100%」+ 逐镜头能量柱 + 标志字标署名）调校——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 与 wall-reveal-moves B 式（整页蓝图描线）同族互斥：同片二选一，
-  都上读作重复报幕
-- 描边路径必须与元素真实轮廓吻合（圆角 rx 一致）——线画的是 14px
-  圆角、元素是 8px，交棒瞬间错型穿帮
-- 真实素材上内容淡入别抢在闭合前：线还没画完内容先出来，"画"的
-  因果就断了
-- 一次点名画一个主体；同屏多元素排队各画一圈读作加载动画
-
-## 参考实现
-demos/ui-entrance/draw-svg-trace/
-（DrawSvgTrace.tsx）
+---
+name: draw-svg-trace
+一句话: 描边生长圈注——一条带笔头的墨线沿元素轮廓跑一圈把它"画"出来，闭合瞬间闪黑交棒、内容淡入；同套路可给标题画下划线
+适用: 单个卡片/图表/标题的被点名入场；元素级手法（整页级蓝图描线归 wall-reveal-moves B 式）
+时长: 132f（预告 10f + 描边 40f + 闪黑交棒 16f + 下划线 18f + hold 40f，约 4.4s）
+能量: 中
+标签: typography
+---
+
+## 意图
+"画出来"是纸墨审美里最顺手的入场隐喻：元素不是飞进来也不是淡进来，
+而是被一支看不见的笔当场描出来。库内 wall-reveal-moves B 式已有整页
+蓝图版（全屏线框逐段画+区域点亮），本卡是它的**元素级特写版**——
+一条线、一个主体、一次闭合，笔头可见、方向可读，适合"接下来讲它"
+的点名时刻。第二用法是标题下划线生长：同一套路 18f 短版，给重点词
+一笔手绘强调，与马克笔审美 token 天然同族。
+
+## 动效核心
+- **免测周长**：SVG rect/path 设 `pathLength={1}`，strokeDasharray="1"，
+  dashoffset 1→0（40f Easing.inOut(cubic)）——不用 getTotalLength
+- **笔头**：同一路径再叠三段渐细短 dash（0.04/6.4px → 0.024/8px → 0.011/9.6px），dashoffset = 笔头长 − p，
+  天然跑在最前；再加一颗按圆角矩形弧长精确定位的实心笔尖（带落影）；
+  没有笔头就只是"边框在变长"，有笔头才是"有人在画"
+- 预告：开场 0–12f 四角先长出裁切标记（印刷对位线，错峰 2f），底下是一层中心清晰、四周隐去的绘图纸点阵——
+  第 1 帧就有画面，观众先知道"这里要画一个东西"；闭合时裁切标记外弹 22px 并淡出
+- 闭合闪：50–52f 描边冲纯黑 + 6→11px 加粗，52–58f out 回落
+  ——白底上加深加粗，不用发光（判例）
+- 交棒：56–66f 描边层淡出、元素自身发丝边淡入；50f 起卡底上墨、卡片从贴地升起（阴影长出来），
+  内容自上而下 3f 错峰由虚到实 + 上浮，柱图错峰 1.5f 从基线长出——闭合即"画完了"，内容跟着"上色"
+- 第二用法：74–92f 给重点词「100%」画一笔朱红马克笔下划线（略带弧度的手绘路径，笔头跟随），画完常驻
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 描边速度 | 一整圈 40f（10→50f，inOut cubic 起收有呼吸） | <28f 读不出"在画"，>60f 读作加载中 |
+| 主线 / 笔头 | 主线 6px；笔头三段渐细最粗 9.6px、笔尖 r 7.5 | 笔头≤主线粗细就消失在主线里 |
+| 闭合闪 | 2f 冲黑 + 加粗到 11px，6f 回落 | 没有这一下，"画完"没有句号 |
+| 主体尺寸 | 1120×660、圆角 28（描边 rx 同值） | 主体占画宽 ~58%，描边一圈才有"画了一个大东西"的分量；描边 rx 必须等于卡片圆角 |
+| 下划线版 | 18f out cubic 单向生长，12px 朱红、路径带 ±5px 手绘弧度，画完常驻 | 用在单个重点词；一屏 ≥2 条读作装饰线 |
+| 收尾 | 交棒完成后 hold 40f（92→132f），只留 0.9% 极缓推近 | R1 |
+
+## 已知坑
+- demo 用手搓的 video-shotcraft 渲染报告卡（paper 纸墨 look，「Cuts on the beat / 100%」+ 逐镜头能量柱 + 标志字标署名）调校——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 与 wall-reveal-moves B 式（整页蓝图描线）同族互斥：同片二选一，
+  都上读作重复报幕
+- 描边路径必须与元素真实轮廓吻合（圆角 rx 一致）——线画的是 14px
+  圆角、元素是 8px，交棒瞬间错型穿帮
+- 真实素材上内容淡入别抢在闭合前：线还没画完内容先出来，"画"的
+  因果就断了
+- 一次点名画一个主体；同屏多元素排队各画一圈读作加载动画
+
+## 参考实现
+demos/ui-entrance/draw-svg-trace/
+（DrawSvgTrace.tsx）

package/lib/motion/shotcraft/upstream/references/shots/ui-entrance/element-body-moves.md

@@ -1,37 +1,37 @@
----
-name: element-body-moves
-一句话: 元素身体感——contact-shadow-lift 接触阴影离面抬升：卡抬起时桌上的阴影同步放大变淡，纸片离桌被阴影证明
-适用: 给"位置在变"之外补"身体在变"：卡片点名给悬浮证据；配 2.5D 运镜与逐张点名
-时长: A 150f 5s
-能量: A 低中
----
-
-## 意图
-库内运动卡全在管"位置在变"——飞入、滑动、弹跳，元素本身始终是刚体。
-这一式管**身体在变**：给悬浮一个可信的证据——卡抬起时正下方阴影同步放大变淡，
-纸片离桌，staging 法则给 2.5D 运镜垫的物理台词。与 CameraMotionBlur 的区别：
-快门拖影是相机的事，离面抬升是身体的事。
-
-## 选型
-| 式 | 做法 | 适用 |
-|----|------|------|
-| A contact-shadow-lift | 斜俯拍桌面（rotateX 24°→20°）上卡沿法线 translateZ 96px + scale 1.05；阴影是躺在桌面 z=0 的两层独立实体（接触核 + 环境影），随抬升变大、变虚、变淡、向背光侧偏移；点名卡落回 8f in-cubic + 2f 微压卡壳，末张选定卡弹簧抬起后停在空中 | 逐张点名强调；2.5D 段落的离面铺垫 |
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| A 抬升幅度 | 2D：−28px + scale 1.08；2.5D 斜俯拍：translateZ 96px + scale 1.05（屏幕可见位移 40–50px） | 判例锁死：屏幕可见位移 <12px 禁用（见已知坑） |
-| A 阴影 | 独立 div（2D 用椭圆径向渐变；2.5D 用与卡同形的圆角矩形 + blur）：接触核 α 0.32→0.14、blur 3→25px；环境影 α 0.09→0.22、blur 14→54px、向右下偏移；卡本体不带外阴影 | box-shadow 跟卡走，给不出"影子留在桌上" |
-| A 落地 | scale 0.99 卡壳 2f 再 5f 回弹到 1 | 无微压读作飘落，没有重量 |
-| 收尾 | 末张选定后悬停 ~50f | 若要循环，把末张改成同样落回 |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- A 微幅加码判例：原案 8px 抬升不可感，加码到 28px 才过——实战禁回调到 12px 以下，宁可不用不可用弱
-- A 一次只抬一张——两张同时离桌，观众找不到被点名的是谁（P4）
-- 声音：抬起轻吸/落回轻放（sound-design §4.5）
-
-## 参考实现
-demos/ui-entrance/element-body-moves/
-（ContactShadowLift.tsx：porcelain 斜俯拍桌面上三张 video-shotcraft 镜头配方卡「Pick your shot.」，扫—扫—选，选定卡是带标志的 Logo sting）
+---
+name: element-body-moves
+一句话: 元素身体感——contact-shadow-lift 接触阴影离面抬升：卡抬起时桌上的阴影同步放大变淡，纸片离桌被阴影证明
+适用: 给"位置在变"之外补"身体在变"：卡片点名给悬浮证据；配 2.5D 运镜与逐张点名
+时长: A 150f 5s
+能量: A 低中
+---
+
+## 意图
+库内运动卡全在管"位置在变"——飞入、滑动、弹跳，元素本身始终是刚体。
+这一式管**身体在变**：给悬浮一个可信的证据——卡抬起时正下方阴影同步放大变淡，
+纸片离桌，staging 法则给 2.5D 运镜垫的物理台词。与 CameraMotionBlur 的区别：
+快门拖影是相机的事，离面抬升是身体的事。
+
+## 选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A contact-shadow-lift | 斜俯拍桌面（rotateX 24°→20°）上卡沿法线 translateZ 96px + scale 1.05；阴影是躺在桌面 z=0 的两层独立实体（接触核 + 环境影），随抬升变大、变虚、变淡、向背光侧偏移；点名卡落回 8f in-cubic + 2f 微压卡壳，末张选定卡弹簧抬起后停在空中 | 逐张点名强调；2.5D 段落的离面铺垫 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 抬升幅度 | 2D：−28px + scale 1.08；2.5D 斜俯拍：translateZ 96px + scale 1.05（屏幕可见位移 40–50px） | 判例锁死：屏幕可见位移 <12px 禁用（见已知坑） |
+| A 阴影 | 独立 div（2D 用椭圆径向渐变；2.5D 用与卡同形的圆角矩形 + blur）：接触核 α 0.32→0.14、blur 3→25px；环境影 α 0.09→0.22、blur 14→54px、向右下偏移；卡本体不带外阴影 | box-shadow 跟卡走，给不出"影子留在桌上" |
+| A 落地 | scale 0.99 卡壳 2f 再 5f 回弹到 1 | 无微压读作飘落，没有重量 |
+| 收尾 | 末张选定后悬停 ~50f | 若要循环，把末张改成同样落回 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- A 微幅加码判例：原案 8px 抬升不可感，加码到 28px 才过——实战禁回调到 12px 以下，宁可不用不可用弱
+- A 一次只抬一张——两张同时离桌，观众找不到被点名的是谁（P4）
+- 声音：抬起轻吸/落回轻放（sound-design §4.5）
+
+## 参考实现
+demos/ui-entrance/element-body-moves/
+（ContactShadowLift.tsx：porcelain 斜俯拍桌面上三张 video-shotcraft 镜头配方卡「Pick your shot.」，扫—扫—选，选定卡是带标志的 Logo sting）

package/lib/motion/shotcraft/upstream/references/shots/ui-entrance/integration-hub-map.md

@@ -1,55 +1,55 @@
----
-name: integration-hub-map
-一句话: 旧页面一次性快翻 180°（侧棱瞬间亮闪）落成新中枢页，五个集成 app 图标同帧弹现、随即五条彩虹光管同帧齐连，光管内输送脉冲持续流动——"翻开新一页，生态一齐接入"
-适用: 集成/生态能力段（一个产品连一切）；版本翻新叙事（旧页翻成新页）；暗场霓虹调性的功能高潮
-时长: 前摇 ~0.5s + 快翻 ~1.2s + 图标齐现 → 光管齐连两拍 ~0.7s + 输送呼吸 ≥1.5s；全段 4.5–5s
-能量: 中高（翻面是爆点，输送段是余韵）
-标签: effects
----
-
-## 意图
-翻面是"换时代"：旧文档页整个翻转 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/ui-entrance/integration-hub-map/
-（IntegrationHubMap.tsx）
-原片出处：clickup-30.mp4
+---
+name: integration-hub-map
+一句话: 旧页面一次性快翻 180°（侧棱瞬间亮闪）落成新中枢页，五个集成 app 图标同帧弹现、随即五条彩虹光管同帧齐连，光管内输送脉冲持续流动——"翻开新一页，生态一齐接入"
+适用: 集成/生态能力段（一个产品连一切）；版本翻新叙事（旧页翻成新页）；暗场霓虹调性的功能高潮
+时长: 前摇 ~0.5s + 快翻 ~1.2s + 图标齐现 → 光管齐连两拍 ~0.7s + 输送呼吸 ≥1.5s；全段 4.5–5s
+能量: 中高（翻面是爆点，输送段是余韵）
+标签: effects
+---
+
+## 意图
+翻面是"换时代"：旧文档页整个翻转 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/ui-entrance/integration-hub-map/
+（IntegrationHubMap.tsx）
+原片出处：clickup-30.mp4

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

@@ -1,50 +1,50 @@
----
-name: list-reveal
-一句话: 垂直菜单 6 项按 10f 的间隔依次 scale 找位、软 back 轻微过冲落定，同时整个列表容器全程匀速上移——逐项入场与整体漂移是两层不相干的运动
-适用: 导航/侧边栏/设置面板的入场；任何"界面自己长出来"的 UI 段落，也适合做旁白铺垫时的低能量底
-时长: 约 4s（120f@30fps）
-能量: 低（稳定节拍，无峰值；靠漂移维持画面不死）
----
-
-## 意图
-列表逐项淡入是最容易做得死板的一类动效：每项动完就停，画面在两项之间是完全静止的。
-这张卡的解法是给容器加一层与逐项入场无关的慢速漂移——局部在"找位"，整体在"呼吸"。
-观众读得清每一项，同时画面从头到尾没有一帧是钉死的。
-
-## 动效核心
-- 两层运动完全解耦：容器 `translateY(DRIFT/2 − DRIFT·f/(N−1))` 只吃全局帧，是贯穿全片的匀速漂移
-  （demo：1920 坐标下总 96px，+48 → −48，≈0.8px/f）；每项只吃自己的局部窗口，互不参与对方的计算
-- 逐项入场：起点 `2 + i·10f`、窗口 24f，stagger 10f 比常规 UI stagger 慢一档——这是"读得完"的间隔，
-  不是"快速铺开"的间隔；窗口是 stagger 的 2.4 倍 → 相邻 2–3 项同时在动，队列连绵
-- 找位动作是 scale 主导：`scale(0.82 → 1)` 配 `translateY(44 → 0)` + 对焦模糊 8px → 0，
-  观众感知到的是"从虚到实、从小长到位"，而不是"从下面飞上来"
-- 软过冲 `bezier(0.3, 1.18, 0.5, 1)`（~1.5%）——量很小，作用是把落位那一帧从"停"变成"扣住"
-- 跟随：图标晚 2f、右侧快捷键 / 徽章晚 4f 落定；透明度 `min(1, lin·2.2)`，行程 45% 就已全实
-- 当前项（Home）是全片唯一的高亮：瓷白实心条 + 落位后一次扫光（Q4）；其余项为深石墨面 + 发丝线
-
-## 参数表（demo 为 1920×1080 原生坐标）
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 项数 | 6（Home…Sign out） | 末项 52f 起、76f 落定，尾部留 ~44f 给观众收尾；>8 项必须压 stagger，否则末项吃到收尾 |
-| stagger | 10f/项 | 10f 是"逐项读得完"；压到 4f 变成一次铺开（另一种手法），拉到 16f 以上节拍会散 |
-| 单项窗口 | 24f | 窗口比 stagger 长 2.4 倍 → 相邻项重叠；两者相等会变成一项一项硬接 |
-| 起始 scale | 0.82 | "已经能认出是个条目"的尺度；<0.5 读作从零弹出，和 pop 类手法混淆 |
-| 起始位移 / 模糊 | 44px / 8px | 位移必须小于行距（92px 行高 + 14px 间距），否则项与项之间穿插 |
-| 过冲 | 软 back ~1.5% | 要小到几乎读不出来；换 spring 或加大过冲，6 项连续抖会显得廉价 |
-| 容器漂移 | 全程匀速 96px（≈0.8px/f） | 总量是单项位移的 2 倍、速度慢一个数量级——读作"画面在呼吸"；速度接近单项入场速度时两层运动混为一件事 |
-| 透明度斜率 | `min(1, lin·2.2)` | 降到 1 会看到半透明项叠在背景上，暗场下尤其脏 |
-
-## 已知坑
-- 容器漂移是匀速且贯穿全程，末帧停在 −48px 而不是 0——这个动效**末帧不回位**。
-  要循环播放或与后一镜对齐位置，得把漂移换成收束曲线，或在末段补一个反向缓收
-- 项数变化必须重算 stagger：末项起点 `2 + (n−1)·10f`，再加 24f 窗口，要给收尾留 ≥30f
-- 行宽 700px、标签 `nowrap`——中文或更长的英文标签会顶到右侧快捷键，换文案要同步加宽；
-  列表总高 ~644px，加项前先算漂移后首末项是否仍在安全区内（demo 漂移范围 y 188–928）
-- 漂移方向（向上）与逐项位移方向（44px→0，也是向上）同向。这是有意的（同向叠加更顺），
-  但两者速度量级必须保持一个数量级差距，否则读作"一起往上飘"而非两层
-- 右侧标题要等列表铺到一半（46f）才进：开场只给列表一个主角（Q5），不然观众在两处之间来回找
-- 图标是单色线性图标，只有当前项用实心高亮、未读徽章用点缀色；浅色界面下描边和阴影都要重调
-
-## 参考实现
-demos/ui-entrance/list-reveal/
-（ListReveal.tsx：graphite 暗场，左列表 + 右侧 120px 标题的侧边栏海报）
+---
+name: list-reveal
+一句话: 垂直菜单 6 项按 10f 的间隔依次 scale 找位、软 back 轻微过冲落定，同时整个列表容器全程匀速上移——逐项入场与整体漂移是两层不相干的运动
+适用: 导航/侧边栏/设置面板的入场；任何"界面自己长出来"的 UI 段落，也适合做旁白铺垫时的低能量底
+时长: 约 4s（120f@30fps）
+能量: 低（稳定节拍，无峰值；靠漂移维持画面不死）
+---
+
+## 意图
+列表逐项淡入是最容易做得死板的一类动效：每项动完就停，画面在两项之间是完全静止的。
+这张卡的解法是给容器加一层与逐项入场无关的慢速漂移——局部在"找位"，整体在"呼吸"。
+观众读得清每一项，同时画面从头到尾没有一帧是钉死的。
+
+## 动效核心
+- 两层运动完全解耦：容器 `translateY(DRIFT/2 − DRIFT·f/(N−1))` 只吃全局帧，是贯穿全片的匀速漂移
+  （demo：1920 坐标下总 96px，+48 → −48，≈0.8px/f）；每项只吃自己的局部窗口，互不参与对方的计算
+- 逐项入场：起点 `2 + i·10f`、窗口 24f，stagger 10f 比常规 UI stagger 慢一档——这是"读得完"的间隔，
+  不是"快速铺开"的间隔；窗口是 stagger 的 2.4 倍 → 相邻 2–3 项同时在动，队列连绵
+- 找位动作是 scale 主导：`scale(0.82 → 1)` 配 `translateY(44 → 0)` + 对焦模糊 8px → 0，
+  观众感知到的是"从虚到实、从小长到位"，而不是"从下面飞上来"
+- 软过冲 `bezier(0.3, 1.18, 0.5, 1)`（~1.5%）——量很小，作用是把落位那一帧从"停"变成"扣住"
+- 跟随：图标晚 2f、右侧快捷键 / 徽章晚 4f 落定；透明度 `min(1, lin·2.2)`，行程 45% 就已全实
+- 当前项（Home）是全片唯一的高亮：瓷白实心条 + 落位后一次扫光（Q4）；其余项为深石墨面 + 发丝线
+
+## 参数表（demo 为 1920×1080 原生坐标）
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 项数 | 6（Home…Sign out） | 末项 52f 起、76f 落定，尾部留 ~44f 给观众收尾；>8 项必须压 stagger，否则末项吃到收尾 |
+| stagger | 10f/项 | 10f 是"逐项读得完"；压到 4f 变成一次铺开（另一种手法），拉到 16f 以上节拍会散 |
+| 单项窗口 | 24f | 窗口比 stagger 长 2.4 倍 → 相邻项重叠；两者相等会变成一项一项硬接 |
+| 起始 scale | 0.82 | "已经能认出是个条目"的尺度；<0.5 读作从零弹出，和 pop 类手法混淆 |
+| 起始位移 / 模糊 | 44px / 8px | 位移必须小于行距（92px 行高 + 14px 间距），否则项与项之间穿插 |
+| 过冲 | 软 back ~1.5% | 要小到几乎读不出来；换 spring 或加大过冲，6 项连续抖会显得廉价 |
+| 容器漂移 | 全程匀速 96px（≈0.8px/f） | 总量是单项位移的 2 倍、速度慢一个数量级——读作"画面在呼吸"；速度接近单项入场速度时两层运动混为一件事 |
+| 透明度斜率 | `min(1, lin·2.2)` | 降到 1 会看到半透明项叠在背景上，暗场下尤其脏 |
+
+## 已知坑
+- 容器漂移是匀速且贯穿全程，末帧停在 −48px 而不是 0——这个动效**末帧不回位**。
+  要循环播放或与后一镜对齐位置，得把漂移换成收束曲线，或在末段补一个反向缓收
+- 项数变化必须重算 stagger：末项起点 `2 + (n−1)·10f`，再加 24f 窗口，要给收尾留 ≥30f
+- 行宽 700px、标签 `nowrap`——中文或更长的英文标签会顶到右侧快捷键，换文案要同步加宽；
+  列表总高 ~644px，加项前先算漂移后首末项是否仍在安全区内（demo 漂移范围 y 188–928）
+- 漂移方向（向上）与逐项位移方向（44px→0，也是向上）同向。这是有意的（同向叠加更顺），
+  但两者速度量级必须保持一个数量级差距，否则读作"一起往上飘"而非两层
+- 右侧标题要等列表铺到一半（46f）才进：开场只给列表一个主角（Q5），不然观众在两处之间来回找
+- 图标是单色线性图标，只有当前项用实心高亮、未读徽章用点缀色；浅色界面下描边和阴影都要重调
+
+## 参考实现
+demos/ui-entrance/list-reveal/
+（ListReveal.tsx：graphite 暗场，左列表 + 右侧 120px 标题的侧边栏海报）