MicroDuck 常见报错：从加载、CUDA 到 ONNX 排查

网页能打开，但机器人不动

确认进入场景并聚焦画面；检查 Feet / Rollers 与已加载策略。R 在当前浏览器控制坐下和站立，不是翻滚。具体按键见仿真操作。

Python 或命令不对

在固定仓库内运行 uv run python --version，应为 3.12.x。找不到 train，或执行了另一个程序时，使用 uv run train 并重新同步同一版本；不要先改整个系统的 PATH。

GPU 存在，但 CUDA 为 False

使用环境检查中的同一个 Python 环境诊断。记录系统架构、驱动、PyTorch 版本和 CUDA 构建。Linux ARM 的安装来源可能不同；Jetson Thor 的问题 #38不能当成所有 NVIDIA 设备的通用处方。

ARM 下载超时

官方快速开始给出延长下载超时的办法，适用于大依赖下载中断，不修复驱动或二进制不兼容。

UV_HTTP_TIMEOUT=600 uv sync --locked --python 3.12

模型报输入维度不匹配

当前 MicroDuck 接口为 61 个观测、14 个动作。旧 51 输入策略需要匹配旧布局。不要用补零强行改维度；关节顺序、归一化和时序同样重要。回到策略导出确认来源。

提问时一次提供这些信息

目标与最后成功的步骤：
原教程 URL 与源码提交号：
系统 / 架构 / 浏览器或 Python 版本：
GPU / 驱动 / PyTorch / CUDA：
完整执行命令：
第一条错误及上下文：
已经试过的改动：

通过讨论入口提交时，删除 token、密码和个人路径中的敏感信息。优先描述最后成功的一步，而不是只贴“不能运行”。