4.0 KiB
4.0 KiB
N-018 Physics 与 Simulation
状态：BLOCKED（family capability、settings/dependency/cache manifest、错误帧门及浏览器自有
BTF1 播放会话已落地；desktop bake playback、WASM solver 和 bake job 未实现）
已验证切片
- N-018-A：Rigid Body、Soft Body、Cloth、Fluid、Dynamic Paint、Particle、Hair
使用固定枚举能力清单；metadata/cache manifest 为
LOCAL_BOUNDED，cache playback、 local solver、server job 均保持BLOCKED。 - N-018-B（部分）：
PhysicsSimulationManifestIR绑定 owner Object、settings SHA-256、 有界设置摘要、依赖 stable ID 和 desktop bake cache；系统依赖环、重复依赖和超预算拒绝。 - N-018-C（门）：cache 绑定 source blend/settings/input/cache SHA-256、帧范围和实际已缓存帧；
COMPLETE必须逐帧连续，frame seek 只返回精确命中帧，禁止复用相邻错误帧。 - Simulation cache 在 Worker restart 后重新验证整包；帧级读取在 OPFS 使用目标 range、
IndexedDB 使用有界 slice，并再次校验该帧 SHA-256，越界帧返回
SIMULATION_CACHE_MISSING。 - 单 manifest 上限 4096 systems、每系统 1024 dependencies、256 settings/64 KiB、 100k frames；单帧 512 MiB、整包 16 GiB，分配和 range 计算前检查安全整数及预算。
- authoritative Main reader 扫描真实 Rigid Body、Soft Body、Cloth、Fluid、Dynamic Paint、 Particle/Hair 数据；只输出实际存在的 system，绑定 owner stable ID、有界 settings、collision dependency 和浏览器可复算 SHA-256。当前 fixture 实证覆盖禁用 Cloth、Soft Body 和 Collision 依赖，save/reopen 保持一致；未用合成 system 填充其余 family。
- N-018-C（浏览器格式边界）：版本化
BTF1二进制帧可解码有界 object transform，校验 frame、对象 stable ID、精确字节长度、有限 translation、单位 quaternion、非零 scale 和重复 ID。该格式仅是浏览器自有的 cache playback primitive，不是 Blender desktop bake family payload，因此 capability inventory 的cachePlayback仍为BLOCKED。 - N-018-C（预览适配）：精确帧匹配的 BTF1 可不可变地映射到 SceneIR preview，按 stable object
ID 更新 translation/quaternion/scale、Euler、local/world matrix 和当前帧；未知对象、错帧、
层级环或缺父对象拒绝。该适配只证明浏览器自有 transform cache，不改变 desktop family
bake playback 的
BLOCKED状态。 - N-018-C（浏览器播放会话）：BTF1 支持有界范围顺序播放、精确 seek 和 cancel；新请求会使旧
异步读取失效，即使底层读取器忽略
AbortSignal，迟到结果也不会覆盖当前预览。每帧都从同一 不可变基准 SceneIR 应用绝对变换，避免逐帧累计误差。 - N-018-C（持久缓存集成）：两帧真实 BTF1 经过 content-addressed Simulation cache 写入，终止 Storage Worker 后由新 Worker 精确 range 读取第二帧并应用到 SceneIR；帧 hash、magic、offset 和最终 object translation 均验证。
仍然阻断
- N-018-A/B：从真实 Main 提取完整 family settings、collection/effector/collision 依赖。
- N-018-C：desktop bake payload 的逐 family decoder、正式 viewport UI 播放控制和 100 帧 golden；浏览器自有 transform frame decoder/SceneIR 播放会话已完成但不替代 Blender bake。
- N-018-D：逐 family WASM solver 初始化、线程、内存和确定性验证。
- N-018-E：bake start/cancel/commit、服务端 job、故障恢复、进度与 UI。
验收
WEB_TEST_PORT=5204 npm --prefix web run test:e2e -- --grep "N-018 physics"
npm --prefix web run test:simulation-cache
npm --prefix web run test:physics-main-reader
本轮在 Chromium 隔离端口复验 content-addressed cache 的 Worker restart、目标帧 range read、
帧 SHA-256、BTF1 seek/play/cancel 和迟到结果抑制通过；没有 desktop bake family decoder 或
solver，因此 desktop playback/solver/bake 状态不变，继续为 BLOCKED。