SuperAPI AI 工具集

simready-foundation-conform-fet-000-physx

通用与其它

查看项目

更新于 10-16 02:34

技能介绍

用途:当所选配置、验证报告或用户请求明确指向 FET_000_PHYSX 时使用本技能,在已满足中性 Core(FET_000_STANDARD@0.1.0)的资产上修复或搭建 PhysX 物理运行时变体契约。它只负责 PhysX 变体集、runnables/physics/physx 载荷和 SimReady 变体元数据的正确性,不编写 PhysX 刚体/碰撞体物理本身(属于 FET_003_PHYSX 等)。默认版本为 FET_000_PHYSX@0.1.0;若报告指向 FET_000_NEWTON 或 FET_000_MUJOCO,应切换到对应技能。

主要能力:按 RV.001 在默认 prim 上添加含 Disabled/Enabled 的 PhysX 变体集并默认 Disabled;按 RV.002 从 Enabled 变体前置 payload = @./runnables/physics/physx.usd@,载荷须位于资产根目录内,用 ./ 锚定,避免 ../ 导致 AA.001 失败;按 RV.003 在 customLayerData.SimReady_Metadata.Variants.Physics.PhysX 写入 prim、variantSetName、activateOption;按 RV.010 保持变体段纯净(Enabled 仅含 payload,Disabled 为空);按 RV.011 保证合成阶段只含中性 UsdPhysics 与 PhysX 数据。对单网格道具,载荷为确定性网格碰撞增量:prepend apiSchemas = ["PhysxCollisionAPI", "PhysxSDFMeshCollisionAPI", "PhysicsMeshCollisionAPI"] 与 custom token physics:approximation = "sdf"。多刚体装配对每个碰撞网格应用同一增量,不重写关节/驱动/articulation。

使用方式:先确认输入与版本,确保 Core 通过(否则先交给 FET_000_STANDARD 技能),读取 FET_000_PHYSX 清单、特性文档及 RV.001–RV.003、RV.010/RV.011 需求文档与隔离矩阵,在暂存输出目录中仅修复上述需求,再重跑同一配置门或最窄验证门并汇报。本地验证需构建 core tier wheel、创建 Python 3.12 venv 并安装 usd-core、usd-validation-nvidia、numpy 与 tier wheel,然后调用 runtime_variants.validation 的 ResetCaches() 与 CheckStage(stage),通过 GetIssues() 读取结果。

适用场景与限制:适用于单网格道具及碰撞体统一增量的多刚体装配。不静默修改源资产,不编写 Newton/MuJoCo 变体,不创建几何体;遇到 PhysX 关节、驱动、场景/材质调优、逐链接碰撞近似决策、碰撞几何不明确、无 defaultPrim 或归属 prim 不明确时应停止并报告。若环境无法引导,可退化为人工检查变体集、锚定载荷、嵌套元数据、纯净变体段与仅含 PhysX 的载荷,并说明为仅检查。