第2章 安装与部署

本章将详细介绍闪电围护（LightningCAD）的安装与部署流程。无论您是首次安装还是升级已有版本，按照本章的步骤操作，即可快速完成环境搭建并投入使用。

---

2.1 安装前的准备

在开始安装之前，请逐项确认以下环境条件已满足，以避免安装过程中出现不必要的问题。

2.1.1 操作系统要求

闪电围护仅支持 64 位 Windows 操作系统：

操作系统	最低版本要求
Windows 10	64 位，版本 1809 及以上
Windows 11	64 位，所有版本

提示：您可以通过 设置 → 系统 → 关于 查看当前操作系统的版本和位数。请确认"系统类型"显示为"基于 x64 的处理器"。

2.1.2 CAD 平台版本要求

闪电围护以 CAD 插件的形式运行，因此需要预先安装以下任一 CAD 平台：

CAD 平台	支持的版本	内部版本代号
AutoCAD	2019、2020	R23.0、R23.1
中望CAD（ZWCAD）	2022 及以上	2022+

注意：

• AutoCAD 2019 和 AutoCAD 2020 共享同一套插件（AC_2019），无需分别安装。
• 中望CAD 2025 及以上版本使用专用的 CUI 菜单文件（Lt_z25.cuix），系统会自动识别并适配。
• 请确保 CAD 已至少成功启动过一次，以便系统生成必要的注册表配置项。

2.1.3 .NET Framework 4.8 检查

闪电围护客户端及 CAD 插件均基于 .NET Framework 4.8 构建。Windows 10（1903 及以上）和 Windows 11 通常已预装此版本。

检查方法：

1. 按 Win + R 打开"运行"对话框。
2. 输入 regedit 并回车，打开注册表编辑器。
3. 导航到以下路径：

   HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full
   

4. 查看右侧 Release 的值：
   • 528040 或更大的数值 → 已安装 .NET Framework 4.8。
   • 小于 528040 → 需要手动安装或升级。

下载地址：如果尚未安装，请从微软官方下载 .NET Framework 4.8 运行时。

2.1.4 管理员权限要求

安装过程中需要向系统注册表写入以下内容：

• CAD 插件的自启动注册表项（HKCU\...\Applications\LtLauncher）
• CAD 受信任路径（TrustedPaths / ZWCADSEARCHPATH）
• 自定义 URL 协议（fsltcad://）
• 打印样式路径和字体搜索路径

因此，安装程序必须以管理员身份运行。如果您的计算机启用了用户账户控制（UAC），系统会在安装启动时弹出权限确认对话框，请点击"是"。

2.1.5 关闭杀毒软件

部分杀毒软件（如 360 安全卫士、腾讯电脑管家等）可能会将安装程序对注册表的写入操作误判为恶意行为，从而拦截安装过程。

建议：

• 在安装前临时关闭杀毒软件的实时防护功能。
• 或将安装程序（.msi 文件）及安装目录添加到杀毒软件的白名单/信任列表中。
• 安装完成后即可重新启用杀毒软件。

2.1.6 版本升级须知

如果您已安装了旧版本的闪电围护：

• 升级安装：直接运行新版本安装包即可。安装程序支持 MajorUpgrade 机制，会自动卸载旧版本并安装新版本。升级场景下，安装向导将跳过许可证和安装路径选择页面，只需点击一次"安装"即可完成升级。
• 降级安装：如果检测到系统中已安装更高版本，安装程序将阻断安装并提示版本信息。您需要先手动卸载高版本，再安装低版本。

---

2.2 客户端安装

闪电围护的安装包采用 MSI 格式，由 WixSharp 工具链构建，提供标准的 Windows 安装向导体验。

2.2.1 获取安装包

安装包文件命名格式为：

LightningCAD-<版本号>.msi

例如：LightningCAD-1.2.3.msi

请从以下渠道获取安装包：

• 企业内部发布平台：请联系您的系统管理员获取

