跳到正文
已核查原始资料

MicroDuck 浏览器仿真:试走、导入公开动作与恢复原版

无需实体机器鸭,先用方向键试走,再用 URL 导入官方公开策略;看懂 PLAYING 标签、manifest 适配条件和卸载、加载失败后的恢复方式。

先打开官方浏览器仿真,点 Waddle In,用方向键试走。要体验公开动作,在网址后使用 ?move=作者/仓库;PLAYING 显示已装载的动作,不代表正在执行,点 ✕ 可恢复占用槽位的官方动作。本站 10 月 12 日检查了官方 sprint 参考模型的加载和卸载。

没有实体机,先完成这一个任务

  1. 打开官方仿真,等待场景载入,点 Waddle In 或按 Enter。
  2. 必要时先点场景,再短按住 ↑ 前进。
  3. 松开后试 ← / → 转向。
  4. 按 Space 复位,再决定继续体验动作还是学习训练。

进入、前进、转向、复位都完成,就通过了这次体验;这里使用已有策略。

打开官方仿真 ↗

先跑通自带动作,再换模型

打开官方仿真页面,等场景与策略资源载入,点击 Waddle In 或按 Enter。画面没有接收按键时先点一下场景。留在 Feet 模式,短按并按住 ↑ 前进,松开后再试 ←、→ 转向;Space 重置。本站 9 月 8 日曾在桌面端检查进入、前进和重置。这里只是在浏览器播放已有动作,不会训练新策略。

当前键位与模式

  • ↑/↓ 或 W/S:前后移动;←/→ 或 A/D:左右转向,不是横移。
  • R:Feet 下自带动作是坐下/站起;加载 episodic 小动作、script 或自定义 sitstand 后,Feet 下的 R 改为触发该动作。Rollers 下 R 优先下蹲滑行,即使动作已加载也是如此。
  • Q/E:左右踢;F:交替踢;G:地面拾取,均限 Feet 模式。
  • M:切换 Feet 与 Rollers,首次进入 Rollers 可能还要下载素材;C 切换跟随视角;Space 重置。

以当前键盘源码为准。键盘实现按物理位置识别,非 QWERTY 布局先用方向键;本地 Python 查看器有另一套操作,不要混用。

用一条公开链接试导入

打开已核对的官方 sprint 参考模型链接,进入场景。网址中的 ?move=pollen-robotics%2Fmicroduck-sprint-2m-reference 指向 Hugging Face 的一个公开模型仓库。可先看到 LOADING MOVE;加载成功后,界面出现 PLAYING 和模型名。PLAYING 只表示已装载;perpetual/walk 要在 Feet 步行时才驱动,其他动作还受 Feet/R 键条件限制。本站 10 月 12 日在匿名浏览器里看到了“SPRINT-2M-REFERENCE BY POLLEN-ROBOTICS”,并点击 ✕ 卸载,标签随即消失。这只证明该公开模型在当次会话中可加载、可卸载,没有测速或评价步态。固定版模型 manifest。

想试另一个公开、单策略仓库,可将 ?move= 后面换成它的 owner/repo;入口源码也接受 ?policy=。加载器还支持浏览器可访问的 HTTPS .onnx 直链,并尝试读取同目录 manifest.json;需要模型服务器允许浏览器访问。当前界面没有“上传本机文件”按钮。私有 Academy session 另需身份验证,不属于上述公开体验。加载器源码。

manifest 不是“格式对了就一定能走”

官方固定版加载器支持 manifest 的 model_api 至多为 2。perpetual 默认占 walk 槽,声明 sitstand 则由 R 触发坐站;episodic 小动作作为 R 的单次动作;script 是在自带步行策略上运行的 13 维命令时间线,并非 ONNX 模型。一次只装一个动作,带 policies 数组的多策略包会被拒绝;没有 manifest 的单模型按普通步行策略处理。

ONNX 动作应是 MicroDuck 的 61 个观测输入、14 个关节动作输出;加载时还会检查单输入输出、数值有限且测试输出不是恒定值。这个检查不懂模型训练时的观测含义、配件或动作缩放,不能把轮滑策略只凭 61/14 形状装成 Feet 步行,更不能推断实体机器人可用。

