dsh-drawai 0.4.2 → 0.4.4

package/lib/motion/shotcraft/upstream/references/shots/effects/glow-flyline-moves.md

@@ -1,53 +1,53 @@
----
-name: glow-flyline-moves
-一句话: 暗场光斑与飞线三式——glow-orb-ambient 光斑底噪、flyline-arc 飞线连接、orb-flyline-relay 同帧共振组合
-适用: 全片唯一暗场段落的氛围与数据叙事：铺底噪用 A、讲数据流向用 B、要背景给前景搭腔用 C；Linear 官网味
-时长: A 170f（~5.7s）/ B 140f（~4.7s）/ C 165f（5.5s）
-能量: A 低（底噪级）/ B 中 / C 中高
-标签: data
----
-
-## 意图
-这是库内第一张整卡住在**暗场**的卡。白底提亮不可见判例反过来读就是：
-要玩光，先去暗场。A 是空间的呼吸——深色底三团大光斑有机漂移，从中央
-磨砂玻璃卡背后游过、颜色透过玻璃染进卡面，卡缘随最近光斑靠近而泛光，
-背景不再是死的；B 是数据的动词——发光弧线从 A 卡"打"到 B 卡，
-亮点头领跑、渐隐光尾，落点描边脉冲点亮，指标关联第一次有了方向；C 是 A+B 的焊接——飞线落点帧邻近光斑同帧涨亮一拍，
-氛围层与事件层**同帧共振**，互相搭腔而非各演各的（组合命门：拆开共振帧
-就退化成两张卡并置）。
-
-## 三式选型
-| 式 | 做法 | 适用 |
-|----|------|------|
-| A glow-orb-ambient | 三团 760–1200px 多段径向渐变光斑（screen 叠加，不做实时 blur），双正弦漂移；中央 1100×600 磨砂玻璃卡（backdrop 模糊 + 提饱和）让光斑透色；卡缘辉光按光斑距离 [240,760]px→[1,0] 加权取 max 驱动 + 朝主导光斑的定向轮廓光 | 暗场段落铺底；卡呼吸感 |
-| B flyline-arc | 暗场 dashboard 压暗当底，卡心到卡心的手写 bezier 100 段采样，22f out-cubic 生长；光头 + 彗尾条件挂载领跑，段 opacity 按离头距离渐隐、到站 10f 抹匀；起点锚亮起、落点节点常驻；落点卡描边脉冲 + 冲击环，可接力 | 数据流向/指标关联；dashboard 叙事 |
-| C orb-flyline-relay | A+B 焊接：三颗玻璃节点各配一团背后光斑，光斑 surge 与节点点亮共用落点帧常量，涨亮 1+1.6×surge 并放大 12%、5f 起升 15f 消散；飞线到站后消散成细点虚线 | 暗场高光段；三站接力收束 |
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| A 光斑 | 潮青 / 深海蓝 / 珊瑚，峰值 0.55/0.5/0.42；漂移振幅 280–300px、周期 96–150f 交叉不等 | 同周期漂移读作整体晃动不是"有机" |
-| A 玻璃卡 | backdrop blur 44px + saturate 1.5；祖先不能带 filter / opacity<1 | 祖先成为 backdrop root 时玻璃里看不到光斑（入场淡入放在玻璃层自身） |
-| A 卡缘辉光 | box-shadow 0→90px 主导光斑色 0.32 + 1.5px 定向渐变轮廓光 | 无辉光光斑与卡互不认识 |
-| A 收敛 | 115–145f out-sine 收敛冻结（振幅 60/π，起始斜率 = 1 速度连续），末 25f 真静止 | 硬停一帧读作卡死；缓动收敛才有真静止 |
-| B 线体 | 暗场版（demo）：白芯 3.5px butt 分段 + 7px/18px 两层靛蓝辉光；浅底版：白线 4.5px + 9px 深色衬底 | 浅底无衬底白线直接消失（判例）；分段用圆头会在渐隐尾叠出珠串 |
-| B 光头 | 白点 r7 + r40 halo + 9 点彗尾，仅生长期条件挂载 | opacity 到 0 不算摘罩，永不真静止 |
-| B 脉冲 | 描边扩散 out-cubic 6f / 消散 12f 到残余 0.25；暗场版提亮（强调色描边 + 外辉光 + 极淡卡面提亮）+ 14f 冲击环；f86 后全静止 | 白底禁提亮——浅底版用加深罩 0.16 替代 |
-| C 共振 | 落点帧同帧起 surge（同一常量 LIT_B / LIT_C）；节点 8f 亮到 1 + 描边脉冲残余 0.35 + 20f 冲击环 | 错 2f 以上共振读不出"搭腔" |
-| C 时间轴 | 动作 f98 前结束、光斑 110–140f 收敛冻结，末 25f 真静止 | 氛围层最后冻，事件层先收 |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 暗场段与纸墨浅底主视觉切换成本高——全片暗场段 ≤1 段，进出
-  用 shot-transitions 藏切族垫，别生切明暗
-- 光斑漂移末段**必须**缓动收敛到静止再冻结——匀速漂移直接 clamp
-  是一次可见的急刹（A 式 out-sine 收敛判例）
-- 实战品牌色版：光斑用品牌色对（如蓝紫），灰阶参数只保证明度关系，
-  色相对比要重调
-- B 接力线 ≥3 条时改用 C——纯飞线连打读作大屏模板，共振才有作者感
-- 声音：B/C 每次落点一声轻打点，A 无声（sound-design §4.5）
-
-## 参考实现
-demos/effects/glow-flyline-moves/
-（FlylineArc.tsx / GlowOrbAmbient.tsx / OrbFlylineRelay.tsx）
+---
+name: glow-flyline-moves
+一句话: 暗场光斑与飞线三式——glow-orb-ambient 光斑底噪、flyline-arc 飞线连接、orb-flyline-relay 同帧共振组合
+适用: 全片唯一暗场段落的氛围与数据叙事：铺底噪用 A、讲数据流向用 B、要背景给前景搭腔用 C；Linear 官网味
+时长: A 170f（~5.7s）/ B 140f（~4.7s）/ C 165f（5.5s）
+能量: A 低（底噪级）/ B 中 / C 中高
+标签: data
+---
+
+## 意图
+这是库内第一张整卡住在**暗场**的卡。白底提亮不可见判例反过来读就是：
+要玩光，先去暗场。A 是空间的呼吸——深色底三团大光斑有机漂移，从中央
+磨砂玻璃卡背后游过、颜色透过玻璃染进卡面，卡缘随最近光斑靠近而泛光，
+背景不再是死的；B 是数据的动词——发光弧线从 A 卡"打"到 B 卡，
+亮点头领跑、渐隐光尾，落点描边脉冲点亮，指标关联第一次有了方向；C 是 A+B 的焊接——飞线落点帧邻近光斑同帧涨亮一拍，
+氛围层与事件层**同帧共振**，互相搭腔而非各演各的（组合命门：拆开共振帧
+就退化成两张卡并置）。
+
+## 三式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A glow-orb-ambient | 三团 760–1200px 多段径向渐变光斑（screen 叠加，不做实时 blur），双正弦漂移；中央 1100×600 磨砂玻璃卡（backdrop 模糊 + 提饱和）让光斑透色；卡缘辉光按光斑距离 [240,760]px→[1,0] 加权取 max 驱动 + 朝主导光斑的定向轮廓光 | 暗场段落铺底；卡呼吸感 |
+| B flyline-arc | 暗场 dashboard 压暗当底，卡心到卡心的手写 bezier 100 段采样，22f out-cubic 生长；光头 + 彗尾条件挂载领跑，段 opacity 按离头距离渐隐、到站 10f 抹匀；起点锚亮起、落点节点常驻；落点卡描边脉冲 + 冲击环，可接力 | 数据流向/指标关联；dashboard 叙事 |
+| C orb-flyline-relay | A+B 焊接：三颗玻璃节点各配一团背后光斑，光斑 surge 与节点点亮共用落点帧常量，涨亮 1+1.6×surge 并放大 12%、5f 起升 15f 消散；飞线到站后消散成细点虚线 | 暗场高光段；三站接力收束 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 光斑 | 潮青 / 深海蓝 / 珊瑚，峰值 0.55/0.5/0.42；漂移振幅 280–300px、周期 96–150f 交叉不等 | 同周期漂移读作整体晃动不是"有机" |
+| A 玻璃卡 | backdrop blur 44px + saturate 1.5；祖先不能带 filter / opacity<1 | 祖先成为 backdrop root 时玻璃里看不到光斑（入场淡入放在玻璃层自身） |
+| A 卡缘辉光 | box-shadow 0→90px 主导光斑色 0.32 + 1.5px 定向渐变轮廓光 | 无辉光光斑与卡互不认识 |
+| A 收敛 | 115–145f out-sine 收敛冻结（振幅 60/π，起始斜率 = 1 速度连续），末 25f 真静止 | 硬停一帧读作卡死；缓动收敛才有真静止 |
+| B 线体 | 暗场版（demo）：白芯 3.5px butt 分段 + 7px/18px 两层靛蓝辉光；浅底版：白线 4.5px + 9px 深色衬底 | 浅底无衬底白线直接消失（判例）；分段用圆头会在渐隐尾叠出珠串 |
+| B 光头 | 白点 r7 + r40 halo + 9 点彗尾，仅生长期条件挂载 | opacity 到 0 不算摘罩，永不真静止 |
+| B 脉冲 | 描边扩散 out-cubic 6f / 消散 12f 到残余 0.25；暗场版提亮（强调色描边 + 外辉光 + 极淡卡面提亮）+ 14f 冲击环；f86 后全静止 | 白底禁提亮——浅底版用加深罩 0.16 替代 |
+| C 共振 | 落点帧同帧起 surge（同一常量 LIT_B / LIT_C）；节点 8f 亮到 1 + 描边脉冲残余 0.35 + 20f 冲击环 | 错 2f 以上共振读不出"搭腔" |
+| C 时间轴 | 动作 f98 前结束、光斑 110–140f 收敛冻结，末 25f 真静止 | 氛围层最后冻，事件层先收 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 暗场段与纸墨浅底主视觉切换成本高——全片暗场段 ≤1 段，进出
+  用 shot-transitions 藏切族垫，别生切明暗
+- 光斑漂移末段**必须**缓动收敛到静止再冻结——匀速漂移直接 clamp
+  是一次可见的急刹（A 式 out-sine 收敛判例）
+- 实战品牌色版：光斑用品牌色对（如蓝紫），灰阶参数只保证明度关系，
+  色相对比要重调
+- B 接力线 ≥3 条时改用 C——纯飞线连打读作大屏模板，共振才有作者感
+- 声音：B/C 每次落点一声轻打点，A 无声（sound-design §4.5）
+
+## 参考实现
+demos/effects/glow-flyline-moves/
+（FlylineArc.tsx / GlowOrbAmbient.tsx / OrbFlylineRelay.tsx）

