dsh-drawai 0.4.2 → 0.4.3

package/lib/motion/shotcraft/upstream/references/shots/rhythm/beat-step-list-theme-cycle.md

@@ -1,66 +1,66 @@
----
-name: beat-step-list-theme-cycle
-一句话: 三通道节拍器——深色场形容词列表逐拍上移一行，视口中央固定胶囊"接住"下一个词并换色，整场底色同拍跟换；行、色、场三通道锁死同一拍点
-适用: "同一产品多种气质/多主题展示"段落（modern/playful/expressive 式形容词连打）；全片节奏最密的一段；音乐段对拍
-时长: 铺垫 30f + 每拍 18f × 拍数 + 收尾 hold；4 拍约 4.7s（demo 140f）
-能量: 高（0.6s 一拍三通道齐跳，密度型高能）
-标签: typography
----
-
-## 意图
-换一次主题色是功能演示；0.6 秒换一次、连换三次、每次"选中行+胶囊色
-+全场底色"三件事同帧齐跳——就成了节拍器。用最便宜的变量切换做出
-全片最高的节奏密度。命门有二：一是**三通道必须锁同一拍点**，任何
-一通道慢半拍，"齐跳"退化成三个各自为政的动画；二是**跳与滑的分界**
-——跳变只占拍头 6f，其余 12f 完全静置，拍点要"跳"不要"滑"，
-匀速滚动的列表就只是列表。
-
-## 动效核心
-- 胶囊固定在视口中央行**不动**，列表 translateY 逐拍步进——视觉上
-  读作"胶囊跳到下一行接住新词"，实际动的是世界不是胶囊
-- 拍长 18f（0.6s @30fps ≈ 100BPM），跳变窗仅拍头 6f：
-  `snap(t) = 1-(1-x)^3.2`（陡 ease-out），其余帧静置
-- 三通道同源驱动：同一个 tInBeat 同时喂列表位移、胶囊/底色
-  rgb 逐通道 cross-mix、胶囊 squash——一个时钟，不许各挂各的曲线
-- 主题表逐拍换对（demo「Make it modern → playful → expressive → BOLD → yours.」：
-  骨白/深浓缩→橘/深梅→鸢尾紫/深靛→薄荷/深青→向日葵黄/深海军蓝），胶囊色与
-  底色是配好的深浅对，不是独立随机色；每个主题还带一套选中词字体（无衬线 / 圆体 /
-  衬线斜体 / 全大写 Futura），同拍换——换肤读作"多种气质"而不只是换色
-- 胶囊 = 透镜：胶囊外是统一暗白列表，胶囊里是同一列表的裁切副本（深色字 + 主题字体），
-  词越过胶囊边缘那一刻才换色换体；胶囊宽度 = 选中词实测字宽 + 边距，跟同一个 tInBeat 插值
-- 胶囊落位 squash：竖向 1.14→0.96→1、横向反相 0.97→1.01→1，随拍头 6f 走完；接住瞬间
-  胶囊提亮 + 同色辉光涨一下（指数 ~3f 收回）
-- 非选中词按离视口中心的行距衰减（相邻行 42% 白、每远一行 −15%，字号微缩、远行虚化）；
-  上下底色渐变羽化收视口——羽化色必须跟 bgColor 实时同步，写死颜色换场时穿帮
-- 元素层回声（可选）：角落主题计数 03/05、色票行挂同一个整数拍换态，不加任何整画面冲击
-- 开拍前 30f 静置铺垫——先让观众看清"这是个列表"，再开始打拍
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 拍长 | 18f（BEAT_LEN，改它即改 BPM 对音轨） | <12f 观众来不及读词只见闪色；>26f 拍感散成逐个展示 |
-| 跳变窗 | 拍头 6f，ease-out 指数 3.2 | 窗 >10f 或缓曲线，"跳"变"滑"，节拍器塌成滚动列表 |
-| 拍数 | 3–4 拍 | 5+ 拍观众适应了节奏开始走神；1–2 拍立不起"节拍器"人设 |
-| squash | 竖 1.14→0.96→1 / 横反相 0.97→1.01→1 | 去掉它胶囊像贴图换色；>1.2 弹跳抢了换色的戏 |
-| 底色跨度 | 相邻主题底色须同明度不同色相（都深色） | 明度跳变（深→浅）会读作闪屏而非换肤 |
-| 铺垫/收尾 | 前 30f 静置；末拍后 hold ≥30f | 没铺垫第一拍读作 bug；末拍即切没有"停在最终色"的确认 |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 与 theme-switch-moves 分工：那卡是单次换肤的仪式（扫场/涟漪，换一次
-  讲一次故事），本卡是连续多次换肤当节拍用——讲"深色模式功能"用那卡，
-  讲"多气质/多主题体量"用本卡
-- **声音强依赖**：拍点对齐鼓点（换 BEAT_LEN 对 BPM），无声版三通道
-  齐跳读作界面抽风
-- 词表长度 ≥ 拍数+2——列表底部要留未选中的词垫着，最后一拍就停在
-  列表末行会露出"下面没了"
-- 选中态别用"整数拍判定反白"：跳变 6f 里新词还在胶囊下方就先变黑，读作穿帮。
-  demo 用胶囊透镜（裁切副本）——字色 / 字体由几何边界决定，颜色仍跟 tInBeat 小数走
-- 胶囊宽度按选中词实测字宽写死（换字体 / 字号要重量），否则字贴边或胶囊半空
-- 主题字体用系统栈：Chrome 不认 `ui-rounded`，圆体走 Arial Rounded MT Bold，缺字体回落无衬线
-
-## 参考实现
-demos/rhythm/beat-step-list-theme-cycle/
-（BeatStepListThemeCycle.tsx）
-原片出处：bear-app 22.3–24.6s
+---
+name: beat-step-list-theme-cycle
+一句话: 三通道节拍器——深色场形容词列表逐拍上移一行，视口中央固定胶囊"接住"下一个词并换色，整场底色同拍跟换；行、色、场三通道锁死同一拍点
+适用: "同一产品多种气质/多主题展示"段落（modern/playful/expressive 式形容词连打）；全片节奏最密的一段；音乐段对拍
+时长: 铺垫 30f + 每拍 18f × 拍数 + 收尾 hold；4 拍约 4.7s（demo 140f）
+能量: 高（0.6s 一拍三通道齐跳，密度型高能）
+标签: typography
+---
+
+## 意图
+换一次主题色是功能演示；0.6 秒换一次、连换三次、每次"选中行+胶囊色
++全场底色"三件事同帧齐跳——就成了节拍器。用最便宜的变量切换做出
+全片最高的节奏密度。命门有二：一是**三通道必须锁同一拍点**，任何
+一通道慢半拍，"齐跳"退化成三个各自为政的动画；二是**跳与滑的分界**
+——跳变只占拍头 6f，其余 12f 完全静置，拍点要"跳"不要"滑"，
+匀速滚动的列表就只是列表。
+
+## 动效核心
+- 胶囊固定在视口中央行**不动**，列表 translateY 逐拍步进——视觉上
+  读作"胶囊跳到下一行接住新词"，实际动的是世界不是胶囊
+- 拍长 18f（0.6s @30fps ≈ 100BPM），跳变窗仅拍头 6f：
+  `snap(t) = 1-(1-x)^3.2`（陡 ease-out），其余帧静置
+- 三通道同源驱动：同一个 tInBeat 同时喂列表位移、胶囊/底色
+  rgb 逐通道 cross-mix、胶囊 squash——一个时钟，不许各挂各的曲线
+- 主题表逐拍换对（demo「Make it modern → playful → expressive → BOLD → yours.」：
+  骨白/深浓缩→橘/深梅→鸢尾紫/深靛→薄荷/深青→向日葵黄/深海军蓝），胶囊色与
+  底色是配好的深浅对，不是独立随机色；每个主题还带一套选中词字体（无衬线 / 圆体 /
+  衬线斜体 / 全大写 Futura），同拍换——换肤读作"多种气质"而不只是换色
+- 胶囊 = 透镜：胶囊外是统一暗白列表，胶囊里是同一列表的裁切副本（深色字 + 主题字体），
+  词越过胶囊边缘那一刻才换色换体；胶囊宽度 = 选中词实测字宽 + 边距，跟同一个 tInBeat 插值
+- 胶囊落位 squash：竖向 1.14→0.96→1、横向反相 0.97→1.01→1，随拍头 6f 走完；接住瞬间
+  胶囊提亮 + 同色辉光涨一下（指数 ~3f 收回）
+- 非选中词按离视口中心的行距衰减（相邻行 42% 白、每远一行 −15%，字号微缩、远行虚化）；
+  上下底色渐变羽化收视口——羽化色必须跟 bgColor 实时同步，写死颜色换场时穿帮
+- 元素层回声（可选）：角落主题计数 03/05、色票行挂同一个整数拍换态，不加任何整画面冲击
+- 开拍前 30f 静置铺垫——先让观众看清"这是个列表"，再开始打拍
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 拍长 | 18f（BEAT_LEN，改它即改 BPM 对音轨） | <12f 观众来不及读词只见闪色；>26f 拍感散成逐个展示 |
+| 跳变窗 | 拍头 6f，ease-out 指数 3.2 | 窗 >10f 或缓曲线，"跳"变"滑"，节拍器塌成滚动列表 |
+| 拍数 | 3–4 拍 | 5+ 拍观众适应了节奏开始走神；1–2 拍立不起"节拍器"人设 |
+| squash | 竖 1.14→0.96→1 / 横反相 0.97→1.01→1 | 去掉它胶囊像贴图换色；>1.2 弹跳抢了换色的戏 |
+| 底色跨度 | 相邻主题底色须同明度不同色相（都深色） | 明度跳变（深→浅）会读作闪屏而非换肤 |
+| 铺垫/收尾 | 前 30f 静置；末拍后 hold ≥30f | 没铺垫第一拍读作 bug；末拍即切没有"停在最终色"的确认 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 与 theme-switch-moves 分工：那卡是单次换肤的仪式（扫场/涟漪，换一次
+  讲一次故事），本卡是连续多次换肤当节拍用——讲"深色模式功能"用那卡，
+  讲"多气质/多主题体量"用本卡
+- **声音强依赖**：拍点对齐鼓点（换 BEAT_LEN 对 BPM），无声版三通道
+  齐跳读作界面抽风
+- 词表长度 ≥ 拍数+2——列表底部要留未选中的词垫着，最后一拍就停在
+  列表末行会露出"下面没了"
+- 选中态别用"整数拍判定反白"：跳变 6f 里新词还在胶囊下方就先变黑，读作穿帮。
+  demo 用胶囊透镜（裁切副本）——字色 / 字体由几何边界决定，颜色仍跟 tInBeat 小数走
+- 胶囊宽度按选中词实测字宽写死（换字体 / 字号要重量），否则字贴边或胶囊半空
+- 主题字体用系统栈：Chrome 不认 `ui-rounded`，圆体走 Arial Rounded MT Bold，缺字体回落无衬线
+
+## 参考实现
+demos/rhythm/beat-step-list-theme-cycle/
+（BeatStepListThemeCycle.tsx）
+原片出处：bear-app 22.3–24.6s

