用途:当所选配置文件、验证报告或用户请求明确指定 FET_004_NEWTON 时,使用该特性技能修复或暂存模拟多体物理(Newton)一致性,避免偏离到其他运行时契约。FET_004_NEWTON 仅有已发布版本 0.1.0,即 FET_004_NEWTON@0.1.0;若报告指定其他 FET_###_RUNTIME 特性,应先切换到对应技能再编辑。
事实来源:改动资产或包前需阅读 nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_004_NEWTON-0.1.0.json 与同目录下的 FET_004_NEWTON.md。所选 JSON 清单对依赖项与需求 ID 具有权威性,特性 markdown 提供人类可读契约细节、需求链接、样例、基准与适配器。
版本与依赖:0.1.0 依赖 FET_003_NEWTON@0.1.0,需求包括 JT.001、JT.002、JT.003、JT.ART.002、JT.ART.003、JT.ART.004、RB.MB.001、RB.011、RB.012。Newton 碰撞体需求(NEWTON.COL.001、NEWTON.COL.002)及 Newton 刚体基础来自该依赖。
适配器:当输入已符合中性基础特性时,优先使用确定性特性适配器先编写运行时特定数据(通过工作区升级命令,见 nv_core/sr_specs/docs/guides/feature_adapters/feature_adapters.md),再修复剩余需求。适配器模块为 nv_core/cip_specs/asset_handler_modules/neutral_to_newton,适配器 collider_neutral_to_prop_newton,转换 FET_004_STANDARD@0.1.0 -> FET_004_NEWTON@0.1.0,为现有碰撞体写入 NewtonCollisionAPI + NewtonMeshCollisionAPI 并使 newton:contactGap = 0。适配器只在暂存输出阶段运行,不创建几何体、关节或铰接拓扑,仅注解现有碰撞体。FET_004_NEWTON@0.1.0 是多体契约,适配器仅覆盖 Newton 碰撞注解;多体需求(JT.、RB.MB.001、RB.011、RB.012)需要已有关节/铰接拓扑,须按下方工作流手动修复。严格 Newton 隔离:不得出现 Mjc/Physx* 数据或 physics:approximation = "sdf"。
工作流:1)确认输入存在,并从配置文件 TOML、验证报告或用户请求中识别所选特性/版本;2)编辑前加载所选 FET_004_NEWTON 清单与特性 markdown;3)针对每个报告失败的需求,加载特性 markdown 链接的需求文档;4)创建或使用暂存输出位置,除非用户明确要求原地编辑;5)仅修复所选 FET_004_NEWTON 清单及其依赖列出的需求;6)重新运行相同配置文件门禁或最窄可用的特性/能力验证门禁,若需要运行时证据但不可用,应报告该限制而非声称通过;7)汇总所选 FET_004_NEWTON 版本、已改文件、验证证据以及首个剩余阻塞或下一个确切特性门禁。
特性指引:在已有刚体、关节和铰接上修复 Newton 多体关节与铰接需求,不创建几何体。Newton 碰撞体一致性(NEWTON.COL.001/NEWTON.COL.002,按碰撞体选择 NewtonMeshCollisionAPI 或 NewtonSDFCollisionAPI,不在同一 prim 上同时应用两者)由 FET_003_NEWTON@0.1.0 依赖负责,应在该处修复。除非所选特性为 FET_004_ROBOT_NEWTON,否则不要使用机器人专用碰撞体豁免。
运行时变体打包:对于通过变体集暴露物理的资产(FET_000_NEWTON 脚手架),Newton 碰撞注解(NewtonCollisionAPI/NewtonMeshCollisionAPI + newton:contactGap)与 NewtonMaterialAPI 材质调优应放在 runnables/physics/newton.usd 载荷中,作为每个碰撞体和绑定材质上的 overs,而非中性基础。该技能在中性基础上修复关节/铰接拓扑(刚体、UsdPhysics 关节、恰好一个 PhysicsArticulationRootAPI,且任何碰撞体上无本地 physics:approximation);各运行时的碰撞体/材质差异通过 FET_000_NEWTON 编写。
报告字段:feature(确切特性 ID 与版本,如 FET_004_NEWTON@0.1.0)、input(检查的源资产、包根或包定义)、output(暂存输出路径,仅在明确要求时原地)、requirements_repaired(本轮修复的需求 ID)、validation(验证该确切特性所用命令或检查)、status(passed、failed、skipped 或 blocked)、next_step(下一个确切特性技能或所需用户/运行时证据)。