安全提示：请始终从官方渠道下载安装包，避免使用来源不明的第三方分发版本。

2.2.2 安装步骤

第 1 步：启动安装向导

双击下载的 .msi 安装包文件。系统将弹出用户账户控制（UAC）对话框，点击"是"以管理员权限运行安装程序。

安装向导启动后，您将看到欢迎页面，其中包含产品品牌横幅图片和许可协议。

第 2 步：阅读并接受许可协议

仔细阅读软件许可协议，勾选"我接受许可协议中的条款"后，点击"下一步"。

第 3 步：选择安装路径

默认安装路径为：

C:\Program Files\LightningCAD

如需更改安装位置，点击"浏览"按钮选择目标文件夹。

建议：使用默认路径以避免潜在的权限问题。安装路径中不建议包含中文或特殊字符。

第 4 步：确认安装

在确认安装页面，检查安装路径和组件信息无误后，点击"安装"按钮。

安装过程将依次完成以下操作：

1. 将客户端程序文件部署到 Client 子目录
2. 部署 CAD 插件文件到 AC_2019 和 ZW_2022 子目录
3. 部署运行时依赖库到 Runtime 子目录
4. 部署 CAD 支持文件（字体、打印样式）到 Support 子目录
5. 部署资源文件（菜单、模板、图标、样例工程等）到 Resources 子目录
6. 部署系统配置文件到 Configs 子目录
7. 注册 fsltcad:// 自定义 URL 协议
8. 配置 CAD 受信任路径（如安装时已检测到 CAD 版本）

第 5 步：完成安装

安装进度条走完后，点击"完成"按钮退出安装向导。

2.2.3 安装目录结构

安装完成后，安装目录的结构如下：

LightningCAD/
├── Client/                  # 客户端主程序
│   ├── Fs.Lt.Client.exe     # 客户端可执行文件（主入口）
│   └── ...                  # 客户端依赖库
├── AC_2019/                 # AutoCAD 2019/2020 插件
│   ├── Fs.Lt.CAD.Launcher.dll
│   ├── FsCadCore.arx
│   ├── FsAecBase.dbx
│   ├── Lt.cuix              # AutoCAD 自定义菜单文件
│   └── ...
├── ZW_2022/                 # 中望CAD 2022+ 插件
│   ├── Fs.Lt.CAD.Launcher.dll
│   ├── FsCadCore.zrx
│   ├── FsAecBase.zrx
│   ├── Lt.cuix              # 中望CAD 自定义菜单文件
│   ├── Lt_z25.cuix          # 中望CAD 2025+ 专用菜单文件
│   └── ...
├── Runtime/                 # 通用运行时依赖库
├── Support/                 # CAD 支持文件
│   ├── Fonts/               # 字体文件
│   └── PlotStyles/          # 打印样式文件
├── Resources/               # 静态资源
│   ├── Menus/               # 菜单与命令配置
│   ├── Templates/           # 标准图纸模板
│   ├── Icons/               # 图标资源
│   ├── Editor/              # 编辑器相关资源
│   ├── SampleProject/       # 样例工程数据
│   └── StandardLibraries/   # 公共库/标准库
└── Configs/                 # 系统配置文件

2.2.4 桌面快捷方式

安装完成后，系统将自动创建以下快捷方式：

• 桌面快捷方式：名称为"闪电围护"，双击可直接启动客户端。
• 开始菜单快捷方式：位于 开始菜单 → Fs → 闪电围护 目录下，包含：
  • "闪电围护"：启动客户端
  • "卸载闪电围护"：启动卸载程序

---

2.3 CAD 插件注册

客户端安装完成后，还需要将插件注册到目标 CAD 平台，才能实现 CAD 启动时自动加载闪电围护功能。

2.3.1 自动检测已安装的 CAD 版本

启动闪电围护客户端后，系统将自动扫描 Windows 注册表，检测计算机上已安装的 CAD 平台及版本。

检测机制如下：

