# NavisworksTransport

Navisworks2026运输冲突检测插件，专用于物流路径规划。

## 功能特性

- ✅ 类别属性分配：为模型项目添加物流类别属性（门、电梯、楼梯、通道、障碍物）
- ✅ 模型分层转换和可见性控制
- ✅ 导航地图构建
- ✅ A*路径规划算法
- ✅ 动态碰撞检测
- ✅ 动画和时间线集成
- ✅ DELMIA数据导出

## 系统要求

- Windows 10 或更高版本
- Navisworks Manage 2026
- .NET Framework 4.8

## 安装说明

1. 编译项目生成NavisworksTransportPlugin.dll
2. 插件会自动安装到Navisworks插件目录：
   `[Navisworks安装路径]\Plugins\NavisworksTransportPlugin\`
3. 重启Navisworks即可在"附加模块"选项卡中找到插件

## 使用方法

1. 在Navisworks中选择要设置属性的模型项目
2. 点击"附加模块"选项卡中的"Transport Plugin"
3. 在弹出窗口中点击相应的类别按钮
4. 在属性面板中查看添加的"物流分类"属性

详细使用说明请参阅：[使用说明文档](doc/working/使用说明.md)

## 开发文档

- [开发任务文档](doc/working/类别属性功能开发任务.md)
- [设计方案](doc/design/Navisworks%20物流路径规划插件快速开发方案：动态碰撞检测与动画集成_.md)
- [需求文档](doc/requirement/user_requiement.md)

## 技术架构

```
NavisworksTransportPlugin/
├── MainPlugin.cs              # 插件主类和用户界面
├── LogisticsCategories.cs     # 物流类别定义
├── CategoryAttributeManager.cs # COM API封装和属性管理
└── Properties/
    └── AssemblyInfo.cs        # 程序集信息
```

## 版本历史

### v1.0 (2025-01-11)

- 实现基础的类别属性分配功能
- 支持5种预定义物流类别
- 提供批量处理能力
- 完整的错误处理和用户反馈

## 原始需求概述

本插件旨在简化 Navisworks Manage 中移动模型沿确定路径进行物理碰撞或干涉检测的流程。通过自动化 Animator 动画创建、Clash Detective 碰撞测试配置与运行，并提供直观的图形化碰撞结果显示，本插件将大大提高工作效率，并为用户提供一个快速验证施工物流和设备移动可行性的工具。

完整的目标功能包括：

- 在 Navisworks Ribbon 界面添加自定义按钮
- 用户选择一个要移动的模型
- 用户通过选择一系列模型元素来定义非直线路径点
- 插件自动在 Animator 中创建基于这些路径点的对象动画
- 插件自动配置并运行一个链接到该动画的动态碰撞测试
- 当检测到碰撞时，插件将通过颜色覆盖直观地高亮显示碰撞的物体，并弹出明确的提示信息
