第11章 常见问题与故障排除

在使用 LightningCAD（闪电围护）的过程中，您可能会遇到各种问题。本章按照问题类别进行了系统整理，每个问题均包含现象描述、可能原因和解决方案三个部分，帮助您快速定位并解决问题。

提示：在联系技术支持之前，建议您先按照本章对应问题的解决方案进行自查，大多数常见问题均可通过简单操作自行修复。

11.1 安装与启动问题

本节涵盖 LightningCAD 安装、注册和启动过程中可能出现的问题。

Q1: 安装时提示”未检测到CAD版本”

现象

启动 LightningCAD 客户端后，进入”设置”页面的 CAD 管理区域为空，或显示”未检测到支持的 CAD 版本”提示。在”软件启动”页面也可能显示红色警告信息。

可能原因

解决方案

1. 确认 CAD 已安装：在 Windows 的”设置 → 应用 → 已安装的应用”中检查是否有 AutoCAD 或中望CAD 的安装记录。
2. 至少启动一次 CAD：安装 CAD 后，请双击桌面图标或从开始菜单启动 CAD，确保其至少成功运行一次并完成初始化。
3. 检查 CAD 版本：
   • AutoCAD：仅支持 2019（内部代号 R23.0）和 2020（R23.1）版本。
   • 中望CAD：仅支持 2022 及以上版本。
   • 如果您使用的是 AutoCAD 2021 或更高版本，当前暂不支持，请联系技术支持了解适配计划。
4. 确认 64 位：打开 CAD，在命令行输入 ABOUT 查看版本信息，确认显示为 64 位版本。
5. 以管理员身份运行客户端：右键点击客户端快捷方式，选择”以管理员身份运行”，确保有权限读取注册表中的 CAD 信息。
6. 手动检查注册表：按 Win + R 输入 regedit，导航到以下路径确认 CAD 注册信息存在：
   • AutoCAD：HKEY_LOCAL_MACHINE\SOFTWARE\Autodesk\AutoCAD
   • 中望CAD：HKEY_LOCAL_MACHINE\SOFTWARE\ZWSOFT\ZWCAD

Q2: 安装完成后 CAD 中不显示 LightningCAD 菜单

现象

CAD 启动后，命令行显示了插件加载成功的欢迎信息（”~欢迎使用闪电CAD~”），但 Ribbon 工具栏中未出现”闪电围护”选项卡。

可能原因

解决方案

1. 检查 CUI 文件是否存在：
   • AutoCAD 及中望CAD 2024 以下：检查安装目录下 AC_2019\ 或 ZW_2022\ 文件夹中是否存在 Lt.cuix。
   • 中望CAD 2025 及以上：检查是否存在 Lt_z25.cuix。
   • 如果文件缺失，在客户端”设置”页面中取消勾选再重新勾选对应 CAD 版本，系统将重新部署 CUI 文件。
2. 手动加载 CUI 菜单：
   • 在 CAD 命令行输入 CUILOAD 并回车。
   • 在弹出的对话框中查看已加载的菜单列表，确认是否包含 FsLtGroup。
   • 如未包含，点击”浏览”按钮，找到插件目录下的 Lt.cuix（或 Lt_z25.cuix）文件并加载。
3. 刷新工作空间：
   • 在 CAD 右下角的工作空间切换器中，切换到其他工作空间（如”三维建模”），然后再切换回”草图与注释”，触发 Ribbon 刷新。
4. 确认插件注册状态：
   • 打开 LightningCAD 客户端，进入”设置”页面，确认对应 CAD 版本的”自启动”开关已开启。
   • 关闭 CAD，然后从客户端的”软件启动”页面重新启动 CAD。

Q3: CAD 启动时提示”无法加载插件 DLL”

现象

CAD 启动后，命令行未显示 LightningCAD 的欢迎信息，或弹出错误对话框提示无法加载某个 DLL 文件。CAD 命令行可能显示类似”无法加载程序集”或”找不到指定模块”的错误。

可能原因

解决方案

1. 检查文件完整性：
   • 打开安装目录下的 AC_2019\（AutoCAD）或 ZW_2022\（中望CAD）文件夹。
   • 确认以下关键文件存在：
     • AutoCAD：Fs.Lt.CAD.Launcher.dll、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
     • 中望CAD：Fs.Lt.CAD.Launcher.dll、FsCadCore.zrx、FsAecBase.zrx、FsAecBaseMgd.dll、Fs.Fox.ZwCad.dll、Fs.Lt.CAD.AecEntity.dll、Fs.Lt.CAD.Common.dll、Fs.Lt.CAD.Kit.dll、Fs.Lt.CAD.Main.dll
   • 如有文件缺失，请重新安装 LightningCAD。
2. 重新注册插件：
   • 打开客户端，进入”设置”页面。
   • 取消勾选对应 CAD 版本，等待几秒后重新勾选，系统将重新写入注册表项和受信任路径。
3. 调整 CAD 安全设置：
   • 在 CAD 命令行输入 SECURELOAD，将值设为 0（允许加载任意位置的插件）。
   • 或确保插件路径已添加到 CAD 的 TRUSTEDPATHS 中（重新注册插件会自动配置）。
4. 检查 .NET Framework：
   • 按 Win + R 输入 regedit，导航到 HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full。
   • 查看 Release 值，确认 ≥ 528040（即 .NET Framework 4.8）。
   • 如未满足，请从微软官网下载安装 .NET Framework 4.8 运行时。
5. 检查杀毒软件隔离区：
   • 打开杀毒软件，查看隔离区/威胁列表，确认 LightningCAD 的 DLL 文件是否被隔离。
   • 如被隔离，恢复文件并将安装目录添加到杀毒软件白名单。
6. 手动加载插件：
   • 在 CAD 命令行输入 NETLOAD 并回车。
   • 浏览到安装目录下的 AC_2019\ 或 ZW_2022\ 文件夹，选择 Fs.Lt.CAD.Launcher.dll 并加载。
   • 如果手动加载成功，说明是自动加载配置问题，请重新注册插件。

Q4: 客户端启动后闪退

现象

双击桌面快捷方式启动 LightningCAD 客户端后，窗口短暂出现后立即消失，或直接崩溃退出。

可能原因