package/lib/motion/shotcraft/upstream/references/shots/effects/icon-performance-moves.md

@@ -1,42 +1,42 @@
----
-name: icon-performance-moves
-一句话: 图标表演——attention-bounce 求关注弹跳（图标连跳递增+落地压扁+镜头被吸引）
-适用: 半屏级 icon 特写段落；新功能引出
-时长: 156f（5.2s）
-能量: 蓄势引入
-标签: interaction
----
-
-## 意图
-库内图标动画品类首批入库：icon 是镜头怼着拍的表演者，不是 UI 角落的
-微交互。attention-bounce 是 macOS Dock 语汇——Dock 里的 video-shotcraft
-app 图标原地连跳 4 次一次比一次高（0.35→1.2 倍 icon 高），每次落地压扁
-（末跳宽 1.2x 高 0.8x）+涟漪溅点，邻居图标逐渐失焦、跳最高那下镜头向它
-轻推 8%（被吸引），落定后弹开「New in Shotcraft」功能面板——把"用户注意力"
-剪进叙事。
-
-## 做法
-| 式 | 做法 | 适用 |
-|----|------|------|
-| A attention-bounce | 抛体弹跳（时长 ∝ √高度）递增 + 空中速度拉伸 + 落地 2f 挤压 + 涟漪溅点，邻居 rack focus 失焦，峰值跳镜头 scale 1.08 推近，落定触发角标 + 面板弹簧展开 | 新功能引出："看我"→镜头看它→它开面板 |
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| icon 尺寸 | 360–400px 高（半屏特写；demo 图标 360） | 角落小图标做表演没人看见——表演者必须占 C 位 |
-| 递增弹跳 | 4 跳 0.35→0.6→0.85→1.2 倍 icon 高，空中 14/18/22/26f（∝ √高度） | 等高连跳读作 loading；递增才是"越喊越大声"；时长不随高度变读作失重 |
-| 落地挤压 | 接触 2f，压扁量 0.1→0.2 递增（末跳宽 1.2x 高 0.8x），末跳阻尼余弦回稳 | squash 缺席=没有重量 |
-| 镜头推近 | 末跳 72–90f smooth 推 8%；邻居 30–96f 失焦到 7px、降饱和 30% | 镜头动作把"被吸引"的观众视角演出来 |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- 同批 bell-swing-alert（铃铛甩摆）淘汰无附言——挂点摆动型 icon
-  表演相性存疑，做新 icon 表演优先弹跳/爆发型
-- 首版曾出画框（末跳最高点顶出），弹跳高度与画面上留白先算像素
-  （demo：地面 960、图标 360、末跳顶点 168px，推近 8% 后约 119px）
-- 声音：每次落地一声"duk"音调递升，面板弹出一声轻"叮"
-
-## 参考实现
-demos/effects/icon-performance-moves/
-（AttentionBounce.tsx）
+---
+name: icon-performance-moves
+一句话: 图标表演——attention-bounce 求关注弹跳（图标连跳递增+落地压扁+镜头被吸引）
+适用: 半屏级 icon 特写段落；新功能引出
+时长: 156f（5.2s）
+能量: 蓄势引入
+标签: interaction
+---
+
+## 意图
+库内图标动画品类首批入库：icon 是镜头怼着拍的表演者，不是 UI 角落的
+微交互。attention-bounce 是 macOS Dock 语汇——Dock 里的 video-shotcraft
+app 图标原地连跳 4 次一次比一次高（0.35→1.2 倍 icon 高），每次落地压扁
+（末跳宽 1.2x 高 0.8x）+涟漪溅点，邻居图标逐渐失焦、跳最高那下镜头向它
+轻推 8%（被吸引），落定后弹开「New in Shotcraft」功能面板——把"用户注意力"
+剪进叙事。
+
+## 做法
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A attention-bounce | 抛体弹跳（时长 ∝ √高度）递增 + 空中速度拉伸 + 落地 2f 挤压 + 涟漪溅点，邻居 rack focus 失焦，峰值跳镜头 scale 1.08 推近，落定触发角标 + 面板弹簧展开 | 新功能引出："看我"→镜头看它→它开面板 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| icon 尺寸 | 360–400px 高（半屏特写；demo 图标 360） | 角落小图标做表演没人看见——表演者必须占 C 位 |
+| 递增弹跳 | 4 跳 0.35→0.6→0.85→1.2 倍 icon 高，空中 14/18/22/26f（∝ √高度） | 等高连跳读作 loading；递增才是"越喊越大声"；时长不随高度变读作失重 |
+| 落地挤压 | 接触 2f，压扁量 0.1→0.2 递增（末跳宽 1.2x 高 0.8x），末跳阻尼余弦回稳 | squash 缺席=没有重量 |
+| 镜头推近 | 末跳 72–90f smooth 推 8%；邻居 30–96f 失焦到 7px、降饱和 30% | 镜头动作把"被吸引"的观众视角演出来 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- 同批 bell-swing-alert（铃铛甩摆）淘汰无附言——挂点摆动型 icon
+  表演相性存疑，做新 icon 表演优先弹跳/爆发型
+- 首版曾出画框（末跳最高点顶出），弹跳高度与画面上留白先算像素
+  （demo：地面 960、图标 360、末跳顶点 168px，推近 8% 后约 119px）
+- 声音：每次落地一声"duk"音调递升，面板弹出一声轻"叮"
+
+## 参考实现
+demos/effects/icon-performance-moves/
+（AttentionBounce.tsx）

