blender-simulation-workflow

Blender 模拟工作流

每项任务开始时，请阅读一次共享执行指南，以指导自主决策、证据检查频率和长任务连续性。

模拟是生成缓存的构建步骤。请保留设置和缓存来源信息；单帧视觉效果看似合理，并不能证明模拟稳定。

定义模拟约定

记录模拟类型、求解器、时间轴、比例、重力/力、碰撞物体、发射器、域边界、期望行为、缓存位置、分辨率或子步数，以及交付格式。注明用于确定起始、交互峰值和稳定状态的帧。对于流体，明确区分液体与气体/火焰/烟雾，并说明交付物是网格、粒子还是体积。

使用项目本地且不纳入源代码管理的缓存目录。除非创建新的输出位置或获得用户明确批准，否则绝不覆盖已通过审核的烘焙结果。

构建受控设置

1. 应用或考虑物体缩放；使用真实世界的场景比例并记录单位。碰撞体和域的缩放不当会使调试结论失效。
2. 为域、流体/发射器、效应器/碰撞体、力场、缓存和输出物体赋予语义明确的名称。将输入内容与生成的网格、体积、粒子或烘焙产物分别放入不同集合。
3. 先创建较短、较低质量的预览缓存，以验证因果设置、碰撞方向和时间安排。查看预览证据之前，不要开始耗时的最终烘焙。
4. 对于流体/烟雾/火焰，合理限制域的范围以控制成本，同时为所需运动留出足够余量。有意选择 Modular 或 Final 缓存；适用时记录按顺序执行的烘焙阶段。
5. 对于刚体、布料、软体、粒子或毛发，先确定碰撞体厚度、子步数、阻尼/摩擦、自碰撞和钉固/附着约束，再设置美观性力场或湍流。
6. 为随机效果明确设置种子。将缓存设置和模拟器版本与生成脚本一同保存。

烘焙与验证

1. 烘焙预览，然后从至少两个有用的摄像机角度检查指定的关键帧。
2. 检查发射器和碰撞体是否在预期时间影响结果；域是否会裁切结果；碰撞是否会穿透、爆炸或发生贯穿；以及质量、阻力、稳定状态和比例是否合理。
3. 每次只更改一组因果参数，使受影响的缓存失效，并仅重新烘焙足以验证更改的最小帧区间。
4. 只有预览通过后，才烘焙最终数据。确认预期的每个缓存阶段/文件都已生成，并且时间轴读取的是这些缓存，而不是重新计算隐式临时状态。 在全新的 Blender 进程中重新打开已保存的场景，并使用 blender_inspect_motion 检查相同帧。对于液体，以求值后的域网格为目标；确认表面非空且会变化，并存在原生数据/网格烘焙元数据。流体修改器、Replay 缓存或静态代理都不算完成烘焙。最终缓存使用 Python 枚举 ALL；UI 标签不一定是枚举标识符。布料除了可见形变外，还必须有已烘焙的点缓存。这些检查不能证明物理模拟正确。
5. 渲染所需的关键帧；如果时间安排很重要，则使用 $blender-agent-studio:blender-rendering-workflow 生成编码后的预览或最终序列。

完成门槛

交付可复现的设置脚本或 .blend、缓存清单（类型、位置、帧、分辨率/子步数、种子、Blender 版本）、按要求提供的最终缓存或导出的模拟产物，以及经过视觉检查的证据。诚实说明验证范围：短缓存预览只能验证其中的帧，不能验证完整的最终时间轴。将模拟转换为网格或导出格式后，请进行资产验证。