Files
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

37 lines
4.3 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 所有机器人共享环境
## 当前规则
- 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`。