解决方案

1. 检查 .NET Framework：
   • 确认已安装 .NET Framework 4.8（参见 Q1 中的注册表检查方法）。
   • 如已安装但仍闪退，可尝试从微软官网下载 .NET Framework 4.8 修复工具进行修复。
2. 清理配置文件：
   • 按 Win + R，输入 %AppData%\FsLt 并回车。
   • 将 UserProfiles 文件夹重命名为 UserProfiles_backup（备份而非删除）。
   • 重新启动客户端，系统将自动创建新的配置目录。
3. 检查后台进程：
   • 按 Ctrl + Shift + Esc 打开任务管理器。
   • 在进程列表中查找 Fs.Lt.Client.exe，如果存在，右键选择”结束任务”。
   • 重新启动客户端。
4. 安装 WebView2 Runtime：
   • 如果闪退发生在尝试 QQ 群登录时，请确认已安装最新版 WebView2 Runtime。
   • 从微软官网下载 WebView2 Runtime 并安装。
5. 检查操作系统版本：
   • 确认操作系统为 Windows 10（64 位，版本 1809 及以上）或 Windows 11。
   • 按 Win + R 输入 winver 查看当前系统版本。
6. 查看日志文件：
   • 打开 %AppData%\FsLt\Logs\ 目录，查看最新的客户端日志文件 lt-client-{日期}.txt。
   • 日志中通常记录了崩溃前的最后操作和异常信息，可将此文件提供给技术支持协助排查。

Q5: 提示”.NET Framework 版本不匹配”

现象

启动客户端或 CAD 插件时，弹出提示”.NET Framework 版本不匹配”或”需要 .NET Framework 4.8”。

可能原因

解决方案

1. 检查当前版本：
   • 按 Win + R 输入 regedit，导航到：

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

   • 查看 Release 的值：
     • 528040 或更大 → 已安装 .NET Framework 4.8
     • 461808 ~ 528039 → 已安装 .NET Framework 4.7.x，需要升级
     • 小于 461808 → 版本过低，需要安装 4.8
2. 安装/升级 .NET Framework 4.8：
   • 访问微软官方下载页面：.NET Framework 4.8 运行时
   • 下载并安装”运行时”版本（非 SDK）。
   • 安装完成后重启计算机。
3. 修复已安装的 .NET Framework：
   • 打开”设置 → 应用 → 可选功能 → 更多 Windows 功能”。
   • 找到”.NET Framework 4.8 Advanced Services”，取消勾选后确认，再重新勾选并确认，系统将重新安装修复。

Q6: 杀毒软件拦截安装/运行

现象

安装过程中或 CAD 启动时，杀毒软件（如 360 安全卫士、腾讯电脑管家、Windows Defender 等）弹出安全警告，阻止操作或将文件隔离。

可能原因

LightningCAD 在安装过程中需要执行以下操作，可能被杀毒软件误判为可疑行为：

• 向 Windows 注册表写入插件自启动项
• 修改 CAD 的受信任路径配置
• 注册自定义 URL 协议（fsltcad://）
• 部署 DLL 和 ARX/ZRX 扩展文件

解决方案

1. 安装阶段：
   • 在安装前临时关闭杀毒软件的”实时防护”功能。
   • 完成安装后立即重新启用杀毒软件。
2. 运行阶段 — 添加白名单：
   • 将以下路径添加到杀毒软件的信任列表/白名单中：
     • 安装目录：C:\Program Files\LightningCAD\（或您自定义的安装路径）
     • 用户数据目录：%AppData%\FsLt\
     • 客户端程序：Fs.Lt.Client.exe
3. 恢复被隔离的文件：
   • 打开杀毒软件的”隔离区”或”威胁历史记录”。
   • 找到 LightningCAD 相关的文件，选择”恢复”或”还原”。
   • 恢复后立即将安装目录添加到白名单，防止再次被隔离。
4. Windows Defender 用户：
   • 打开”Windows 安全中心 → 病毒和威胁防护 → 管理设置”。
   • 在”排除项”中添加 LightningCAD 安装目录和用户数据目录。

Q7: 开机自启不生效

现象

在客户端”设置”中已开启”开机自动运行”，但重启计算机后 LightningCAD 客户端未自动启动。

可能原因

解决方案

1. 检查任务管理器启动项：
   • 按 Ctrl + Shift + Esc 打开任务管理器。
   • 切换到”启动”选项卡。
   • 查找 LightningCAD 相关项，确认”状态”为”已启用”。
   • 如果显示”已禁用”，右键选择”启用”。
2. 检查杀毒软件：
   • 部分杀毒软件（如 360 安全卫士）的”启动项管理”功能可能禁用了 LightningCAD 的自启动。
   • 在杀毒软件的启动项管理中查找并启用 LightningCAD。
3. 关闭 Windows 快速启动：
   • 打开”控制面板 → 电源选项 → 选择电源按钮的功能”。
   • 点击”更改当前不可用的设置”。
   • 取消勾选”启用快速启动”，保存更改后重启计算机。
4. 重新开启自启动：
   • 打开 LightningCAD 客户端，进入”设置”页面。
   • 关闭”开机自动运行”开关，等待几秒后重新开启。

11.2 登录与认证问题

本节涵盖 LightningCAD 客户端登录、认证和账号管理相关的问题。

Q8: 登录时提示”无法连接到服务器”

现象

在登录窗口输入账号密码后点击”登录”，系统提示”无法连接到服务器”或”请求失败，请检查网络连接”。标题栏的服务器状态指示灯显示为红色。

可能原因

解决方案

1. 检查网络连接：
   • 确认本地网络连接正常，可尝试打开浏览器访问其他网站验证。
2. 检查防火墙设置：
   • 打开”Windows 安全中心 → 防火墙和网络保护 → 允许应用通过防火墙”。
   • 确认 Fs.Lt.Client.exe 已被允许通过防火墙（包括”专用”和”公用”网络）。
   • 如未列出，点击”允许其他应用”手动添加。
3. 检查代理设置：
   • 如果您在企业网络环境下，请咨询网络管理员是否需要配置代理。
   • 当前版本暂不支持手动配置代理服务器，如必须使用代理，请联系技术支持。