package/lib/motion/shotcraft/upstream/references/shots/effects/impact-feedback.md

@@ -1,50 +1,50 @@
----
-name: impact-feedback
-一句话: 命中反馈两式——hit-counter 连招计数（顿帧+伤害数字+combo 跳字）、anime-impact 动漫打击帧（负片+集中线+色散）
-适用: 元素落位/撞击的"命中一瞬"——给砸入、撞停加游戏级手感；按强度阶梯选式
-时长: n/a（元素级技法，寄生在落位动作上；各式占用帧数见参数表）
-能量: 高（瞬时冲击）
----
-
-## 意图
-元素砸到位却没有"砸到了"的一瞬，落位读作 PPT 飞入。游戏 juice
-（Vlambeer screenshake 理论）与动漫演出 impact frames 给了同一答案：
-命中的那几帧把时间咬住，冲量才传到观众手上。两式是一条强度阶梯：
-B 用局部顿帧叠伤害数字和 combo 跳字，把功能清单剪成一套连招，
-叙事感最强；C 是最重的一拳——撞停 3 帧翻负片炸集中线，强调级最高、
-最风格化。
-
-## 两式选型表
-| 式 | 做法 | 适用 |
-|----|------|------|
-| B hit-counter 连招计数 | 三卡接连砸入，每命中 = 顿帧 2f + 伤害数字上浮 + ×N 计数跳字逐次加码；demo 把"伤害"写成 video-shotcraft 每项功能省下的制作时间，飘走后落进卡片页脚 | 功能点连打段——"功能很多"用连招讲；游戏化语言浓 |
-| C anime-impact 打击帧 | crash-zoom 撞停的 3f 整幅负片反色 + 放射集中线 + 红青色散，第 4f 全撤 | 全片唯一高潮的那一拳；强调级封顶 |
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| B 节奏 | 三卡各隔 28f（动画时间 30/58/86），命中前 10f ease-in(quad) 砸落；每命中全局冻结 2f（背景斜纹滚动也一起冻） | 间隔均匀才有"连招"节拍感 |
-| B 伤害数字 | 打在卡面中下部，scale 1.45→1 + 上浮 150px 出卡沿，4f 后 12f 渐隐；字号逐击 88/104/124px，黄色斜体 + 硬投影 | 渐隐 >16f 拖泥带水，遮住下一击；从卡顶上方起跳会撞上角落计数器 |
-| B 计数器 | 脉冲峰值 1.3/1.45/1.6、rotate −2/−4/−6°、字号 140/166/196px，`exp(−t/2.4)` 回落；三格热度条逐格点亮 | 逐次加码是命门——三次一样大读不出"越打越狠" |
-| C 急推撞停 | 先 6f 预备回拉到 0.985，再 crash-zoom 6f ease-in(cubic) 推到 2.25x（卡高 454×2.25≈画高 95%，描边不被画框切半），卡心收敛到画面正中；飞行帧做时间采样运动模糊 + 中心锐利副本 | 急推参数走 crash-zoom-punch 卡 |
-| C 冲击帧 | 撞停起 3f：`invert(1) grayscale(1) contrast(1.45)` + 34 粗楔 + 22 细针集中线（每帧换形态，内端被径向渐隐吃掉留出焦点）+ 红/青负片副本 screen 叠加 ±8px 错位；第 4f 全撤，卡外页面压暗一拍 | 3f 是甜点——4f 起观众开始"看清"负片，魔术就穿帮 |
-| C 恢复震屏 | 第 4f 起 6px 指数衰减（τ≈2.2f），~12f 收干 | 幅度须过肉眼阈值（可感性判例） |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- B 式顿帧**必须全局**——背景滚动也要一起冻，否则读不出"时间被
-  咬住"，只像那张卡掉帧。demo 用统一 remap 帧 df 驱动所有层是命门；
-  唯闪白等"冻结期间也要发生"的效果用真实帧 f 驱动
-- 帧 remap 与 speed-ramp-freeze 同技术根，同一镜头别叠用两卡——
-  两套 remap 互相打架，节奏读作故障
-- C 式负片帧在纸墨审美的片子里非常抢戏——限高潮一次，且必须与
-  impact 音效同帧落地（拟音走 sound-design），无声的负片帧读作闪坏
-- B 式游戏化语言浓（伤害数字/combo 是明晃晃的游戏梗），产品调性
-  偏严肃时慎用
-- B 式多次顿帧后真实帧比动画时间多出累计冻结帧，排镜头预算时
-  按 `真实命中帧 = 动画命中帧 + 已冻结帧数` 折算（demo HITS_REAL）
-
-## 参考实现
-demos/effects/impact-feedback/
-（AnimeImpact.tsx / HitCounter.tsx）
+---
+name: impact-feedback
+一句话: 命中反馈两式——hit-counter 连招计数（顿帧+伤害数字+combo 跳字）、anime-impact 动漫打击帧（负片+集中线+色散）
+适用: 元素落位/撞击的"命中一瞬"——给砸入、撞停加游戏级手感；按强度阶梯选式
+时长: n/a（元素级技法，寄生在落位动作上；各式占用帧数见参数表）
+能量: 高（瞬时冲击）
+---
+
+## 意图
+元素砸到位却没有"砸到了"的一瞬，落位读作 PPT 飞入。游戏 juice
+（Vlambeer screenshake 理论）与动漫演出 impact frames 给了同一答案：
+命中的那几帧把时间咬住，冲量才传到观众手上。两式是一条强度阶梯：
+B 用局部顿帧叠伤害数字和 combo 跳字，把功能清单剪成一套连招，
+叙事感最强；C 是最重的一拳——撞停 3 帧翻负片炸集中线，强调级最高、
+最风格化。
+
+## 两式选型表
+| 式 | 做法 | 适用 |
+|----|------|------|
+| B hit-counter 连招计数 | 三卡接连砸入，每命中 = 顿帧 2f + 伤害数字上浮 + ×N 计数跳字逐次加码；demo 把"伤害"写成 video-shotcraft 每项功能省下的制作时间，飘走后落进卡片页脚 | 功能点连打段——"功能很多"用连招讲；游戏化语言浓 |
+| C anime-impact 打击帧 | crash-zoom 撞停的 3f 整幅负片反色 + 放射集中线 + 红青色散，第 4f 全撤 | 全片唯一高潮的那一拳；强调级封顶 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| B 节奏 | 三卡各隔 28f（动画时间 30/58/86），命中前 10f ease-in(quad) 砸落；每命中全局冻结 2f（背景斜纹滚动也一起冻） | 间隔均匀才有"连招"节拍感 |
+| B 伤害数字 | 打在卡面中下部，scale 1.45→1 + 上浮 150px 出卡沿，4f 后 12f 渐隐；字号逐击 88/104/124px，黄色斜体 + 硬投影 | 渐隐 >16f 拖泥带水，遮住下一击；从卡顶上方起跳会撞上角落计数器 |
+| B 计数器 | 脉冲峰值 1.3/1.45/1.6、rotate −2/−4/−6°、字号 140/166/196px，`exp(−t/2.4)` 回落；三格热度条逐格点亮 | 逐次加码是命门——三次一样大读不出"越打越狠" |
+| C 急推撞停 | 先 6f 预备回拉到 0.985，再 crash-zoom 6f ease-in(cubic) 推到 2.25x（卡高 454×2.25≈画高 95%，描边不被画框切半），卡心收敛到画面正中；飞行帧做时间采样运动模糊 + 中心锐利副本 | 急推参数走 crash-zoom-punch 卡 |
+| C 冲击帧 | 撞停起 3f：`invert(1) grayscale(1) contrast(1.45)` + 34 粗楔 + 22 细针集中线（每帧换形态，内端被径向渐隐吃掉留出焦点）+ 红/青负片副本 screen 叠加 ±8px 错位；第 4f 全撤，卡外页面压暗一拍 | 3f 是甜点——4f 起观众开始"看清"负片，魔术就穿帮 |
+| C 恢复震屏 | 第 4f 起 6px 指数衰减（τ≈2.2f），~12f 收干 | 幅度须过肉眼阈值（可感性判例） |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- B 式顿帧**必须全局**——背景滚动也要一起冻，否则读不出"时间被
+  咬住"，只像那张卡掉帧。demo 用统一 remap 帧 df 驱动所有层是命门；
+  唯闪白等"冻结期间也要发生"的效果用真实帧 f 驱动
+- 帧 remap 与 speed-ramp-freeze 同技术根，同一镜头别叠用两卡——
+  两套 remap 互相打架，节奏读作故障
+- C 式负片帧在纸墨审美的片子里非常抢戏——限高潮一次，且必须与
+  impact 音效同帧落地（拟音走 sound-design），无声的负片帧读作闪坏
+- B 式游戏化语言浓（伤害数字/combo 是明晃晃的游戏梗），产品调性
+  偏严肃时慎用
+- B 式多次顿帧后真实帧比动画时间多出累计冻结帧，排镜头预算时
+  按 `真实命中帧 = 动画命中帧 + 已冻结帧数` 折算（demo HITS_REAL）
+
+## 参考实现
+demos/effects/impact-feedback/
+（AnimeImpact.tsx / HitCounter.tsx）