不满意或报错,怎样回到原版

PLAYING 标签右侧点 ✕,会卸载已装载动作并恢复被占用槽位的官方策略;本轮已在公开参考模型上检查这一交互。界面实现、槽位与恢复实现。准备换另一个动作时,先用 ✕ 明确卸载。从新公开链接首次导入失败时,界面显示错误,原版动作仍可用;若已装自定义动作时再次加载失败,源码不会自动清掉旧动作,应在换模型前卸载,或回到不带参数的仿真网址重新开始。源码还会在运行输出异常或短时多次异常跌倒时自动撤回自定义动作。这些是浏览器保护逻辑,不是实机安全验证。

按键无效先关欢迎层、点击场景、用方向键复查;嵌入页抢焦点可改开独立页面。若基础场景一直不加载,打开?boot=1 诊断页,保存最后成功步骤和报错。官方 README。要训练新动作看训练路线;要给实体机器鸭装策略看实机策略指南,浏览器导入不会更新机器人。

**资料时间:**公开动作导入功能在 9 月已进入官方 Space,本站 10 月 12 日补核并上文;Space 10 月 9 日的最新提交只新增许可文件,并不是动作导入当天上线。9 月初始提交 · 后续 manifest 处理 · 10 月最新提交。

继续之前先确认

在浏览器加载动作是在训练新策略吗?

不是。浏览器运行已有且兼容的动作;训练新策略需要单独的训练环境。

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

资料核查于:

来源与核查 (15)
  1. huggingface.co/spaces/pollen-robotics/microduck-simulator
  2. huggingface.co/spaces/pollen-robotics/microduck-simulator/blob/ad9d41a763f30dc770817c33d92dcfec0205db1e/README.md
  3. huggingface.co/spaces/pollen-robotics/microduck-simulator/blob/ad9d41a763f30dc770817c33d92dcfec0205db1e/app/src/App.jsx
  4. huggingface.co/spaces/pollen-robotics/microduck-simulator/blob/ad9d41a763f30dc770817c33d92dcfec0205db1e/app/src/game/custom-policy.js
  5. huggingface.co/spaces/pollen-robotics/microduck-simulator/blob/ad9d41a763f30dc770817c33d92dcfec0205db1e/app/src/game/game.js
  6. huggingface.co/spaces/pollen-robotics/microduck-simulator/blob/ad9d41a763f30dc770817c33d92dcfec0205db1e/app/src/ui/Hud.jsx
  7. huggingface.co/spaces/pollen-robotics/microduck-simulator/blob/ad9d41a763f30dc770817c33d92dcfec0205db1e/app/src/game/controls/keyboard.js
  8. huggingface.co/pollen-robotics/microduck-sprint-2m-reference/blob/62afcc461f1d4a5ac22bfbff55ce4900c1afba32/manifest.json
  9. huggingface.co/spaces/pollen-robotics/microduck-simulator/commit/cb0312619f09138069130328c3bef05736e1730c
  10. huggingface.co/spaces/pollen-robotics/microduck-simulator/commit/850e9430c7d4451ca35a69f8600cca74ce51814f
  11. huggingface.co/spaces/pollen-robotics/microduck-simulator/commit/ad9d41a763f30dc770817c33d92dcfec0205db1e
  12. github.com/pollen-robotics/microduck_rl/blob/ceca01706143d729305baa94cbd8ab990979e325/scripts/infer_policy.py
  13. pollen-robotics-microduck-simulator.hf.space/?move=pollen-robotics%2Fmicroduck-sprint-2m-reference
  14. pollen-robotics-microduck-simulator.hf.space/
  15. pollen-robotics-microduck-simulator.hf.space/?boot=1

接下来读这些教程

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

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

MicroDuck 本地训练入门:环境检查、短跑与云预览

使用固定源码版本建立 Python 3.12 环境,检查 CUDA 和任务注册,运行有边界的安装测试,再保存检查点并预览云任务,附可复制命令。

MicroDuck 排障:升级配对、摄像头与策略

MicroDuck 0.20.1:先分清访问方式再恢复. Wi-Fi SSH 需要本地决定。先核对 daemon/API 和 Setup Code,不把连接被拒直接当成升级失败。