• AutoCAD：扫描注册表路径 HKLM\SOFTWARE\Autodesk\AutoCAD（含 WOW6432Node），识别版本代号 R23.0（AutoCAD 2019）和 R23.1（AutoCAD 2020），并读取安装路径（AcadLocation）和用户配置列表（Profiles）。
• 中望CAD：扫描注册表路径 HKLM\SOFTWARE\ZWSOFT\ZWCAD，识别 2022 及以上版本，并读取安装路径（LOCATION）。

2.3.2 插件注册流程

1. 打开 CAD 管理页面

   在客户端主界面中，进入设置或 CAD 管理页面。您将看到所有检测到的 CAD 版本列表，每个版本显示以下信息：

   信息项	说明
   显示名称	如"AutoCAD2019"、"中望CAD2022"
   安装路径	CAD 可执行文件的完整路径
   注册状态	复选框，表示插件是否已注册到该 CAD 版本
   主页 CAD	标记此版本是否为默认启动版本

2. 勾选需要注册的 CAD 版本

   找到目标 CAD 版本，勾选其前方的复选框。系统将立即执行注册操作。

3. 注册表写入

   勾选后，系统自动在对应 CAD 的注册表路径下创建 Applications\LtLauncher 键，并写入以下值：

   注册表值	说明	AutoCAD	中望CAD
   DESCRIPTION	插件描述	"闪电围护设计软件"	"闪电围护设计软件"
   LOADCTRLS	加载控制标志	14（随 CAD 启动加载）	2（随 CAD 启动加载）
   LOADER	插件 DLL 路径	...\AC_2019\Fs.Lt.CAD.Launcher.dll	...\ZW_2022\Fs.Lt.CAD.Launcher.dll
   MANAGED	标记为 .NET 托管插件	1	1
   LOAD	启用加载	1	—

4. 自动配置受信任路径

   系统会自动将插件目录添加到 CAD 的受信任路径中，以避免 CAD 在加载插件时弹出安全警告：

   • AutoCAD：修改 TRUSTEDPATHS 注册表值，追加 AC_2019 插件目录。
   • 中望CAD：修改 ZWCADSEARCHPATH 注册表值，追加 ZW_2022 插件目录。

   同时还会配置以下辅助路径：

   路径类型	AutoCAD 注册表位置	中望CAD 注册表位置
   搜索路径	General\ACAD	Config\ZWCADSEARCHPATH
   打印样式路径	General\PrinterStyleSheetDir	Config\PLOTSTYLEPATH
   字体路径	General\ACAD	Config\ZWCADSEARCHPATH

5. 自动部署 CUI 菜单文件

   系统会将自定义菜单文件（.cuix）复制到插件目录或用户配置目录中：

   • AutoCAD 及 中望CAD 2024 及以下：使用 Lt.cuix
   • 中望CAD 2025 及以上：使用 Lt_z25.cuix

   菜单文件将在 CAD 启动时由插件自动加载，无需手动操作。

6. 设置主页 CAD（可选）

   如果您安装了多个 CAD 版本，可以将其中一个设置为"主页 CAD"。此版本将作为客户端首页的默认启动目标，点击"启动 CAD"按钮时将启动此版本。

2.3.3 通过客户端启动 CAD

客户端提供了集成的 CAD 启动功能，启动流程如下：

1. 在客户端主页，确认已设置好"主页 CAD"。
2. 点击"启动 CAD"按钮。
3. 系统将自动执行以下操作：
   • 验证路径：检查 CAD 路径配置（受信任路径、搜索路径、字体路径等）是否完整，如有缺失则自动补全。
   • 生成加载脚本：在用户配置目录（%AppData%\FsLt\UserProfiles\Scripts\）下生成 .scr 脚本文件，内容为 netload "插件DLL路径"。
   • 启动 CAD 进程：以 /b "脚本路径" 参数启动 CAD，使 CAD 在启动时自动执行 netload 命令加载插件。

