Files
workinf_Blender_Wasm/docs/tasks/WBV2-P1424-001-desktop-completion/DW22.md
mes123456 f3e21c6b98
Some checks failed
M6 deployable RC / quick (push) Has been cancelled
M6 deployable RC / chromium (push) Has been cancelled
M6 deployable RC / release (push) Has been cancelled
chore: checkpoint web Blender migration source, tools and docs
Accumulated uncommitted work: GHOST Web backend, WebGL/GPU web layer,
web workflow engine and protocol, tooling, docs and task records.
Large generated evidence, user-testing archives, build snapshots and
imported test assets remain untracked.

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-11-10 11:18:01 +08:00

3.1 KiB
Raw Blame History

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,首次领取时阅读;不要将完整计划作为后续执行上下文。