package/lib/motion/shotcraft/upstream/references/shots/rhythm/panel-grid-moves.md

@@ -1,43 +1,43 @@
----
-name: panel-grid-moves
-一句话: 分格节奏——comic-panel-split 漫画斜格劈出同一主体的三个机位，咔咔咔三格定格后末格斜边吃屏成海报
-适用: 把"格子"当节奏器：同主体多机位定格并列，逐格踩拍劈出；吃拍点
-时长: 156f ≈5.2s（全屏侧拍 20f + 三刀分格定格 + 吃屏 + 海报 hold）
-能量: 中高
-标签: ui-entrance
----
-
-## 意图
-与 wall-reveal-moves 的区别是本卡的定位锚：那是"整墙怎么入场"
-（一次性揭示），这是"格子怎么当节奏器"——分格发生在节拍上，格变即鼓点。
-A 是并：画面被三刀斜缝咔咔劈开，同一产品三种机位同时定格，
-停一拍后末格斜边扫过吃掉全屏——Scott Pilgrim 的分屏语言。
-适合单品多视角（demo：一支刻着 video-shotcraft 的定焦镜头，三格旁白框按
-「Shot 01 / 02 / 03」编号，吃屏后落成「Craft the shot.」海报）。
-
-## 选型
-| 式 | 做法 | 适用 |
-|----|------|------|
-| A comic-panel-split | 全屏 3/4 侧拍 20f → 三刀 12° 斜缝每 4f 一刀从上往下劈出，对应格硬切弹入（5f scale 1.07→1 + 白闪）；三格 = 同一主体的全身 / 局部特写 / 微距；定格 29f 靠主体自身动作保活；末格 2f 反向回拉 + 14f 扫屏吃掉全屏成海报 | 同一主体多视角并列；漫画感段落 |
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| A 斜缝 | SVG 双线：墨边 + 奶油纸芯（总宽 18px），12° 斜角，每刀 3f 从上往下画出 | 斜缝纸芯是漫画感命门；直缝读作分屏工具 |
-| A 保活 | 定格期主体自己在动：对焦环转 26°、光圈叶片收拢、全身格极缓推近 | 三格全静读作截图拼贴；"镜头在工作"比缓推更有内容 |
-| A 旁白框 | 奶油底 + 4px 墨描边 + 7px 硬投影，-2° 歪斜盖章弹入，活在格子里随格被盖掉 | 漫画语言的第二个锚点；浮在格子上方会穿帮 |
-| 收尾 | 最后一行字揭示完后 ~50f 海报 hold（只留 1.5% 极缓推近） | R1；摘罩帧与吞屏终值逐像素对齐防跳变 |
-
-## 已知坑
-- demo 在虚构内容（矢量镜头）上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 三格必须是**同一主体的不同机位**——三格塞不同内容读作 bento
-  排版不是漫画分格，语义就散了
-- 吃拍点、声音强依赖：逐格咔咔三声（sound-design §4.5）；不踩拍的分格只是布局动画
-- 主体用 SVG 矢量画（或高分辨率素材）：三格机位最高放大 2.45x，
-  位图截图放大会糊（Q2）
-- 同片分格系 ≤1 段——格子语言辨识度太强，两段就撞
-
-## 参考实现
-demos/rhythm/panel-grid-moves/
-（ComicPanelSplit.tsx）
+---
+name: panel-grid-moves
+一句话: 分格节奏——comic-panel-split 漫画斜格劈出同一主体的三个机位，咔咔咔三格定格后末格斜边吃屏成海报
+适用: 把"格子"当节奏器：同主体多机位定格并列，逐格踩拍劈出；吃拍点
+时长: 156f ≈5.2s（全屏侧拍 20f + 三刀分格定格 + 吃屏 + 海报 hold）
+能量: 中高
+标签: ui-entrance
+---
+
+## 意图
+与 wall-reveal-moves 的区别是本卡的定位锚：那是"整墙怎么入场"
+（一次性揭示），这是"格子怎么当节奏器"——分格发生在节拍上，格变即鼓点。
+A 是并：画面被三刀斜缝咔咔劈开，同一产品三种机位同时定格，
+停一拍后末格斜边扫过吃掉全屏——Scott Pilgrim 的分屏语言。
+适合单品多视角（demo：一支刻着 video-shotcraft 的定焦镜头，三格旁白框按
+「Shot 01 / 02 / 03」编号，吃屏后落成「Craft the shot.」海报）。
+
+## 选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A comic-panel-split | 全屏 3/4 侧拍 20f → 三刀 12° 斜缝每 4f 一刀从上往下劈出，对应格硬切弹入（5f scale 1.07→1 + 白闪）；三格 = 同一主体的全身 / 局部特写 / 微距；定格 29f 靠主体自身动作保活；末格 2f 反向回拉 + 14f 扫屏吃掉全屏成海报 | 同一主体多视角并列；漫画感段落 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 斜缝 | SVG 双线：墨边 + 奶油纸芯（总宽 18px），12° 斜角，每刀 3f 从上往下画出 | 斜缝纸芯是漫画感命门；直缝读作分屏工具 |
+| A 保活 | 定格期主体自己在动：对焦环转 26°、光圈叶片收拢、全身格极缓推近 | 三格全静读作截图拼贴；"镜头在工作"比缓推更有内容 |
+| A 旁白框 | 奶油底 + 4px 墨描边 + 7px 硬投影，-2° 歪斜盖章弹入，活在格子里随格被盖掉 | 漫画语言的第二个锚点；浮在格子上方会穿帮 |
+| 收尾 | 最后一行字揭示完后 ~50f 海报 hold（只留 1.5% 极缓推近） | R1；摘罩帧与吞屏终值逐像素对齐防跳变 |
+
+## 已知坑
+- demo 在虚构内容（矢量镜头）上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 三格必须是**同一主体的不同机位**——三格塞不同内容读作 bento
+  排版不是漫画分格，语义就散了
+- 吃拍点、声音强依赖：逐格咔咔三声（sound-design §4.5）；不踩拍的分格只是布局动画
+- 主体用 SVG 矢量画（或高分辨率素材）：三格机位最高放大 2.45x，
+  位图截图放大会糊（Q2）
+- 同片分格系 ≤1 段——格子语言辨识度太强，两段就撞
+
+## 参考实现
+demos/rhythm/panel-grid-moves/
+（ComicPanelSplit.tsx）