package/lib/motion/shotcraft/upstream/references/shots/effects/light-play-moves.md

@@ -1,46 +1,46 @@
----
-name: light-play-moves
-一句话: 光效两式——spotlight-sweep 聚光扫字、sheen 单点扫光
-适用: 把光当另一种笔触（扫/擦）：暗场标题揭示（A）、主角卡加冕（B）
-时长: A 170f ~5.7s / B 150f ~5s
-能量: A 中 / B 低
-标签: typography
----
-
-## 意图
-库内"光"一直只有 spotlight-hero-card 一个点射手法；这两式把光做成
-体系，两种笔触两种职责：A 是**扫**——暗场里几乎不可见的标题被锥形
-光摆动扫亮，光到哪哪亮，与 spotlight-hero-card 的区别是那个打卡片、
-这个扫文字；B 是**擦**——深墨主角卡上一道 45° 高光带缓扫一次，被
-圆角裁住，无声的加冕。
-全部深底或深主角——**白底上提亮不可见**（判例）是这整张卡的地基。
-
-## 两式选型
-| 式 | 做法 | 适用 |
-|----|------|------|
-| A spotlight-sweep | 双层同文本：暗版 0.07 常驻，亮版 radial mask 随光斑走，钟摆式追光摆两个半来回阻尼停在正中，iris 张开全亮定格（demo 标题「Craft the shot.」，收在 video-shotcraft 字标） | 暗场大标题揭示开场 |
-| B sheen-sweep | 深墨卡（demo：钛黑金属卡，蚀刻 video-shotcraft 单色标志与字标）转向光源的同时，115° 高光带扫一次，overflow hidden 圆角裁剪 | 主角卡静止段的一次加冕 |
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| A 反差 | 暗版 0.07 vs 全亮 1.0；demo 为暖白 #f8efe2 衬线字对酒红黑天鹅绒幕布（#1a0a0d→#070203），幕布本身也只在光斑里被照亮 | 反差是本式全部；暗版 >0.15 就没有"点亮"了 |
-| A 光斑 | ellipse 360px（硬芯+长软边），钟摆：x = 960+600·sin θ·env，θ 从 −π/2（最左）起、周期 50f、走 2.25 个周期至 f121；y 走下凹弧（中心最低 44px）；env 第一来回后 smooth 收到 0，x 与速度在 f121 同时归零（纯 sin 会在中心最快时急刹）；开灯 4–10f 钨丝预热闪两下 | f121–141 iris 张开 360→1080px 全亮（out-cubic）、光锥线性收成柔和顶光（扩散/消散解耦判例） |
-| B 高光带 | 宽 2×卡宽，115° 渐变：宽柔光 0.14 + 窄亮芯 0.5（暖白，screen），58–90f swift 扫一次；同段卡 rotateY 21°→14°（转向光源 = 扫光的物理动机）；光带下拉丝纹与蚀刻字的亮版副本被同一遮罩揭开 | 0.5 芯在钛黑上足够响又不糊；双向 clamp + 条件挂载保证只扫一次 |
-| 摘罩 | 扫光（B）条件挂载，扫完即卸载；A 光锥收成常驻柔和顶光 | opacity 0 残留层照样每帧合成——不用的光效层直接卸载 |
-| 收尾 | A ~30f / B ~55f hold；hold 段只留极缓运动（A 浮尘与顶光呼吸、B 卡 rotateY 再转 1.5°） | 不加手持抖动（Q3） |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- **全片光效合计 ≤2 次**——光是最快掉价的手法，每个卡都闪一下
-  等于廉价模板
-- B 式是高标准重试通过：旧否决（2026-07-13 判例）针对当时实现不好看，
-  非路径不可行；四约束 = 单点+主角+圆角裁剪+只扫一次，违反任何
-  一条回到否决区
-- 深底是地基：两式全部依赖深底/深主角，白底上做光效直接跳过本卡
-- A 与 spotlight-hero-card 同片二选一，都是"聚光"语汇
-
-## 参考实现
-demos/effects/light-play-moves/
-（SheenSweepRetry.tsx / SpotlightSweepReveal.tsx）
+---
+name: light-play-moves
+一句话: 光效两式——spotlight-sweep 聚光扫字、sheen 单点扫光
+适用: 把光当另一种笔触（扫/擦）：暗场标题揭示（A）、主角卡加冕（B）
+时长: A 170f ~5.7s / B 150f ~5s
+能量: A 中 / B 低
+标签: typography
+---
+
+## 意图
+库内"光"一直只有 spotlight-hero-card 一个点射手法；这两式把光做成
+体系，两种笔触两种职责：A 是**扫**——暗场里几乎不可见的标题被锥形
+光摆动扫亮，光到哪哪亮，与 spotlight-hero-card 的区别是那个打卡片、
+这个扫文字；B 是**擦**——深墨主角卡上一道 45° 高光带缓扫一次，被
+圆角裁住，无声的加冕。
+全部深底或深主角——**白底上提亮不可见**（判例）是这整张卡的地基。
+
+## 两式选型
+| 式 | 做法 | 适用 |
+|----|------|------|
+| A spotlight-sweep | 双层同文本：暗版 0.07 常驻，亮版 radial mask 随光斑走，钟摆式追光摆两个半来回阻尼停在正中，iris 张开全亮定格（demo 标题「Craft the shot.」，收在 video-shotcraft 字标） | 暗场大标题揭示开场 |
+| B sheen-sweep | 深墨卡（demo：钛黑金属卡，蚀刻 video-shotcraft 单色标志与字标）转向光源的同时，115° 高光带扫一次，overflow hidden 圆角裁剪 | 主角卡静止段的一次加冕 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| A 反差 | 暗版 0.07 vs 全亮 1.0；demo 为暖白 #f8efe2 衬线字对酒红黑天鹅绒幕布（#1a0a0d→#070203），幕布本身也只在光斑里被照亮 | 反差是本式全部；暗版 >0.15 就没有"点亮"了 |
+| A 光斑 | ellipse 360px（硬芯+长软边），钟摆：x = 960+600·sin θ·env，θ 从 −π/2（最左）起、周期 50f、走 2.25 个周期至 f121；y 走下凹弧（中心最低 44px）；env 第一来回后 smooth 收到 0，x 与速度在 f121 同时归零（纯 sin 会在中心最快时急刹）；开灯 4–10f 钨丝预热闪两下 | f121–141 iris 张开 360→1080px 全亮（out-cubic）、光锥线性收成柔和顶光（扩散/消散解耦判例） |
+| B 高光带 | 宽 2×卡宽，115° 渐变：宽柔光 0.14 + 窄亮芯 0.5（暖白，screen），58–90f swift 扫一次；同段卡 rotateY 21°→14°（转向光源 = 扫光的物理动机）；光带下拉丝纹与蚀刻字的亮版副本被同一遮罩揭开 | 0.5 芯在钛黑上足够响又不糊；双向 clamp + 条件挂载保证只扫一次 |
+| 摘罩 | 扫光（B）条件挂载，扫完即卸载；A 光锥收成常驻柔和顶光 | opacity 0 残留层照样每帧合成——不用的光效层直接卸载 |
+| 收尾 | A ~30f / B ~55f hold；hold 段只留极缓运动（A 浮尘与顶光呼吸、B 卡 rotateY 再转 1.5°） | 不加手持抖动（Q3） |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- **全片光效合计 ≤2 次**——光是最快掉价的手法，每个卡都闪一下
+  等于廉价模板
+- B 式是高标准重试通过：旧否决（2026-07-13 判例）针对当时实现不好看，
+  非路径不可行；四约束 = 单点+主角+圆角裁剪+只扫一次，违反任何
+  一条回到否决区
+- 深底是地基：两式全部依赖深底/深主角，白底上做光效直接跳过本卡
+- A 与 spotlight-hero-card 同片二选一，都是"聚光"语汇
+
+## 参考实现
+demos/effects/light-play-moves/
+（SheenSweepRetry.tsx / SpotlightSweepReveal.tsx）

