dsh-drawai 0.4.2 → 0.4.4

package/lib/motion/shotcraft/upstream/references/shots/typography/glitch-cycle.md

@@ -1,64 +1,64 @@
----
-name: glitch-cycle
-一句话: 同一行等宽槽位循环轮播 4 条状态短语，每条头尾按概率关键帧 [1,0,0,0.1,0,0,1] 全乱码、中段偶发单字抖动，切换瞬间叠 RGB 分离与整行位移；末条概率收 0 保证收尾干净
-适用: 加载/构建/部署过程的状态播报；技术型片头的"系统自述"；需要机器口吻推进时间的一段垫底
-时长: 约 5.6s（168f@30fps；demo 每条短语 38f，末条延续到片尾作收尾 hold）
-能量: 中高（持续的高频噪声脉冲，切换点是峰值）
----
-
-## 意图
-状态播报最笨的做法是四行字逐条淡入。轮播把它们压进**一个槽位**：
-短语头尾用乱码"熔断"再"凝固"，中段几乎干净只偶尔抽一下——观众读到的
-是"系统在一步步推进"，而不是四条独立文案。乱码浓度是这卡的语法：
-浓 = 正在切换，淡 = 正在这一状态里。底部进度条把四拍串成一条时间线，
-最后一条把概率收到 0，落定即结束。
-
-## 动效核心
-- 槽位按最长短语预建 `MAXCH` 个 span（`min-width:0.66em` 固定槽宽），
-  短短语左右对称填空格（行居中）——**字符不增删，只换内容**，整行永不重排
-- 时段等分：`slot = floor(frame / SLOT)`，短语内进度 `p = (frame - slot·SLOT)/SLOT`（demo SLOT=38f；
-  末条按同一 38f 走 `KF_LAST` 后保持干净直到片尾，留出 ~28f 收尾）
-- glitch 概率关键帧 `KF=[1,0,0,0.1,0,0,1]` 按 p 线性插值：**开头 1.0 全乱、
-  中段 0、约 p=0.5 处回弹到 0.1（偶发抽字）、结尾又回 1.0 熔进下一条**
-- 末条专用 `KF_LAST=[1,0,0,0.1,0,0,0]`，结尾概率归零 → t=1 画面干净
-- 逐字符判定：`rand(i·31 + bucket·17 + slot·97) < g` 才替换成字池字符，
-  命中字随机上强调点缀色或暗色（demo aurora：粉 / 暗紫）；`bucket = floor(frame/2)`，
-  即每 2 帧重掷一次
-- 整行抖动与 RGB 分离强度全部乘 g（480 设计坐标值；demo 原生 1920、短语 104px）：`jx = ±g·10`px
-  （demo ±g·36）、`jy = ±g·4`px（demo ±g·10），`text-shadow` 左右各偏 `g·3`px（demo 粉 / 冰蓝各 g·10，
-  g>0.04 才开）——**噪声浓度一个变量同时驱动换字、位移、色散**，所以三者永不打架；g>0.25 时同一个 g
-  再驱动一条水平撕裂带（行切三段、中段横移，带高每 2 帧重掷），g>0.45 时再叠 3 块像素块残影
-- demo 版式：上方状态行（脉冲点 + RENDERING · 工程名 · 渲染号）、槽位四角细括号、下方 1100px 进度轨
-  线性走满（与四拍无关地铺底，三根四拍刻度 + 发光头）+ `STEP n/4` / 百分比（tabular-nums）；
-  末条收干净时给一次柔和泛光（只给主角一次），进度满后状态转 RENDERED、点转实心，再升起一行强调色署名（video-shotcraft 标志 + 品牌名）
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 短语表 | 4 条，最长 17 字符（demo `LOCKING BEAT GRID`） | 每条 42f 是"读得完一个状态"的下限；5 条以上单条不足 34f 观众只看到闪 |
-| 概率关键帧 | `[1,0,0,0.1,0,0,1]`（6 段） | 中间那个 0.1 是"活着"的证据，删了短语中段死板；把 0 段调到 0.3+ 全片糊成故障 |
-| 重掷频率 | 每 2 帧（`floor(frame/2)`） | 1 帧一换糊成灰带；4 帧以上乱码看得清是"另一个词"，不像噪声 |
-| 抖动幅度 | `x ±g·10` / `y ±g·4`px（480 坐标；1920 原生约 ×3.6） | x 大于 y 是横向撕裂的关键（等比抖动读作地震）；超过 ~2 个字宽整行跳出槽位 |
-| RGB 分离 | 左红右青各 `g·3`px，阈值 g>0.04 | 这是"电子故障"的身份证；无阈值时中段那 0.1 的概率会让字常年带毛边 |
-| 槽宽字体 | SF Mono 26px（480 坐标；demo 原生 104px）、槽 `0.64–0.66em` | 等宽 + 固定槽宽是刚需；字距 3px 让乱码之间有呼吸，挤在一起读作乱码块 |
-| 进度条 | 150×2px（demo 原生 1100×4px），强调色渐变填充，线性 + 四拍刻度 | 唯一的线性元素，给四拍噪声一个稳定参照；删了轮播读不出"在推进" |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- **换项目文案时四条短语字符数要接近（demo 12–17 字符）**：槽位数按最长
-  短语一次建好，短短语靠右填空格——如果一条只有 4 字符、另一条 30 字符，
-  短的那条在 30 格里孤零零居左，行宽全程被最长条撑着，节奏读作漂移
-- 概率关键帧是 6 段等分映射到短语内进度：短语条数变了单条时长跟着变，
-  但关键帧形状不变——所以条数越多，"全乱码"那两段的绝对时长越短，
-  切换感越弱，超过 5 条就该把首尾的 1.0 段拉宽
-- 末条必须用 `KF_LAST`（结尾收 0）：用普通 KF 会让 t=1 停在满乱码上，
-  接下一镜时读作没渲染完
-- 深底专用：深色底 + 冷/艳色噪声是整套配色的地基（demo 用 aurora 深紫黑 + 粉 / 冰蓝分离），浅底上 RGB 分离
-  几乎不可见；声音也强依赖——四个切换点天然是四个节奏点，实战必须配
-  电子故障/开关音；
-  配法纪律见 sound-design.md（同类元素同音，连发交替双样本防机枪感）
-
-## 参考实现
-demos/typography/glitch-cycle/
-（GlitchCycle.tsx）
+---
+name: glitch-cycle
+一句话: 同一行等宽槽位循环轮播 4 条状态短语，每条头尾按概率关键帧 [1,0,0,0.1,0,0,1] 全乱码、中段偶发单字抖动，切换瞬间叠 RGB 分离与整行位移；末条概率收 0 保证收尾干净
+适用: 加载/构建/部署过程的状态播报；技术型片头的"系统自述"；需要机器口吻推进时间的一段垫底
+时长: 约 5.6s（168f@30fps；demo 每条短语 38f，末条延续到片尾作收尾 hold）
+能量: 中高（持续的高频噪声脉冲，切换点是峰值）
+---
+
+## 意图
+状态播报最笨的做法是四行字逐条淡入。轮播把它们压进**一个槽位**：
+短语头尾用乱码"熔断"再"凝固"，中段几乎干净只偶尔抽一下——观众读到的
+是"系统在一步步推进"，而不是四条独立文案。乱码浓度是这卡的语法：
+浓 = 正在切换，淡 = 正在这一状态里。底部进度条把四拍串成一条时间线，
+最后一条把概率收到 0，落定即结束。
+
+## 动效核心
+- 槽位按最长短语预建 `MAXCH` 个 span（`min-width:0.66em` 固定槽宽），
+  短短语左右对称填空格（行居中）——**字符不增删，只换内容**，整行永不重排
+- 时段等分：`slot = floor(frame / SLOT)`，短语内进度 `p = (frame - slot·SLOT)/SLOT`（demo SLOT=38f；
+  末条按同一 38f 走 `KF_LAST` 后保持干净直到片尾，留出 ~28f 收尾）
+- glitch 概率关键帧 `KF=[1,0,0,0.1,0,0,1]` 按 p 线性插值：**开头 1.0 全乱、
+  中段 0、约 p=0.5 处回弹到 0.1（偶发抽字）、结尾又回 1.0 熔进下一条**
+- 末条专用 `KF_LAST=[1,0,0,0.1,0,0,0]`，结尾概率归零 → t=1 画面干净
+- 逐字符判定：`rand(i·31 + bucket·17 + slot·97) < g` 才替换成字池字符，
+  命中字随机上强调点缀色或暗色（demo aurora：粉 / 暗紫）；`bucket = floor(frame/2)`，
+  即每 2 帧重掷一次
+- 整行抖动与 RGB 分离强度全部乘 g（480 设计坐标值；demo 原生 1920、短语 104px）：`jx = ±g·10`px
+  （demo ±g·36）、`jy = ±g·4`px（demo ±g·10），`text-shadow` 左右各偏 `g·3`px（demo 粉 / 冰蓝各 g·10，
+  g>0.04 才开）——**噪声浓度一个变量同时驱动换字、位移、色散**，所以三者永不打架；g>0.25 时同一个 g
+  再驱动一条水平撕裂带（行切三段、中段横移，带高每 2 帧重掷），g>0.45 时再叠 3 块像素块残影
+- demo 版式：上方状态行（脉冲点 + RENDERING · 工程名 · 渲染号）、槽位四角细括号、下方 1100px 进度轨
+  线性走满（与四拍无关地铺底，三根四拍刻度 + 发光头）+ `STEP n/4` / 百分比（tabular-nums）；
+  末条收干净时给一次柔和泛光（只给主角一次），进度满后状态转 RENDERED、点转实心，再升起一行强调色署名（video-shotcraft 标志 + 品牌名）
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 短语表 | 4 条，最长 17 字符（demo `LOCKING BEAT GRID`） | 每条 42f 是"读得完一个状态"的下限；5 条以上单条不足 34f 观众只看到闪 |
+| 概率关键帧 | `[1,0,0,0.1,0,0,1]`（6 段） | 中间那个 0.1 是"活着"的证据，删了短语中段死板；把 0 段调到 0.3+ 全片糊成故障 |
+| 重掷频率 | 每 2 帧（`floor(frame/2)`） | 1 帧一换糊成灰带；4 帧以上乱码看得清是"另一个词"，不像噪声 |
+| 抖动幅度 | `x ±g·10` / `y ±g·4`px（480 坐标；1920 原生约 ×3.6） | x 大于 y 是横向撕裂的关键（等比抖动读作地震）；超过 ~2 个字宽整行跳出槽位 |
+| RGB 分离 | 左红右青各 `g·3`px，阈值 g>0.04 | 这是"电子故障"的身份证；无阈值时中段那 0.1 的概率会让字常年带毛边 |
+| 槽宽字体 | SF Mono 26px（480 坐标；demo 原生 104px）、槽 `0.64–0.66em` | 等宽 + 固定槽宽是刚需；字距 3px 让乱码之间有呼吸，挤在一起读作乱码块 |
+| 进度条 | 150×2px（demo 原生 1100×4px），强调色渐变填充，线性 + 四拍刻度 | 唯一的线性元素，给四拍噪声一个稳定参照；删了轮播读不出"在推进" |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- **换项目文案时四条短语字符数要接近（demo 12–17 字符）**：槽位数按最长
+  短语一次建好，短短语靠右填空格——如果一条只有 4 字符、另一条 30 字符，
+  短的那条在 30 格里孤零零居左，行宽全程被最长条撑着，节奏读作漂移
+- 概率关键帧是 6 段等分映射到短语内进度：短语条数变了单条时长跟着变，
+  但关键帧形状不变——所以条数越多，"全乱码"那两段的绝对时长越短，
+  切换感越弱，超过 5 条就该把首尾的 1.0 段拉宽
+- 末条必须用 `KF_LAST`（结尾收 0）：用普通 KF 会让 t=1 停在满乱码上，
+  接下一镜时读作没渲染完
+- 深底专用：深色底 + 冷/艳色噪声是整套配色的地基（demo 用 aurora 深紫黑 + 粉 / 冰蓝分离），浅底上 RGB 分离
+  几乎不可见；声音也强依赖——四个切换点天然是四个节奏点，实战必须配
+  电子故障/开关音；
+  配法纪律见 sound-design.md（同类元素同音，连发交替双样本防机枪感）
+
+## 参考实现
+demos/typography/glitch-cycle/
+（GlitchCycle.tsx）

