feat(timeline): 吸附迟滞+多探针 / 链接 offset 角标 / 音量橡皮筋 (#99)

[cuic19053-hue]

What

解决 #99：吸附迟滞+多探针 / 链接 offset 角标 / 音量橡皮筋

How

1. 吸附迟滞 + 多探针

• TimelineContainer.tsx 新增 snapStateRef 跨 pointer 事件保持吸附状态
• onPointerMove 改用 findSnapDelta，传入 currentlySnapped（不再传 null）
• 探针组收集所有 companions 的 start+end

2. 链接 offset 角标

• clip.ts 新增 linkOffsetForClip 计算链接组内帧偏移
• clipRenderer.ts 新增 drawOffsetBadge 绘制红色圆角徽章

3. 音量橡皮筋

• clipRenderer.ts 新增 drawVolumeEnvelope 绘制 volumeTrack 折线 + kf 圆点
• hitTest.ts 新增 audioVolumeKfHit 命中测试
• TimelineContainer.tsx 新增 audioVolumeKf DragState + 拖拽逻辑
• Cmd+click 空白处调 stampKeyframe

额外说明

#95（keyframe editing）尚未合并到 upstream/main，后端 EditCommand 仅暴露 SetKeyframes。
为保持纯前端 PR，edit.moveKeyframe / edit.stampKeyframe 实现为前端 wrapper
（read-modify-write over setKeyframes）：读取当前 timeline mirror → 修改 kf 数组 → 调用
已有的 setKeyframes 命令。运行时可用，无需后端改动。

Testing

• pnpm tsc --noEmit 通过
• pnpm build 通过
• 52 项单元测试全通过
• 后端无变更（纯前端 PR）

Limitation

• fade knee 拖拽留作后续
• 多选 ghost 预览仅处理单选 clip 的 volume kf 拖拽
• moveKeyframe / stampKeyframe 为前端 wrapper（基于 setKeyframes），待 [timeline] 关键帧编辑入口缺失（菱形/面板只读不可编辑） #95 合并后可切换为原生后端命令

Closes #99

[appergb]

@cuic19053-hue 自动审核结论:请修改(REQUEST_CHANGES)。snap 迟滞/多探针、链接 offset 角标、音量橡皮筋方向不错,但有阻塞:

1. 与刚合并的 #119 关键帧路线冲突:你在 web/src/store/editActions.ts 重复定义了 stampKeyframe/moveKeyframe(纯前端 read-modify-write),而 #119 已合并并确立后端命令路线(走真命令 + undo + 全属性含 pair/crop)。两者同名同签名,同时进 main 会 TS 重复导出编译失败 + 语义分叉(RMW 有 TOCTOU 竞态、仅支持 scalar)。请删除本 PR 的前端 RMW stampKeyframe/moveKeyframe,改调 #119 的后端命令(或本 PR 专注 snap/offset/音量,移除关键帧段)。
2. 与 #123 在 timelineCanvas.ts 的 DragPaint 类型冲突:你加 volumeKf 变体,#123 把 move 变体改为对象——rebase 时手动整合 DragPaint 与 paintTimeline。
3. 请 rebase 到含 #119 的最新 main(#119 已改 editActions/clipRenderer/types,本 PR 现已冲突)。

[appergb]

@cuic19053-hue Sonnet 4.6 复审:主体功能(吸附迟滞+多探针、音量橡皮筋、链接 offset 角标)已实现,但有三处阻塞:

1. 角标位置违反 1:1。 本 PR 放左上角(clipRenderer.ts bx = rect.x + CLIP.stripWidth + 3),上游 ClipRenderer.swift:640-644 是右上角(x = rect.maxX - handleW - badgeWidth - 2)。且与 #139 重复实现同名 drawOffsetBadge + linkOffset 字段,合并必冲突——请与 #139 二选一/协调(#139 位置与上游一致)。
2. move 拖拽错误吸附 playhead。 TimelineContainer.tsx move 分支 collectTargets(timeline, excluded, activeFrame) 传了 activeFrame,使拖移可吸附播放头;上游 SnapEngine.swift move 拖拽 includePlayhead 默认 false(仅 razor 传 true)。注意此处与 #138 同行冲突,需协调。
3. 与 #123 的 DragPaint 冲突。 本 PR 新增 volumeKf variant、#123 改 move variant,同改 timelineCanvas.ts 的 DragPaint/paintTimeline,合并顺序不定必产生 TS 冲突,需手动整合。

请处理后重提。

[cuic19053-hue]

@appergb 请求重新审查。此前反馈已全部修复，CI 双绿（Rust ✅ Web ✅，commit \32f0d9a\）：

1. 角标位置：从左上角改为右上角（对齐上游 \ClipRenderer.swift:640-644\）
2. move 不吸附 playhead：\collectTargets\ move 分支不传 \�ctiveFrame\（\includePlayhead=false\）
3. 删重复关键帧：删除与 feat(inspector): keyframe editing UI + fine-grained backend commands (#95) #119 重复的前端 RMW \stampKeyframe/\moveKeyframe\，改调 feat(inspector): keyframe editing UI + fine-grained backend commands (#95) #119 后端命令

DragPaint 合并顺序：本 PR 与 #123 在 \ imelineCanvas.ts\ 的 \DragPaint\ 类型有冲突。本 PR 新增 \�olumeKf\ 变体（纯新增，风险低），#123 给 \move\ 变体加 \duplicate\ 字段。建议先合并本 PR（#120），#123 rebase 整合后再合并。

请 re-review，谢谢！