提示：通过客户端启动 CAD 时，即使未在注册表中设置自启动（LOADCTRLS），插件也会通过 .scr 脚本被加载。这为临时使用或调试提供了便利。

---

2.4 多版本 CAD 共存

闪电围护完整支持多版本 CAD 并行安装的场景，您可以同时注册多个 CAD 版本的插件而不会相互干扰。

2.4.1 AutoCAD 多版本共存

如果您同时安装了 AutoCAD 2019 和 AutoCAD 2020：

• 两个版本共享同一套插件文件（位于 AC_2019 目录），因为 AutoCAD 2019 和 2020 的内部版本代号（R23.0 和 R23.1）使用兼容的 .NET API。
• 在客户端的 CAD 管理页面中，两个版本将分别显示，您可以独立勾选每个版本的插件注册状态。
• 每个版本的注册表项写入各自的 Applications\LtLauncher 路径下，互不影响。

2.4.2 AutoCAD 与中望CAD 共存

如果您同时安装了 AutoCAD 和中望CAD：

• 两个平台使用完全独立的插件文件：
  • AutoCAD 使用 AC_2019 目录下的 .arx、.dbx、.dll 文件
  • 中望CAD 使用 ZW_2022 目录下的 .zrx、.dll 文件
• 注册表路径完全隔离：
  • AutoCAD 写入 HKCU\SOFTWARE\AutoDesk\AutoCAD\...
  • 中望CAD 写入 HKCU\SOFTWARE\ZWSOFT\ZWCAD\...
• 受信任路径配置也各自独立，不会交叉影响。

2.4.3 插件注册版本隔离

每个 CAD 版本的插件注册状态独立管理：

• 勾选某个版本的复选框仅影响该版本的注册表项。
• 取消勾选某个版本仅删除该版本的 LtLauncher 注册表键，不会影响其他版本。
• 每个 CAD 版本可以有多个用户配置（Profile），系统会遍历所有配置并统一更新路径信息。

---

2.5 安装验证

完成安装和插件注册后，请按照以下步骤验证安装是否成功。

2.5.1 验证 CAD 插件加载

1. 通过闪电围护客户端启动目标 CAD（或直接从桌面/开始菜单启动 CAD）。

2. CAD 启动完成后，观察命令行窗口，应看到如下欢迎信息：

   ~~~欢迎使用闪电CAD~~~
   闪电CAD核心模块已加载完成
   FsCadCore.arx: 加载成功
   FsAecBase.dbx: 加载成功
   FsAecBaseMgd.dll: 加载成功
   Fs.Fox.AutoCad.dll: 加载成功
   Fs.Lt.CAD.AecEntity.dll: 加载成功
   Fs.Lt.CAD.Common.dll: 加载成功
   Fs.Lt.CAD.Kit.dll: 加载成功
   Fs.Lt.CAD.Main.dll: 加载成功
   Enjoy~
   

   如果某个模块显示"加载失败"，请记录失败原因并参考本章末尾的"常见安装问题"进行排查。

2.5.2 验证 Ribbon 菜单

CAD 启动并加载插件后，在 Ribbon 工具栏区域应出现"闪电围护"选项卡（或"FsLtGroup"菜单组）。点击该选项卡，应能看到闪电围护提供的各项功能按钮。

AutoCAD 用户：菜单通过 Lt.cuix 局部菜单文件加载，采用 Managed API（LoadPartialMenu）确保加载的原子性和持久性。

中望CAD 用户：菜单通过 LISP 脚本动态加载，每次启动时自动检测并加载，确保菜单始终显示。

2.5.3 验证命令行

在 CAD 命令行中输入以下命令并回车，确认系统能够识别：

_FsLt

如果命令被正确识别，将启动闪电围护的主操作向导。如果提示"未知命令"，说明插件未正确加载，请检查插件注册状态。

2.5.4 验证状态栏

在 CAD 窗口底部的状态栏区域，应显示"闪电CAD"字样的状态面板。点击该面板，可以快速启动闪电围护的主操作向导。

2.5.5 验证客户端功能