4. 等待并重试：
   • 如果确认本地网络正常，可能是服务端临时故障。
   • 等待 5~10 分钟后重试。客户端的心跳检测会每 5 分钟自动重试连接。
5. 刷新 DNS 缓存：
   • 按 Win + R 输入 cmd，在命令提示符中执行：

     ipconfig /flushdns
     

   • 然后重新启动客户端尝试登录。

Q9: 登录时提示”账号或密码错误”（确认密码正确）

现象

输入正确的邮箱和密码后，系统提示”账号或密码错误”，但您确认密码输入无误。

可能原因

解决方案

1. 检查输入细节：
   • 确认键盘的 Caps Lock 未开启（密码区分大小写）。
   • 切换到英文输入法状态输入密码。
   • 点击密码框右侧的眼睛图标，切换为明文显示，确认输入内容正确。
2. 清除自动填充：
   • 如果勾选了”记住账号”，系统可能自动填充了旧密码。
   • 手动清空密码框，重新输入当前密码。
3. 重置密码：
   • 如果确认密码正确但仍无法登录，建议通过”重置密码”功能重新设置密码（参见 Q13）。
4. 确认验证码：
   • 确保图形验证码输入正确。如果看不清，点击图片刷新获取新验证码。
   • 注意区分容易混淆的字符（如数字 0 和字母 O、数字 1 和字母 l 等）。

Q10: 验证码不显示/无法刷新

现象

登录窗口中的图形验证码区域显示为空白、加载失败，或点击验证码图片后无法刷新。

可能原因

解决方案

1. 检查网络：确认计算机已连接互联网，尝试在浏览器中访问其他网站验证网络连通性。
2. 点击刷新：直接点击验证码图片区域，系统将重新请求新的验证码。
3. 重启客户端：关闭客户端后重新启动，验证码将随登录窗口重新加载。
4. 等待重试：如果服务端暂时异常，等待 1~2 分钟后再次尝试。

Q11: 登录后频繁掉线

现象

登录成功后，使用一段时间后标题栏的服务器状态指示灯变为红色（”服务器未连接”），或操作时提示需要重新登录。

可能原因

解决方案

1. 检查网络稳定性：
   • 如果使用 Wi-Fi，尝试切换到有线网络连接。
   • 观察掉线是否与网络波动同步发生。
2. 重新登录：
   • 进入”个人中心”，点击”注销登录”。
   • 在登录窗口中重新输入账号密码登录，系统将获取新的 Token。
3. 检查电源设置：
   • 打开”设置 → 系统 → 电源和睡眠”，将”睡眠”时间设置为较长的值或”从不”。
   • 对于笔记本电脑，确保电源适配器已连接，避免节能模式断开网络。
4. 确认单设备使用：
   • 如果同一账号在多台设备上登录，可能导致 Token 冲突。
   • 确保同一时间只在一台设备上使用该账号。
5. 查看心跳状态：
   • 客户端每 5 分钟自动发送一次心跳检测。如果心跳失败，状态灯将变红。
   • 网络恢复后，心跳检测会自动重新连接，无需手动操作。

Q12: QQ群登录失败/扫码后无反应

现象

点击”QQ群登录”按钮后，弹出的 WebView2 窗口中 QQ 登录页面无法加载，或扫码完成后系统未自动跳转，提示”验证失败”。

可能原因

解决方案

1. 安装 WebView2 Runtime：
   • 从微软官网下载并安装最新版 WebView2 Runtime。
   • 安装完成后重启 LightningCAD 客户端。
2. 确认群成员身份：
   • 确认您的 QQ 账号已加入 LightningCAD 授权的 QQ 群。
   • 如不确定授权群号，请联系 LightningCAD 官方获取信息。
3. 等待页面完全加载：
   • 在 WebView2 窗口中，确保 QQ 登录页面已完全加载（能看到完整的 QQ 空间或群页面）。
   • 不要过早点击验证按钮。
4. 重新登录：
   • 点击窗口中的”重新登录”按钮，重新加载 QQ 登录页面。
   • 使用手机 QQ 重新扫描二维码。
5. 检查网络：
   • 确认能够正常访问 QQ 相关网站（如 https://qzone.qq.com）。
   • 如果企业网络屏蔽了 QQ 相关域名，请切换到其他网络环境。

Q13: 忘记密码如何重置

现象

忘记了 LightningCAD 的登录密码，无法登录。

解决方案

LightningCAD 提供了内置的密码重置功能，操作步骤如下：

1. 在登录窗口中，找到并点击“重置密码”入口。
2. 在弹出的”重置密码”窗口中，输入您注册时使用的邮箱地址。
3. 点击“发送验证码”按钮，系统将向您的邮箱发送验证码邮件。
4. 登录邮箱查收验证码，将其填入”验证码”输入框。
   • 如果 60 秒倒计时结束后仍未收到，点击”重新发送”。
   • 检查邮箱的垃圾邮件文件夹，验证码邮件可能被误判为垃圾邮件。
5. 在”新密码”输入框中设置新密码（不少于 6 位）。
6. 在”确认密码”输入框中再次输入新密码，确保两次一致。
7. 点击“重 置 密 码”按钮。
8. 重置成功后，系统将自动返回登录页面，使用新密码登录即可。

安全说明：密码在传输过程中采用 SM2 国密算法加密，确保通信安全。

Q14: “设备未授权”提示

现象

登录或使用时，系统提示”设备未授权”或”许可证无效”。

可能原因

解决方案

1. 申请/续期许可证：
   • 请联系您的 LightningCAD 服务提供商获取许可证申请指引。
   • 按照指引申请新的许可证或续期现有许可证。
2. 检查试用期状态：
   • LightningCAD 提供 30 天的免费试用期。
   • 如果试用期已过，需要申请正式许可证才能继续使用。
3. 联系技术支持：
   • 如果硬件变更导致设备指纹变化，请联系技术支持重新绑定许可证。
   • 如需将许可证迁移到新设备，同样需要联系技术支持协助处理。

11.3 板材排布问题

本节涵盖板材排布功能使用过程中可能遇到的问题。

Q15: 排布生成的板材数量与预期不符

现象

执行板材排布后，生成的板材总数量明显多于或少于预期值。

可能原因

解决方案

