# DW20：关键帧、Graph、Dope Sheet、NLA 与驱动

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

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

ANIMATION、NLA strip、ACTION-MARKER、FCURVE-DRIVER 覆盖已有实现。

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

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

## 操作者工作流与交付

创建关键帧/动作 → 曲线编辑 → NLA/driver → 播放求值 → 保存

从打关键帧到编辑和播放的连贯动画工作流。

## 最小生产入口

- `web/protocol/animation-render-commands.ts`
- `web/protocol/nla.ts`
- `blender-5.2.0/source/blender/web_engine/web_engine_main_state.cpp`
- `blender-5.2.0/source/blender/editors/space_graph/space_graph.cc`
- `blender-5.2.0/source/blender/editors/space_action/space_action.cc`
- `blender-5.2.0/source/blender/editors/space_nla/space_nla.cc`
- `web/app/src/app/App.tsx`

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

## 只补未完成部分

1. 复用原生动画数据和 typed command，补齐 keyframe/插值/handles、通道选择/锁定、动作 slot 与 markers。
2. Graph/Dope Sheet/Timeline 共享 frame/time/context；剪切复制、缩放、吸附、循环和范围操作实际更新原生数据。
3. NLA track/strip、混合/时间映射、动作引用与 transitions 按源码完整接通。
4. driver 变量、路径解析、表达式和依赖更新使用原生 RNA/Python 生命周期；不在 JS 重新求值。
5. 播放与 scrub 使用正确帧率、依赖求值和 redraw；缓存取消/历史/文件切换正确处理。

## 失败边界

时间轴移动或参数显示不能代替原生动画求值；失效 driver 不得静默返回旧值。

## 实现交接与后续使用

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

用户使用阶段的场景（现在不执行）：制作多动作动画，调整曲线，再用 NLA 混合并添加驱动关系，保存重开播放。

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