回到闪电围护客户端，确认以下功能正常：

• 能够正常登录或进入主界面。
• CAD 管理页面中已注册的版本显示为勾选状态。
• 点击"启动 CAD"按钮能够成功启动目标 CAD。

---

2.6 卸载

如需卸载闪电围护，请按照以下步骤操作。

2.6.1 通过控制面板卸载

1. 打开 Windows 设置 → 应用 → 已安装的应用（或传统控制面板 → 程序和功能）。
2. 在列表中找到"闪电围护 v<版本号>"。
3. 点击"卸载"按钮。
4. 按照卸载向导完成操作。

替代方式：也可以通过开始菜单中的"卸载闪电围护"快捷方式启动卸载程序。

2.6.2 自动清理注册表残留

卸载过程中，安装程序将自动执行以下清理操作（由 CleanupCadRegistry 自定义动作完成）：

AutoCAD 清理项：

• 删除所有 AutoCAD 版本下的 Applications\LtLauncher 注册表键
• 从 ACAD（搜索路径）中移除闪电围护相关路径
• 从 PrinterStyleSheetDir（打印样式路径）中移除闪电围护相关路径
• 从 TRUSTEDPATHS（受信任路径）中移除闪电围护相关路径

中望CAD 清理项：

• 删除所有中望CAD 版本下的 Applications\LtLauncher 注册表键
• 从 ZWCADSEARCHPATH（搜索路径）中移除闪电围护相关路径
• 从 PLOTSTYLEPATH（打印样式路径）中移除闪电围护相关路径

技术细节：清理操作采用"精确匹配"策略——仅移除以安装目录开头的路径段，不会影响用户自行添加的其他路径。

2.6.3 用户配置文件

卸载程序不会自动删除以下用户数据目录：

%AppData%\FsLt\
├── Logs\           # 运行日志
├── UserProfiles\   # 用户配置
│   └── Scripts\    # CAD 启动脚本
└── Cache\          # 临时缓存

如需彻底清除所有数据，请在卸载后手动删除上述目录。

2.6.4 卸载后验证

卸载完成后：

1. 启动 CAD，确认命令行不再显示闪电围护的欢迎信息。
2. 确认 Ribbon 中不再出现"闪电围护"选项卡。
3. 确认状态栏中不再显示"闪电CAD"面板。

---

2.7 常见安装问题

以下是安装和使用过程中可能遇到的问题及其解决方案。

2.7.1 "未检测到 CAD 版本"

现象：启动客户端后，CAD 管理页面为空，提示未检测到任何 CAD 版本。

可能原因及解决方案：

原因	解决方案
CAD 未安装或安装不完整	确认 CAD 已正确安装，且至少启动过一次。重新安装 CAD 后再试。
注册表权限不足	以管理员身份运行客户端。检查注册表 HKLM\SOFTWARE\Autodesk\AutoCAD 或 HKLM\SOFTWARE\ZWSOFT\ZWCAD 是否存在且可读。
CAD 版本不在支持范围内	当前仅支持 AutoCAD 2019/2020 和中望CAD 2022+。如果您使用的是其他版本，请联系技术支持确认兼容性。
64 位/32 位不匹配	确认安装的是 64 位版本的 CAD。闪电围护不支持 32 位 CAD。

2.7.2 "插件加载失败"

现象：CAD 启动后，命令行显示某些模块"加载失败"，或出现安全警告弹窗。

可能原因及解决方案：

原因	解决方案
受信任路径未配置	在客户端 CAD 管理页面取消勾选后重新勾选该 CAD 版本，以重新写入受信任路径。
.NET Framework 版本不匹配	确认已安装 .NET Framework 4.8（参见 2.1.3 节）。
插件 DLL 文件缺失	检查安装目录下的 AC_2019 或 ZW_2022 文件夹是否完整，特别是 Fs.Lt.CAD.Launcher.dll 文件是否存在。
CAD 安全设置阻止加载	在 CAD 中输入 SECURELOAD 命令，将值设为 0（允许加载任意位置的插件），或确保插件路径已加入 TRUSTEDPATHS。
ARX/ZRX 文件加载失败	确认 FsCadCore.arx（AutoCAD）或 FsCadCore.zrx（中望CAD）文件存在且未被杀毒软件隔离。