1. 检查排布参数：
   • 打开排布配置方案窗口，逐项核对板型参数（特别是”排板板宽”）。
   • 确认排布方向（横排/竖排）和排布方式（从下到上/从上到下等）符合设计意图。
   • 检查起铺点位置是否正确。
2. 验证围护边界：
   • 选中围护边界线，在属性面板中检查其尺寸参数。
   • 确认边界线为闭合多段线，且形状与设计图纸一致。
3. 确认洞口关联：
   • 在排布操作的选择洞口步骤中，确认所有洞口已被正确选中。
   • 检查洞口对象是否为 LightningCAD 识别的有效洞口实体（AecRectOpeningMgd 或 AecPolyOpeningMgd）。
4. 检查循环排板设置：
   • 如果使用多板型循环排布，检查板型列表中的循环单元是否正确。
   • 调整板型顺序和数量比例，观察预排板预览结果。
5. 利用预排板预览：
   • 在确认生成之前，使用”预排板”功能预览排布结果。
   • 根据预览效果调整参数，直到数量符合预期后再确认生成。

Q16: 排布后板材出现重叠

现象

排布完成后，部分板材在图纸上出现相互重叠的情况，碰撞检查报告中也标识了重叠区域。

可能原因

解决方案

1. 检查边界关系：
   • 如果选择了多个围护边界进行排布，确认各边界之间不存在交叉或重叠区域。
   • 使用 ZOOM 命令放大检查边界交接处。
2. 运行碰撞检查：
   • 使用 LightningCAD 的碰撞检查功能（FsLtCollisionCheck），系统将自动检测所有重叠区域并在图纸上高亮标识。
   • 根据检查报告逐一处理重叠问题。
3. 调整排布参数：
   • 检查板宽是否与边界尺寸存在整数倍关系，避免末端出现窄条板材。
   • 尝试调整起铺点位置，使板材分布更均匀。
4. 重新排布：
   • 如果重叠问题较多，建议删除当前排布结果，调整参数后重新执行排布操作。

Q17: 板长超出最大限制

现象

排布生成的某些板材长度超出了板材规格的最大允许长度，或系统提示”板长超出限制”。

可能原因

解决方案

1. 检查板材库参数：
   • 打开板材库浏览器，找到正在使用的板型。
   • 检查板型参数中的最大长度限制是否设置正确。
   • 如需修改，在板材库中编辑板型参数。
2. 添加搭接线分段：
   • 对于跨度较大的墙面，在排布前添加搭接线（节点线），将长墙面分割为多个较短的区段。
   • 搭接线位置应与结构檩条或檩距对应。
3. 调整排布方向：
   • 如果横向排布导致板长超限，尝试切换为竖向排布（或反之）。

Q18: 洞口周围板材未正确裁剪

现象

排布后，洞口（门窗洞口）周围的板材未被正确裁剪，板材穿越了洞口区域，或裁剪形状不正确。

可能原因

解决方案

1. 重新排布并选择洞口：
   • 删除当前排布结果，重新执行排布操作。
   • 在”选择洞口”步骤中，确保所有洞口对象均被正确选中。
   • 如果不确定是否全部选中，可使用框选方式选择边界内的所有洞口。
2. 验证洞口实体：
   • 选中洞口对象，在属性面板中确认其类型为 LightningCAD 的矩形洞口（AecRectOpeningMgd）或异形窗（AecPolyOpeningMgd）。
   • 如果洞口是用普通 CAD 线段绘制的，需要先通过 LightningCAD 的洞口命令创建有效洞口实体。
3. 检查洞口位置：
   • 确认洞口完全位于围护边界内部，不与边界线交叉或超出边界范围。
   • 使用 PROPERTIES 命令检查洞口和边界的 Z 坐标，确保两者一致。

Q19: 排布失败（提示边界/参数错误）

现象

执行排布命令后，系统弹出错误提示，如”边界不闭合”、”参数错误”、”排布失败”等，未能生成板材。

可能原因

解决方案

1. 检查边界闭合性：
   • 选中边界多段线，在 CAD 属性面板中查看”闭合”属性是否为”是”。
   • 如果未闭合，使用 PEDIT 命令的”闭合”选项将其闭合。
2. 检查边界自相交：
   • 放大检查边界线的每个顶点，确认不存在自相交。
   • 如有自相交，使用 PEDIT 命令编辑顶点，消除交叉。
3. 执行单体初始化：
   • 在 CAD 命令行输入 FsInitBuilding 并回车。
   • 按照提示完成单体初始化，系统将在 DWG 文件同级创建 .cfg/ 配置目录。
   • 初始化完成后再执行排布操作。
4. 检查板型参数：
   • 打开排布配置方案窗口，逐项检查板型参数，确保所有数值均为有效正数。
   • 特别注意”排板板宽”、”板材厚度”等必填参数。
5. 重建配置方案：
   • 如果怀疑配置方案损坏，删除当前方案并新建一个配置方案。
   • 配置方案保存在 DWG 文件同级的 .cfg\Configs\ 目录下，您也可以手动删除对应的 .configs.json 文件后重新创建。

Q20: 板材合并后编号混乱

现象

对板材执行合并操作后，板材编号出现重复、跳号或格式不统一的情况。

可能原因

解决方案

1. 执行自动重新编号：
   • 使用 LightningCAD 的板材编号工具（FsLtPanelRenumber），对所有板材进行统一重新编号。
   • 系统将按排布顺序自动生成连续、不重复的编号。
2. 运行编号校验：
   • 使用图纸校验功能中的”板材编号检查”项，系统将自动检测重复、跳号或格式不规范的编号。
   • 根据校验报告逐一修正问题编号。
3. 清理多余排布：
   • 如果存在多次排布叠加的情况，先删除不需要的旧排布结果，再对保留的板材重新编号。

Q21: 统计表数据与实际不符

现象

生成的板材统计表中的数量、面积或总长度等数据与图纸中实际的板材不一致。

可能原因

解决方案

1. 刷新统计数据：
   • 删除旧的统计表，重新执行统计表生成命令。
   • 确保在生成统计表之前，所有板材编辑操作已完成。
2. 确认选择范围：
   • 生成统计表时，使用框选方式确保选中了所有需要统计的板材。
   • 或按图层选择，确保目标图层上的所有板材均被包含。
