Skip to content

sca-usd-export 0.1.8rc2 (Pre-release)

Pre-release
Pre-release

Choose a tag to compare

@wwlloo wwlloo released this 25 Oct 10:46
f8b7770

sca-usd-export 0.1.8rc2 — Pre-release

构建对应:Tag v0.1.8rc2 指向已核实的合并提交 f8b7770d354d34e9cac4d7f71536b1ccf9f25fb6;完整payload 86文件与该提交逐文件相同。本次补齐公开文档后重封装,使用本页新的附件哈希,旧本地候选包及证据另行保留。

这是 rc候选预发布,非稳定版,不标记Latest。读取已完成产品包并生成USD、逐项报告和历史资源,静态重新读取检查。源码、文档、技能资源和必要测试在仓库main维护,安装包在本页Assets分发。

安装附件与校验

  • 插件安装包:sca-usd-export-0.1.8rc2.zip;SHA256:77cf9b0ce4d6676ced567ddd5c43fcb6fcc7d123dc1869d7183a930f6156496d。
  • 同页下载 SHA256SUMS.txt,核对准确文件名与哈希。
  • 请下载上述手动上传的插件ZIP;GitHub自动生成的 Source code (zip/tar.gz) 是源码快照,不是本安装指南使用的插件安装包。
  • 插件ZIP直接下载;SHA256SUMS。
  • 配套版本:sca-physics 0.1.8rc1 Pre-release。只验证 physics0.1.8rc1 + USD0.1.8rc2,不宣称全部版本组合兼容。

主要变更与职责

纳入完整持久化物理消费、来源/false/0保持、单位与schema1.8普通关节/驱动/articulation及刚体链导出;保留无物理metadata的独立几何能力与准确可选physics依赖。安装身份回执、输入守卫与Windows参数传输保留。本轮新增公开Release下载、校验、隔离安装和升级说明,运行实现与依赖未变。

下载、安装、检查与最小使用

  1. 准备合法安装SCA SDK2.2.5的宿主Python、基础Python3.12,以及可访问的依赖源或完整可信wheelhouse。插件ZIP不附带SDK或其他第三方运行依赖。主机装有SDK不等于新venv能取得它。
  2. 从本页下载插件ZIP与SHA256SUMS,先用Get-FileHash -Algorithm SHA256同校验记录核对,再解压。保持解压根目录名为sca-usd-export,其根下应有sca-addon.toml。
  3. 选全新的短state根,例如可写的C:/sca-rc,在专用PowerShell窗口重定向完整命令链的USERPROFILE/HOME/APPDATA/LOCALAPPDATA,先断言Python的Path.home。仅传home/skills-dir不能隔离真实用户配置。安装根不能含单引号或cmd元字符;深目录曾使Jedi依赖触发WinError206。
  4. 用宿主执行官方simplecadapi.cli init --home <home> --skills-dir <skills> --no-shell,再addon add ... <解压后的插件目录>。**SDK2.2.5安装目录,不直接安装ZIP。**随后addon use ... sca-usd-export provision、addon check ... sca-usd-export,核对registry中的runtime_check.passed=true;退出0本身不足以证明probe通过。
  5. 纯几何用全新无physics runtime导出无嵌入配置包并validate。配套物理设SCA_PHYSICS_SOURCE为校验后的physics0.1.8rc1解压目录;读取端check通过后运行enrich→新进程validate→带require-physics/输入SHA256的export→USD validate。
  6. 完整可直接运行的PowerShell命令、模块来源检查及最小例子见本版本公开安装指南。命令只使用调用者明确选择的路径,不依赖维护者电脑上的盘符。

环境、依赖、兼容和升级

实际验证环境:Windows x86-64、Python3.12.15、SCA SDK2.2.5、OpenUSD26.8、OCP7.9.3.1(NumPy2.3.1、Plotly7.1.0)。OpenUSD来自USD私有venv,不借用Isaac。physics直接运行依赖仅SDK,不导入USD;USD必需SDK、usd-core、OCP、NumPy及Plotly,物理路径还直接调用physics合同/几何模块,physics extra精确pin sca-physics==0.1.8rc1。hatchling是构建依赖,pytest/jsonschema等test extra是开发依赖,Isaac/PhysX是另备仿真环境。

所测旧数据仅为2026-10-19 physics0.1.0/schema1.0摆臂包(SHA256 ba39ea3d58fbe8c59ca00153858fd72d6d00f091f71602374461ec6c7f4406ec)和2026-10-20 physics0.1.3rc1/schema1.1机械包(54f37bbfd0576d88a2d7f7a718718fce0fa29cf8e3540601b3e1fcc29caf8893)。读取、SDK原生加载/重载、完整物理快照和USD导出通过;所测旧路径/内存export_package、JSON ExportConfig及CLI仍有效。更早GitHub默认Y/恢复0与当前Z/0.1不同,需显式配置以保留所需行为。范围和具体输入见兼容说明。

**旧无来源裸参数原样不兼容;按要求补充来源信息后,所测试案例通过。**保持原值/单位/schema,补真实source.kind/detail;资料引用还需真实citation/conditions,也可按合同在组/根继承。准确physics候选的examples/pendulum/physics-input.json与verification/raw.scadpkg提供可运行迁移例子:保留collision_enabled=false,注明它是软件fixture试验估计,不得冒称实测或虚构出处。旧FEM显式elasticity_damping单位1须先核实再另存1/s,不自动缩放数值;自动线缆缺category会明确拒绝。

无嵌入物理配置、不使用prepare-deformable的纯几何用户可只使用/升级USD;已安装准确physics0.1.8rc1者无需重复升级。其他物理用户先准备并检查匹配读取端USD0.1.8rc2及其准确physics依赖,再切换实际物理写入端。每次更新payload后重新provision/check;版本号相同不代表文件相同。保留旧包及旧环境,不默认remove;缺peer、错版本、未知schema明确失败,不能降低schema标签绕过。

验证结果与限制

本轮GitHub附件下载/隔离安装结论:已验证通过。发布后从本页ZIP和SHA256SUMS公开地址匿名重新下载,均HTTP200;SHA256、CRC、资源与准确Tag源码一致。使用下载包创建三个全新私有venv,官方add/provision/check及payload、skill、wheel、实际模块路径和ready receipt核对通过。独立USD没有physics模块或distribution,几何导出/重开通过;准确配对的物理配置保存、独立进程重载、带输入哈希及require-physics导出、USD重开通过。直接读取USD核对质量、摩擦、关节collision=false和zero damping保留;缺peer读取物理包明确失败且无输出残留。依赖通过完整可信离线wheelhouse取得,在线索引完整性未验证。无GitHub自动CI;这些结果不代表原生仿真或材料标定验收。

已复核前轮同业务代码/依赖的安装、纯几何、保存/重载/静态USD及所选历史/API证据;此次交付仅补公开文档,最终包资源和模块身份仍须以本轮新包与下载验证结果为准。没有GitHub自动检查时不写CI通过。

**未验证:两项外部CAD-FEM检查、Isaac/PhysX行为、其他环境、全部历史版本组合及全部旧参数分支。**既有FEM、Capsule/预览、自然态、接触和力学精度限制保留。安装、保存及静态导出通过不代表物理仿真全面通过、材料标定或支持所有Isaac属性;输出保持simulator_validated=false。