SuperAPI AI 工具集

simready-foundation-conform-fet-006-materials

通用与其它

查看项目

更新于 10-16 07:24

技能介绍

用途:在 Core、Minimal、物理与抓取要求已基本达标后,修复分阶段 USD 资产的材质一致性,目标是让所选 FET006 变体(FET006_BASE_MDL 或 FET006_BASE_USDPREVIEW)通过校验。这是编写与修复技能,不是最终校验器。

主要能力:解析校验报告并筛选 FET006 失败项;检查默认 prim、payload 边界、引用与相对资源锚点;检查可渲染 Gprim、材质绑定关系、UsdShade 材质与着色器、MDL 源资产与标识、纹理路径、尺寸与色彩空间元数据。修复顺序为:先修绑定范围与缺失绑定,再修 USDPreviewSurface 属性类型与 token 值,再修 MDL schema 字段与源资产路径,再修着色器输入类型与无效数值,最后修纹理色彩空间。

使用方式:先读取指定权威文件(FET_006 的 JSON 清单、FET_006-materials.md、materials/requirements.md、validation.py),在 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-fet006.json

适用场景:修复材质绑定、USDPreviewSurface 或 MDL 着色器、纹理路径与色彩空间等机械可验证问题。

限制:不静默修改源资产;不虚构 MDL 材质或材质标识;纹理缩放、替换、格式转换等会改变外观的操作需用户批准;遇到需材质标识、源纹理编辑、MDL 库或视觉判断时,停止并报告阻塞项。校验工具不可用时仅运行可用的最窄检查并报告缺口。