# DW24：视频剪辑、音频与编码输出

- stage: `animation-media`
- queueTask: `WBV2-P1424-001`；parent: `WBV2-P1424-000`；nextTask: `null`
- 包状态：`planned_gap_closure`（并不表示已有源码尚未实现）
- 完整交付依赖：DW13, DW19, DW20
- 工作量级：XL；不表示日期承诺
- validation: `NOT_RUN`；acceptance: `NOT_CLAIMED`

## 优先复用的十多天成果

SEQUENCER-AUTHORING、SEQUENCER-COMPOSITOR、媒体协议和 timeline 已有。

既有任务：`SEQUENCER-AUTHORING`（记录为 implemented）、`SEQUENCER-COMPOSITOR-COVERAGE`（记录为 implemented）。按需读取一个任务结果的 summary/remaining/ownedPaths，不打开完整产品报告。

先对照当前小范围源码和最新交接保留已实现子项；只有缺功能、缺接线或缺必要依赖才新增实现。历史状态不自动当作当前缺口。

## 操作者工作流与交付

导入音视频/图像序列 → 剪辑/效果/混音 → 同步预览 → 编码输出

可剪辑、有同步音视频预览且能生成真实输出文件的 Sequencer 工作流。

## 最小生产入口

- `web/protocol/sequencer.ts`
- `web/protocol/io-media-commands.ts`
- `web/app/src/sequencer/SequencerTimeline.ts`
- `blender-5.2.0/source/blender/editors/space_sequencer/space_sequencer.cc`
- `blender-5.2.0/source/blender/web_engine/web_engine_main_state.cpp`
- `blender-5.2.0/source/blender/web_engine/web_engine_api.cpp`
- `web/app/src/workers/web-engine.worker.ts`

以上为聚焦入口，非要求全文加载。使用源码聚焦工具、精确 --source/--unit 和函数片段；接入新 operator 时追加其具体原生文件，单次最多 8 个精确源码文件。没有默认测试入口或要运行的 fixture；功能完成前不执行任何验证。

## 只补未完成部分

1. 复用原生 strip 数据与编辑命令，补齐 trim/split/move/snap、channels/meta、transitions、retiming 和源码现有效果/修饰器。
2. 媒体解码、帧寻址、音频读取和样本时钟复用现有本地库/浏览器真实接口，明确媒体时间与场景帧率映射。
3. 播放、scrub、预取/缓存、代理、缺失媒体重链接和波形预览连接真实内容。
4. 音量/声道/混音、视频色彩/alpha 和 compositor/scene strips 走原生求值，不能只显示时间轴。
5. 把原生编码器或真实浏览器编解码适配接到统一输出，落实容器、音轨、分辨率、帧范围与取消后的文件事务。
6. 禁止以设备不支持某 codec 自动改格式并宣称完整；每格式保留实际实现/依赖。

## 失败边界

音频静音占位、模拟播放进度、空视频文件不计完成；未移植 codec 继续跟踪。

## 实现交接与后续使用

交付前必须具有实际入口→原生执行→消费者/结果→错误/取消→适用 history/save 的生产代码。这里是实现交付条件，不运行验收；编译成功不能替代功能。旧的已完成子项可引用并保留，不能声称本轮重新实现。

用户使用阶段的场景（现在不执行）：剪辑视频与图片序列，混入音频和转场，预览后输出带音轨的视频。

每次记录保留成果、补齐断点、仍有缺口、必要构件与下一动作。共同规则见同目录 `EXECUTION.md`，首次领取时阅读；不要将完整计划作为后续执行上下文。