From 10be0a5e4ffd4ee993eff3e98c53bf7ac75b67e0 Mon Sep 17 00:00:00 2001
From: tian <11429339@qq.com>
Date: Wed, 5 Aug 2026 17:45:59 +0800
Subject: [PATCH] =?UTF-8?q?chore:=20=E7=89=88=E6=9C=AC=200.18.1=20?=
 =?UTF-8?q?=E2=80=94=20F1=20=E5=AF=BC=E5=87=BA=E5=89=8D=E6=81=A2=E5=A4=8D?=
 =?UTF-8?q?=E7=A7=BB=E5=8A=A8=E7=89=A9=E4=BD=93=20+=20=E5=9D=90=E6=A0=87?=
 =?UTF-8?q?=E7=B3=BB=E5=BC=BA=E5=88=B6=E6=B3=A8=E5=85=A5=20+=20=E8=AE=B0?=
 =?UTF-8?q?=E5=BD=95=20fragment=20=E4=BE=9D=E8=B5=96=E5=B7=B2=E7=9F=A5?=
 =?UTF-8?q?=E9=97=AE=E9=A2=98?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- F1 导出前恢复移动物体到路径起点（解决盒外物体'无法解析'失败）
- 副实例坐标系强制注入（极小导出模型 AutoDetect 误判 ZUp）
- 真实物体选择失败错误信息明确化
- 已知问题记录：Rail + 管道/嵌套实例类真实物体 fragment 不完整→代表帧漂移；后续去掉 fragment 依赖
---
 CHANGELOG.md | 21 +++++++++++++++++++++
 VERSION.md   |  2 +-
 2 files changed, 22 insertions(+), 1 deletion(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index caeacda..a5c8e2b 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,26 @@
 # NavisworksTransport 变更日志
 
+## [0.18.1] - 2026-08-05
+
+### 🐛 Bug 修复
+
+- **F1 导出前恢复移动物体到路径起点**：加入批处理时物体已移到路径起点，但后续操作（添加其他项/归位）会把物体移回 CAD 原位置（甚至不在路径剖面盒内）→ 导出不含移动物体 → 副实例"无法解析真实物体"失败。现在 F1 导出前按批处理项记录的 MovingObject PathId 解析移动物体并 `MoveObjectToPathStart` 恢复到路径起点后再导出。
+- **副实例坐标系强制注入**：极小导出模型的 `Document.UpVector` 可能获取失败/丢失 → AutoDetect 误判为 ZUp（实际 YUp）→ 真实物体姿态链（尤其 Rail 严格依赖 YUp/ZUp）出错。`CoordinateSystemManager` 支持环境变量 `TRANSPORTPLUGIN_TEST_COORD_SYSTEM` 强制坐标系，`InstanceManager` 启动副实例时注入主 NW 的 `ResolvedType`。
+- **真实物体选择失败错误信息明确化**：副实例中物体 fragment 姿态解析失败时，错误信息明确提示（而非笼统的"动画视图模型未保留选中的对象"）。
+
+### 📋 已知问题（待后续解决）
+
+- **真实物体姿态链依赖 fragment 完整矩阵（Rail 路径突出）**：
+  - 现象：`42" Diameter` 等嵌套实例/管道类物体作为移动物体时，副实例（路径剖面盒导出模型）中物体被盒截断（fragment 只含 4/64 个）→ `TryGetRepresentativeFrame` 从部分矩阵综合代表帧漂移（5.7° → 103°）→ 世界轴匹配（要求 ≥0.98）失败 → 动画生成失败
+  - 影响：Rail 路径 + 管道/嵌套实例类真实物体移动在副实例不可用；Ground/Hoisting + 完整 fragment 物体（如 Chair Lounge Couch Double）正常
+  - **方向：后续去掉 fragment 代表姿态依赖**（真实物体姿态链不依赖 fragment 完整矩阵），届时此类场景将解除限制
+
+### 验证
+
+- 同一物体（96"，CAD 位置盒外）+ 两条不同路径（Ground/Hoisting）均成功
+- 同一条路径 × 2 并行均成功（碰撞数一致）
+- 集成测试此前 25/25
+
 ## [0.18.0] - 2026-08-05
 
 ### ✨ 新功能
diff --git a/VERSION.md b/VERSION.md
index b072aff..1017b46 100644
--- a/VERSION.md
+++ b/VERSION.md
@@ -1,3 +1,3 @@
 # 版本号
 
-0.18.0
+0.18.1