package/lib/motion/shotcraft/upstream/references/shots/typography/gradient-word-sweep.md

@@ -1,54 +1,54 @@
----
-name: gradient-word-sweep
-一句话: 黑底标语里关键词被渐变彩光从左到右快速扫过"充能"——波前字符辉光最强向后衰减，填满后字符间勾连细紫红闪电、整词稳态泛光呼吸
-适用: 标语里给单个动词/卖点词充能（Supercharged/faster/AI…）；能量高潮段的文字戏；黑场品牌片的口号帧
-时长: 扫充 ~15–20f（要快）+ 稳态闪电呼吸 1–2s；全段 2.5–3.5s
-能量: 高（一词爆点，前后都该让位）
-标签: effects
----
-
-## 意图
-整句白字里只有关键词被"通电"：渐变彩光从左到右快速扫过字符，
-像能量注入——扫过的瞬间最亮（波前尾迹），随后衰减到稳态；
-填满后字符之间跳起勾连的细闪电，词保持泛光呼吸。三个命门：
-**快**（扫充 15–20f，慢了读作进度条）、**波前最亮**（刚点亮的
-字符效果最强，没有这个梯度就是静态渐变裁切）、**辉光克制**
-（AE 式多层泛光但别糊成一团，闪电细而稀疏才是点缀）。
-
-## 动效核心
-- 渐变填充：关键词做双层文字（白/渐变彩），彩层用从左到右推进的
-  mask 揭开；斜切 mask 边缘略糊（~8% 词宽）
-- 波前尾迹增亮：跟随 mask 前沿一条 ~34% 词宽的增亮带，波前处
-  辉光最强、向后衰减；填充结束后 ~10f 淡出到稳态
-- 辉光：4 层泛光（环境大柔光+中晕+近核+亮核），稳态 opacity
-  0.55–0.72 档（实测：0.75–0.95 档被裁"泛光感有点强"）
-- 闪电：填满后字符间勾连细闪电，紫红系三层描边（外晕 6/中 2.4/
-  亮核 1.4），mulberry32 种子随机跳位闪烁，稀疏零星（不是持续电弧）
-- 禁：填充过程不带跟随移动的光点/星光（实测判例：跟随白色光点读作廉价装饰，删）
-- 带模糊的辉光层不能直接用文字盒做 mask/clip：模糊溢出盒外会被切成矩形"方框光"——
-  demo 把这些层放进四周外扩 90px 的盒子，mask 色标用 `calc(PAD + (100% − 2·PAD)·x)` 换算回文字坐标
-- demo 时长 `GRADIENT_WORD_SWEEP_DURATION = 105`（3.5s）：入场两行错峰 blur-slide，
-  12→30f 扫充，33f 起 7 次排期闪电（末次 ~92f 熄灭），整段极缓推近 1→1.025
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 扫充时长 | 15–20f | 原片"速度很快"；>28f 读作进度条 |
-| 波前增亮带 | ~34% 词宽，波前最亮向后衰减 | 无梯度＝静态渐变；带太宽＝整词一起亮没有"注入"感 |
-| 稳态泛光 | 4 层 opacity 0.55/0.55/0.62/0.72 | 0.75+ 档被裁太强；辉光层数<3 读作纯色 |
-| 闪电线宽 | 外 6/中 2.4/核 1.4 @1080p | 加倍即被裁"粗"；颜色偏紫红（magenta 216,60,190 系） |
-| 闪电频率 | 稀疏零星（同屏 ≤2 道，间歇 >8f；demo 排期 7 次、同屏 1 道、间隔 ≥4–11f） | 频率高读作电弧故障 |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 判例三条（用户逐字意见沉淀）：①填充过程禁跟随光点；②闪电
-  必须紫红+细；③泛光宁弱勿强，波前梯度补足冲击力
-- 与 type-rhythm-sync 分工：那张是节拍；
-  本卡是单词"充能"的能量语义，词必须是句中卖点词
-- 关键词外的正文保持纯白静止——全句都动就没有"只有它通电"的戏
-
-## 参考实现
-demos/typography/gradient-word-sweep/
-（GradientWordSweep.tsx）
-原片出处：clickup-30.mp4
+---
+name: gradient-word-sweep
+一句话: 黑底标语里关键词被渐变彩光从左到右快速扫过"充能"——波前字符辉光最强向后衰减，填满后字符间勾连细紫红闪电、整词稳态泛光呼吸
+适用: 标语里给单个动词/卖点词充能（Supercharged/faster/AI…）；能量高潮段的文字戏；黑场品牌片的口号帧
+时长: 扫充 ~15–20f（要快）+ 稳态闪电呼吸 1–2s；全段 2.5–3.5s
+能量: 高（一词爆点，前后都该让位）
+标签: effects
+---
+
+## 意图
+整句白字里只有关键词被"通电"：渐变彩光从左到右快速扫过字符，
+像能量注入——扫过的瞬间最亮（波前尾迹），随后衰减到稳态；
+填满后字符之间跳起勾连的细闪电，词保持泛光呼吸。三个命门：
+**快**（扫充 15–20f，慢了读作进度条）、**波前最亮**（刚点亮的
+字符效果最强，没有这个梯度就是静态渐变裁切）、**辉光克制**
+（AE 式多层泛光但别糊成一团，闪电细而稀疏才是点缀）。
+
+## 动效核心
+- 渐变填充：关键词做双层文字（白/渐变彩），彩层用从左到右推进的
+  mask 揭开；斜切 mask 边缘略糊（~8% 词宽）
+- 波前尾迹增亮：跟随 mask 前沿一条 ~34% 词宽的增亮带，波前处
+  辉光最强、向后衰减；填充结束后 ~10f 淡出到稳态
+- 辉光：4 层泛光（环境大柔光+中晕+近核+亮核），稳态 opacity
+  0.55–0.72 档（实测：0.75–0.95 档被裁"泛光感有点强"）
+- 闪电：填满后字符间勾连细闪电，紫红系三层描边（外晕 6/中 2.4/
+  亮核 1.4），mulberry32 种子随机跳位闪烁，稀疏零星（不是持续电弧）
+- 禁：填充过程不带跟随移动的光点/星光（实测判例：跟随白色光点读作廉价装饰，删）
+- 带模糊的辉光层不能直接用文字盒做 mask/clip：模糊溢出盒外会被切成矩形"方框光"——
+  demo 把这些层放进四周外扩 90px 的盒子，mask 色标用 `calc(PAD + (100% − 2·PAD)·x)` 换算回文字坐标
+- demo 时长 `GRADIENT_WORD_SWEEP_DURATION = 105`（3.5s）：入场两行错峰 blur-slide，
+  12→30f 扫充，33f 起 7 次排期闪电（末次 ~92f 熄灭），整段极缓推近 1→1.025
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 扫充时长 | 15–20f | 原片"速度很快"；>28f 读作进度条 |
+| 波前增亮带 | ~34% 词宽，波前最亮向后衰减 | 无梯度＝静态渐变；带太宽＝整词一起亮没有"注入"感 |
+| 稳态泛光 | 4 层 opacity 0.55/0.55/0.62/0.72 | 0.75+ 档被裁太强；辉光层数<3 读作纯色 |
+| 闪电线宽 | 外 6/中 2.4/核 1.4 @1080p | 加倍即被裁"粗"；颜色偏紫红（magenta 216,60,190 系） |
+| 闪电频率 | 稀疏零星（同屏 ≤2 道，间歇 >8f；demo 排期 7 次、同屏 1 道、间隔 ≥4–11f） | 频率高读作电弧故障 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 判例三条（用户逐字意见沉淀）：①填充过程禁跟随光点；②闪电
+  必须紫红+细；③泛光宁弱勿强，波前梯度补足冲击力
+- 与 type-rhythm-sync 分工：那张是节拍；
+  本卡是单词"充能"的能量语义，词必须是句中卖点词
+- 关键词外的正文保持纯白静止——全句都动就没有"只有它通电"的戏
+
+## 参考实现
+demos/typography/gradient-word-sweep/
+（GradientWordSweep.tsx）
+原片出处：clickup-30.mp4

