# DW22：物理模拟、粒子与缓存烘焙

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

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

PHYSICS-SIMULATION-COVERAGE 和原生 physics protocol/入口已存在。

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

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

## 操作者工作流与交付

配置模拟对象/约束 → 时间求值 → cache/bake → 播放/清理/保存

真实可烘焙、可回放、可保存的物理工作流与逐 solver 状态。

## 最小生产入口

- `web/protocol/physics-simulation.ts`
- `web/protocol/modifier.ts`
- `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`
- `blender-5.2.0/source/blender/editors/physics/particle_object.cc`
- `web/app/src/workers/web-engine.worker.ts`
- `web/app/src/app/PhysicsSettingsEditor.tsx`

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

## 只补未完成部分

1. 按本地源码现有 rigid body、cloth、soft body、fluid、particles/force fields 等模块逐批实现，补齐实体与资源依赖。
2. 真实 solver 用现有原生源码编译入所需 WASM；几何查询/拓扑操作统一现有 OCCT 出口，不用 JS 简化运动替代模拟。
3. 补齐初始状态、碰撞/约束/域参数、时间步、依赖关系和动画驱动。
4. 缓存目录、bake/free/rebake、参数/拓扑变化失效、帧范围和 pack/reopen 共用 DW06/DW14。
5. 长任务取消/内存不足/solver 错误保留 coherent 场景；不能把 UI 配置成功当作 solver 已执行。

## 失败边界

粒子/流体/布料互不替代；某一 solver 未移植时仍是完整功能范围中的未完成项。

## 实现交接与后续使用

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

用户使用阶段的场景（现在不执行）：设置刚体和布料场景，烘焙后播放，修改碰撞参数重新烘焙并重开工程。

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