用途:把一组 USD 资产文件夹转换为 SimReady 包,由 create_simready_package.py 依次执行预校验、包创建和后校验。脚本自带 sr_pkg_sample 辅助包,无需回溯 nv_core/package_sample/。
前提:仓库根目录为 simready_foundations;需 Python 3.10+;setup_venv.sh 需在 Git Bash 或 WSL 等 bash 兼容 shell 运行;需 WRAPP wheel omni_wrapp_minimal-2.2.0-py3-none-any.whl 或可提供它的内部索引;source 需包含全部 USD 及引用资产;license 由用户提供,不可代为选择。无需 OpenAI API key。
输入:name(小写无空格,如 apple_a01)、version、license(SPDX 或 LicenseRef-*)、source、repo(WRAPP 仓库路径或 file:// URL)、root_usd(相对 source 的路径,可重复 --root-usd)、mode(完整、仅预校验、仅后校验、跳过某阶段、无 WRAPP 回退)。
用法:在 skills/simready-foundation-create-package/assets/scripts/ 下先运行 ./setup_venv.sh --wrapp-wheel <wheel> 建环境(已存在则激活并确认 import simready.validate 与 import wrapp);每次打包命令先激活 .venv,仓库外运行时设 SIMREADY_FOUNDATIONS_ROOT。默认发布流程:python create_simready_package.py <name> <version> <license> <source> <repo> --root-usd <relative/root.usd>。仅预校验用 --only-pre-validation --source <folder> --root-usd <path>;仅后校验用 --only-post-validation --package-def <path>;--skip-pre-validation 仅在相同 source 成功预校验后建议使用;--skip-post-validation 仅在有意延后校验时;--no-wrapp 仅用于最小骨架或不适合发布场景,可能无法通过 BOM 或 introspection 检查。需检查返回码,stdout 只作证据。
失败处理:预校验 FET_031_STANDARD 或 AA.001 需报告锚定路径失败并在改引用前询问;预校验用法错误收集缺失参数;创建时 .wrapp 标记存在或嵌套包需询问或先清理;后校验 FET_030_STANDARD 保留包并引用失败要求;FET_032_STANDARD 检查 BOM 元数据并重跑完整流程。
限制:不替代修复 USD 内容的 profile 专用合规技能;WRAPP 依赖用户提供的包、凭据或索引;无 WRAPP 回退会缺失完整发布证据;不自动改写用户 USD,不代选许可证,保留生成的报告和元数据,设置重试两次后停止并总结。多处细节暂未提供。