用途:将项目从一个 Isaac Sim 版本迁移到另一个版本,先用发布审计工具盘点受影响面,把发现分诊为有归属的工作项,再证明每个工作流在目标版本中仍正确。当前仅覆盖 Isaac Sim 5.1 -> 6.0;跨版本跳迁需按顺序逐跳执行各版本自带的审计工具与指南。
前提:需要提供 source/tools/isaac_sim_migration/audit_isaac_sim_6_0.py 的 Isaac Sim 源码检出,或把该脚本复制到项目中;PATH 中有 Python 3(审计工具仅用标准库);$WORKSPACE_DIR 指向待迁移项目;以及已构建或安装的目标版本 Isaac Sim 用于运行时验证。
主要能力:静态审计工具可扫描项目并输出清单,支持 JSON 输出与 --max-results 0 显示全部结果;默认退出码为成功,便于在 CI 中收集清单而不中断;可用 --fail-on required 仅在存在未解决的破坏性发现时让 CI 失败。发现分为 required(可能破坏或已移除,需指定工作流负责人并验证)与 review(迁移清单,需人工检查)。
使用方式:先界定源/目标版本、安装类型、客户自有面(.kit 文件、扩展依赖、Python、USD/USDA、Action Graphs、ROS 2 工作区、机器人资产、传感器配置、基准脚本、CI 任务、生成数据管线)及运行时冒烟测试。运行审计:python source/tools/isaac_sim_migration/audit_isaac_sim_6_0.py "$WORKSPACE_DIR" --max-results 0;JSON 输出加 --json;CI 门禁加 --fail-on required。随后对每个受影响工作流在目标版本做经验性冒烟测试(扩展/应用、仿真、传感器、Action Graphs、ROS 2、机器人资产、基准),并记录证据:目标版本、命令、应用体验、输入资产、预期 5.x 行为、观察到的 6.0 行为、通过/失败结果与剩余缺口负责人。
限制:仅覆盖 5.1 -> 6.0,其他跳迁需对应版本的审计工具。审计是静态盘点助手而非完整分析器,可能遗漏项目包装器、生成文件、二进制 USD 层、动态导入、自定义 OmniGraph 节点、扩展设置及仅运行时出现的行为;干净报告不等于迁移完成。已安装的 Isaac Sim 6.0 包不包含 tools/isaac_sim_migration/。弃用警告应视为迁移信号,isaacsim.core.deprecation_manager 只迁移弃用设置与保存的 OmniGraph 节点命名空间并记录更改,并非保证所有弃用 Python 符号都会告警的通用系统。
适用场景:已有 Isaac Sim 项目需要升级到 6.0 时的迁移盘点、分诊与运行时验证。不适用于新项目搭建或无关的运行时缺陷。