3. 运行 ID 重复检查：
   • 使用图纸校验功能中的”ID 重复检查”项，检测并修复实体 ID 重复问题。
   • 修复后重新生成统计表。
4. 检查归并参数：
   • 在统计表设置中，检查归并长度的容差值。
   • 容差值过大会将不同长度的板材归并为同一规格，过小则可能无法正确归并相近长度。

11.4 节点线与收边问题

本节涵盖节点线自动生成、规则映射以及收边处理相关的问题。

Q22: 自动生成的节点线位置不正确

现象

使用自动生成节点线功能后，生成的节点线位置偏离预期位置，或出现在不应有节点的地方。

可能原因

解决方案

1. 检查规则映射配置：
   • 打开”墙面节点线规则映射配置”或”屋面节点线规则映射配置”窗口。
   • 逐项检查每种安装位置（如女儿墙、板底、转角、窗上等）对应的节点类型是否正确。
   • 修改后保存配置并重新生成节点线。
2. 调整缩进值：
   • 在节点线属性面板中，检查并调整左侧缩进（IndentLeft）和右侧缩进（IndentRight）的值。
   • 缩进值通常根据板材厚度和安装方式确定，请参考设计图纸中的节点详图。
3. 删除并重新生成：
   • 选中位置不正确的节点线，将其删除。
   • 修正配置后，重新执行自动生成节点线命令。
4. 手动调整位置：
   • 对于个别位置偏差较小的节点线，可以使用 CAD 的 MOVE 命令或夹点编辑进行手动微调。

Q23: 节点线规则映射不生效

现象

已配置好节点线规则映射，但执行自动生成命令后，节点线未按配置的规则创建，或某些位置完全没有生成节点线。

可能原因

解决方案

1. 确认配置已保存：
   • 打开规则映射配置窗口，确认所有修改已保存（窗口标题栏不应显示”未保存”标记）。
   • 关闭配置窗口后重新打开，确认配置内容已持久化。
2. 插入节点图块：
   • 通过节点库浏览器（FsJieDianKuWeiHu），将规则映射中引用的节点图块插入到图纸中。
   • 确保图纸中至少存在一个节点图块，规则映射才能正确引用。
3. 验证前置条件：
   • 确认图纸中已完成板材排布，且存在有效的围护边界线（AecLayoutBoundaryMgd）。
   • 如果包含洞口，确认洞口对象已被正确创建。
4. 重建配置文件：
   • 如果怀疑配置文件损坏，删除 .cfg\Configs\ 目录下对应的节点线配置文件。
   • 重新打开规则映射配置窗口，重新配置并保存。

Q24: 收边分段后编号异常

现象

对收边执行分段操作后，各段的编号出现重复、缺失或格式混乱的情况。

可能原因

解决方案

1. 检查分段参数：
   • 在收边属性面板中，检查分段参数（布置模式、分段长度、搭接长度等）是否合理。
   • 分段长度应小于或等于收边件的标准件规格长度。
2. 规范编号格式：
   • 确保原始收边编号采用标准格式（如 SB-001），系统将在分段后自动追加段号（如 SB-001-1、SB-001-2）。
3. 撤销并重新分段：
   • 如果编号已混乱，使用 UNDO 命令撤销分段操作。
   • 调整参数后重新执行分段。

Q25: 收边 BOM 导出数据不完整

现象

导出收边 BOM 表（材料清单）到 Excel 时，部分收边件信息缺失或数据不完整。

可能原因

解决方案

1. 检查收边属性：
   • 逐一选中收边图块，在属性面板中检查核心字段是否填写完整：
     • 收边编号（ShouBianNumber）
     • 收边名称（ShouBianName）
     • 收边分类（ShouBianCategory）
     • 截面参数（展宽、边长、角度等）
     • 材质、颜色、厚度
2. 修复关联关系：
   • 选中关联的节点线，在属性面板的”收边信息”区域确认收边编号列表是否正确。
   • 如关联丢失，重新设置节点线上的收边编号。
3. 扩大导出范围：
   • 导出 BOM 表时，确保选中了图纸中所有相关的收边对象。
   • 可使用”全选”功能或按图层选择。
4. 检查图块完整性：
   • 双击收边图块，确认能够正常打开属性编辑对话框。
   • 如果图块无法编辑，可能需要从收边库重新插入。

Q26: 节点线与板材关联丢失

现象

原本与板材关联的节点线，在板材编辑或移动后，关联关系丢失，节点线不再跟随板材变化。

可能原因

解决方案

1. 使用 LightningCAD 命令编辑：
   • 编辑板材时，尽量使用 LightningCAD 提供的专用编辑命令（如锚点调整、板材合并等），这些命令会自动维护关联关系。
   • 避免使用 CAD 原生的 MOVE、COPY 等命令直接操作板材实体。
2. 重新生成节点线：
   • 如果关联已丢失，删除现有节点线，使用自动生成节点线功能重新创建。
   • 重新生成前确保板材排布数据完整。
3. 避免跨图纸操作：
   • 如需将排布结果迁移到其他图纸，建议使用 LightningCAD 提供的导出/导入功能，而非简单的复制粘贴。

11.5 CAD 兼容性问题

本节涵盖不同 CAD 平台、版本之间的兼容性问题。

Q27: AutoCAD 不同版本间的兼容性

现象

在 AutoCAD 2019 中创建的图纸，在 AutoCAD 2020 中打开时出现异常，或反之。

说明

LightningCAD 的 AutoCAD 插件采用统一的 AC_2019 构建，同时兼容 AutoCAD 2019（R23.0）和 AutoCAD 2020（R23.1）。两个版本之间共享同一套插件文件，核心功能完全一致。

可能遇到的问题

Q28: 中望CAD 与 AutoCAD 的差异

现象

某些功能在 AutoCAD 中正常，但在中望CAD 中表现不同或不可用。

已知差异

解决方案

1. 确保使用正确的插件版本：
   • AutoCAD 使用 AC_2019 目录下的插件文件。
   • 中望CAD 使用 ZW_2022 目录下的插件文件。
   • 两个平台的插件文件完全独立，不可混用。
