feat: release v0.4 with textured Microban visuals
This commit is contained in:
@@ -16,6 +16,8 @@
|
||||
|
||||
- `model.xml` 与它实际声明的 25 个 STL;原模型不修改,运行时组合空地与 timestep。
|
||||
- `policies/walk.onnx`。
|
||||
- `visuals/*.glb`:用户提供的新版 `microban2.zip` 中 20 个原始 GLB,保留 PBR 材质和 46 张内嵌纹理(45 张法线贴图及 1 张屏幕颜色贴图);替代白模显示,不替换物理网格。
|
||||
- `visual-source-manifest.json`:视觉压缩包和逐文件 SHA-256,与原物理 / 策略来源记录分开。压缩包没有许可说明,公开分发前需向资产所有者确认。
|
||||
- `source-manifest.json`:源 remote、HEAD、dirty 标志、逐文件 SHA-256、行为参考代码哈希。
|
||||
- `SOURCE.md` 和 `LICENSES/`:原项目混合许可文本、XML 的 Apache-2.0 许可文本和归属说明。
|
||||
|
||||
@@ -28,6 +30,20 @@ npm --prefix app run validate:packages
|
||||
|
||||
导入是显式离线维护操作,不是运行或构建的依赖;日常运行不读取源仓库、不要求 Python / BAM / Placo。导入后需检查是否有实质变化,不自动接受策略 / 行为更新。
|
||||
|
||||
## 带纹理外观
|
||||
|
||||
刷新页面后选择 Microban 即使用新外观:浅紫外壳、蓝色金属支架、黑色电机及带颜色贴图的屏幕。新版 20 个 GLB 的顶点位置和节点变换与上一版一致,保留现有部件绑定。`render.body_visuals` 将 BASE、LINK1–19 映射到已有的 20 个 MuJoCo body,显式记录米制平移和 xyzw 单位四元数。坐标变换经原几何对齐检查;部件包围盒端点差异最大约 3 mm,包含新外观的螺丝等细节,不是运行时自动猜测比例或改变关节姿态。
|
||||
|
||||
所有部件每帧读取原 `xpos/xquat`,包括独立转头;原 visual geom 隐藏,碰撞、质量、惯量、关节、策略和 PD 均保留。GLB 加载失败会放弃候选机器人并恢复旧机器人,不会以静默白模掩盖缺失资源。切换时释放几何、材质、纹理和 ImageBitmap。
|
||||
|
||||
```bash
|
||||
python3 app/scripts/import-microban-visuals.py /path/to/microban2.zip
|
||||
npm --prefix app run validate:packages
|
||||
npm --prefix app run test:e2e -- microban-visuals.spec.js microban-walking.spec.js runtime-leaks.spec.js
|
||||
```
|
||||
|
||||
`microban-visuals.spec.js` 验证 20 个 body 的材质/纹理、原 visual 隐藏、非零根 yaw 和关节角下的对齐、失败回退,以及开关新视觉后 80 个控制周期的 qpos / qvel / ONNX action 逐项完全一致。截图保存于该测试的 `test-results/` 输出目录。行走原有三轮有界 70 s、三轮无界诊断 84 s 和 H / reset / 近 50 Hz 验证通过;20 次跨 Microduck / Microban / RP1 切换后,Microban 的 GPU 纹理数稳定为 48(46 张模型纹理加场景资源),无增长。
|
||||
|
||||
## 策略接口
|
||||
|
||||
| 项目 | 数值 |
|
||||
|
||||
@@ -41,6 +41,27 @@ app/public/robots/example/
|
||||
- `app/src/platform/loader/world.schema.json`
|
||||
- `SchemaValidator.js` 的跨字段检查(所有权、输入绑定、命令尺寸等)。
|
||||
|
||||
## 可选分部件 GLB 外观
|
||||
|
||||
通用 runtime 保留 `render.source: "mjcf_visual"`,可增加 `render.body_visuals`,仅替换指定 body 的可见几何:
|
||||
|
||||
```json
|
||||
"body_visuals": [
|
||||
{
|
||||
"body": "trunk",
|
||||
"path": "visuals/trunk.glb",
|
||||
"position": [0, 0, 0],
|
||||
"quaternion": [0, 0, 0, 1]
|
||||
}
|
||||
]
|
||||
```
|
||||
|
||||
`body` 必须是 MJCF 中存在的非 world body,且不能重复。`position` 为米制 body-local 平移;`quaternion` 为 xyzw 单位四元数;省略时分别使用零平移 / 单位旋转。不按导出文件名猜 body,不使用 MuJoCo 编译器重心校正后的 geom 坐标绑定 GLB。模型单位须预先为米,不支持隐式自动缩放。
|
||||
|
||||
GLB 必须自包含(纹理/二进制内嵌),不能引用外部图片或 buffer;`path` 是包内相对 `.glb` 路径。资源经 PackageLoader 加载,保留部署前缀与同源签名。GLB 不加入 `assets` / VFS,因为它们不参与物理编译。隐藏原 visual 不修改原碰撞、惯量、关节、策略或动作。缺失 body 或资源导致候选加载失败,并通过现有切换流程回退。
|
||||
|
||||
新增视觉资源应单独保存 `visual-source-manifest.json`,包含 `files: [{"file":"visuals/trunk.glb","sha256":"..."}]`;`validate:packages` 同时验证原来源记录、视觉记录和 GLB 自包含约束。示例与实测记录见 [Microban](microban.md)。
|
||||
|
||||
## 场地与机器人尺寸
|
||||
|
||||
在 Robot Package 顶层声明参考站姿的全身高度(米),例如:
|
||||
|
||||
Reference in New Issue
Block a user