SuperAPI AI 工具集

test-ecs-core

测试与质量

查看项目

更新于 10-16 05:07

技能介绍

用途:对 IWSDK ECS 核心功能执行端到端自动化验证,运行在示例工程 $IWSDK_REPO_ROOT/examples/poke 中。

主要能力与测试范围:共 8 个套件。1) 系统注册:核对 LocomotionSystem、InputSystem、GrabSystem、TransformSystem 等的优先级与实体计数。2) 组件注册:核对 Transform、Visibility、LevelRoot、LevelTag、PanelUI、AudioSource 及字段默认值。3) Transform 同步:通过 ECS 修改 position 后检查 Object3D 是否同步。4) 暂停/单步/恢复。5) 系统开停(如 GrabSystem)。6) 实体发现:按组件、名称模式、排除组件查找。7) 快照与差分。8) 稳定性:检查日志错误与警告。

使用方式:所有工具调用形式为 npx @iwsdk/cli <子命令> [--input-json '<JSON>'] [--timeout <ms>],在示例工作目录执行,CLI 自动发现应用根目录。先 npm run fresh:install,再后台启动 npm run dev(须用 run_in_background:true,不要加 &),轮询 Vite 就绪或用 npx @iwsdk/cli dev status。连通性用 npx @iwsdk/cli ecs systems 验证。输出为 stdout JSON,形如 {ok, workspaceRoot, operation, result},需解析后断言。重载、进入 XR、截图等用 --timeout 20000。清理用 npx @iwsdk/cli dev down。

限制与已知问题:每条 Bash 命令须单独执行并验证后再继续,不可串联;等待用独立 sleep N 命令。Transform 字段默认 [NaN,NaN,NaN] 属设计,表示不覆盖已有 Object3D 值。重载后 Object3D UUID 与实体索引会变化,须重新获取,不可缓存。ecs step 每步 5 秒超时,渲染循环不活跃时可能失败。TLS 自签证书等告警可忽略,只关注应用级错误。出现非代码原因的瞬时错误(服务器崩溃、WebSocket 超时等)可重启并重试一次,同一套件失败两次则记 FAIL 继续。缺少的细节(如其他配置项、平台支持)暂未提供。