package/lib/motion/shotcraft/upstream/references/shots/effects/radial-ripple-phone-chips.md

@@ -1,56 +1,56 @@
----
-name: radial-ripple-phone-chips
-一句话: 暖沙底四层同心圆错相呼吸如水波，中央手机 mockup 屏内 feed 自动缓滚，两侧白色 chip 先后 spring pop 入场并悬浮
-适用: 移动端产品的"这就是它"定格镜头；功能点分列两侧的介绍段；片头/片尾的产品全景
-时长: 约5.6s（168f@30fps）
-能量: 低（安静、有呼吸感，靠同心圆的持续起伏撑住不冷场）
----
-
-## 意图
-用最少的动作把手机放在画面正中并让它"活着"：同心圆负责氛围呼吸，
-屏内自动滚屏负责证明"里面有内容在跑"，两侧 chip 负责点出功能名。
-三层动作各自极慢，叠起来才不会显得静止——这是产品定格镜头的标准配法。
-
-## 动效核心
-- demo 画面（look = sand，手机里是 video-shotcraft 的镜头库 feed）：1080p 原生尺寸布局（不走 DesignStage 放大），
-  手机 430×900 占画高 83%，左下角镜刻标志 + video-shotcraft 字标在两枚 chip 落定后升起，收尾是一张产品海报
-- 4 层同心圆（2240/1760/1280/840px，#dccbb4→#f2eadf 由深到浅，最外两层出画铺满）各自
-  `scale 1 ± 0.06`，全片走 1.5 个正弦周期，相邻层相位差 1.7 rad
-  ——错相是"水波"而不是"整体缩放"的关键；每层带受光上沿 + 白色发丝外缘，中心一团暖白柔光托住手机
-- 手机：暖钛金属边框 12px + 黑边 9px、70px 圆角、灵动岛/侧键/玻璃斜反光，两层落地投影；
-  0–26f 从下方 90px snappy 升起，投影随落位收紧
-- 屏内为镜头设计的 feed：大标题 + 精选大卡 + 8 条单集卡（几何插画封面 / 标题 / 时长·节目 / 收听进度），
-  底部常驻迷你播放条（进度匀速推进、波形确定性轻跳），状态栏与播放条下方各一层屏幕底色渐隐
-- feed `translateY 0→−560px`，窗口 `t 0.08→0.98` **匀速无缓动**
-- chip pop：`springAt(t0, damping 13, stiffness 190)` 驱动 scale 0.8→1（一次可见过冲），
-  同时从手机一侧 snappy 外移 28px、opacity 5f 跳满；左 chip 起 37f、右 chip 起 67f
-- pop 完接 `sin` 悬浮 ±8px（2 周期/全片），并由 pop 后 18f 起 24f 的 smooth 渐渐介入
-  ——不是一落位就开始飘
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 同心圆层数/尺寸 | 4 层 2240/1760/1280/840px（1080p） | 3 层撑不满画面；最外层要出画，否则读作一块圆形色板 |
-| 呼吸幅度 | scale 1±0.06，1.5 周期/全片 | 0.06 已是上限；到 0.1 就读作"脉冲动画"而非水波 |
-| 相位差 | 相邻层 1.7 rad | 相位全同 = 整块放大缩小；差 1.7 才有波从中心荡开的错觉 |
-| 手机投影 | 贴近实影 0 4px 10px + 远影 0 40px 80px -20px + 环境影 0 90px 140px -40px（sand.shadow 带色相） | 投影是手机"浮在波上"的唯一依据，去掉就贴平了 |
-| 自动滚屏 | translateY 0→−560px，t 0.08→0.98 匀速 | 加 ease 立刻读作"有人在滑"；匀速才是自动播放 |
-| chip pop | spring damping 13 / stiffness 190，scale 0.8→1，外移 28px | 过冲量是"弹出"的全部质感，damping >20 就平了 |
-| chip 时序 | 左 37f / 右 67f（1s 差） | 同时出现读作两个标签；错开才有"一个一个说"的节奏 |
-| chip 悬浮 | ±8px、2 周期，pop 后 18f 起 24f 渐入 | 幅度超过 ~12px 就和同心圆的呼吸抢戏 |
-| chip 字号 | 36px / 600 字重 + 60px 强调色图标圆 | 1080p 下 chip 是要读的字，别回到 12–20px 的贴纸尺寸 |
-
-## 已知坑
-- chip 用 `right: 1920 − PX + CHIP_GAP` / `left: PX + PW + CHIP_GAP` 贴着手机外缘定位；
-  改手机宽度 PW 后两侧 chip 自动跟随，但要确认长文案 chip 的外缘仍在 96px 安全边距内
-- 屏内 feed 是假条目的占位内容，落地换真实截图时总高必须
-  大于「560px + 屏高」，否则滚到底露白
-- 手机屏只有 ~390px 宽：单集卡标题控制在 ~18 个字符、元信息 `nowrap + ellipsis`，否则折行把卡片撑高
-- 同心圆是实色叠放（不是描边圆环），层序必须由大到小 append，
-  顺序反了就只看得见最大那层
-- ACCENT（默认 sand 的赤陶 #c4552d）作用于屏内封面/进度条/播放键与 chip 图标，
-  换项目品牌色只改这一个变量即可换肤
-
-## 参考实现
-demos/effects/radial-ripple-phone-chips/
-（RadialRipplePhoneChips.tsx）
+---
+name: radial-ripple-phone-chips
+一句话: 暖沙底四层同心圆错相呼吸如水波，中央手机 mockup 屏内 feed 自动缓滚，两侧白色 chip 先后 spring pop 入场并悬浮
+适用: 移动端产品的"这就是它"定格镜头；功能点分列两侧的介绍段；片头/片尾的产品全景
+时长: 约5.6s（168f@30fps）
+能量: 低（安静、有呼吸感，靠同心圆的持续起伏撑住不冷场）
+---
+
+## 意图
+用最少的动作把手机放在画面正中并让它"活着"：同心圆负责氛围呼吸，
+屏内自动滚屏负责证明"里面有内容在跑"，两侧 chip 负责点出功能名。
+三层动作各自极慢，叠起来才不会显得静止——这是产品定格镜头的标准配法。
+
+## 动效核心
+- demo 画面（look = sand，手机里是 video-shotcraft 的镜头库 feed）：1080p 原生尺寸布局（不走 DesignStage 放大），
+  手机 430×900 占画高 83%，左下角镜刻标志 + video-shotcraft 字标在两枚 chip 落定后升起，收尾是一张产品海报
+- 4 层同心圆（2240/1760/1280/840px，#dccbb4→#f2eadf 由深到浅，最外两层出画铺满）各自
+  `scale 1 ± 0.06`，全片走 1.5 个正弦周期，相邻层相位差 1.7 rad
+  ——错相是"水波"而不是"整体缩放"的关键；每层带受光上沿 + 白色发丝外缘，中心一团暖白柔光托住手机
+- 手机：暖钛金属边框 12px + 黑边 9px、70px 圆角、灵动岛/侧键/玻璃斜反光，两层落地投影；
+  0–26f 从下方 90px snappy 升起，投影随落位收紧
+- 屏内为镜头设计的 feed：大标题 + 精选大卡 + 8 条单集卡（几何插画封面 / 标题 / 时长·节目 / 收听进度），
+  底部常驻迷你播放条（进度匀速推进、波形确定性轻跳），状态栏与播放条下方各一层屏幕底色渐隐
+- feed `translateY 0→−560px`，窗口 `t 0.08→0.98` **匀速无缓动**
+- chip pop：`springAt(t0, damping 13, stiffness 190)` 驱动 scale 0.8→1（一次可见过冲），
+  同时从手机一侧 snappy 外移 28px、opacity 5f 跳满；左 chip 起 37f、右 chip 起 67f
+- pop 完接 `sin` 悬浮 ±8px（2 周期/全片），并由 pop 后 18f 起 24f 的 smooth 渐渐介入
+  ——不是一落位就开始飘
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 同心圆层数/尺寸 | 4 层 2240/1760/1280/840px（1080p） | 3 层撑不满画面；最外层要出画，否则读作一块圆形色板 |
+| 呼吸幅度 | scale 1±0.06，1.5 周期/全片 | 0.06 已是上限；到 0.1 就读作"脉冲动画"而非水波 |
+| 相位差 | 相邻层 1.7 rad | 相位全同 = 整块放大缩小；差 1.7 才有波从中心荡开的错觉 |
+| 手机投影 | 贴近实影 0 4px 10px + 远影 0 40px 80px -20px + 环境影 0 90px 140px -40px（sand.shadow 带色相） | 投影是手机"浮在波上"的唯一依据，去掉就贴平了 |
+| 自动滚屏 | translateY 0→−560px，t 0.08→0.98 匀速 | 加 ease 立刻读作"有人在滑"；匀速才是自动播放 |
+| chip pop | spring damping 13 / stiffness 190，scale 0.8→1，外移 28px | 过冲量是"弹出"的全部质感，damping >20 就平了 |
+| chip 时序 | 左 37f / 右 67f（1s 差） | 同时出现读作两个标签；错开才有"一个一个说"的节奏 |
+| chip 悬浮 | ±8px、2 周期，pop 后 18f 起 24f 渐入 | 幅度超过 ~12px 就和同心圆的呼吸抢戏 |
+| chip 字号 | 36px / 600 字重 + 60px 强调色图标圆 | 1080p 下 chip 是要读的字，别回到 12–20px 的贴纸尺寸 |
+
+## 已知坑
+- chip 用 `right: 1920 − PX + CHIP_GAP` / `left: PX + PW + CHIP_GAP` 贴着手机外缘定位；
+  改手机宽度 PW 后两侧 chip 自动跟随，但要确认长文案 chip 的外缘仍在 96px 安全边距内
+- 屏内 feed 是假条目的占位内容，落地换真实截图时总高必须
+  大于「560px + 屏高」，否则滚到底露白
+- 手机屏只有 ~390px 宽：单集卡标题控制在 ~18 个字符、元信息 `nowrap + ellipsis`，否则折行把卡片撑高
+- 同心圆是实色叠放（不是描边圆环），层序必须由大到小 append，
+  顺序反了就只看得见最大那层
+- ACCENT（默认 sand 的赤陶 #c4552d）作用于屏内封面/进度条/播放键与 chip 图标，
+  换项目品牌色只改这一个变量即可换肤
+
+## 参考实现
+demos/effects/radial-ripple-phone-chips/
+（RadialRipplePhoneChips.tsx）