package/lib/motion/shotcraft/upstream/references/shots/typography/lead-word-zoom-assemble.md

@@ -1,91 +1,91 @@
----
-name: lead-word-zoom-assemble
-一句话: 首词以 2.3 倍字号占据画面中央、hold 期间继续推近 6%，随后一条曲线同时完成「缩回终字号」与「整行左滑归位」，后续词各自从槽位右侧 0.5em 被推进来；支点横向钉首词中心、纵向钉基线（挂载时实测），整行上移的同一时窗副行浮出，停一拍后整幕 crash-zoom 推近失焦交棒
-适用: 品牌名/产品名的 Introducing 字卡；发布会式开场第二镜；一句话主张需要"先让一个词占满画面、再把整句补齐"的场合
-时长: 约 2.8s（84f@30fps；组句 f36 完成、上移与副行 f32–46、静止 26f、末 12f crash）
-能量: 中高（起手就是满画面的大字，但全程只有一次运动，没有二次冲击）
-标签: opening
----
-
-## 意图
-字卡最容易犯的错是"整句一起淡入"——观众同时收到 5 个词，一个都没记住。这张卡把
-阅读顺序做成**物理顺序**：先只给一个词，而且大到占满画面、还在继续朝观众推近，观众
-被迫先读它；然后这个词退回自己在句子里的尺寸和位置，整句围绕它长出来。落定时观众
-已经读过两遍主词。
-
-真正的手感命门不是缩放曲线，而是**支点**。首词从"画面正中"走到"行内第三个字符的
-位置"，如果支点取行盒中心，缩放和左滑会各自把字往两边拽，末尾几帧基线抖得肉眼可见。
-把 `transform-origin` 横向钉在首词中心、纵向钉在基线，这两点全程不动，整行就只是
-"收小"，没有任何漂移。
-
-## 动效核心
-- **两段缩放叠加成一条 scale**：
-  `scale = interpolate(f, [0,12], [2.3, 2.3·1.06], PUSH_EASE)
-         + interpolate(f, [12,24], [0, 1-2.3·1.06], ZOOM_EASE)`。
-  第一段是 hold 期间的推近（`cubic-bezier(.25,1,.5,1)`，减速后挂在峰值），第二段是缩回
-  （从峰值一路减到终字号 1）。写成相加而不是分段判断，两段之间没有速度断点
-- **缩回与左滑共用 ZOOM_EASE**（`cubic-bezier(.5,0,.05,1)`，重 ease-in-out、零回弹）：
-  `translate = interpolate(f, [12,36], [slideDistance, 0], ZOOM_EASE)`。两个动作必须读作
-  **一次**运动；各走各的曲线时会读成"先缩小、再滑走"两拍
-- **偏心距怎么来**：`slideDistance = lineWidth · (0.5 - leadRatio)`，`leadRatio` =
-  首词中心在整行里的占比。首词要停在画面正中，整行就得先向右偏这么多
-- **支点实测**：挂载时 `delayRender` 挂起渲染，量三个值——整行 `offsetWidth`、
-  首词 `offsetLeft + offsetWidth/2`、基线。基线用一个**零尺寸 inline-block 尺子**读出
-  （`<span style={{display:'inline-block',width:0,height:0}}>` 的 `offsetTop` 就是基线），
-  比 `lineHeight × 0.8` 之类的估算准得多。量到之后 `continueRender`，`transform-origin`
-  写成 `${leadRatio*100}% ${baseline}px`
-- **后续词是被推进来的，不是淡进来的**：第 i 词（i≥1）在
-  `pushStart = 12 + 6 + (i-1)·4` 起，`translate` 从 `0.5em → 0`
-  （`cubic-bezier(.22,.8,.36,1)`，起步快、落地长），透明度只用 2f 淡完。淡入必须极短，
-  否则词会"浮现"而不是"被塞进槽位"
-- **词间空格必须放在 inline-block 之外**。跟在词 span 内部尾随时会被行盒裁掉，
-  落定后所有词黏成一团（上游原组件的 bug，这里已修）
-- **场景层的三拍收尾**：f32–46 整行 `translateY 0→−56px`（outCubic），副行在**同一时窗**
-  淡入 + 上移 16px——上移让出的空间当帧被副行填掉，没有空当；f46–72 完全静止 26f；
-  f72–83 整幕 `scale 1→1.2` + `blur 0→9px` + `opacity 1→0.45`（ease-in-quad），推近失焦
-  交棒下一镜
-- **质感（demo）**：首词入场 6f 内带 8px→0 失焦；缩回段按 scale 速度给瞬时失焦（≤3.5px，停稳归零）；
-  底为靛蓝主光 + 一抹暖色余光的低对比 mesh + 颗粒 + 暗角
-- **强调词**：精确匹配某个词换强调色（demo 里是品牌名 `video-shotcraft`）。品牌词推入落位那一下自带
-  高亮，不用再加第二个动作
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 首词起手倍数 | initialScale 2.3 | 2.3 让首词横向溢出画面一点点（读作"太大了装不下"）；<1.8 只是"稍大的字"，冲击消失 |
-| 推近 | pushScale 1.06，占满 hold 12f | 6% 是"还在朝观众来"的最小可感量；>1.15 会在缩回时读作反向弹跳 |
-| hold | 12f | 首词独占画面的时长；<8f 观众读不完一个长单词，>20f 整句节奏塌 |
-| 缩回 | 12f，ZOOM_EASE | 与左滑同曲线；单独给缩回一条更快的曲线会让整行"先缩完再滑"，断成两拍 |
-| 左滑 | assembleDuration 24f | 比缩回长一倍：字号已经落定、位置还在走，这段"滑行尾巴"是电影感的来源 |
-| 后续词延迟 | wordDelay 6f（缩回起点之后） | 首词开始缩回才放后续词；同帧放会挤在一起看不清谁在动 |
-| 词间错峰 | wordStagger 4f | 4f 读作"依次被推进"；0 则整段后缀一起进，回到"整句淡入" |
-| 单词推入 | wordDuration 12f，wordPush 0.5em | 0.5em 是"刚从槽位外面"；>1em 会读作从画外飞入，与首词的收束方向打架 |
-| 词淡入 | wordFade 2f | 刻意极短。>6f 词会读作"浮现"，推入的力学感消失 |
-| 字号/字重/字距 | 96px / 600 / −0.03em | 负字距在放大 2.3 倍时才不会散架；正字距的大字会读作"标语横幅" |
-| 上移 + 副行 | f34–50，−56px，副行同窗 | 两件事必须同窗：先上移再出副行会多出一个空当拍 |
-| 静止 | 22f | 落定后的可读时间，低于 15f 观众来不及读副行 |
-| crash | 末 12f，scale→1.2，blur→9px | 这是转场的**前半**，动机要和下一镜的第一帧对上；单独播时看起来像"没结束"是正常的 |
-
-## 已知坑
-- **支点错了就抖基线**。`transform-origin` 必须是「首词中心 % + 基线 px」这一对。
-  取行盒中心（默认 `50% 50%`）时缩放与左滑互相拉扯，末尾几帧基线肉眼可见地跳
-- 基线别估算。`lineHeight × 0.8` 这类经验值在不同字体上差几像素，放大 2.3 倍后就是
-  十几像素的抖动。零尺寸 inline-block 尺子的 `offsetTop` 是唯一可靠的读法
-- `delayRender` 期间整行 `opacity: 0`——**必须**如此。否则未量到支点的第一帧会闪一下
-  错位的大字，成片里就是一帧脏帧
-- 布局是挂载时实测的，所以**结果随渲染环境的字体而变**：跨平台字体回退不同时整行宽度
-  会整体漂移（首词占比也跟着变）。介意的话把量到的三个值写死成常量
-- `scale` / `translate` 用的是独立 CSS 属性（不是 `transform` 简写）。混用会让其中一个
-  被覆盖；要合并成 `transform` 就必须自己保证 `translate → scale` 的顺序
-- 词间空格放进词 span 内部会被行盒裁掉（见上）。这个 bug 在小字号下不明显，96px 时
-  所有词会明显黏连
-- 首词必须是**短词**。"Introducing" 这类 10 字符左右刚好；首词超过 14 字符时 2.3 倍
-  放大会溢出画面两侧，观众读不到词尾
-- 强调色只给一个词。两个词都上色时观众不知道该记哪个，而且推入落位的高亮变成了
-  "彩色标题"，动作的意义被抹掉
-- 末段 crash 是转场的前半式，不是收尾。单独当片尾用会显得"断了"——要收尾就把
-  crash 换成静止 hold 或淡出
-
-## 参考实现
-demos/typography/lead-word-zoom-assemble/
-（LeadWordZoomAssemble.tsx）
+---
+name: lead-word-zoom-assemble
+一句话: 首词以 2.3 倍字号占据画面中央、hold 期间继续推近 6%，随后一条曲线同时完成「缩回终字号」与「整行左滑归位」，后续词各自从槽位右侧 0.5em 被推进来；支点横向钉首词中心、纵向钉基线（挂载时实测），整行上移的同一时窗副行浮出，停一拍后整幕 crash-zoom 推近失焦交棒
+适用: 品牌名/产品名的 Introducing 字卡；发布会式开场第二镜；一句话主张需要"先让一个词占满画面、再把整句补齐"的场合
+时长: 约 2.8s（84f@30fps；组句 f36 完成、上移与副行 f32–46、静止 26f、末 12f crash）
+能量: 中高（起手就是满画面的大字，但全程只有一次运动，没有二次冲击）
+标签: opening
+---
+
+## 意图
+字卡最容易犯的错是"整句一起淡入"——观众同时收到 5 个词，一个都没记住。这张卡把
+阅读顺序做成**物理顺序**：先只给一个词，而且大到占满画面、还在继续朝观众推近，观众
+被迫先读它；然后这个词退回自己在句子里的尺寸和位置，整句围绕它长出来。落定时观众
+已经读过两遍主词。
+
+真正的手感命门不是缩放曲线，而是**支点**。首词从"画面正中"走到"行内第三个字符的
+位置"，如果支点取行盒中心，缩放和左滑会各自把字往两边拽，末尾几帧基线抖得肉眼可见。
+把 `transform-origin` 横向钉在首词中心、纵向钉在基线，这两点全程不动，整行就只是
+"收小"，没有任何漂移。
+
+## 动效核心
+- **两段缩放叠加成一条 scale**：
+  `scale = interpolate(f, [0,12], [2.3, 2.3·1.06], PUSH_EASE)
+         + interpolate(f, [12,24], [0, 1-2.3·1.06], ZOOM_EASE)`。
+  第一段是 hold 期间的推近（`cubic-bezier(.25,1,.5,1)`，减速后挂在峰值），第二段是缩回
+  （从峰值一路减到终字号 1）。写成相加而不是分段判断，两段之间没有速度断点
+- **缩回与左滑共用 ZOOM_EASE**（`cubic-bezier(.5,0,.05,1)`，重 ease-in-out、零回弹）：
+  `translate = interpolate(f, [12,36], [slideDistance, 0], ZOOM_EASE)`。两个动作必须读作
+  **一次**运动；各走各的曲线时会读成"先缩小、再滑走"两拍
+- **偏心距怎么来**：`slideDistance = lineWidth · (0.5 - leadRatio)`，`leadRatio` =
+  首词中心在整行里的占比。首词要停在画面正中，整行就得先向右偏这么多
+- **支点实测**：挂载时 `delayRender` 挂起渲染，量三个值——整行 `offsetWidth`、
+  首词 `offsetLeft + offsetWidth/2`、基线。基线用一个**零尺寸 inline-block 尺子**读出
+  （`<span style={{display:'inline-block',width:0,height:0}}>` 的 `offsetTop` 就是基线），
+  比 `lineHeight × 0.8` 之类的估算准得多。量到之后 `continueRender`，`transform-origin`
+  写成 `${leadRatio*100}% ${baseline}px`
+- **后续词是被推进来的，不是淡进来的**：第 i 词（i≥1）在
+  `pushStart = 12 + 6 + (i-1)·4` 起，`translate` 从 `0.5em → 0`
+  （`cubic-bezier(.22,.8,.36,1)`，起步快、落地长），透明度只用 2f 淡完。淡入必须极短，
+  否则词会"浮现"而不是"被塞进槽位"
+- **词间空格必须放在 inline-block 之外**。跟在词 span 内部尾随时会被行盒裁掉，
+  落定后所有词黏成一团（上游原组件的 bug，这里已修）
+- **场景层的三拍收尾**：f32–46 整行 `translateY 0→−56px`（outCubic），副行在**同一时窗**
+  淡入 + 上移 16px——上移让出的空间当帧被副行填掉，没有空当；f46–72 完全静止 26f；
+  f72–83 整幕 `scale 1→1.2` + `blur 0→9px` + `opacity 1→0.45`（ease-in-quad），推近失焦
+  交棒下一镜
+- **质感（demo）**：首词入场 6f 内带 8px→0 失焦；缩回段按 scale 速度给瞬时失焦（≤3.5px，停稳归零）；
+  底为靛蓝主光 + 一抹暖色余光的低对比 mesh + 颗粒 + 暗角
+- **强调词**：精确匹配某个词换强调色（demo 里是品牌名 `video-shotcraft`）。品牌词推入落位那一下自带
+  高亮，不用再加第二个动作
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 首词起手倍数 | initialScale 2.3 | 2.3 让首词横向溢出画面一点点（读作"太大了装不下"）；<1.8 只是"稍大的字"，冲击消失 |
+| 推近 | pushScale 1.06，占满 hold 12f | 6% 是"还在朝观众来"的最小可感量；>1.15 会在缩回时读作反向弹跳 |
+| hold | 12f | 首词独占画面的时长；<8f 观众读不完一个长单词，>20f 整句节奏塌 |
+| 缩回 | 12f，ZOOM_EASE | 与左滑同曲线；单独给缩回一条更快的曲线会让整行"先缩完再滑"，断成两拍 |
+| 左滑 | assembleDuration 24f | 比缩回长一倍：字号已经落定、位置还在走，这段"滑行尾巴"是电影感的来源 |
+| 后续词延迟 | wordDelay 6f（缩回起点之后） | 首词开始缩回才放后续词；同帧放会挤在一起看不清谁在动 |
+| 词间错峰 | wordStagger 4f | 4f 读作"依次被推进"；0 则整段后缀一起进，回到"整句淡入" |
+| 单词推入 | wordDuration 12f，wordPush 0.5em | 0.5em 是"刚从槽位外面"；>1em 会读作从画外飞入，与首词的收束方向打架 |
+| 词淡入 | wordFade 2f | 刻意极短。>6f 词会读作"浮现"，推入的力学感消失 |
+| 字号/字重/字距 | 96px / 600 / −0.03em | 负字距在放大 2.3 倍时才不会散架；正字距的大字会读作"标语横幅" |
+| 上移 + 副行 | f34–50，−56px，副行同窗 | 两件事必须同窗：先上移再出副行会多出一个空当拍 |
+| 静止 | 22f | 落定后的可读时间，低于 15f 观众来不及读副行 |
+| crash | 末 12f，scale→1.2，blur→9px | 这是转场的**前半**，动机要和下一镜的第一帧对上；单独播时看起来像"没结束"是正常的 |
+
+## 已知坑
+- **支点错了就抖基线**。`transform-origin` 必须是「首词中心 % + 基线 px」这一对。
+  取行盒中心（默认 `50% 50%`）时缩放与左滑互相拉扯，末尾几帧基线肉眼可见地跳
+- 基线别估算。`lineHeight × 0.8` 这类经验值在不同字体上差几像素，放大 2.3 倍后就是
+  十几像素的抖动。零尺寸 inline-block 尺子的 `offsetTop` 是唯一可靠的读法
+- `delayRender` 期间整行 `opacity: 0`——**必须**如此。否则未量到支点的第一帧会闪一下
+  错位的大字，成片里就是一帧脏帧
+- 布局是挂载时实测的，所以**结果随渲染环境的字体而变**：跨平台字体回退不同时整行宽度
+  会整体漂移（首词占比也跟着变）。介意的话把量到的三个值写死成常量
+- `scale` / `translate` 用的是独立 CSS 属性（不是 `transform` 简写）。混用会让其中一个
+  被覆盖；要合并成 `transform` 就必须自己保证 `translate → scale` 的顺序
+- 词间空格放进词 span 内部会被行盒裁掉（见上）。这个 bug 在小字号下不明显，96px 时
+  所有词会明显黏连
+- 首词必须是**短词**。"Introducing" 这类 10 字符左右刚好；首词超过 14 字符时 2.3 倍
+  放大会溢出画面两侧，观众读不到词尾
+- 强调色只给一个词。两个词都上色时观众不知道该记哪个，而且推入落位的高亮变成了
+  "彩色标题"，动作的意义被抹掉
+- 末段 crash 是转场的前半式，不是收尾。单独当片尾用会显得"断了"——要收尾就把
+  crash 换成静止 hold 或淡出
+
+## 参考实现
+demos/typography/lead-word-zoom-assemble/
+（LeadWordZoomAssemble.tsx）