package/lib/motion/shotcraft/upstream/references/shots/rhythm/quad-split-parallel-scenes.md

@@ -1,38 +1,38 @@
----
-name: quad-split-parallel-scenes
-一句话: 画面硬切 2×2 四宫格，四个象限并行跑各自的微场景（打字、急推、逐词、交互链），关键节拍错开 3–6 帧制造信息轰炸
-适用: 节奏段"功能很多、同时发生"的蒙太奇拍；预告片中段的密度峰值
-时长: 90f（3s@30fps：0–62f 并行轰炸 + 28f 终态 hold，全程无转场）
-能量: 高（四线并行 + 错拍冲击，标准的 BGM 副歌位）
----
-
-## 意图
-用并行密度替代顺序展示：四件事同时在眼前发生，观众来不及逐一细读，但每 3–6 帧就有一个象限"动一下"——扫视节奏被牢牢钉住。这是手法卡：格内内容全部可替换，错拍编排才是配方。
-
-## 动效核心
-- 四象限独立场景（内容为示例：video-shotcraft 出一支宣传片时同时发生的四个现场）：TL 浏览器 tab 依次 overshoot 弹入 + 地址栏逐字打字 + 44f 页面载入大标题从下滑入 + 全程 inQuad 慢推 1→1.1；TR 终端命令打字 + 两行输出 + 末行出现同时 whip 急推 1→1.85（sin 包络 blur 5px，旧行退到 8%）；BL 三个 132px 大词逐个 overshoot 下落砸入；BR 审批卡滑入 → 光标贝塞尔飞向 Approve 点击 → 按钮变 Approved → 二段飞向 Publish 点击 → 上线通知弹出并计数
-- **错拍是灵魂**：TL tab 6/11/16/21、页面 44；TR 输出 27/33、急推 37；BL 词 14/30/49；BR 点击 25、变色 27、点击 52、通知 56——任意相邻重事件间隔 ≥3 帧，永远有东西在动但从不齐动
-- 两处打字光标闪烁周期错开（16 帧 vs 14 帧 +5 相位），避免同闪
-- 四格明度棋盘交错（ember：奶油 #f7eee4 / 暖黑 #160d09 / 橙实底 / 拿铁 #e9d7c4），8px 暖黑缝 + 20px 圆角分格；格内字按 1080p 重排（辅助 ≥32px、主词 132px）
-- 62f 后四格都停在终态（Launch film. / promo.mp4 ready / Prompt. Render. Ship. / Live · 3,214 views），拼成一张完整海报 hold 28f
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 错拍间隔 | 相邻重事件 3–6 帧 | <2 帧读作同拍（齐动=呆板）；>8 帧密度散掉，轰炸感消失 |
-| TL 慢推 | inQuad 1→1.1，origin 50% 90% | 全程缓慢加速的"底噪运动"，让静格也不静；过大窗口会顶到角标 |
-| TR 急推 | 37–47f，scale 1.85 + blur 峰值 5px，旧行淡到 8% | 这是全卡最重的一拍，压 BGM 重音；blur 包络必须 sin（进出对称）|
-| 打字速度 | TL 20 字符 / 0–40f，TR 19 字符 / 0–24f | 换文案保持字符数近似，否则打字节奏与其他象限错拍关系漂移 |
-| BR 交互链 | 滑入 4→巡游 14→点击 25→变色 27→二段巡游 38→点击 52→通知 56 | 环环相扣，改任何一步需顺延后续；通知 overshoot 弹出是链尾重音 |
-| 底色 | 浅 / 深 / 强调 / 浅 棋盘交错 | 换项目主题色时保持相邻格明度差 ≥15%，否则格线感消失 |
-| 收尾 | 62f 后终态 hold 28f | 并行轰炸后必须给一拍让四格同时被读到 |
-
-## 已知坑
-- 这是手法卡：四格内容整体可换（产品截图/录屏/其他动效卡），但**错拍表必须重排**——新内容的关键帧继承原时刻表，否则四格变四个独立视频拼贴
-- 轰炸段 ~2.1s 是密度上限，再拉长需给每象限加第二轮事件，否则后半段"没东西动"；收尾 hold 另算
-- 光标闪烁按帧号计算（周期 16f / 14f+5），改时间表后重新核对两个光标的错相位
-- 四格同时打字/同时弹入是最常见的退化写法——检查方式：逐帧过一遍，任何一帧不应有两个象限同时发生"重事件"
-
-## 参考实现
-demos/rhythm/quad-split-parallel-scenes/
-（QuadSplitParallelScenes.tsx）
+---
+name: quad-split-parallel-scenes
+一句话: 画面硬切 2×2 四宫格，四个象限并行跑各自的微场景（打字、急推、逐词、交互链），关键节拍错开 3–6 帧制造信息轰炸
+适用: 节奏段"功能很多、同时发生"的蒙太奇拍；预告片中段的密度峰值
+时长: 90f（3s@30fps：0–62f 并行轰炸 + 28f 终态 hold，全程无转场）
+能量: 高（四线并行 + 错拍冲击，标准的 BGM 副歌位）
+---
+
+## 意图
+用并行密度替代顺序展示：四件事同时在眼前发生，观众来不及逐一细读，但每 3–6 帧就有一个象限"动一下"——扫视节奏被牢牢钉住。这是手法卡：格内内容全部可替换，错拍编排才是配方。
+
+## 动效核心
+- 四象限独立场景（内容为示例：video-shotcraft 出一支宣传片时同时发生的四个现场）：TL 浏览器 tab 依次 overshoot 弹入 + 地址栏逐字打字 + 44f 页面载入大标题从下滑入 + 全程 inQuad 慢推 1→1.1；TR 终端命令打字 + 两行输出 + 末行出现同时 whip 急推 1→1.85（sin 包络 blur 5px，旧行退到 8%）；BL 三个 132px 大词逐个 overshoot 下落砸入；BR 审批卡滑入 → 光标贝塞尔飞向 Approve 点击 → 按钮变 Approved → 二段飞向 Publish 点击 → 上线通知弹出并计数
+- **错拍是灵魂**：TL tab 6/11/16/21、页面 44；TR 输出 27/33、急推 37；BL 词 14/30/49；BR 点击 25、变色 27、点击 52、通知 56——任意相邻重事件间隔 ≥3 帧，永远有东西在动但从不齐动
+- 两处打字光标闪烁周期错开（16 帧 vs 14 帧 +5 相位），避免同闪
+- 四格明度棋盘交错（ember：奶油 #f7eee4 / 暖黑 #160d09 / 橙实底 / 拿铁 #e9d7c4），8px 暖黑缝 + 20px 圆角分格；格内字按 1080p 重排（辅助 ≥32px、主词 132px）
+- 62f 后四格都停在终态（Launch film. / promo.mp4 ready / Prompt. Render. Ship. / Live · 3,214 views），拼成一张完整海报 hold 28f
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 错拍间隔 | 相邻重事件 3–6 帧 | <2 帧读作同拍（齐动=呆板）；>8 帧密度散掉，轰炸感消失 |
+| TL 慢推 | inQuad 1→1.1，origin 50% 90% | 全程缓慢加速的"底噪运动"，让静格也不静；过大窗口会顶到角标 |
+| TR 急推 | 37–47f，scale 1.85 + blur 峰值 5px，旧行淡到 8% | 这是全卡最重的一拍，压 BGM 重音；blur 包络必须 sin（进出对称）|
+| 打字速度 | TL 20 字符 / 0–40f，TR 19 字符 / 0–24f | 换文案保持字符数近似，否则打字节奏与其他象限错拍关系漂移 |
+| BR 交互链 | 滑入 4→巡游 14→点击 25→变色 27→二段巡游 38→点击 52→通知 56 | 环环相扣，改任何一步需顺延后续；通知 overshoot 弹出是链尾重音 |
+| 底色 | 浅 / 深 / 强调 / 浅 棋盘交错 | 换项目主题色时保持相邻格明度差 ≥15%，否则格线感消失 |
+| 收尾 | 62f 后终态 hold 28f | 并行轰炸后必须给一拍让四格同时被读到 |
+
+## 已知坑
+- 这是手法卡：四格内容整体可换（产品截图/录屏/其他动效卡），但**错拍表必须重排**——新内容的关键帧继承原时刻表，否则四格变四个独立视频拼贴
+- 轰炸段 ~2.1s 是密度上限，再拉长需给每象限加第二轮事件，否则后半段"没东西动"；收尾 hold 另算
+- 光标闪烁按帧号计算（周期 16f / 14f+5），改时间表后重新核对两个光标的错相位
+- 四格同时打字/同时弹入是最常见的退化写法——检查方式：逐帧过一遍，任何一帧不应有两个象限同时发生"重事件"
+
+## 参考实现
+demos/rhythm/quad-split-parallel-scenes/
+（QuadSplitParallelScenes.tsx）