2. 中望CAD 2025+ 用户：
   • 系统会自动识别中望CAD 2025 及以上版本，并使用专用的 Lt_z25.cuix 菜单文件。
   • 如果菜单未显示，确认插件目录下存在 Lt_z25.cuix 文件。
3. 功能差异反馈：
   • 如果发现某个功能在中望CAD 中不可用或表现异常，请通过客户端内置的反馈通道提交问题报告。

Q29: 其他 CAD 插件冲突

现象

安装了其他 CAD 插件（如天正建筑、理正等）后，LightningCAD 出现功能异常、命令无法识别或 CAD 崩溃等问题。

可能原因

解决方案

1. 排查冲突插件：
   • 临时禁用其他 CAD 插件（在客户端中取消对应插件的自启动注册），然后启动 CAD 测试 LightningCAD 是否恢复正常。
   • 逐一启用其他插件，定位具体冲突的插件。
2. 调整加载顺序：
   • 如果确认了冲突的插件，尝试调整插件的加载顺序。
   • 在 CAD 的 Applications 注册表中修改加载控制参数。
3. 联系技术支持：
   • 记录冲突插件的名称和版本，连同日志文件一起提交给 LightningCAD 技术支持。
   • 我们将评估兼容性并在后续版本中优化。

Q30: 高版本 CAD 保存后低版本无法打开

现象

在 AutoCAD 2020 中保存的 DWG 文件，在 AutoCAD 2019 中打开时提示”版本过高无法打开”。

说明

这是 AutoCAD 自身的 DWG 文件格式版本问题，与 LightningCAD 无关。AutoCAD 2019 和 2020 使用相同的 DWG 文件格式版本（R23.x），因此通常不存在此问题。如果出现，可能是保存时选择了更高版本的格式。

解决方案

1. 另存为兼容格式：
   • 在高版本 CAD 中，使用”另存为”功能，选择”AutoCAD 2018/LT2018 DWG”或更低版本的格式保存。
2. 设置默认保存版本：
   • 在 CAD 中输入 SAVEASDEFAULT 命令，将默认保存格式设置为较低的 DWG 版本。

Q31: 中望CAD 中某些功能不可用

现象

在 AutoCAD 中正常使用的某些 LightningCAD 功能，在中望CAD 中无法执行或提示”功能不支持”。

可能原因

解决方案

1. 确认中望CAD 版本：
   • 建议使用中望CAD 2022 及以上版本，推荐升级到最新版本以获得最佳兼容性。
2. 执行 REGEN 刷新：
   • 如果自定义实体显示异常，在命令行输入 REGEN 或 REGENALL 刷新显示。
3. 反馈问题：
   • 记录不可用的功能名称和具体表现，通过客户端反馈通道提交。
   • 附上中望CAD 的版本号（在命令行输入 ABOUT 查看）。

11.6 性能与稳定性问题

本节涵盖软件运行性能、资源占用和稳定性相关的问题。

Q32: 大型项目操作卡顿

现象

当图纸中包含大量板材（数百块以上）、节点线或收边时，CAD 操作明显变慢，包括平移、缩放、选择对象等基本操作都出现延迟。

可能原因

解决方案

1. 分图管理：
   • 将大型项目拆分为多个 DWG 文件，按区域（如不同立面、不同楼层）分别管理。
   • 使用外部参照（XREF）将各分图组合查看。
2. 合理利用图层：
   • 将不同类型的实体分配到不同图层（如板材层、节点线层、收边层、标注层等）。
   • 在编辑某一类型时，冻结其他不相关的图层，减少 CAD 的渲染负担。
3. 升级硬件：
   • 内存：建议 16GB 及以上。
   • 硬盘：使用 SSD 固态硬盘。
   • 显卡：使用支持硬件加速的独立显卡，并在 CAD 中启用硬件加速（输入 3DCONFIG 命令）。
4. 清理图纸：
   • 使用 PURGE 命令清理图纸中未使用的图层、块定义、线型等冗余数据。
   • 使用 AUDIT 命令检查并修复图纸中的错误。
5. 关闭不必要的显示：
   • 关闭板材的文字标注显示（仅保留图形），减少文字渲染开销。
   • 在不需要查看节点线时，冻结节点线图层。

Q33: CAD 崩溃/无响应

现象

CAD 在操作过程中突然崩溃退出、弹出”致命错误”对话框，或长时间处于”无响应”状态。

可能原因

解决方案

1. 修复图纸文件：
   • 打开 CAD，使用 RECOVER 命令打开损坏的 DWG 文件，CAD 将尝试自动修复。
   • 或使用 AUDIT 命令对已打开的图纸进行错误检查和修复。
2. 检查内存使用：
   • 按 Ctrl + Shift + Esc 打开任务管理器，查看内存使用率。
   • 如果内存使用率超过 90%，关闭不必要的应用程序释放内存。
   • 考虑增加物理内存。
3. 查看崩溃日志：
   • 检查 %AppData%\FsLt\Logs\ 目录下的日志文件：
     • CAD 插件日志：LaunchCAD_{日期}.log（记录插件加载和初始化过程）
     • 主程序日志：fslt-plugin.txt（记录插件运行时的详细操作和错误信息）
   • 日志中的 Fatal 或 Error 级别记录通常包含崩溃原因。
4. 更新显卡驱动：
   • 访问显卡制造商官网（NVIDIA/AMD/Intel），下载并安装最新的显卡驱动。
   • 在 CAD 中输入 3DCONFIG，尝试关闭硬件加速测试是否改善。
5. 避免大数据量操作：
   • 排布大面积墙面时，分区域逐步排布，而非一次性选择所有边界。
   • 批量操作前先保存图纸，防止崩溃导致数据丢失。
6. 启用自动备份：
   • LightningCAD 支持文件自动备份功能，可在 CAD 工具包中配置备份间隔。
   • 同时建议开启 CAD 自身的自动保存功能（SAVETIME 系统变量，建议设为 10~15 分钟）。

Q34: 内存占用过高

现象

LightningCAD 客户端或 CAD 进程的内存占用持续增长，长时间使用后达到数 GB，导致系统变慢。

可能原因

解决方案

1. 定期重启 CAD：
   • 长时间工作后，保存图纸并重启 CAD，释放累积的内存占用。