2.7.3 "杀毒软件拦截"

现象：安装过程中或 CAD 启动时，杀毒软件弹出警告，阻止操作或隔离文件。

解决方案：

1. 安装阶段：临时关闭杀毒软件的实时防护，完成安装后重新启用。
2. 运行阶段：将以下路径添加到杀毒软件的白名单/信任列表：
   • 安装目录：C:\Program Files\LightningCAD\（或您自定义的安装路径）
   • 用户数据目录：%AppData%\FsLt\
   • 客户端可执行文件：Fs.Lt.Client.exe
3. 如果文件已被隔离，请从杀毒软件的隔离区恢复文件，并添加白名单。

2.7.4 "安装权限不足"

现象：双击 MSI 安装包后，提示"您没有足够的权限安装此程序"或安装过程中报错。

解决方案：

1. 右键点击 MSI 文件，选择"以管理员身份运行"。如果右键菜单没有此选项，请打开管理员权限的命令提示符（CMD），然后执行：

   msiexec /i "LightningCAD-<版本号>.msi"
   

2. 确认当前 Windows 用户账户具有管理员权限。
3. 如果计算机加入了域，可能需要联系 IT 管理员授权安装。

2.7.5 "检测到已安装更新版本"

现象：安装时弹出提示"检测到电脑中已安装更新版本"，安装被阻断。

原因：安装程序检测到系统中已安装了更高版本的闪电围护，为防止降级导致功能异常，自动阻断了安装。

解决方案：

• 如果确实需要降级：先通过控制面板卸载当前版本，再运行低版本安装包。
• 如果只是想重新安装当前版本：请使用相同版本或更高版本的安装包。

2.7.6 "CUI 菜单未显示"

现象：CAD 启动后插件加载成功（命令行有欢迎信息），但 Ribbon 中未出现"闪电围护"选项卡。

可能原因及解决方案：

原因	解决方案
CUI 文件缺失	检查插件目录下是否存在 Lt.cuix（或中望CAD 2025+ 的 Lt_z25.cuix）。如缺失，重新安装或从客户端重新注册插件。
CAD 工作空间未切换	尝试在 CAD 中切换工作空间（如从"草图与注释"切换到"三维建模"再切回来），触发 Ribbon 刷新。
CUI 加载失败	在 CAD 命令行输入 CUILOAD，查看已加载的菜单列表中是否包含 FsLtGroup。如未包含，手动加载 Lt.cuix 文件。

2.7.7 "URL 协议无法识别"

现象：从网页或其他应用点击 fsltcad:// 链接时，系统提示无法打开。

解决方案：

1. 确认闪电围护已正确安装（安装程序会自动注册 fsltcad:// URL 协议）。
2. 检查注册表 HKEY_CLASSES_ROOT\fsltcad 是否存在，且 shell\open\command 指向正确的客户端路径。
3. 如注册表项缺失，重新安装闪电围护即可修复。

---

附录：用户数据目录说明

闪电围护在运行过程中会在用户目录下创建以下数据：

路径	说明
%AppData%\FsLt\Logs\	运行日志文件，排查问题时可提供给技术支持
%AppData%\FsLt\UserProfiles\	用户配置文件（界面布局、偏好设置等）
%AppData%\FsLt\UserProfiles\Scripts\	CAD 启动脚本（.scr 文件）
%AppData%\FsLt\UserProfiles\CUI\	用户级 CUI 菜单文件副本
%AppData%\FsLt\Cache\	临时缓存数据

提示：如遇到异常问题，可尝试删除 Cache 目录下的文件后重启客户端。如需提交问题报告，请附上 Logs 目录中的最新日志文件。