# IsaacLab增强模仿学习Checkpoint评估得分为0及渲染模式不匹配

> 原文链接：https://robotics.hellobike.com/pitfalls/2026-11-18-isaaclab-9033
> 频道：pitfalls | 更新日期：2026-11-18 | 标签：auto, github-issue, isaaclab
> 核心摘要：IsaacLab 2.x文档推荐的performance渲染模式导致视觉数据分布偏移使模型失效，需改用balanced模式；3.0版本因四元数格式变更暂不可用。

# IsaacLab增强模仿学习Checkpoint评估得分为0及渲染模式不匹配

::: v-pre
> 本文由 AI 根据公开内容整理，可能有误，请以原文为准：[[Bug Report] Augmented imitation tutorial: released visuomotor checkpoints score 0% with the documented eval command (2.x) and on 3.0; published robustness table does not reproduce](https://github.com/isaac-sim/IsaacLab/issues/9033)（GitHub isaac-sim/IsaacLab #9033）

**状态**：有绕过办法

## 问题

在IsaacLab中使用官方发布的Augmented Imitation Learning Checkpoint进行评估时，2.x版本文档指定的`--rendering_mode performance`参数导致`table_cam`图像均值约115且含重噪声，与训练数据（均值约103）严重不符，模型成功率归零。3.0/main分支中评估环境图像均值升至144，且末端执行器四元数格式由WXYZ变为XYZW，即使手动重排也无法恢复性能。

## 环境

Isaac Lab v2.2.0 + Isaac Sim 5.0.0 (pip)；任务`Isaac-Stack-Cube-Franka-IK-Rel-Visuomotor-Cosmos-v0`；

## 解决办法

1. 在Isaac Lab v2.2.0 + Isaac Sim 5.0.0环境下评估时，移除`--rendering_mode performance`参数或显式指定`--rendering_mode balanced`，使渲染图像均值（~102）匹配训练数据分布，可恢复Mimic 1k/2k及Cosmos-Mimic 2k模型的基础成功率。
2. 避免在当前阶段使用Isaac Lab 3.0或main分支进行该系列Checkpoint评估，因其默认渲染过亮且`eef_quat`格式变更为XYZW，与训练时的WXYZ格式不兼容，暂无可用配置修复。
3. 下载HuggingFace revision `9a9167bcf5e59f130b115395c5da411c11e3cebc`下的Checkpoint时，注意`franka_stack_mimic_2k_table_only`目录实际对应Cosmos数据集，而`franka_stack_mimic_cosmos_2k_table_o…

讨论原作者：@josha10cio 等，版权归原作者所有。
:::

## 原始参考来源 (Sources)

- [GitHub isaac-sim/IsaacLab #9033：[Bug Report] Augmented imitation tutorial: released visuomotor checkpoints score 0% with the documented eval command (2.x) and on 3.0; published robustness table does not reproduce](https://github.com/isaac-sim/IsaacLab/issues/9033)