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.
5.3 KiB
5.3 KiB
Microduck 场景提亮、线条调色和交互几何体
本文记录最初的 Microduck 单机器人改动。后续根据“每个机器人的环境都保持一致”的要求,已推广到所有机器人,并改为会话共享布局和全局线条色;当前规则及验证见 共享环境验证。
实现范围
app/src/scene/GameCanvas.jsx:新增半球补光,提高环境贴图、环境光、主光和侧光强度;漫画场景背景从近黑调整为深蓝灰。没有添加外部光照资源或网络依赖。app/src/ui/Hud.jsx、app/src/game/worlds/arena/line-color.js:原左下角四个色块改为 Line color,仍使用原 Cream / Graphite / Lavender / Sky 色值、尺寸、边框、选中动画和漫画面板。同步改变地板与四面围墙的粗细网格线,不修改机器人或几何体材质。颜色在 reset、feet / rollers 切换和机器人往返切换时保留。app/src/game/interactive-props.js、app/src/game/worlds/arena/compose.js、app/src/robots/microduck/runtime.js:生产场景删除足球刚体、足球纹理渲染、生成逻辑和足球专属音频/拖拽分支,替换为每次新建 Microduck runtime 随机生成的 5~7 个轻量几何体,包括方块、球体、圆柱和胶囊体。- 几何体具有独立 MuJoCo freejoint、真实质量、摩擦和碰撞;支持机器人推动/踢动、物体间碰撞、地面/围墙碰撞、鼠标弹簧力拖拽与抬起。生成位置互不重叠并避开机器人出生点,至少一个位于机器人附近。reset / locomotion 切换恢复当前布局;重新进入 Microduck 随机生成新布局。越界物体单独复位。
- 原有足球素材/历史库文件未做无关删除,但生产 runtime 不再加载或创建足球。
物理与回归说明
新增自由刚体会改变 MuJoCo 的 DOF 数。轮滑模型可能跨越自动 sparse Jacobian 阈值,因此显式保留原来的 jacobian="dense",避免几何体数量影响求解路径。
九份历史动作轨迹全部保留,未更新基线或放宽浮点比较。?test=1&oracle=legacy 专门复现历史回归使用的 3 m 实验场及一个远处停放的无足球纹理球形物理探针,保留原始 DOF 数和接触参数,从而继续精确比对全部状态。正常运行和 ?test=1 单独使用时都构建真实的 5~7 个几何体场景。新场景的碰撞、鼠标拖拽、物体数量、材质、光照和运行稳定性由独立浏览器测试覆盖,不以历史实验场测试替代。
验证覆盖
app/test/interactive-props.test.js:2,000 个布局(1,000 个随机种子 × 3 m / 4.5 m 两种边界),验证 5/6/7 数量、四种形状、出生点净空、物体间距、边界和质量;验证可视几何体尺寸、Z-up 转换、刚体状态同步与复位;验证四种颜色同步更新地面与四面墙。app/e2e/scene-interaction.spec.js:真实 Chromium + MuJoCo WASM,验证新光源与场景初始内容、四个色块外观与功能、机器人材质不变、鼠标物理拖拽、暂停释放抓取力、重置布局、物体间动量传递、机器人/地面碰撞、腿/轮滑切换后的物体数量及状态。app/e2e/scene-stability.spec.js:真实新场景中腿/轮滑各 60 秒模拟时间的连续运动,检查状态有限、物体边界、确实产生移动,以及越界物体单独恢复。app/e2e/deployment.spec.js:正常生产入口自动显示 5~7 个物体且不存在足球;继续覆盖三种机器人与静态资源路径。app/e2e/runtime-leaks.spec.js:20 次机器人切换后检查 WASM 对象释放、GPU 几何体、纹理和事件监听器无增长;对当前 5~7 个物体带来的预期几何体数量差异做精确扣除,而非放宽泄漏上限。
执行结果
cd app && npm test:62/62 通过。npm run validate:packages:四个 bundled Package 的 schema、World、资源路径与既有来源校验全部通过。npm run format:check、npm run build、git diff --check:通过。npm run test:e2e:48/48 通过(13.8 分钟;包含九项精确历史动作回归、三机器人场景/动作、20 次资源切换及新场景交互)。该批启动后补充的连续运动用例另外独立执行并通过。- 对最终
dist/启动本地 Vite preview,以TEST_BASE_URL=http://127.0.0.1:5175 npm run test:e2e -- scene-interaction scene-stability deployment robot-switching microduck-regression --output=/tmp/microduck-scene-production-final-artifacts执行生产包复验:16/16 通过(2.7 分钟)。覆盖全部新交互、围墙阻挡、正常入口无足球、两分钟新场景模拟运动和九项历史动作精确回归。 - 人工查看新场景截图:
app/test-results/scene-interaction-overview.png,确认补光后的机器人及彩色几何体、浅蓝网格线和保留原样的四格色板显示正常。截图属于忽略的本地测试产物,不提交大尺寸图片。
日志:/tmp/microduck-scene-unit-tests.log、/tmp/microduck-scene-full-e2e.log、/tmp/microduck-scene-production-final-tests.log。全量浏览器 JSON 结果另存于 /tmp/microduck-scene-full-results.json。
边界:没有声称执行连续 15 小时实时时长的压力测试;新增长序列检查为真实 WASM 中累计两分钟的模拟运动。