# Navisworks插件2026版本迁移需求文档

## 项目概述

本项目原为Navisworks 2017版本的物流路径规划插件，现需要迁移到Navisworks 2026版本，并增加导航地图创建功能。

## 功能需求

### 1. 通道选择及路径点规划

#### 1.1 模型切分

- **功能描述**：实现全模型按楼层或自定义属性切分
- **特殊要求**：可忽略编组站区域楼层间上下贯穿模块

#### 1.2 通道选择

- **功能描述**：支持选择通道模型功能
- **操作方式**：
  - 通过选择树选择模型
  - 通过三维视图点选的方式选择模型
  - 将选中模型指定为通道类型

#### 1.3 路径点规划

- **基本功能**：
  1. 针对较为复杂的环境，支持路径点功能
  2. 在三维视图中，在通道上点击指定起点、路径点、终点的位置及方向
  3. 以三维可视化的方式显示路径
- **高级功能**：
  - 支持多条路径的保存、选择和编辑

#### 1.4 编辑保存和导入

- **坐标编辑**：支持对路径上的各点进行坐标编辑
- **文件保存**：
  - 支持保存当前路径点集合为路径规划文件
  - 文件格式支持：XML、JSON、CSV
- **路径导入**：支持路径导入，在当前通道表面重绘路径
- **历史记录**：支持记录并查看路径文件操作的历史记录

#### 1.5 路径点自动贴合

- **功能描述**：路径点要自动贴合通道模型表面
- **连接方式**：路径点之间通过直线进行联通

### 2. 物流"类别"设置

#### 2.1 类别设置

- **功能描述**：支持模型属性页面新增"物流属性"类别

#### 2.2 属性设置

- **选择方式**：
  - 通过选择树选择物流路径相关元素
  - 通过三维视图选择物流路径相关元素
- **元素类型**：门、电梯、楼梯、通道等
- **属性配置**：
  - 设置为特定的物流分类
  - 支持类型设置
  - 可通行性设置
  - 速度限制设置
  - 宽度限制设置
  - 优先级设置
- **管理功能**：
  - 支持在工具箱中进行识别和筛选
  - 支持物流分类属性的添加、编辑和清除

#### 2.3 层级创建

- **层级显示**：支持自动隐藏或淡化非关键层，以便专注于物流路径相关的层级
- **物流元素筛选**：支持通过预设的物流分类属性筛选出物流路径相关元素
- **路径时间标签**：支持路径时间标签设置，以预估运输时间

### 3. 交互式导航

#### 3.1 交互式导航控件

- **功能描述**：创建交互式导航控件
- **核心功能**：允许用户选择不同的起点和终点，动态生成路径

#### 3.2 结果输出

- **导航地图输出**：输出导航地图和路径规划结果
- **输出格式**：
  - 视频格式
  - 图片格式
- **结构化文件输出**：
  - 支持路径规划结果结构化文件输出（XML/JSON/CSV）
  - 结果文件能够导入DELMIA

### 4. 碰撞检测

#### 4.1 动画生成和播放

- **物流组件设置**：指定物流组件（待载转运车）
- **动画功能**：
  1. 选择路径，支持生成动画仿真物流组件的运动过程
  2. 支持设置动画时长
  3. 支持动画的播放、停止和步进播放

#### 4.2 碰撞检查

- **实时检测**：指定物流组件（待载转运车）动画运行过程中，如果与其他模型发生碰撞或干涉，要高亮显示该模型
- **记录功能**：记录碰撞结果
- **导出功能**：支持碰撞记录导出

#### 4.3 路径规划分析

- **分析功能**：对多个路径运行的碰撞结果进行分析
- **报告生成**：生成路径分析报告
- **优化建议**：
  - 选择最佳路径
  - 提供调整建议

## 技术要求

### 版本兼容性

- **目标版本**：Navisworks 2026
- **源版本**：Navisworks 2017
- **API迁移**：需要适配新版本API变更

### 文件格式支持

- **输入格式**：支持Navisworks原生格式
- **输出格式**：XML、JSON、CSV
- **第三方集成**：支持导入DELMIA

### 性能要求

- **模型处理**：支持大型复杂模型的分层处理
- **实时渲染**：支持三维路径的实时可视化
- **动画流畅性**：确保动画播放的流畅性

## 实施优先级

1. **高优先级**：版本迁移和基础功能适配
2. **中优先级**：路径规划和物流属性设置
3. **低优先级**：高级分析和优化功能

## 验收标准

- [ ] 成功迁移到Navisworks 2026版本
- [ ] 所有原有功能正常工作
- [ ] 新增导航地图功能完整实现
- [ ] 支持多种文件格式的导入导出
- [ ] 碰撞检测和动画功能稳定运行
- [ ] 用户界面友好，操作流畅