diff --git a/CHANGELOG.md b/CHANGELOG.md index a5c8e2b..b733a5c 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,27 @@ # NavisworksTransport 变更日志 +## [0.19.0] - 2026-08-05 + +### ✨ 功能变更 + +- **去掉真实物体 fragment 参考姿态依赖(默认轴约定替代)**: + - 背景:fragment 参考姿态提供的是物体在模型里的**原始摆放(CAD 朝向)**,不代表物流 forward——哪根局部轴沿路径是**业务语义,由用户定义**(不存在固定朝向)。且 fragment 有系统性隐患:盒内部分几何时代表帧漂移、嵌套实例不稳定、副实例坐标系误判连带。 + - 修改:`TryCaptureRealObjectReferenceRotation` 不再解析 fragment,改用**默认轴约定**(forward=+X,up=宿主 up:YUp→+Y / ZUp→+Z)。用户通过“调整物体”窗口手工指定最终朝向(所见即所得)。 + - 收益: + - **F1 Rail + 42" Diameter(此前失败场景)现可正常检测**(碰撞 1,对象识别成功) + - 消除全部 fragment 相关隐患(盒内 fragment 不完整/嵌套实例漂移/AutoDetect 坐标系) + - 集成测试 25/25 通过(真实物体动画 Ground/Hoisting/Rail 正常) + +### ⚠️ 语义变化(需注意) + +- 真实物体**初始姿态基准**从 fragment(物体 CAD 实际朝向)→ **默认约定**(forward=+X) +- 用户通过“调整物体”手工指定最终朝向,功能不受影响(本来就相对路径/地面) +- **已保存的角度修正数据**(ObjectRotationCorrection)相对基准变化,旧数据需重新调整 + +### ✅ 已解决(0.18.1 已知问题) + +- ~~真实物体姿态链依赖 fragment 完整矩阵(Rail + 管道/嵌套实例类物体在副实例不可用)~~ → 已随去掉 fragment 依赖解决(42" Diameter Rail 路径检测成功) + ## [0.18.1] - 2026-08-05 ### 🐛 Bug 修复 diff --git a/VERSION.md b/VERSION.md index 1017b46..234fd4a 100644 --- a/VERSION.md +++ b/VERSION.md @@ -1,3 +1,3 @@ # 版本号 -0.18.1 +0.19.0