# NavisworksTransport 插件管理员手册

本手册面向系统管理员，介绍 NavisworksTransport 物流路径规划插件的部署、升级、数据管理和维护操作。

---

## 目录

1. [系统要求](#系统要求)
2. [插件安装](#插件安装)
3. [插件升级](#插件升级)
4. [路径数据导出与导入](#路径数据导出与导入)
5. [数据库管理](#数据库管理)
6. [日志与故障排查](#日志与故障排查)
7. [常见问题](#常见问题)

---

## 系统要求

### 软件环境

| 组件 | 版本要求 |
|------|---------|
| 操作系统 | Windows 10/11 64位 |
| Autodesk Navisworks | Manage 2026 |
| .NET Framework | 4.8 或更高 |

### 权限要求

- **安装插件**: 需要管理员权限（写入 `C:\ProgramData\Autodesk\`）
- **运行插件**: 普通用户权限即可
- **数据库操作**: 对模型文件所在目录有读写权限

---

## 插件安装

### 安装前准备

1. 确认已安装 Navisworks Manage 2026
2. 关闭 Navisworks
3. 准备好安装包（包含 `TransportPlugin.dll` 和 `resources` 文件夹）

### 安装步骤

1. **创建插件目录**

   创建目录：`C:\ProgramData\Autodesk\Navisworks Manage 2026\plugins\TransportPlugin\`

2. **复制文件**

   将以下文件复制到插件目录：
   - `TransportPlugin.dll`
   - `resources` 文件夹（如有）

3. **验证安装**

   启动 Navisworks，检查菜单栏是否出现 **"物流路径"** 选项卡。

---

## 插件升级

### 升级前准备

1. **备份数据**（详见[数据库管理](#数据库管理)）
2. **关闭 Navisworks**
3. **记录当前版本**（查看 `TransportPlugin.dll` 文件属性）

### 升级步骤

1. **备份旧版本**（可选）

   复制 `TransportPlugin.dll` 为 `TransportPlugin_backup.dll`

2. **替换文件**

   将新版本的 `TransportPlugin.dll` 复制到插件目录，覆盖旧文件。

3. **验证升级**

   启动 Navisworks，检查插件是否正常加载，验证现有数据是否完整。

### 版本回滚

如升级后出现问题：

1. 关闭 Navisworks
2. 将备份的 `TransportPlugin_backup.dll` 重命名为 `TransportPlugin.dll`
3. 重新启动 Navisworks

---

## 路径数据导出与导入

### 导出路径数据

#### 支持的格式

| 格式 | 扩展名 | 用途 |
|------|-------|------|
| XML | `.xml` | 标准格式，推荐用于备份 |
| JSON | `.json` | 数据交换 |
| CSV | `.csv` | Excel 查看分析 |

#### 导出步骤

1. 在 **"路径编辑"** 面板中找到 **"路径文件管理"** 区域
2. 选择导出方式：
   - **"导出全部"**：导出所有路径
   - **"导出选中路径"**：导出当前选中的路径
3. 选择保存位置和格式
4. 点击"保存"

**命名建议**: `项目名_日期.xml`

### 导入路径数据

#### 导入步骤

1. 在 **"路径文件管理"** 区域点击 **"导入"** 按钮
2. 选择要导入的文件（XML 或 JSON）
3. 点击"确定"

导入的路径将自动合并到现有路径列表中。如遇重名路径，系统会自动重命名。

---

## 数据库管理

### 数据库概述

- **位置**: 与模型文件（`.nwd`）同目录
- **文件名**: 与模型文件同名，扩展名为 `.db`
- **示例**: `Project.nwd` → `Project.db`

### 数据备份

#### 通过插件界面备份

1. 打开 **"系统管理"** 选项卡
2. 在 **"数据管理"** 区域点击 **"备份数据"** 按钮
3. 选择保存位置
4. 系统自动导出所有路径、检测记录和截图

#### 自动备份设置

1. 在 **"数据管理"** 区域勾选 **"启用自动备份"**
2. 设置保留备份数量（默认保留最近若干个）

#### 手动备份数据库文件

1. **关闭 Navisworks**（必须）
2. 复制模型文件同目录的 `.db` 文件到备份位置

### 数据恢复

1. 在 **"系统管理"** 选项卡的 **"数据管理"** 区域
2. 点击 **"恢复数据"** 按钮
3. 选择备份文件
4. 点击"确定"

或手动恢复：关闭 Navisworks 后，用备份的 `.db` 文件覆盖原文件。

### 数据库维护

- **修复数据库**: 在 **"数据管理"** 区域点击 **"修复数据库"** 按钮，检查并修复完整性
- **清空数据**: 点击 **"清空数据"** 按钮清空所有路径和检测记录（谨慎使用）

---

## 日志与故障排查

### 日志查看

1. 打开 **"系统管理"** 选项卡
2. 在 **"日志管理"** 区域点击 **"查看日志"** 按钮

### 日志文件位置

```
C:\ProgramData\Autodesk\Navisworks Manage 2026\plugins\TransportPlugin\logs\
```

### 日志级别设置

在 **"日志管理"** 区域选择日志级别：

- Debug：详细调试信息
- Info：一般信息
- Warning：警告信息
- Error：仅错误信息

### 常见问题

#### 插件未加载（无"物流路径"选项卡）

**检查项**:

- 插件目录是否存在 `TransportPlugin.dll`
- Navisworks 版本是否为 Manage 2026
- .NET Framework 4.8 是否已安装

**查看 Windows 事件查看器**:

- 运行 `eventvwr.msc`
- 查看 "Windows 日志" → "应用程序"
- 查找 Navisworks 或 .NET 相关错误

#### 无法保存路径

**检查项**:

- 磁盘剩余空间
- 模型文件目录的写入权限
- 是否有其他 Navisworks 实例占用该模型

#### 导出/导入失败

**检查项**:

- 目标目录写入权限
- 磁盘空间是否充足
- 导入文件格式是否正确

### 联系技术支持

收集以下信息：

1. **日志文件**: `debug.log`
2. **插件版本**: 在 **"系统管理"** 选项卡的 **"系统信息"** 区域查看
3. **系统信息**: 运行 `msinfo32` 导出
4. **问题描述**: 操作步骤、错误提示

---

## 常见问题

### Q: 如何查看数据库版本？

**A**: 在 **"系统管理"** 选项卡的 **"数据管理"** 区域查看"插件版本"（如果没显示，可以点击“恢复数据库”刷新信息）。

### Q: 可以在多台机器上使用吗？

**A**: 可以。在每台机器安装插件即可。路径数据随 `.db` 文件与模型一起共享。

### Q: 卸载插件会删除数据吗？

**A**: 不会。数据存储在模型目录的 `.db` 文件中。

### Q: 如何彻底卸载插件？

**A**: 删除插件目录：`C:\ProgramData\Autodesk\Navisworks Manage 2026\plugins\TransportPlugin\`

### Q: 升级后数据还能用吗？

**A**: 要查看数据库版本，主版本相同，升级（如 2.1 → 2.2）完全兼容，跨主版本升级要删除数据库并重建。

### Q: 如何迁移到新电脑？

**A**:

1. 在原电脑使用"备份数据"功能
2. 在新电脑安装插件
3. 使用"恢复数据"功能

---

## 附录

### 常用路径

| 用途 | 路径 |
|------|------|
| 插件目录 | `C:\ProgramData\Autodesk\Navisworks Manage 2026\plugins\TransportPlugin\` |
| 日志目录 | `C:\ProgramData\Autodesk\Navisworks Manage 2026\plugins\TransportPlugin\logs\` |

**文档版本**: 1.0
