跳到正文

软件环境 ​

当前环境与安装命令以 安装与准备 和 Python 包管理 为准。软件运行在独立 uv 环境,不安装到系统 Python,不修改 site-packages。

当前组件 ​

  • 根 workspace:CLI、core、runtime、models 和 server;CAD 使用 models/server 的 cad extra。
  • backends/isaaclab:固定官方 Isaac Lab 3 提交和匹配 Newton;PhysX/RTX 使用 backends/isaac/runtime.json 指定的原生 Isaac Sim 6.2.0-rc.14,Steel 使用官方无 Kit 路径。完整版本和 wheel 哈希见 集成说明。
  • backends/planning:MPLib/Pinocchio/FCL、Ruckig;用于归档模型的 IK、碰撞和局部轨迹。
  • backends/learning:独立 LeRobot 桥接环境。
  • backends/hardware:厂家 SDK 的只读观察环境;ROS 2 控制另见 集成说明。
  • SolidCraft、驱动、Vulkan 和原生 Isaac Sim 属于系统工具或外部运行时,不属于 Python 锁文件。

ARM64 构建输入 ​

MPLib 的 wheel、源码提交、补丁、许可和哈希位于 backends/planning/wheels 与 backends/planning/native。它固定官方 main 的基线与必要 ARM64 修复,限定 CPython 3.12 / Linux ARM64 / glibc >= 2.39。

cuSPARSELt 使用 packages/wheel-repairs/packages/cusparselt 的 PEP 517 配方,仅修正上游 ARM64 wheel 的平台标签,二进制 payload 不变。构建工具源码和版本化 wheel 位于同一个包;修改后同步版本、构建产物和哈希。没有其他模拟器的修复配方或本地运行环境。

局部抓取复用 MPLib/Pinocchio CLIK 和 Ruckig;这不等于完整避障规划或已经完成双臂交接。当前验证入口及范围见 验证矩阵。

实时内核与设备接入 ​

主机内核、驱动和 Secure Boot 状态在执行前查询;实时系统前提与运动边界见现场联调。历史兼容性调查见实机与诊断状态,不要把当时的机器状态复制为当前安装事实。