疑难排查

排障时先分清三层：链路是否通，原始数据是否对，协议解析是否对。不要一开始就改协议配置；原始视图能看到稳定收发，才说明问题进入了解析或业务层。

常见问题

现象	可能原因	处理建议
程序名或图标仍显示旧名称	使用了旧发布包，或资源文件没有一起更新	从 GitHub 发布仓库 或 Gitee 镜像 重新获取完整发布包，确认运行的是 NexuTrace.exe，并保持资源目录完整。
下载后只有一个 exe	下载方式不完整，或只复制了主程序	重新下载完整发布包，确认 Resource/Image、VekLang、config 和 update.exe 等文件目录存在。
授权码无法激活	授权码、机器码、网络或订单信息不匹配	先确认网络和本机时间，再核对授权码、订单号和机器码；需要购买或补充授权时使用 淘宝授权码链接。
找不到串口或 USB 设备	设备未枚举、驱动未安装、VID/PID 不匹配	先在设备管理器确认枚举，再检查驱动、线缆、供电和 USB 模式。
能连接但没有数据	设备未发送、端口参数不一致、网络地址错误、CAN 总线未接好	先看原始表格和 Hex；串口核对波特率，网络核对 IP/端口，CAN 核对波特率和终端电阻。
文本乱码	接收编码不匹配，或数据本身是二进制	切换 UTF-8、GBK/GB18030 等编码；二进制协议请改看 Hex 或协议面板。
原始数据有，协议面板没有值	协议类型、帧头、命令号、校验、偏移或大小端不匹配	在 Raw Frame 和 Hex 里核对真实字节，再逐个检查协议设置。
通道值跳变或明显不合理	字段偏移错误、数据类型错误、单位未换算	先确认 offset/type，再用公式把原始值转换成工程值。
周期发送不稳定	周期过低、设备处理不过来、CPU 负载高	降低频率或减小载荷；高频 USB 场景开启高性能模式并关闭无关视图。
文件发送中断	设备拒收、链路断开、文件过大、包长不合适	先用小文件验证；再调整包长和包间延时，观察设备端 ACK 或日志。
CAN 表没有报文	CAN 模式、波特率、接线、终端电阻或设备模式错误	用 ListenOnly 旁听，确认 VCAN/Candle 模式正确，再检查 CANH/CANL、GND、终端电阻和速率。
CAN FD 数据长度不对	DLC 与实际载荷换算不一致，或 FD/BRS 配置不一致	检查发送帧的 FD、BRS、DLC 和数据段波特率；CAN 表的 Len 是换算后的载荷长度。
复位 CAN 链路无效	非 USB-CAN 场景，或设备 USB 侧已经异常	该功能只用于 USB-CAN。仍无响应时断开重连；必要时重新插拔设备。
切到 PCAN 模式后 NexuTrace 看不到设备	PCAN 兼容模式通常交给 PCAN 工具访问	使用厂商工具操作，或把设备切回 VCAN / GS_USB 后再用 NexuTrace。
波形不刷新	通道未加入 Plot Channels，或协议值没有更新	先看 RX Channel 实时值，再检查 Plot Channels 绑定和曲线显示开关。
控件写入没有效果	控件未绑定 TX/GX，TX 帧未发送，设备不接受该命令	检查绑定目标、TX 帧载荷、发送计数和设备端响应。
3D 模型不动	模型未加载、节点名不匹配、通道没有值或单位错误	先绑定一个简单角度通道做验证，再扩展到完整模型。
软件更新失败	发布包不完整、网络不可用、目录权限不足或安全软件拦截	检查更新源、发布包完整性、目录权限和杀毒软件隔离记录。

CAN 排障顺序

1. 确认设备处于 NexuTrace 支持的 VCAN 或 Candle/GS_USB 模式。

2. 选择正确的 Standard CAN、ISO CAN FD 或 NON-ISO CAN FD。

3. 核对仲裁波特率；CAN FD 还要核对数据波特率和 BRS。

4. 检查 CANH、CANL、GND、终端电阻和收发器供电。

5. 先用 ListenOnly 观察总线，再切回 Normal 发送。

6. 报文太多时增加过滤器，只保留目标 ID。

7. 设备短暂复位或模式切换后，先用“复位 CAN 链路”，再考虑完整重连。

协议排障顺序

1. 关闭协议解析，只看原始 Text、Table 或 Hex。

2. 找到一帧完整数据，确认帧头、长度、命令号、载荷和校验。

3. 打开对应协议，观察 Raw Frame 是否能识别。

4. 建一个最简单的 RX Channel，只解析一个字段。

5. 字段正确后再添加更多通道、公式、波形和控件。

6. 保存 JSON 配置，并在文件名里标明设备和协议版本。

术语速查

术语	含义
RX / TX	RX 是设备发给电脑的数据，TX 是电脑发给设备的数据。
GX	数据面板里的全局变量，常用于公式中间值或跨控件共享状态。
Payload	协议载荷。CAN 场景下通常指 CAN Data，不包含 CAN ID 和 DLC。
DLC	CAN 数据长度码。CAN FD 中 DLC 需要换算成实际载荷长度。
FD / BRS / RTR / EXT	CAN FD 帧、数据段加速、远程帧、扩展帧标志。
NexuFrame	NexuTrace 支持的一种二进制工程协议，按命令号和载荷字段解析。
数据配置	保存帧、通道、公式和波形绑定的 JSON 文件。

需要反馈问题时，尽量同时提供 NexuTrace 版本、发布包来源、设备固件版本、连接类型、关键参数、授权状态、导出的原始数据和对应的数据配置 JSON。这样别人才能复现你的现场。