a8be5e0134
Unify lighting and line-colour controls across robots, replace the football with a shared layout of draggable physical props, and import the supplied RP1 GLBs without changing trained physics or policies. Include reproducible visual import/provenance, regression coverage and verification records. Verified 66 unit tests, 55 browser tests and production-build checks.
4.3 KiB
4.3 KiB
所有机器人共享环境
当前规则
- Microduck、Microban、RP1 使用相同的补光、环境贴图亮度、背景、网格线色板和漫画式场景显示。
- Line color 在每个机器人界面都可用,仍为原四种色块及原按钮样式;颜色为全局会话设置,从任意机器人更改后切换其他机器人不会恢复成各自旧颜色。
- 同一浏览器会话只随机生成一套 5~7 个交互几何体。各机器人的种类、色彩、旋转及相对布局相同,保留原先的尺寸适配:4.5 m / 5.5 m / 22 m 场地按机器人尺度缩放,几何体大小与坐标同步缩放。质量按尺度平方增长,保持大机器人场景中的物体轻便可推。
- 默认出生点
(-0.6, 0)和(0, 0)均预留净空。不同机器人有独立的物理仿真,切换恢复这套共同的初始布局,不跨不同尺度仿真搬运实时物体速度。刷新页面才重新随机布局。 - 所有机器人都可与几何体真实碰撞、推移;几何体也与地面、墙壁及其他几何体碰撞。鼠标拖动物体或机器人施加物理弹簧力;拖动空白区域仍然旋转相机。暂停、重置、切换及资源清理时释放抓取力。
- 仅场景控制共用:Microduck 特有的 Feet / Rollers 按钮不会出现在 Microban / RP1 上;机器人动作、策略、关节控制和尺寸缩放契约不变。
- 显式无边界诊断 World 不添加干扰物;历史 Microduck 动作 oracle 仍保持原始实验模型,以便继续精确对比九份未修改的轨迹基线。
关键实现
app/src/game/worlds/arena/session-environment.js:会话共享模板及统一 MuJoCo 几何体注入。app/src/game/interactive-props.js:统一几何体形状、材质、刚体状态同步和资源清理;生成器支持多个出生点净空。app/src/platform/sim/{SceneComposer,SimCore}.js:generic 机器人同样包含交互刚体,重置、越界恢复和显式测试隔离。app/src/platform/runtime/{RobotRuntime,RuntimeManager}.js:统一线条颜色、几何体渲染、设置传递、物理拖拽和资源所有权。app/src/platform/input/PhysicsDrag.js:generic 机器人/几何体的真实拖拽及每个物理子步施力。app/src/game/worlds/arena/presentation.js、app/src/ui/Hud.jsx:所有机器人共用地面/围墙调色入口,机器人特有操作仍按 capability 控制。
新增验证
app/test/session-environment.test.js:三个机器人比例使用同一模板;坐标、几何体尺寸按同一尺度变化;避开两个出生点;返回值相互隔离、不污染共享模板;诊断 World 不添加物体。app/e2e/shared-environment.spec.js:跨 Microduck → Microban → RP1 → Microduck,检查同一几何体数量、形状、颜色、归一化布局、光源及环境亮度,验证全局颜色继承和机器人特有按钮边界。- 同一浏览器用例验证 Microban 和 RP1 的真实围墙碰撞、鼠标施力拖拽、暂停清除抓取力和重置布局。
执行结果
cd app && npm test:63/63 通过。npm run format:check、npm run validate:packages、npm run build、git diff --check:通过。npm run test:e2e:52/52 通过(15.0 分钟)。没有为障碍物放宽步行/技能断言;Microban 长序列步行、RP1 行走/舞蹈/挥手、九项 Microduck 精确历史回归、新场景交互、两分钟运动稳定性、20 次切换资源释放均通过。- 对最终生产包再次执行
TEST_BASE_URL=http://127.0.0.1:5175 npm run test:e2e -- shared-environment scene-interaction deployment microduck-regression --output=/tmp/shared-environment-production-artifacts:16/16 通过(3.1 分钟)。其中共享颜色测试还覆盖在 RP1 选择 Lavender 后返回 Microduck,验证不会被 Microduck 的旧设置覆盖。 - 人工查看生产入口的 Microban / RP1 截图,确认两者均显示相同网格、原四格色板及同布局的彩色几何体,机器人自身呈现不变。截图位于
/tmp/shared-environment-production-artifacts/deployment-deployed-assets-19ea7-l-three-Robot-Packages-boot/。
日志:/tmp/shared-environment-unit.log、/tmp/shared-environment-full-e2e.log、/tmp/shared-environment-production-e2e.log;全量浏览器 JSON 结果另存于 /tmp/shared-environment-full-results.json。