主题
软件环境
当前环境与安装命令以 安装与准备 和 Python 包管理 为准。软件运行在独立 uv 环境,不安装到系统 Python,不修改 site-packages。
当前组件
- 根 workspace:CLI、core、runtime、models 和 server;CAD 使用 models/server 的
cadextra。 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 状态在执行前查询;实时系统前提与运动边界见现场联调。历史兼容性调查见实机与诊断状态,不要把当时的机器状态复制为当前安装事实。