用途:在 IWSDK 的 physics 示例中验证 Havok 物理系统,包含 5 组测试套件:重力(动态刚体下落)、静态刚体不动、PhysicsBody 状态字段、系统与组件注册、稳定性。
主要能力:通过 npx @iwsdk/cli 子命令操作示例工作区,检查 ECS 系统、组件、实体与浏览器日志,并用暂停/步进/快照/差异对比做确定性重力测试。
使用方式:先进入 $IWSDK_REPO_ROOT/examples/physics 执行 npm run fresh:install,再以 run_in_background 启动 npm run dev,轮询 Vite 就绪或 npx @iwsdk/cli dev status。随后用 npx @iwsdk/cli ecs systems 验证连通性,按顺序执行 reload、xr enter、日志检查、ecs find/query 等命令。每条 Bash 命令单独运行并解析 JSON 输出后再继续,等待用独立 sleep 命令。结束时用 npx @iwsdk/cli dev down 关闭服务并输出结果表。
限制:需在示例工作区运行;Havok WASM 初始化异步,_engineBody 可能首帧为 0;PhysicsManipulation 为一次性,处理后无法查询;PhysicsSystem 运行时可能覆盖 Transform 位置,修改前需 pause;实体索引在 reload 后变化,不可缓存;无独立静态 PhysicsBody 实体时套件 2 标记 SKIP;瞬时错误可重启服务重试一次,同一套件失败两次记 FAIL。