2. 调整日志级别：
   • 在客户端”设置”中，确认”调试模式”处于关闭状态。
   • 调试模式开启时，客户端会输出大量调试信息到日志，增加内存和磁盘 I/O 负担。
3. 关闭不必要的图纸：
   • 在多文档模式下，关闭不再使用的 DWG 文件，释放内存。
4. 清理缓存：
   • 删除 %AppData%\FsLt\Cache\ 目录下的临时文件。
   • 重启客户端后缓存将自动重建。

Q35: 备份文件过多占用磁盘空间

现象

%AppData%\FsLt\ 目录或 DWG 文件同级目录下的备份文件占用大量磁盘空间。

可能原因

LightningCAD 的文件自动备份功能会定期创建备份文件，长时间使用后备份文件会不断累积。

解决方案

1. 清理旧备份：
   • 打开 %AppData%\FsLt\ 目录，检查各子目录的磁盘占用。
   • 手动删除不再需要的旧备份文件。
2. 调整备份策略：
   • 在 CAD 中的 LightningCAD 工具包设置中，调整自动备份的间隔时间和保留份数。
   • 建议保留最近 5~10 份备份即可。
3. 清理日志文件：
   • 日志文件保存在 %AppData%\FsLt\Logs\ 目录下。
   • CAD 插件日志按天滚动（LaunchCAD_{日期}.log），客户端日志按天滚动（lt-client-{日期}.txt）。
   • 系统默认保留最近 30 天的日志，超期的日志文件可手动删除。

11.7 网络与更新问题

本节涵盖自动更新、网络连接和心跳检测相关的问题。

Q36: 自动更新检测失败

现象

客户端启动后未自动检测更新，或手动点击”检查更新”后提示”检测失败”。状态栏始终不显示版本信息。

可能原因

解决方案

1. 检查网络连通性：
   • 打开浏览器，确认能够正常访问互联网。
2. 检查防火墙：
   • 确认防火墙未阻止 Fs.Lt.Client.exe 的网络访问权限。
   • 如果使用企业防火墙，请咨询管理员是否屏蔽了相关域名。
3. 手动检查更新：
   • 在客户端主窗口底部状态栏，点击”检查更新”链接。
   • 手动检查将清除之前的”稍后提醒”和”跳过此版本”记录，重新进行完整检查。
4. 稍后重试：
   • 如果确认网络正常但检测仍失败，可能是服务器端暂时异常。
   • 等待几分钟后再次尝试。

Q37: 更新下载中断

现象

更新窗口中下载进度条停滞不前，或提示”下载失败”。

可能原因

解决方案

1. 确保网络稳定：
   • 尽量使用有线网络连接进行更新。
   • 避免在网络高峰期（如晚间）进行大版本更新。
2. 检查磁盘空间：
   • 确认安装目录所在磁盘至少有 500MB 以上的可用空间。
   • 使用 Windows 的”磁盘清理”工具释放空间。
3. 关闭 CAD 后重试：
   • 更新前系统会检测 CAD 进程。如果 CAD 正在运行，请先保存工作并关闭所有 CAD 窗口。
   • 关闭 CAD 后，在更新对话框中点击”确定”继续。
4. 手动下载安装：
   • 如果自动更新持续失败，请联系服务提供商获取最新版本的安装包。
   • 运行 MSI 安装包进行升级安装（支持 MajorUpgrade，会自动卸载旧版本）。

Q38: 更新后设置丢失

现象

完成版本更新后，之前的个人设置（如主题、快捷键、CAD 注册状态等）丢失，需要重新配置。

可能原因

解决方案

1. 重新配置：
   • 大多数情况下，更新不会丢失用户配置。如果确实丢失，请重新进行设置。
   • CAD 注册状态需要在”设置”页面重新勾选对应 CAD 版本。
2. 检查备份：
   • 用户配置保存在 %AppData%\FsLt\UserProfiles\ 目录下。
   • 如果更新前此目录被备份过，可以从备份中恢复配置文件。
3. 反馈问题：
   • 如果更新后设置丢失，请通过反馈通道告知技术支持，以便在后续版本中优化配置迁移机制。

Q39: 心跳检测失败

现象

标题栏的服务器状态指示灯持续显示红色（”服务器未连接”），即使网络正常也无法恢复。

可能原因

解决方案

1. 重新登录：
   • 进入”个人中心”，点击”注销登录”。
   • 重新输入账号密码登录，获取新的 Token。
2. 检查系统时间：
   • 右键点击任务栏的时间显示，选择”调整日期/时间”。
   • 开启”自动设置时间”，确保系统时间与网络时间同步。
3. 等待自动恢复：
   • 客户端每 5 分钟自动执行一次心跳检测。
   • 如果是服务端暂时异常，等待几分钟后状态应自动恢复。
4. 检查网络环境：
   • 确认防火墙未阻止客户端的网络访问。
   • 如果在企业网络环境下，咨询管理员是否有出站流量限制。

11.8 数据与文件问题

本节涵盖配置文件、公共库文件和图纸文件相关的问题。

Q40: 配置文件损坏如何恢复

现象

客户端或 CAD 插件启动时提示”配置文件读取失败”、”配置数据异常”，或某些功能因配置错误无法正常使用。

可能原因

解决方案

1. 客户端配置恢复：
   • 关闭客户端。
   • 打开 %AppData%\FsLt\UserProfiles\ 目录。
   • 将 UserProfiles 文件夹重命名为 UserProfiles_damaged。
   • 重新启动客户端，系统将自动创建默认配置。
2. CAD 插件配置恢复：
   • 关闭 CAD。
   • 打开 %AppData%\FsLt\Configs\ 目录。
   • 删除异常的配置 JSON 文件。
   • 重新启动 CAD，插件将使用默认配置。
3. 排布配置方案恢复：
   • 排布配置方案保存在 DWG 文件同级的 .cfg\Configs\ 目录下。
   • 如果某个排布配置方案损坏，删除对应的 .configs.json 文件。
   • 在 CAD 中重新打开排布窗口，新建配置方案。
4. 从备份恢复：
   • 如果之前有备份用户数据目录，可以从备份中恢复配置文件。
   • 建议定期备份 %AppData%\FsLt\ 整个目录。

Q41: 公共库文件丢失