package/lib/motion/shotcraft/upstream/references/shots/rhythm/rhythm-interrupt-moves.md

@@ -1,38 +1,38 @@
----
-name: rhythm-interrupt-moves
-一句话: 打断节奏——jump-cut-punch-in 三级跳切推近：同构图三次无补间硬跳放大，逐级逼近目标
-适用: 用"打断连续性"本身当节奏器：顿挫推近（A）；与 beat-cut-moves（切点排布）互补
-时长: A 135f ≈4.5s
-能量: A 中
----
-
-## 意图
-库内节奏卡管的都是"怎么切、切多密"；本卡管**怎么断**——观众预期
-连续，你偏打断，打断方式即表达：A 是空间断——同构图三次无补间跳大
-（1x→1.6x→2.6x），戈达尔跳切的顿挫，比连续推近更有"看这里、再近点、
-就是它"的指令感。适合强制聚焦指标。
-
-## 选型
-| 式 | 做法 | 适用 |
-|----|------|------|
-| A jump-cut-punch-in | transform-origin 钉目标中心，三档 scale 阶梯跳变（零补间），每跳 2f 加深脉冲当 tick | 逐级逼近核心指标；纪录片式盯住 |
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| A 跳挡 | 1.0→1.6→2.6，各 hold ≥35f | 挡差 <1.5× 读作画面抖了一下 |
-| A tick | 跳变帧起 2f brightness 0.92 全画面脉冲 | 无 tick 的跳切读作丢帧 |
-| 收尾 | 末挡 ≥45f 真静止 | 打断系事后 hold 从重给 |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 与 speed-ramp-freeze 都动"时间轴"，同一镜头只能有一个时间
-  操纵者
-- 三挡构图必须同 origin（钉死目标中心）——每挡重新构图就是
-  三个镜头，不是跳切
-- 声音强依赖：每跳一声 tick（sound-design §4.5）
-
-## 参考实现
-demos/rhythm/rhythm-interrupt-moves/
-（JumpCutPunchIn.tsx）
+---
+name: rhythm-interrupt-moves
+一句话: 打断节奏——jump-cut-punch-in 三级跳切推近：同构图三次无补间硬跳放大，逐级逼近目标
+适用: 用"打断连续性"本身当节奏器：顿挫推近（A）；与 beat-cut-moves（切点排布）互补
+时长: A 135f ≈4.5s
+能量: A 中
+---
+
+## 意图
+库内节奏卡管的都是"怎么切、切多密"；本卡管**怎么断**——观众预期
+连续，你偏打断，打断方式即表达：A 是空间断——同构图三次无补间跳大
+（1x→1.6x→2.6x），戈达尔跳切的顿挫，比连续推近更有"看这里、再近点、
+就是它"的指令感。适合强制聚焦指标。
+
+## 选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A jump-cut-punch-in | transform-origin 钉目标中心，三档 scale 阶梯跳变（零补间），每跳 2f 加深脉冲当 tick | 逐级逼近核心指标；纪录片式盯住 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 跳挡 | 1.0→1.6→2.6，各 hold ≥35f | 挡差 <1.5× 读作画面抖了一下 |
+| A tick | 跳变帧起 2f brightness 0.92 全画面脉冲 | 无 tick 的跳切读作丢帧 |
+| 收尾 | 末挡 ≥45f 真静止 | 打断系事后 hold 从重给 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 与 speed-ramp-freeze 都动"时间轴"，同一镜头只能有一个时间
+  操纵者
+- 三挡构图必须同 origin（钉死目标中心）——每挡重新构图就是
+  三个镜头，不是跳切
+- 声音强依赖：每跳一声 tick（sound-design §4.5）
+
+## 参考实现
+demos/rhythm/rhythm-interrupt-moves/
+（JumpCutPunchIn.tsx）

