配置、主题与工作区

NexuTrace 的配置分成几类：工作区 INI、数据面板 JSON、3D 场景 JSON、软件设置和运行时状态。分开保存的好处是，一个设备的协议配置可以复用到不同窗口布局，也可以为不同固件版本保留不同数据表。

配置类型

配置	用途
.ini 工作区配置	保存连接参数、窗口布局、常用视图和部分界面状态。
config/cfg_data/*.json	保存协议帧、RX/TX 通道、GX 变量、公式和 Plot Channels。
config/cfg_model/*.json	保存 3D 模型路径、场景配置和节点绑定。
软件设置	主题、语言、时间戳、编码、高性能模式等。
授权/更新配置	授权状态、更新源和升级相关设置。

工作区 INI

工具栏提供“打开配置(.ini)”和“另存为(.ini)”。适合以下场景：

1. 为同一设备保存一套常用窗口布局。

2. 为不同测试项目保存不同视图组合。

3. 在多台电脑之间迁移常用连接参数。

4. 做演示前准备固定界面。

建议命名：

motor_lab_uart.ini
bms_canfd_field.ini
usb_hid_factory_test.ini

数据配置 JSON

数据面板配置放在 config/cfg_data。界面支持选择已有 JSON、新建空配置和另存为 JSON。

建议一个设备或一个协议版本保留一份 JSON：

motor_controller_v1_2.json
bms_canfd_500k_2m.json
bootloader_uart_nexuframe.json

不要在固件协议变更时直接覆盖旧配置。旧配置能帮助你确认问题来自固件变更、工具设置还是现场设备版本不一致。

3D 场景配置

3D 配置放在 config/cfg_model。如果目录里没有 JSON，界面会提示把 .json 放入该目录，也可以选择自定义路径。

建议：

1. 模型文件和场景 JSON 放在稳定目录。

2. 节点命名和设备含义一致。

3. 角度、位移和缩放单位写在配置文件名或项目说明里。

4. 先绑定一个通道验证方向，再扩展到完整模型。

外观设置

设置页包含主题和语言。

设置	说明
语言	支持 English 和简体中文，界面文案来自语言资源。
主题	深蓝、浅色、翠绿、紫罗兰、琥珀、玫红、樱花、樱花白、薰衣草、蜜桃。

长期测试建议选择对比度较高的主题；演示或截图可以选择更符合项目风格的主题。

数据设置

设置	用途
时间戳	在文本和记录中显示时间，适合分析延迟和事件顺序。
编码	影响文本显示和 ABC 发送。乱码时优先检查这里。

编码建议：

1. 新项目优先 UTF-8。

2. 中文老固件日志常见 GBK/GB18030。

3. 二进制协议不要依赖文本视图判断内容。

性能设置

高性能模式会关闭动态休眠，降低调度延迟，但 CPU 占用会增加。适合：

1. 200 us 级周期发送。

2. 高频 USB 收发。

3. 长时间高吞吐记录。

4. CAN/CAN FD 高负载观察。

普通日志、低频命令、协议配置和演示场景保持默认自适应模式即可。

视图管理

视图管理用于打开、关闭、切换常用视图：

视图	用途
文本视图	看日志、命令回显和可读协议。
表格视图	按行记录收发事件。
HEX 表格 / HEX 分析	按字节检查二进制数据。
CAN 表格	查看 CAN/CAN FD 报文和总线状态。
发送视图 / CAN 发送	构造普通数据和 CAN 报文。
数据管理	管理帧、通道、公式和波形绑定。
波形、仪表、LED、开关、数字显示、数值输入、文本/图像、3D	构建调试面板和演示界面。

绑定配置建议

绑定通道时，优先按业务含义命名通道，而不是按位置命名：

不推荐	推荐
RX_00、float_1	motor_rpm、bus_voltage、cell_temp_01
TX_01	target_current、enable_motor
GX_0	power_w、temp_alarm

好名字会让波形、仪表、公式和导出记录都更容易复盘。