现象

使用板材库浏览器、节点库浏览器或收边库浏览器时，提示”库文件不存在”或库列表为空。

可能原因

解决方案

1. 检查库文件目录：
   • 打开安装目录下的 Resources\StandardLibraries\ 文件夹。
   • 确认库文件（如板材库、节点库、收边库的 DWG 模板文件）是否存在。
2. 重新安装：
   • 如果库文件缺失，从官方渠道获取安装包，执行升级安装（会自动覆盖并补全文件）。
3. 检查模板目录：
   • 确认安装目录下的 Resources\Templates\ 文件夹中包含必要的模板文件（如 FsLtTemplate.dwt、ShouBian_DingYi_Template.dwg 等）。

Q42: 图纸文件损坏

现象

打开 DWG 图纸文件时，CAD 提示”图形文件无效”或”文件已损坏”，无法正常打开。

可能原因

解决方案

1. 使用 RECOVER 命令修复：
   • 打开 CAD，在命令行输入 RECOVER 并回车。
   • 在文件选择对话框中选择损坏的 DWG 文件。
   • CAD 将尝试自动修复文件中的错误并打开。
2. 使用 AUDIT 命令检查：
   • 如果文件能够打开但行为异常，输入 AUDIT 命令。
   • 当提示”是否修复检测到的错误”时，选择”是”。
3. 从备份恢复：
   • 检查 LightningCAD 的自动备份文件（通常保存在 DWG 同级目录或 %AppData%\FsLt\ 下）。
   • 检查 CAD 自身的自动保存文件（.sv$ 文件），通常位于：

     %AppData%\Autodesk\AutoCAD 2019\R23.0\chs\Support\
     

     或

     %AppData%\ZWSOFT\ZWCAD\2022\chs\Support\
     

   • 将 .sv$ 文件扩展名改为 .dwg 后尝试打开。
4. 从 .bak 文件恢复：
   • CAD 在每次保存时会生成 .bak 备份文件（与 DWG 同目录）。
   • 将 .bak 文件扩展名改为 .dwg 后尝试打开。

Q43: 导出 Excel 文件乱码

现象

从 LightningCAD 导出统计表或 BOM 表到 Excel 文件后，打开文件发现中文内容显示为乱码。

可能原因

解决方案

1. 使用 Excel 的”数据”导入功能：
   • 不要直接双击打开导出的 CSV 文件。
   • 打开 Excel，选择”数据 → 从文本/CSV”导入。
   • 在导入向导中，将文件编码设置为”UTF-8”（代码页 65001）。
2. 检查导出格式：
   • 如果 LightningCAD 提供了 .xlsx 格式导出选项，优先使用 .xlsx 格式（原生支持 Unicode）。
3. 添加 BOM 标记：
   • 如果导出的是 CSV 文件，使用记事本打开，选择”另存为”，编码选择”UTF-8 BOM”后保存。
   • 重新用 Excel 打开即可正常显示中文。

11.9 联系技术支持

如果按照本章各问题的解决方案仍无法解决您遇到的问题，请通过以下渠道联系 LightningCAD 技术支持团队。

11.9.1 反馈渠道

11.9.2 日志文件获取方法

提交问题时，请尽量附上相关的日志文件，这将极大提高问题定位效率。

日志文件位置：

获取步骤：

1. 按 Win + R，输入 %AppData%\FsLt\Logs 并回车。
2. 在打开的文件夹中，找到与问题发生时间对应的日志文件。
3. 将相关日志文件打包压缩后提交给技术支持。

开启调试模式获取更详细日志：

如果常规日志信息不足以定位问题，可以在客户端”设置”中开启”调试模式”：

1. 打开 LightningCAD 客户端。
2. 进入”⚙ 设置”标签页。
3. 在”基础设置”区域，开启”启用调试模式”开关。
4. 重现问题操作。
5. 关闭调试模式，将生成的日志文件提交给技术支持。

注意：调试模式会输出大量详细信息，建议仅在排查问题时临时开启，问题解决后及时关闭。

11.9.3 问题报告模板

提交问题时，请参照以下模板提供信息，以便技术支持团队快速定位问题：

【问题标题】：简要描述问题现象
【产品版本】：LightningCAD 客户端版本号（如 v1.2.3）
【CAD 平台】：AutoCAD 2019 / AutoCAD 2020 / 中望CAD 2022 / 中望CAD 2025
【操作系统】：Windows 10 / Windows 11，64位
【问题描述】：
1. 问题发生的具体操作步骤
2. 预期结果是什么
3. 实际结果是什么
【错误提示】：如有错误弹窗，请截图或记录完整的错误信息
【日志文件】：已附上 %AppData%\FsLt\Logs\ 目录下的相关日志文件
【截图/录屏】：如有，请附上问题现象的截图或录屏
【复现频率】：必现 / 偶现（大约 X 次中出现 Y 次）
【其他信息】：是否安装了其他 CAD 插件、最近是否更新过系统等

11.9.4 远程协助方式

如果问题无法通过文字描述和日志分析解决，技术支持团队可能会请求远程协助：

运维工具使用：

1. 打开 LightningCAD 客户端，进入”⚙ 设置”标签页。
2. 滚动到底部的”高级”区域，点击“运维管理”按钮。
3. 系统将启动独立的 FsOmTools.exe 运维工具。
4. 运维工具可检测硬件配置、环境状态、崩溃日志等信息，方便一键导出并提交。

11.10 错误代码速查

本节汇总 LightningCAD 中可能遇到的常见错误代码及其含义和解决方案。

11.10.1 HTTP API 错误代码

LightningCAD 客户端与服务器通信时，可能返回以下状态码：

11.10.2 CAD 插件加载错误

CAD 启动时加载插件可能出现的错误信息：

11.10.3 内部错误代码（XRecord 操作）

LightningCAD 在操作 CAD 图纸内部数据（XRecord）时可能遇到的错误：

11.10.4 解决方案速查表

以下是按问题现象快速定位解决方案的速查表：

温馨提示：LightningCAD 团队持续优化产品稳定性和兼容性。如果您遇到了本章未涵盖的问题，请通过 11.9 节中的反馈渠道告知我们，我们将在后续版本中持续改进。感谢您的支持与信任！