From 48d7714131b2ab1907f0d7adc709d847519bb01b Mon Sep 17 00:00:00 2001
From: tian <11429339@qq.com>
Date: Wed, 5 Aug 2026 23:46:41 +0800
Subject: [PATCH] =?UTF-8?q?chore:=20=E7=89=88=E6=9C=AC=200.19.0=20?=
 =?UTF-8?q?=E2=80=94=20=E5=8E=BB=E6=8E=89=20fragment=20=E4=BE=9D=E8=B5=96?=
 =?UTF-8?q?=EF=BC=88=E9=BB=98=E8=AE=A4=E8=BD=B4=E7=BA=A6=E5=AE=9A=E6=9B=BF?=
 =?UTF-8?q?=E4=BB=A3=EF=BC=89+=20CHANGELOG?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CHANGELOG.md | 22 ++++++++++++++++++++++
 VERSION.md   |  2 +-
 2 files changed, 23 insertions(+), 1 deletion(-)

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