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.
37 lines
4.3 KiB
Markdown
37 lines
4.3 KiB
Markdown
# 所有机器人共享环境
|
||
|
||
## 当前规则
|
||
|
||
- 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`。
|