package/lib/motion/shotcraft/upstream/references/shots/rhythm/sakuga-timing-shift.md

@@ -1,56 +1,56 @@
----
-name: sakuga-timing-shift
-一句话: 一拍三转一拍一——元素先以每 3 帧一步的手翻书顿挫移动，高潮瞬间切成逐帧丝滑冲刺，帧率量化的突变本身就是看点
-适用: 单元素的强调性位移（卡片入场、指标冲线）；需要"手工感→高潮爆发"反差的段落
-时长: 150f（5s）
-能量: 中高
-标签: ui-entrance
----
-
-## 意图
-库内时间轴操纵已有 speed-ramp-freeze 的定格解冻与 hit-counter 的局部顿帧。
-本卡是另一种——**改的不是速度是帧率本身**：
-顿挫段驱动帧 q=floor(f/3)*3，元素每 3 帧才动一步（10fps 手翻书），
-切换帧起改用原始 f 逐帧驱动，丝滑冲刺。一拍三的钝与一拍一的滑
-同屏对切，日式作画的拍数演出（shooting on 3s / on 1s）。顿挫段
-不是低级感是手工感，切换点即高潮标记。
-
-## 动效核心
-- 顿挫段：q = Math.floor(f/3)*3 当驱动帧，位置线性 X 140→1180，
-  16 张原画、每步 ≈69px；姿势随 q 冻结：sin(q) rotate ±5° + 挤压/拉伸交替
-  （0.97/1.035）+ 一高一低小跳（−18/−2px），一步一个样
-- f48 切换：两帧「冲击帧」（画面反相成墨底 + 以卡片为焦点的集中线）当高潮标记，
-  之后改原始 f 连续驱动，Easing.out(poly(4)) 高初速冲刺折返中央 + 过冲 40px
-  + 6f 回弹，落地 scaleX 0.92 / scaleY 1.07 挤压
-- 冲刺段运动拉伸由位置差分速度驱动（scaleX 峰值 ≈1.3 / scaleY 0.9），
-  身后 9 条横向锥形墨色速度线、长度 ∝ 速度，**条件挂载**——速度低即摘除
-- 换拍标注三处同步：角标 "ON 3s / 3コマ打ち"→"ON 1s / 1コマ打ち"（pop 1.25×，
-  手绘下划线每 4 帧重描一次沸腾、f=108 后冻结）；底部「摄影表」一拍三只在每 3 格写原画号、
-  中间格画竖线（= 沿用上一张），一拍一格格有号——观众直接看见每秒画几张
-- 画面：paper look 作画纸（定位孔、淡蓝铅笔安全框/十字），主体是 5px 墨线 + 硬边
-  赛璐珞投影的 video-shotcraft 产品卡（30fps · every frame, crafted）；f74 后 hold 段 2% 极缓推进
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 拍数 | 顿挫段 floor(f/3)（一拍三） | /2 顿感不足、/4 以上读作播放器卡死 |
-| 每步位移 | ≈69px（总程 1040 ÷ 15 步倒推） | <30px 读作卡顿掉帧不是顿挫——命门 |
-| 步间姿势 | sin(q) rotate ±5° + 挤压/拉伸交替 + 一高一低小跳 | 无姿势变化的纯位移顿挫像 bug 不像手翻书 |
-| 切换帧 | f48（顿挫:冲刺 ≈ 3:2） | 切换必须一帧完成，任何补间都毁掉"换拍"感 |
-| 冲刺缓动 | Easing.out(poly(4)) + 过冲 40px + 6f 回弹 | 初速要猛，与顿挫段拉满反差 |
-| 收尾 | 落位后 hold 70f（只留 2% 极缓推进），角标沸腾 f108 冻结 | 沸腾残留毁真静止（feTurbulence 摘罩判例同族） |
-
-## 已知坑
-- demo 用手搓作画纸 + 赛璐珞卡调校——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 冲击帧是全画面级冲击（R4 计数），一个镜头只给切换点这一次，且只给 2f
-- 同一镜头单一时间操纵者判例：与 speed-ramp-freeze / hit-counter 顿帧
-  互斥，一个镜头只能有一个人动时间轴
-- 顿挫段每步位移 ≥30px 才读得出"顿"——微步顿挫读作渲染掉帧，
-  这是本卡命门；步幅不够就缩短总时长换大步幅
-- 切换点必须有标注（角标 "ON 3s"→"ON 1s"、摄影表格子或一声打点，
-  sound-design §4.5）——无标注观众只觉得"变快了"，读不出"换拍"
-
-## 参考实现
-demos/rhythm/sakuga-timing-shift/
-（SakugaTimingShift.tsx）
+---
+name: sakuga-timing-shift
+一句话: 一拍三转一拍一——元素先以每 3 帧一步的手翻书顿挫移动，高潮瞬间切成逐帧丝滑冲刺，帧率量化的突变本身就是看点
+适用: 单元素的强调性位移（卡片入场、指标冲线）；需要"手工感→高潮爆发"反差的段落
+时长: 150f（5s）
+能量: 中高
+标签: ui-entrance
+---
+
+## 意图
+库内时间轴操纵已有 speed-ramp-freeze 的定格解冻与 hit-counter 的局部顿帧。
+本卡是另一种——**改的不是速度是帧率本身**：
+顿挫段驱动帧 q=floor(f/3)*3，元素每 3 帧才动一步（10fps 手翻书），
+切换帧起改用原始 f 逐帧驱动，丝滑冲刺。一拍三的钝与一拍一的滑
+同屏对切，日式作画的拍数演出（shooting on 3s / on 1s）。顿挫段
+不是低级感是手工感，切换点即高潮标记。
+
+## 动效核心
+- 顿挫段：q = Math.floor(f/3)*3 当驱动帧，位置线性 X 140→1180，
+  16 张原画、每步 ≈69px；姿势随 q 冻结：sin(q) rotate ±5° + 挤压/拉伸交替
+  （0.97/1.035）+ 一高一低小跳（−18/−2px），一步一个样
+- f48 切换：两帧「冲击帧」（画面反相成墨底 + 以卡片为焦点的集中线）当高潮标记，
+  之后改原始 f 连续驱动，Easing.out(poly(4)) 高初速冲刺折返中央 + 过冲 40px
+  + 6f 回弹，落地 scaleX 0.92 / scaleY 1.07 挤压
+- 冲刺段运动拉伸由位置差分速度驱动（scaleX 峰值 ≈1.3 / scaleY 0.9），
+  身后 9 条横向锥形墨色速度线、长度 ∝ 速度，**条件挂载**——速度低即摘除
+- 换拍标注三处同步：角标 "ON 3s / 3コマ打ち"→"ON 1s / 1コマ打ち"（pop 1.25×，
+  手绘下划线每 4 帧重描一次沸腾、f=108 后冻结）；底部「摄影表」一拍三只在每 3 格写原画号、
+  中间格画竖线（= 沿用上一张），一拍一格格有号——观众直接看见每秒画几张
+- 画面：paper look 作画纸（定位孔、淡蓝铅笔安全框/十字），主体是 5px 墨线 + 硬边
+  赛璐珞投影的 video-shotcraft 产品卡（30fps · every frame, crafted）；f74 后 hold 段 2% 极缓推进
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 拍数 | 顿挫段 floor(f/3)（一拍三） | /2 顿感不足、/4 以上读作播放器卡死 |
+| 每步位移 | ≈69px（总程 1040 ÷ 15 步倒推） | <30px 读作卡顿掉帧不是顿挫——命门 |
+| 步间姿势 | sin(q) rotate ±5° + 挤压/拉伸交替 + 一高一低小跳 | 无姿势变化的纯位移顿挫像 bug 不像手翻书 |
+| 切换帧 | f48（顿挫:冲刺 ≈ 3:2） | 切换必须一帧完成，任何补间都毁掉"换拍"感 |
+| 冲刺缓动 | Easing.out(poly(4)) + 过冲 40px + 6f 回弹 | 初速要猛，与顿挫段拉满反差 |
+| 收尾 | 落位后 hold 70f（只留 2% 极缓推进），角标沸腾 f108 冻结 | 沸腾残留毁真静止（feTurbulence 摘罩判例同族） |
+
+## 已知坑
+- demo 用手搓作画纸 + 赛璐珞卡调校——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 冲击帧是全画面级冲击（R4 计数），一个镜头只给切换点这一次，且只给 2f
+- 同一镜头单一时间操纵者判例：与 speed-ramp-freeze / hit-counter 顿帧
+  互斥，一个镜头只能有一个人动时间轴
+- 顿挫段每步位移 ≥30px 才读得出"顿"——微步顿挫读作渲染掉帧，
+  这是本卡命门；步幅不够就缩短总时长换大步幅
+- 切换点必须有标注（角标 "ON 3s"→"ON 1s"、摄影表格子或一声打点，
+  sound-design §4.5）——无标注观众只觉得"变快了"，读不出"换拍"
+
+## 参考实现
+demos/rhythm/sakuga-timing-shift/
+（SakugaTimingShift.tsx）

