SuperAPI AI 工具集

simready-foundation-conform-fet-003-rigid-body-physics

通用与其它

查看项目

更新于 10-16 02:34

技能介绍

用途:在 FET000_CORE 和 FET001_BASE_NEUTRAL 通过后,针对 FET003_BASE_NEUTRAL 或 FET003_BASE_PHYSX 验证门,将暂存 USD 资产修复到 SimReady 刚体物理契约。这是编写与修复技能,不是最终验证器。

主要能力:解析验证报告并过滤 FET003 失败项;加载所选 FET003 清单(如 nv_core/sr_specs/docs/features/FET_003_base_neutral-0.1.0-rigid_body_physics.json 等);检查默认 prim、根 prim、单位、边界、现有 UsdPhysics.RigidBodyAPI/CollisionAPI/MeshCollisionAPI/MassAPI、实例化与缩放问题;按顺序移除无效 API、在有效 Xformable 根上应用 RigidBodyAPI、在有效碰撞 prim 上应用 CollisionAPI、按规则应用 MeshCollisionAPI、仅依据明确来源编写质量、修复实例化与嵌套问题、将不可见碰撞网格标记 purpose = "guide"。

使用方式:在 output_root 下创建暂存副本,不修改源资产;每次修复后重跑同一验证门。可用命令:uv run --python 3.12 validate-simready-profile <staged-usd> --profile <profile> --profile-version <version> --foundation-root <simready-foundation-root> --foundation-spec-root <simready-foundation-root>/nv_core/sr_specs/docs --report <output-root>/simready-profile-after-fet003.json。

适用场景:中性或 PhysX 道具资产的刚体与碰撞体合规修复。

限制:不处理 FET004 多体物理或 FET005 抓取物理;不静默修改源资产;不编造质量、几何或元数据;遇到静态道具、多个可能刚体根、缺少质量来源、需要 CAD 生成碰撞几何、嵌套刚体暗示关节、PhysX 网格合并不可用等情况应停止并报告。若验证工具不可用,运行最窄的 USD 或静态检查并报告缺口。