package/lib/motion/shotcraft/upstream/references/shots/typography/marker-underline-title.md

@@ -1,51 +1,51 @@
----
-name: marker-underline-title
-一句话: 大标题落定后，关键词下方马克笔下划线从左到右快速描画——变宽笔形、毛糙边缘、微上斜跟随斜体字势，贴着字底
-适用: 标题里强调单个关键词（new/free/AI…）；手写感/人味的品牌调性；正文标注式强调
-时长: 标题落定 +4~8f 后起笔，划线 8–12f，总 1–1.5s
-能量: 低（一笔点睛，不抢标题的戏）
----
-
-## 意图
-打印体标题里突然出现一笔手绘马克笔，用材质反差把一个词从
-排版里拎出来——像人拿笔在海报上圈重点。命门有三：**快**
-（8–12f 一笔呵成，慢了读作加载条）、**近**（贴着字底，离远了
-读作分隔线不是强调）、**跟字势**（斜体词的划线必须左低右高
-微上斜——斜向画反是最容易犯且一眼假的错，判例见已知坑）。
-
-## 动效核心
-- SVG path 描画（strokeDashoffset 或裁剪窗），从左到右 8–12f，
-  ease-out 微收尾（起笔快收笔略缓＝手劲）
-- 笔形：路径变宽（中段最宽）、边缘毛糙（轻微噪声扰动/粗糙笔刷
-  贴图），首尾略细＝起笔收笔
-- 位置：贴字底（bottom 偏移 ≈ -0.1em），中轴微上斜跟随斜体字势
-- 时机：标题完全落定后 +4~8f 起笔——划线是"看完标题后的强调"，
-  与标题同动就抢戏
-- 质感（demo）：笔画过一道确定性干笔滤镜——低频 feTurbulence 位移（1.8px）做毛糙边、
-  沿笔向拉长的高频噪声阈值做细碎飞白；墨色暖调近黑 multiply 进纸面
-- demo 导出 `MARKER_UNDERLINE_TITLE_DURATION = 75`：标题两行错峰 22f 落定 → f32–42 划线 → 静止 33f
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 划线时长 | 10f（原片实测节奏；14f 版被裁偏慢） | >14f 读作进度条；<6f 看不见笔迹方向 |
-| 字底距离 | ≈-0.1em（从 -40 收到 -20@1080p 才贴住字势） | 离远读作分隔线；碰到字底降部又乱 |
-| 斜向 | 左低右高微上斜（跟斜体） | **画反（左高右低）一眼假**——返工判例 |
-| 笔宽 | 中段 ~0.12em，首尾 ~0.6x | 等宽读作机器线；差异>2x 读作书法 |
-| 毛糙度 | 边缘轻噪声 | 太糙读作故障；全平滑读作 CSS border |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 与 draw-svg-trace 撞领域（有意单列为两卡）：那张是通用
-  SVG 描画（图标/插画/任意线稿）；本卡专做**文字强调**的马克笔
-  质感（变宽+毛糙+跟字势），做图形描画去用那张
-- 斜向判例：v1 左高右低被比对环节抓出——划线斜向必须跟字势，
-  正体字则水平微抖
-- 残余差距：原片（notion-ai）笔头飞白颗粒感更细碎，实战可加
-  更细的笔刷噪点
-
-## 参考实现
-demos/typography/marker-underline-title/
-（MarkerUnderlineTitle.tsx）
-原片出处：notion-ai.mp4
+---
+name: marker-underline-title
+一句话: 大标题落定后，关键词下方马克笔下划线从左到右快速描画——变宽笔形、毛糙边缘、微上斜跟随斜体字势，贴着字底
+适用: 标题里强调单个关键词（new/free/AI…）；手写感/人味的品牌调性；正文标注式强调
+时长: 标题落定 +4~8f 后起笔，划线 8–12f，总 1–1.5s
+能量: 低（一笔点睛，不抢标题的戏）
+---
+
+## 意图
+打印体标题里突然出现一笔手绘马克笔，用材质反差把一个词从
+排版里拎出来——像人拿笔在海报上圈重点。命门有三：**快**
+（8–12f 一笔呵成，慢了读作加载条）、**近**（贴着字底，离远了
+读作分隔线不是强调）、**跟字势**（斜体词的划线必须左低右高
+微上斜——斜向画反是最容易犯且一眼假的错，判例见已知坑）。
+
+## 动效核心
+- SVG path 描画（strokeDashoffset 或裁剪窗），从左到右 8–12f，
+  ease-out 微收尾（起笔快收笔略缓＝手劲）
+- 笔形：路径变宽（中段最宽）、边缘毛糙（轻微噪声扰动/粗糙笔刷
+  贴图），首尾略细＝起笔收笔
+- 位置：贴字底（bottom 偏移 ≈ -0.1em），中轴微上斜跟随斜体字势
+- 时机：标题完全落定后 +4~8f 起笔——划线是"看完标题后的强调"，
+  与标题同动就抢戏
+- 质感（demo）：笔画过一道确定性干笔滤镜——低频 feTurbulence 位移（1.8px）做毛糙边、
+  沿笔向拉长的高频噪声阈值做细碎飞白；墨色暖调近黑 multiply 进纸面
+- demo 导出 `MARKER_UNDERLINE_TITLE_DURATION = 75`：标题两行错峰 22f 落定 → f32–42 划线 → 静止 33f
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 划线时长 | 10f（原片实测节奏；14f 版被裁偏慢） | >14f 读作进度条；<6f 看不见笔迹方向 |
+| 字底距离 | ≈-0.1em（从 -40 收到 -20@1080p 才贴住字势） | 离远读作分隔线；碰到字底降部又乱 |
+| 斜向 | 左低右高微上斜（跟斜体） | **画反（左高右低）一眼假**——返工判例 |
+| 笔宽 | 中段 ~0.12em，首尾 ~0.6x | 等宽读作机器线；差异>2x 读作书法 |
+| 毛糙度 | 边缘轻噪声 | 太糙读作故障；全平滑读作 CSS border |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 与 draw-svg-trace 撞领域（有意单列为两卡）：那张是通用
+  SVG 描画（图标/插画/任意线稿）；本卡专做**文字强调**的马克笔
+  质感（变宽+毛糙+跟字势），做图形描画去用那张
+- 斜向判例：v1 左高右低被比对环节抓出——划线斜向必须跟字势，
+  正体字则水平微抖
+- 残余差距：原片（notion-ai）笔头飞白颗粒感更细碎，实战可加
+  更细的笔刷噪点
+
+## 参考实现
+demos/typography/marker-underline-title/
+（MarkerUnderlineTitle.tsx）
+原片出处：notion-ai.mp4