workinf_Blender_Wasm/docs/status/N-021.md

N-021 Sequencer 与音频

状态：BLOCKED（strip schema、真实 Main reader、确定性时间编辑、长媒体有界索引/seek/cache 和 codec 能力门已落地；Main 写回、完整媒体解码/渲染、音频波形和服务端编码仍未实现）

已验证切片

1. N-021-A（部分）：版本化 SequencerTimelineIR 覆盖 Scene、Movie、Image、Sound、 Effect、Meta strip、channel、帧范围、source range、speed、proxy 和依赖；strip、 image、dependency 数量以及帧范围都有预算，资源路径经过项目沙箱规范化。
2. N-021-B（部分）：MOVE、TRIM、SPLIT 以 revision 乐观并发控制作用于内存 timeline；编辑后重新解析依赖和预算，锁定 strip 与 stale revision 会拒绝。
3. N-021-B/C：sequencerSourceFrame 对 speed、trim、split 使用确定性的 source-frame 映射，避免左右片段复用越界源帧。
4. N-021-B/C（部分）：resolveSequencerFrame 在切分边界解析当前顶层 strip、source frame 与依赖；META 覆盖的子 strip 和 inactive dependency 不会泄漏到渲染帧。
5. N-021-C/D（门）：运行时只报告 WebCodecs/HTMLMedia 需要精确 probe；codec 必须 出现在已验证 MIME 集合中才可放行，本地编码固定为 BLOCKED。
6. N-021-A（部分）：Blender 5.2 Scene.ed/Editing.seqbase 读取 Scene、Movie、Image、Sound、 Meta 和协议支持的 Effect；显示范围由持久 start/startofs/endofs/len 计算，保留 channel、 mute/lock、相对媒体路径、24/1.001 FPS 和 effect input stable ID。绝对路径、未知类型、 坏依赖或超预算将 Scene sequencer 标为 BLOCKED。
7. N-021-B（transition 子集）：CROSS/GAMMA_CROSS 可按半开显示区间确定性解析 [0,1) 进度， 保持 Blender input1,input2 顺序，并为两个活动依赖返回各自 source frame；越界、依赖缺失、 muted 输入和非 cross effect 拒绝。
8. 桌面 Blender 5.2 fixture 经 WASM/Worker 后，在真实 CROSS 中间帧得到 factor 0.5；两个单张 Image strip 的 source range 为 0..1，显示 20 帧仍固定到 source frame 1，不伪造成图像序列。
9. V1 long-media 门使用本地 261-byte PNG 与 16,044-byte WAV 建立 1,000,000 帧、10,001 strips 时间线；1,024-frame bucket index 仅产生 11,914 references，不按总帧数展开 JSON。 起点/中点/终点、64 次确定性随机 seek、连续 scrub 最新请求胜出和 index/seek/decode 取消均通过。
10. preview cache 使用 20 KiB 显式 byte budget/LRU，随机 seek 发生真实淘汰且当前 audio/image key 仍 resident；timeline/current frame/asset hashes 作为内容寻址 session manifest 写入 OPFS，终止 StorageWorker 与 media Worker 后在 frame 765432 恢复。session SHA-256 固定为 d2e7e3c5ed9ae4fda6fe358cebb474f5774f1d2037dff3df9b6dfde9e0bebd2d。
11. 上述门只放行 fixture 的 IMAGE/SOUND 原始本地资源读取，不声称 WebCodecs MOVIE decode、 waveform/proxy 生成或最终编码完成；video/mp4 和 local encoding 仍结构化阻断。

仍然阻断

• N-021-A/B：Main strip 写回、非 CROSS transition/modifier 完整参数、undo/redo 和 save/reopen； 基础真实 reader 与 CROSS/GAMMA_CROSS 帧描述已完成。
• N-021-C：WebCodecs 精确 seek/decode、音频 waveform、proxy 生成、A/V sync、丢帧和 损坏媒体处理。
• N-021-D：浏览器不支持的 codec、混音与最终编码的服务端 Blender job。
• N-021-E：V1 有界 Chromium/OPFS 长媒体门已完成；完整桌面/Chromium 解码/渲染 golden 仍阻断。

验收

WEB_TEST_PORT=5321 npm --prefix web run test:e2e -- --grep "N-021 sequencer"
npm --prefix web run test:sequencer-main-reader
npm --prefix web run test:long-media-performance