Add declarative robot packages, shared simulation lifecycle and Microban ONNX/PD walking with independent head control. Unify comic UI and chase camera; default robot packages to a 4.5m arena with real collision walls. Include regression tests, asset provenance/licenses and verification evidence.
9.9 KiB
多机器人平台首期工程验收
历史检查点:2026-10-28 已按用户确认统一界面风格和背后跟随相机。当前行为与验证见 更新报告;下文保留原验收状态与当时的输入哈希。
- 日期:2026-10-27;最终自动化检查完成于 22:03(UTC+08:00)。
- 结论:本地首期实现及自动化验收通过;待用户实际体验确认。未提交、未推送、未部署。
- 范围:Microduck legs / rollers;Microban ONNX 行走及独立转头;单一仿真界面。
- 依据:批准的设计、实施计划。
1. 交付内容
| 阶段 | 结果 |
|---|---|
| P0 / T01–T04 | 真实浏览器/WASM、独占步进、原版 Microduck 参考、资产来源/许可与 Microban PD 可行性验证 |
| P1 / T05–T06 | 生命周期、冻结式暂停、自动启动、行内错误/重试、工具栏及默认展开的键盘帮助;移除菜单/BIOS/触屏层 |
| P2 / T07–T11 | Package/World schema、加载与验证、共享调度/模型寻址/观测/动作/驱动、primary/overlay 技能;Microduck 兼容适配器 |
| P3 / T12–T14 | arena/flat World、编译后 MJCF 视觉、事务切换、失败回滚、资源释放与偏好恢复 |
| P4 / T15 | Microban 正式接入、50 Hz 控制、行走和独立 head overlay、手动倒地复位 |
| P5 / T16 | 单元/浏览器/生产构建/子路径检查、文档、截图、录像和数值记录;下述未验证事项不计入已通过范围 |
入口是 app/src/App.jsx / app/src/scene/GameCanvas.jsx。通用能力在 app/src/platform/,注册表在 app/src/robots/registry.js;原有 Microduck 行为迁至 app/src/robots/microduck/runtime.js,game/game.js 仅保留兼容导出。
平台核心没有按 Microduck/Microban ID 分派的逻辑,也不导入 game/;内置适配器名称在 schema 中显式允许。Microduck 的 GLB、材质和既有技能仍由专用适配器维护,并未声称全部转换成通用声明式状态机。
2. 最终检查结果
环境:Linux x86_64、Node v24.19.0、Playwright 1.64.1、Chromium/SwiftShader,MuJoCo @mujoco/mujoco 3.11.0。依赖由 app/package-lock.json 锁定。以下均为实际执行,没有 skip、自动重试或更新已接受黄金快照。
| 检查 | 结果 | 持久证据 |
|---|---|---|
npm --prefix app test |
29/29 | 测试源:app/test/*.test.js |
npm --prefix app run validate:packages |
三包 schema、World、路径通过;Microban 实际文件哈希通过 | 两个 Microduck 包各 10 路径;Microban 27 路径 |
npm --prefix app run format:check |
通过 | 按脚本指定的新模块/测试范围检查,不代表整个历史代码库重排格式 |
npm --prefix app run test:e2e |
25/25,226.54 s | 开发态结果 |
npm --prefix app run build + production preview |
20/20,173.34 s | 生产结果 |
VITE_BASE=/play/ build + preview |
1/1,20.20 s;两机器人、资源前缀、字体均通过 | 子路径结果 |
npm --prefix app audit |
0 vulnerabilities | 当前锁定依赖的检查;不等于安全审计保证 |
git diff --check |
通过 | 没有自动提交 |
最终 app/dist 已重新构建为默认根路径版本。临时原版/生产/prefix preview 服务在验收后关闭;未关闭已有开发服务器。
生产套件包括九个 Microduck 数值场景、Microban 三轮协议/实时控制/IMU、鼠标选点与物理拖拽、双向切换与回滚、独占步进和 UI。完整开发套件还包含隔离 PD probe、渲染器夹具、并发竞态及 20 次切换资源检查;因此不要把“生产 20 项”误写成生产环境执行了全部 25 项。
3. Microduck 保真
九个场景:stand、walk、kick、sitstand、groundpick、roll、recovery、rollers、crouch。按固定输入和种子执行,当前实现与原版同后端参考的观测、动作和物理轨迹比较通过,没有提高容差或用当前实现覆盖参考。
参考来自独立归档的原始提交 44d3681726468bdd00e88241894d5faa53e3c63e,不是重构后 runtime 自己生成的“预期值”。建立参考时发现外观用球生成会改变 RNG/物理状态,随后统一隔离条件并从原版重新采集;出处及条件见 基线说明。baseline:record 只生成忽略的候选,不自动接受。
保留 arena、GLB、配色、追随/轨道相机、鼠标物理拖拽、主要技能和原有倒地恢复。跨机器人切换重新初始化物理,并记住本会话内 Microduck 配色和 legs/rollers;家族内切换仍走原有安全路径。窗口实际相机与加载时被 helper 捕获的相机已同步,并新增真实鼠标选点/拖拽检查。
视觉材料供用户复核,不以九条数值回归代替所有可能玩法或像素级视觉验收:
4. Microban 实际物理证据
- 原模型、25 个 STL 与 ONNX 复制到包内,正式运行不依赖
../microban或 Python。 - 源 HEAD 为
d0a128d180ecfce69eaaf31b295a0fce31280bfd,源工作区本来有未提交修改;记录的是实际文件哈希,未修改源项目。 - 真实 policy
obs [1,63] → actions [1,18];metadata 有 19 个关节,按名称选取 18 个 actor 关节,head 不进入 actor/lastAction。 - IMU 角速度保持 site frame;投影重力由去除安装旋转的 trunk 姿态计算,已用非零姿态/角速度检查。
- 简化 PD:
kp=.3、kd=.02、|tau|≤.65 Nm,每个.005 s物理子步更新;decimation 4,控制 50 Hz。原<motor>的 ctrl 写入力矩,不把目标角当力矩。 - 键盘速度:前进
.15 m/s、后退-.1 m/s、转向±.6 rad/s。未降低重力、锁定底座、播放 qpos 轨迹或以定时 reset 掩盖倒地。
完整三轮记录。每轮从复位开始,10 s 站立、20 s 前进、10 s 后退、左右转向各 10 s、四段 3 s 零命令、行走中转头 10 s、关头后继续 2 s,共 84 s。轮内无倒地/重置,状态有限;三个复位起步重复通过。
| 指标(每轮) | 实测 |
|---|---|
| 20 s 前进:按段起始朝向投影位移 | +2.438 m |
| 10 s 后退:同定义投影位移 | −0.769 m |
| 左转/右转累计偏航 | +4.780 / −4.564 rad |
| 行走并行转头实测范围 | −0.692 至 +0.693 rad |
| 关头 2 s 后角度 | 约 +0.040 rad;目标为 0 |
| 力矩采样/饱和 | 319,200 / 0 |
Head 目标仍为 .35 Hz、±π/4,启停 .5 s 插值;H 开关不清 walking actor 的 lastAction,暂停冻结技能时间。实际关节幅度/残差反映简化 PD 跟踪,不宣称 BAM 等价。
实时记录:约 5.005 s 墙钟推进 5.040 s 仿真,比例 1.007。这是本机短窗测量,不是所有设备实时性保证。另测了主动制造倒地、Space 手动复位和键盘 H;正式运行没有 Microban 自动站起。
5. 生命周期和故障
同页面 20 次切换记录:旧 model/data 均确认 deleted;稳定阶段 Microduck 约 46 geometry/4 texture/24 个被跟踪监听器,Microban 64/1/14,场景顶层 children 为 5。跟踪范围是 window/canvas,不声称穷尽浏览器/驱动的每一字节。
已实际覆盖:
- 自动循环与手动步进互斥,等待在途推理;暂停后不补偿过去的墙钟时间。
- 切换 single-flight、旧 tick 排空、held keys 清理、暂停意图保留。
- 模型/GLB/策略加载失败:行内错误、重试、保留旧 runtime、未污染共享 GLB 缓存。
- 复位与暂停的技能计时;输入框/选择器/按钮的原生键盘行为;帮助与输入路由共用 bindings。
- 编译后 mesh/primitive 的变换、倒序 actuator 的名称寻址,不使用两个模型间的索引巧合。
收尾修复:Google Fonts 外部 CSS 曾使 page.goto(..., waitUntil=load) 等待到 180 s 超时。现本地打包 Anton 并保留 OFL 通知;根路径/子路径默认加载两机器人均验证没有外站请求。中性 World 的参考网格直接着色于编译后的物理地面视觉,不增加碰撞体,也不使用有裁剪伪影的长 GL line 叠层。
6. 已知限制 / 未验证
- 简化 PD 不是 BAM。Microban 前进会有方向漂移,转向/头关节跟踪存在误差;没有硬件、BAM 或 Python 全轨迹等价保证。
- 没有连续 15 小时耐久试验。20 次切换的平台资源计数不能证明任意使用时长绝无泄漏。
- Docker、实际公网部署、私有 Hugging Face 签名鉴权未独立部署验收;已有同源
signed()行为保留。构建仍有 MuJoComodulebrowser-externalization 提示,真实浏览器运行测试已通过。 - 音频 master
SOUND_DISABLED=true保持原状。仿真不等用户音频手势;未启用或验收有声音频。 - 移动端、触屏、手柄、Microban Placo 下蹲、联网/贴纸/庆祝、任意远程 Package、固定底座机械臂、RNN/历史/图像观测不在首期交付。
- 保留 Microban 各资产实际混合许可与来源,并保留 Anton OFL;发布/再分发前仍应复核相应义务。
- 没有自动提交;实施前已有的设计文档修改也一并留在工作区供用户审阅。
7. 复现与进一步接入
运行、测试和 /play/ 构建命令见 README。新增包流程见 Package authoring,Microban 坐标/策略/PD 参数详见 Microban 接入。
验收时源码与资产 SHA-256 不含生成的 dist、node_modules 或本报告;依赖以锁文件为准。机器可读通过列表和物理数据保留在本目录,不依赖 /tmp 测试日志。