package/lib/motion/shotcraft/upstream/references/shots/effects/riso-print-hits.md

@@ -1,49 +1,49 @@
----
-name: riso-print-hits
-一句话: 套印错位冲击帧——riso-misregistration-hit 单发：标题撞停瞬间裂成双色 riso 印版，抖两下"啪"地套准
-适用: 标题/卡片的命中强调，纸墨审美版的"故障闪"；全片 1–2 次的单发高潮
-时长: 4s（120f，单发）
-能量: 高
-标签: typography
----
-
-## 意图
-RGB 色散故障闪（impact-feedback C 式的一部分）是荧光屏语言，与纸墨
-调性相克。这张卡给出印刷版平替：元素裂成两份单色 riso 印版（demo：荧光粉 × 蓝；
-multiply 油墨感而非 screen 荧光感，两版套准时叠成深色墨），
-像 risograph 没对准版，抖几下
-"啪"地套准——同样的冲击力，介质想象完全换成纸上油墨。单发：
-撞停瞬间裂版、震荡衰减、硬切套准，给一次命中盖章。demo 是一张 video-shotcraft 的
-双色 riso 宣传海报（「CRAFT IT / LOUD.」+ 三栏卖点，圆章中心是单色版镜刻标志）。
-
-## 做法
-| 式 | 做法 | 适用 |
-|----|------|------|
-| misregistration-hit 单发 | 标题 8f 撞入撞停，裂两版反向错 ~40px，44f 衰减震荡后硬切套准 + scale 脉冲 + 「ON REGISTER」圆章盖下 | 全片 1–2 次的命中盖章；标题/大字的到位一瞬 |
-
-## 参数表
-| 参数 | 典型值 | 调节手感 |
-|------|--------|----------|
-| 双版 | 两色 riso 油墨：荧光粉 #ff4fa3 + 蓝 #1f5fc4（套准叠成深紫）。`mix-blend-mode: multiply` 叠在再生纸（#f3eee2 + 静态纸纤维/油墨颗粒）上，位移反向；套准即两版归零重合 | multiply 叠出的重影就是"油墨没对准"；screen 叠加立刻变荧光故障；两版选互补色相、套准后叠成近黑最好，别用纯灰（读作阴影） |
-| 错位包络 | `offset = A·cos(2πt/18)·exp(-t/60)`，A=(20,8)px 两版反向（300px 标题）；帧 72 硬切归零 | 命门：套准是**硬切跳变**不是渐收——衰减到 ~11px 残余时啪地归零才有"啪"；纯渐收读不出套准一拍 |
-| 撞入 | 8f Easing.in(cubic) 从画外撞停，命中帧即裂版 | 裂版必须与撞停同帧——晚 2f 就读作两件事 |
-| 套准脉冲 | 归零帧 4f scale 1.03→1；同帧圆章 scale 1.5→1 盖下；命中帧整页 1.2% 顿挫 10f 回落 | 盖章的一拍；省略则套准无重量 |
-| 作用域 | 错版只作用标题，背景（太阳 / 版记 / 信息栏）保持套准 | 整画面全裂读作故障而非印刷 |
-| 收尾 | 套准后 ≥40f 真静止 | R1 |
-
-## 已知坑
-- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
-  首次实战须以真实素材回验
-- **错位幅度可感性判例（本批实渲）**：词汇表原案 ±5px 在 1920 宽画面
-  正常速度下肉眼几乎不可见——单版 16px/总分离 32px 起步才可感（200–300px 大标题按 20px/40px）；
-  幅度存疑时做极端版给用户看（可感性优先）
-- 本卡与 impact-feedback C（负片冲击帧）语义重叠——纸墨调性片子用本卡、
-  游戏/动漫调性用 C 式，同片不并用（P4）
-- 错位方向一横一纵混合（x 为主 y 少量）更像没对准版；纯横向读作
-  左右晃动
-- 300px 大字配 −0.045em 负字距时，相邻字形的横笔可能恰好相接（如 CRAFT 的 F→T 顶横），
-  两边抗锯齿叠出一条发丝亮缝——给前一个字单独再收 ~0.01em 让两笔重叠即可
-
-## 参考实现
-demos/effects/riso-print-hits/
-（RisoMisregistrationHit.tsx）
+---
+name: riso-print-hits
+一句话: 套印错位冲击帧——riso-misregistration-hit 单发：标题撞停瞬间裂成双色 riso 印版，抖两下"啪"地套准
+适用: 标题/卡片的命中强调，纸墨审美版的"故障闪"；全片 1–2 次的单发高潮
+时长: 4s（120f，单发）
+能量: 高
+标签: typography
+---
+
+## 意图
+RGB 色散故障闪（impact-feedback C 式的一部分）是荧光屏语言，与纸墨
+调性相克。这张卡给出印刷版平替：元素裂成两份单色 riso 印版（demo：荧光粉 × 蓝；
+multiply 油墨感而非 screen 荧光感，两版套准时叠成深色墨），
+像 risograph 没对准版，抖几下
+"啪"地套准——同样的冲击力，介质想象完全换成纸上油墨。单发：
+撞停瞬间裂版、震荡衰减、硬切套准，给一次命中盖章。demo 是一张 video-shotcraft 的
+双色 riso 宣传海报（「CRAFT IT / LOUD.」+ 三栏卖点，圆章中心是单色版镜刻标志）。
+
+## 做法
+| 式 | 做法 | 适用 |
+|----|------|------|
+| misregistration-hit 单发 | 标题 8f 撞入撞停，裂两版反向错 ~40px，44f 衰减震荡后硬切套准 + scale 脉冲 + 「ON REGISTER」圆章盖下 | 全片 1–2 次的命中盖章；标题/大字的到位一瞬 |
+
+## 参数表
+| 参数 | 典型值 | 调节手感 |
+|------|--------|----------|
+| 双版 | 两色 riso 油墨：荧光粉 #ff4fa3 + 蓝 #1f5fc4（套准叠成深紫）。`mix-blend-mode: multiply` 叠在再生纸（#f3eee2 + 静态纸纤维/油墨颗粒）上，位移反向；套准即两版归零重合 | multiply 叠出的重影就是"油墨没对准"；screen 叠加立刻变荧光故障；两版选互补色相、套准后叠成近黑最好，别用纯灰（读作阴影） |
+| 错位包络 | `offset = A·cos(2πt/18)·exp(-t/60)`，A=(20,8)px 两版反向（300px 标题）；帧 72 硬切归零 | 命门：套准是**硬切跳变**不是渐收——衰减到 ~11px 残余时啪地归零才有"啪"；纯渐收读不出套准一拍 |
+| 撞入 | 8f Easing.in(cubic) 从画外撞停，命中帧即裂版 | 裂版必须与撞停同帧——晚 2f 就读作两件事 |
+| 套准脉冲 | 归零帧 4f scale 1.03→1；同帧圆章 scale 1.5→1 盖下；命中帧整页 1.2% 顿挫 10f 回落 | 盖章的一拍；省略则套准无重量 |
+| 作用域 | 错版只作用标题，背景（太阳 / 版记 / 信息栏）保持套准 | 整画面全裂读作故障而非印刷 |
+| 收尾 | 套准后 ≥40f 真静止 | R1 |
+
+## 已知坑
+- demo 在灰阶/占位素材上调校通过——参数是调校起点非实战定稿，
+  首次实战须以真实素材回验
+- **错位幅度可感性判例（本批实渲）**：词汇表原案 ±5px 在 1920 宽画面
+  正常速度下肉眼几乎不可见——单版 16px/总分离 32px 起步才可感（200–300px 大标题按 20px/40px）；
+  幅度存疑时做极端版给用户看（可感性优先）
+- 本卡与 impact-feedback C（负片冲击帧）语义重叠——纸墨调性片子用本卡、
+  游戏/动漫调性用 C 式，同片不并用（P4）
+- 错位方向一横一纵混合（x 为主 y 少量）更像没对准版；纯横向读作
+  左右晃动
+- 300px 大字配 −0.045em 负字距时，相邻字形的横笔可能恰好相接（如 CRAFT 的 F→T 顶横），
+  两边抗锯齿叠出一条发丝亮缝——给前一个字单独再收 ~0.01em 让两笔重叠即可
+
+## 参考实现
+demos/effects/riso-print-hits/
+（RisoMisregistrationHit.tsx）