package/lib/motion/shotcraft/upstream/references/shots/rhythm/speed-ramp-freeze.md

@@ -1,44 +1,44 @@
----
-name: speed-ramp-freeze
-一句话: 帧号非线性 remap 的节奏手法——定格标注（流动→定格圈注→解冻）
-适用: 卡片流/长横移中把一个重点"停下给人看"；教学解说、评审语境
-时长: 定格标注全程 158f（≈5.3s，定格段 67f ≥45f）
-能量: 中高（速度反差本身即energy beat）
----
-
-## 意图
-匀速流读作 PPT（R2），全程快流观众抓不住重点（R3）。定格标注在一条
-运动里干脆停下来——马克笔圈出重点再走。技术根是帧号 remap（斜率即速率），
-语义是"停课划重点"。
-
-## 动效核心
-- 源动画匀速，输出帧对源帧做非线性 remap（斜率即速率）：流动段斜率 1（26px/源帧）→
-  定格段斜率 0 → 解冻段 smootherstep；**blur 联动速率**——按 remap 后的实际速度给方向性
-  模糊（Polish SpeedBlur，|v|<8px/f 不挂滤镜），定格段裸渲；CameraMotionBlur 多重采样会给
-  页面纹理染色，本卡不用
-- 定格段斜率 =0（瞬时切换，无缓入——定格要干脆）；定格那一帧给"按下暂停"的
-  信号：快门白闪 3f、整帧取景框四角弹入、时间码从 LIVE 走字切到 PAUSED 并停住；
-  强调色马克笔超椭圆一笔圈 10f 描边（stroke-dashoffset，1.08 圈、收笔不闭合）圈住目标 +
-  箭杆 6f + 箭头 3f 点题，feTurbulence（scale≈6）给手绘抖动，再接一行 68px 粗体批注 +
-  手绘下划线 + 署名；解冻段 smootherstep（ease-in 起步）22f 走完一张卡、
-  平均斜率 >1 补偿时长，墨迹 8f 淡出，但在目标卡角留一枚评论图钉随卡离场
-- 目标卡对位屏中并被"拾起"（抬高 + 放大 3–5% + 阴影加深），其余卡退暗 / 去饱和；
-  卡宽 600px 时 2x 卡片纹理是向下采样，任选一张都锐利（凝视/圈注对象必须锐利、居中）
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 定格时长 | ≥45f | 短了凝视不成立（R3 宁慢勿快） |
-| 解冻补偿 | smootherstep 22f 走完一张卡（平均斜率 >1） | 解冻太慢全片拖沓；不补偿则定格吃掉的时间读作冷场 |
-| 圈注描边 | 10f 划完 + 抖动 scale 6 | 太慢像加载动画；无抖动像机械标注 |
-| 暂停信号 | 快门白闪 3f + 取景框四角 + 时间码 PAUSED | 无信号时观众分不清"定格"和"卡顿" |
-
-## 已知坑
-- SFX 钉帧跟**输出帧**不跟源帧（画面动作在输出时间轴上发生）；
-  拟音槽位：定格配马克笔沙沙声（S4），本卡转正时未配、实战补
-- 定格标注一支 30s 片 ≤2 次（克制原则）
-- 参数经占位素材调校转正，非实战定稿，首次实战后回验
-
-## 参考实现
-demos/rhythm/speed-ramp-freeze/
-（FreezeAnnotateReal.tsx）
+---
+name: speed-ramp-freeze
+一句话: 帧号非线性 remap 的节奏手法——定格标注（流动→定格圈注→解冻）
+适用: 卡片流/长横移中把一个重点"停下给人看"；教学解说、评审语境
+时长: 定格标注全程 158f（≈5.3s，定格段 67f ≥45f）
+能量: 中高（速度反差本身即energy beat）
+---
+
+## 意图
+匀速流读作 PPT（R2），全程快流观众抓不住重点（R3）。定格标注在一条
+运动里干脆停下来——马克笔圈出重点再走。技术根是帧号 remap（斜率即速率），
+语义是"停课划重点"。
+
+## 动效核心
+- 源动画匀速，输出帧对源帧做非线性 remap（斜率即速率）：流动段斜率 1（26px/源帧）→
+  定格段斜率 0 → 解冻段 smootherstep；**blur 联动速率**——按 remap 后的实际速度给方向性
+  模糊（Polish SpeedBlur，|v|<8px/f 不挂滤镜），定格段裸渲；CameraMotionBlur 多重采样会给
+  页面纹理染色，本卡不用
+- 定格段斜率 =0（瞬时切换，无缓入——定格要干脆）；定格那一帧给"按下暂停"的
+  信号：快门白闪 3f、整帧取景框四角弹入、时间码从 LIVE 走字切到 PAUSED 并停住；
+  强调色马克笔超椭圆一笔圈 10f 描边（stroke-dashoffset，1.08 圈、收笔不闭合）圈住目标 +
+  箭杆 6f + 箭头 3f 点题，feTurbulence（scale≈6）给手绘抖动，再接一行 68px 粗体批注 +
+  手绘下划线 + 署名；解冻段 smootherstep（ease-in 起步）22f 走完一张卡、
+  平均斜率 >1 补偿时长，墨迹 8f 淡出，但在目标卡角留一枚评论图钉随卡离场
+- 目标卡对位屏中并被"拾起"（抬高 + 放大 3–5% + 阴影加深），其余卡退暗 / 去饱和；
+  卡宽 600px 时 2x 卡片纹理是向下采样，任选一张都锐利（凝视/圈注对象必须锐利、居中）
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 定格时长 | ≥45f | 短了凝视不成立（R3 宁慢勿快） |
+| 解冻补偿 | smootherstep 22f 走完一张卡（平均斜率 >1） | 解冻太慢全片拖沓；不补偿则定格吃掉的时间读作冷场 |
+| 圈注描边 | 10f 划完 + 抖动 scale 6 | 太慢像加载动画；无抖动像机械标注 |
+| 暂停信号 | 快门白闪 3f + 取景框四角 + 时间码 PAUSED | 无信号时观众分不清"定格"和"卡顿" |
+
+## 已知坑
+- SFX 钉帧跟**输出帧**不跟源帧（画面动作在输出时间轴上发生）；
+  拟音槽位：定格配马克笔沙沙声（S4），本卡转正时未配、实战补
+- 定格标注一支 30s 片 ≤2 次（克制原则）
+- 参数经占位素材调校转正，非实战定稿，首次实战后回验
+
+## 参考实现
+demos/rhythm/speed-ramp-freeze/
+（FreezeAnnotateReal.tsx）