跳到正文
已核查原始资料

MicroDuck 策略导出:检查点转 ONNX,再正确回放

用官方导出器保留观测归一化,核对 61 输入与 14 动作接口,再用当前命令布局回放并预览发布包;说明旧模型与硬件部署的边界。

训练检查点不能直接改名为 ONNX。用匹配任务的官方导出器保留观测归一化,再核对输入布局、关节顺序和回放参数。当前 MicroDuck 策略接口是 61 个观测值与 14 个动作值。

先保留模型的上下文

记录生成检查点的提交号、任务 ID、配置与来源。下面的路径只是示例,必须替换为实际文件;已有 first-walk.onnx 先另存,避免被覆盖。

用官方导出器处理检查点

可复制示例
uv run scripts/export.py Mjlab-Velocity-Flat-MicroDuck \
  --checkpoint-file /absolute/path/to/model_3000.pt \
  --num-envs 1 \
  --onnx-file first-walk.onnx

导出器包含训练时的观测归一化。play 中看起来会走,不足以证明自行转换的模型正确带上归一化。

按当前接口回放

可复制示例
uv run scripts/infer_policy.py \
  --walking first-walk.onnx \
  --new-cmd-obs

--new-cmd-obs 对应当前 61 输入布局;旧 51 输入模型需要关闭该选项并确认兼容来源。该查看器使用 CPU ONNX 推理,但仍需要 Python 依赖、模型资产和图形环境。

浏览器按键不要搬到本地查看器

浏览器 R 是坐下/站立;本地脚本 Y 才对应已加载的坐站策略。行走命令没有自动加载踢腿、翻滚等模型。以本地脚本为准。

发布前只预览打包

可复制示例
uv run publish --onnx first-walk.onnx \
  --repo YOUR_USERNAME/microduck-first-walk \
  --kind perpetual --slot walk --dry-run

替换 YOUR_USERNAME。此 perpetual / walk 示例只适用于持续行走策略;--dry-run 检查形状、基础输出和清单,在本地准备包但不上传。它会重建 publish-first-walk 目录,手写记录存到目录外。

把仿真验证留在模型旁边

记录启动、停止、转向和恢复测试。有限且非恒定的输出只是基本合法性检查,不能证明实体机器鸭可安全运行。

继续之前先确认

同一份导出模型能用于所有机器鸭吗?

不能。关节顺序、观测布局、动作缩放、运行时和附件必须匹配,实机部署前先核对完整模型包。

适用范围: Pollen Robotics MicroDuck. 把模型、镜像、软件和驱动版本一起记录。各日期段落保留原有验证范围。

资料核查于:

来源与核查 (4)
  1. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/src/mjlab_microduck/export.py
  2. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/scripts/infer_policy.py
  3. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/src/mjlab_microduck/publish/cli.py
  4. github.com/pollen-robotics/microduck_rl/blob/2b25a48b08f1f17bc38c90bb03144c81fbd9ed07/README.md

接下来读这些教程

MicroDuck 训练到部署教程:准备、训练、导出与验证

按准备、本地训练、导出、模拟回放和部署检查依次阅读。导出或上传成功,不能证明机器人能执行该策略。

MicroDuck 官方参考模型:短跑、轮式、爬坡与坐站怎么选

比较四个参考策略的槽位、舵机和附件要求,检查指令含义与内置归一化,按固定版本加载并恢复;说明训练仓库的公开访问限制。

MicroDuck 官方策略 v8:确认 walk 覆盖、更新与单槽恢复

10 月 12 日官方 velstand v8 已发布。先核对 policy list 与 check,再分开更新策略集;说明手动覆盖为何仍生效,以及恢复官方 walk 的准确步骤。