Files
VibemakerSandbox/docs/superpowers/verification/shared-robot-environment.md
T
chenlin a8be5e0134 feat: release v0.5 with shared interactive arenas and textured RP1
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.
2026-10-30 14:14:03 +08:00

4.3 KiB
Raw Blame History

所有机器人共享环境

当前规则

  • 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。