更新：1、将参数配置信息对象改为全局可访问，并避免通过函数参数传入；

Signed-off-by: waiwaylee <waiwaylee@foxmail.com>
2026-10-27 15:56:02 +08:00
parent 76b0b460a5
commit 7e4cb2922d
34 changed files with 202 additions and 271 deletions
@@ -5,7 +5,7 @@
 >
 > 版本号由 `parameters.h` 的 `MAJOR_VERSION` / `MINOR_VERSION` / `PATCH_VERSION`（当前 1.5.9）与 `VERSION_INFO`（`"GENERIC"`——机扫/相扫版本已合并为同一份 DLL，无体制后缀）拼装为 `VERSION_STRING`（`V1.5.9.GENERIC`），实例创建后可从 `Data_Process_Factory::GetB()` 返回对象的公开成员 `version_info`（`const char*`）读取。
 >
-> **工作参数来源（参数配置方式改造后）**：全部雷达工作参数由宿主调用 `parameters_reload(配置文件路径)` 从 **TOML 配置文件**加载到内部 `RDP_parameter`，不再由宿主下发 `struct RadarPara`、也不再由 `parameters.h` 编译期宏配置（见 10）。
+> **工作参数来源（参数配置方式改造后）**：全部雷达工作参数由宿主调用 `parameters_reload(配置文件路径)` 从 **TOML 配置文件**加载到 DLL 内的**全局对象 `rdp_parameter`**（`struct.h` 中 `extern` 声明、`data_process.cpp` 中定义并零初始化），不再由宿主下发 `struct RadarPara`、也不再由 `parameters.h` 编译期宏配置；各处理模块直接访问该全局对象（见 5.1、10）。

 ---

@@ -50,7 +50,7 @@
 | 坐标 | 直角坐标系 x/y 为水平面投影，z = 目标高度 + 雷达平台高度 |
 | 点迹类型 | point_type = 0 为 TWS，point_type = 1 为 TAS |
 | 跟踪模式 | Track_Mode = 0 为 TWS，Track_Mode = 1 为 TAS |
-| 参数来源 | TOML 配置文件（`config/config_tmp.toml` 为样例）→ 内部 `struct RDP_parameter`，宿主通过 `parameters_reload()` 加载；参数对照见 10 |
+| 参数来源 | TOML 配置文件（`config/config_tmp.toml` 为样例）→ DLL 内全局对象 `rdp_parameter`（`struct RDP_parameter`），宿主通过 `parameters_reload()` 加载；参数对照见 10 |
 | 判圈模式 | 由配置项 `[radar_params] scan_mode` 运行时选择：0 相扫（波位号 ≤ 上一帧判满圈）/ 1 机扫（波位号 == 0 判满圈）；机扫/相扫已合并为同一份构建，不再有编译期体制（见 4.2、7.2） |

 ---
@@ -121,9 +121,9 @@
 │   ├── rdp_log.h / .cpp                 # 日志输出模块：rdbuf() 重定向 std::cout、RDP_LOG 宏（开关宏在 parameters.h）
 │   ├── rdp_record.h / .cpp              # 数据记录调试模块：结构体→SQLite 表（内置 ormpp）、异步入队接口与宏（RDP_RECORD_POINTS 等 6 个）+ 遗留 RDP_RECORD/RDP_RECORD_BATCH、有界队列、异步写线程、批量事务、Stats 统计、失败降级/熔断（开关由 CMake 选项 RDP_DATA_RECORD 控制；实现以 C++20 独立编译）
 │   ├── rdp_record_entity.h              # 记录实体（=数据表）定义区：6 张在用表（输入点迹、TWS/TAS 凝聚后点迹、临时航迹、可靠航迹、关联信息）+ RDP_RECORD_DECLARE 声明宏；新增需要记录的数据在此加结构体
-│   ├── rdp_parameter_loader.h / .cpp    # TOML 参数加载器（内部模块，不属于宿主接口）：rdp_parameter_load() 严格校验 11 个配置段并写入 RDP_parameter，失败返回 -1 且不改变入参
-│   ├── data_process.h / .cpp            # Data_Process 实现：接口分发、TWS/TAS 主流程、参数加载（parameters_reload）、清空/删除/转跟踪；含 point_id/frame_id/circle_id 自增计数（记录用）
-│   ├── struct.h                         # 内部结构体：PointRecv / Trust_Track / Temp_track / Asso_Info / Tracking_Target / RDP_parameter（工作参数，与 TOML 配置一一对应）
+│   ├── rdp_parameter_loader.h / .cpp    # TOML 参数加载器（内部模块，不属于宿主接口）：rdp_parameter_load() 严格校验 11 个配置段并写入全局对象 rdp_parameter，失败返回 -1 且不改变入参
+│   ├── data_process.h / .cpp            # Data_Process 实现：接口分发、TWS/TAS 主流程、参数加载（parameters_reload）；.cpp 中定义全局对象 rdp_parameter；含 point_id/frame_id/circle_id 自增计数（记录用）
+│   ├── struct.h                         # 内部结构体：PointRecv / Trust_Track / Temp_track / Asso_Info / Tracking_Target / RDP_parameter（工作参数，与 TOML 配置一一对应）+ 全局工作参数对象 rdp_parameter 的 extern 声明
 │   ├── parameters.h                     # 编译期常量：PI、版本宏、RDP_LOG_*、RDP_RECORD_*、MAX_TRACK_NUM、RDP_TAS_QUEUE_CAPACITY、Round（不再含雷达工作参数宏；机扫/相扫合并后构建不再定义体制宏，版本串为 V1.5.9.GENERIC）
 │   ├── dot_coh.h / .cpp                 # TWS 点迹凝聚（含两帧滑窗缓冲）
 │   ├── dot_coh_tas.h / .cpp             # TAS 点迹凝聚
@@ -236,7 +236,7 @@ VS Code 任务（`.vscode/tasks.json`）只保留以下 5 个（原有任务已

 产物为 **x64（AMD64）** 目标。宿主程序必须是 64 位、且使用与本 DLL 同一版本头文件重新编译——MSVC 2013 → MSVC 2022 同时伴随 x86 → x64 的 ABI 变化，旧的 32 位宿主无法加载该 DLL。

-> **本次参数配置改造后的体积/导出变化**：Release REC_OFF 的 `data_process_class_dll.dll` 为 331,776 字节（约 324 KB），较改造前约 178 KB 增大——原因是纯头文件的 toml++ 解析器随 `rdp_parameter_loader.cpp` 编入 DLL。机扫/相扫合并后的四种构建（0 warning、0 error）：Release REC_OFF 331,776 字节、Release REC_ON 1,653,248 字节、Debug REC_OFF 1,718,272 字节、Debug REC_ON 4,694,528 字节。导出表（Release REC_OFF 共 31 个导出）新增 `parameters_reload`（`?parameters_reload@Data_process_class_dll@@UEAAHPEBD@Z`），`track_process_parameters_initial`/`track_process_parameters_modify` 与 `RadarPara` 相关符号已不存在，`Data_Process_Factory::GetB`/`Destroy` 等其余接口不变。
+> **本次参数配置改造后的体积/导出变化**：Release REC_OFF 的 `data_process_class_dll.dll` 为 331,776 字节（约 324 KB），较改造前约 178 KB 增大——原因是纯头文件的 toml++ 解析器随 `rdp_parameter_loader.cpp` 编入 DLL。机扫/相扫合并后的四种构建（0 warning、0 error）：Release REC_OFF 331,776 字节、Release REC_ON 1,653,248 字节、Debug REC_OFF 1,718,272 字节、Debug REC_ON 4,694,528 字节。导出表（Release REC_OFF 共 31 个导出）新增 `parameters_reload`（`?parameters_reload@Data_process_class_dll@@UEAAHPEBD@Z`），`track_process_parameters_initial`/`track_process_parameters_modify` 与 `RadarPara` 相关符号已不存在，`Data_Process_Factory::GetB`/`Destroy` 等其余接口不变。**全局工作参数对象改造后**体积略降：Release REC_OFF 331,264、Release REC_ON 1,652,736、Debug REC_OFF 1,715,200、Debug REC_ON 4,691,968 字节；导出表仍 31 项且全局对象 `rdp_parameter` 不导出（见 12）。

 仓库 `build/<Debug|Release>/<REC_*>/bin/` 内原附带 **rdp_playback.exe**（回放测试工具，依赖 Qt5Core.dll、sqlite3.dll，配置样例 RadarConfigParam.ini，可回放 .db 记录的点迹数据验证 DLL 输出），该工具不在本仓库源码范围内、当前构建目录中亦不存在，需自行放置；由于 DLL 已改为 x64，配套的 rdp_playback.exe 必须是 **x64 版本**（同时其自带 Qt5Core.dll / sqlite3.dll 也需为 x64），32 位版本无法加载新版 DLL。

@@ -296,7 +296,6 @@ classDiagram
        -point_recv / point_recv_tas : vector PointRecv
        -trust_track : vector Trust_Track
        -temp_track : vector Temp_track
-        -rdp_parameter : RDP_parameter
        -dot_coh / dot_coh_tas / track_asso / track_asso_tas
        -track_init / track_die / track_die_tas / tas_ctrl
    }
@@ -334,12 +333,14 @@ classDiagram
    kalman ..> coor_trans
 ```

+> **全局工作参数对象（全局工作参数对象改造后）**：工作参数不再是 `Data_Process` 的成员、也不再通过函数形参逐层传递，而是 `struct.h` 中 `extern RDP_parameter rdp_parameter;` 声明的**全局对象**，由 `data_process.cpp` 定义并零初始化（当前 L14）、`Data_Process::parameters_reload()` 在配置文件完整校验通过后整体赋值（失败不写入、保持原值）。所有处理模块（`dot_coh`/`kalman`/`track_asso`/`track_init`/`track_die`/`tas_ctrl`/`track_index_mangement` 等）直接以 `rdp_parameter.<field>` 访问该对象，函数签名不再包含该参数。全局对象为 DLL 内**单实例可变状态**，处理期间只读；`parameters_reload()` 与处理调用之间**非线程安全**，宿主应按单线程接口使用、配置重载与处理互斥（与 BUG-03 一致，见 11.2）。
+
 ### 5.2 模块职责

 | 类 / 文件 | 职责 |
 |---|---|
-| Data_Process（data_process.cpp） | 对外接口实现与流程编排：输入缓存、按 model 分发 TWS/TAS 流水线、参数加载（`parameters_reload`：TOML → `rdp_parameter`）、航迹清空/删除、手动转/停 TAS、手动标记/取消重点目标（primary_target_add/cancel）、波束控制转发 |
-| rdp_parameter_loader（rdp_parameter_loader.h/.cpp） | 参数加载器（内部模块）：解析 TOML 并严格校验 11 个配置段/键集合/类型/取值范围/屏蔽区数组长度，全部通过后一次性写入 `RDP_parameter`；失败返回 -1 并给出首条原因、不改变入参（见 10.1） |
+| Data_Process（data_process.cpp） | 对外接口实现与流程编排：输入缓存、按 model 分发 TWS/TAS 流水线、参数加载（`parameters_reload`：TOML → 全局对象 `rdp_parameter`，定义在 data_process.cpp）、航迹清空/删除、手动转/停 TAS、手动标记/取消重点目标（primary_target_add/cancel）、波束控制转发 |
+| rdp_parameter_loader（rdp_parameter_loader.h/.cpp） | 参数加载器（内部模块）：解析 TOML 并严格校验 11 个配置段/键集合/类型/取值范围/屏蔽区数组长度，全部通过后一次性写入**全局对象 `rdp_parameter`**；失败返回 -1 并给出首条原因、不改变入参（见 10.1） |
 | Dot_Coh | TWS 点迹凝聚：两帧滑窗合并凝聚（dot_coh_process_buff） |
 | Dot_Coh_TAS | TAS 点迹凝聚（单帧，距离/方位/速度三维门限） |
 | Track_Asso | TWS 点航关联 + IMM 滤波：模型交互 → 门限筛选（NN）→ 各模型 EKF → 概率更新 → 模型输出（只输出 `Track_Update_Flag==1` 的航迹）；未关联航迹按上限外推；高度平滑；按滤波速度矢量写 `Flag_Direction`；ΔT≤0（乱序/重复时间戳）的候选取出后不更新滤波、不刷新航迹，仅消费该点迹 |
@@ -367,13 +368,13 @@ classDiagram
 | TrackingBeam | TAS 跟踪波束指令 | open_flag、type、Range、Azi、Elev、TAS_track_index |
 | Target_direct_tracking | 引导跟踪信息 | 批号、距离/方位/俯仰、开关（接口未启用） |

-> 工作参数结构体 `RDP_parameter` 定义在内部头 `struct.h`，**不在公开头中导出**：宿主不再构造/下发参数结构体，改为通过 `parameters_reload(配置文件路径)` 把 TOML 配置加载进 DLL（参数含义见 10）。
+> 工作参数结构体 `RDP_parameter` 及全局对象 `rdp_parameter` 定义在内部头 `struct.h`（对象本身定义于 `data_process.cpp`），**不在公开头中导出**：宿主不再构造/下发参数结构体，改为通过 `parameters_reload(配置文件路径)` 把 TOML 配置加载进 DLL（参数含义见 10）。

 ### 6.2 内部结构体（struct.h）

 | 结构体 | 用途 | 关键字段 |
 |---|---|---|
-| RDP_parameter | 工作参数（唯一来源） | 按注释分组：雷达工作参数（`radar_work_mode`/`freq_0_GHz`/`radar_height`/`radar_system_delay`/`data_rate_tws`/`data_rate_tas`/`data_rate_track_only`）、点迹凝聚参数、航迹关联参数（`sigma_*`/`associate_threshold`/`extrapolate_max(_tas)`/`height_smooth_win`）、航迹起始参数（`track_init_*`）、航迹消亡参数（`track_die_*`）、航迹质量参数（`track_quality_*`）、航迹批号（`track_index_max`）、波束调度（`default_track_beam_type`/`tas_track_num_max`）、singer 模型参数（`model_*_Q_*`）、两个屏蔽区（各 30 组距离/方位区间）；与 TOML 配置段/键一一对应（见 10.2） |
+| RDP_parameter | 工作参数（唯一来源，**全局对象 `rdp_parameter`**） | 按注释分组：雷达工作参数（`radar_work_mode`/`scan_mode`/`freq_0_GHz`/`radar_height`/`radar_system_delay`/`data_rate_tws`/`data_rate_tas`/`data_rate_track_only`）、点迹凝聚参数、航迹关联参数（`sigma_*`/`associate_threshold`/`extrapolate_max(_tas)`/`height_smooth_win`）、航迹起始参数（`track_init_*`）、航迹消亡参数（`track_die_*`）、航迹质量参数（`track_quality_*`）、航迹批号（`track_index_max`）、波束调度（`default_track_beam_type`/`tas_track_num_max`）、singer 模型参数（`model_*_Q_*`）、两个屏蔽区（各 30 组距离/方位区间）；与 TOML 配置段/键一一对应（见 10.2）。`struct.h` 中另有 `extern RDP_parameter rdp_parameter;` 全局对象声明（定义在 data_process.cpp，模块直接访问） |
 | PointRecv | 内部点迹 | 距离/方位(弧度)/速度/幅度/高度/SNR/RCS/CPI/GNSS 时间、点迹号 `point_id` / 帧号 `frame_id` / 圈号 `circle_id`（记录链路用，c3c7e66 新增）、使用标志、波位/PRF/频点、跟踪模式、点迹区号、归一化幅度 `amp_asv_point` / 速度维 FFT 点数 `prn_fftn_point`、十字星数据 |
 | Trust_Track | 可靠航迹（IMM 全状态） | 航迹号、标识字段 `track_id` / `point_id` / `circle_id`（b227ae1 新增，起批时取临时航迹末点的 `temp_track_id`/`point_id`/`circle_id`，关联成功时刷新为被关联点迹的 ID）、高度、极坐标量快照 `Range` / `Azimuth` / `Elevation` / `Velocity`（b227ae1 新增，仅在本圈有输出时回填）、**航迹质量相关状态（V1.5.8 新增）`Quality`（0~1）/ `Point_sum`（累计点数，含外推）/ `Valid_point_sum`（累计实点关联次数）/ `Unupdated_time`（连续未关联实点的累计毫秒）**、航迹时间 `T_track`（CPI 时间）/ `GNSS_time`、更新标志 Track_Update_Flag（**输出门控**：仅置 1 的航迹当圈被输出，输出后清零）、外推轮数 Extrapolate_round、实虚点标志、手动删除/手动 TAS/重点目标（primary_target_flag，决定消亡走质量还是 10 圈轮数）标志、关联点数、高度平滑缓冲 Hight_smooth、关联点信息、归一化幅度 `amp_asv_point` / 速度维 FFT 点数 `prn_fftn_point`、融合状态 X[6]/P[6][6]、三个子模型 X1/X2/X3、P1/P2/P3、模型概率 u[3] |
 | Temp_track | 临时航迹（航迹起始阶段） | 4 维状态 X[4]/P[4][4]、极坐标点信息（`r`/`azi`/`vr`/`height`/`SNR`/`RCS`/`amplitude`）、**航迹质量 `quality`（0~1，V1.5.8 新增，起批时带给 Trust_Track）**、时间戳 `CPI_time` / `GNSS_time`、`buff_round`（已缓存圈数）、标识字段 `temp_track_id` / `point_id` / `circle_id`、区号 `temp_track_section_idx`、俯仰波位号 `pitch_num`、关联标志（c3c7e66 起字段统一更名，如原 `snr`/`Amp`/`T`） |
@@ -396,7 +397,7 @@ classDiagram
 | Data_Process_Factory::GetB() | 实例指针 | 获取单例（首次调用时创建，并写入 `version_info`） |
 | Data_Process_Factory::Destroy() | — | 销毁实例并将指针置空 |
 | version_info（基类公开成员） | `const char*` | DLL 版本字符串，由 `GetB()` 赋值为 `VERSION_STRING`（`V1.5.9.GENERIC`——机扫/相扫已合并，无体制后缀）；只读使用，不要释放（b227ae1） |
-| parameters_reload(const char* path) | 0 成功 / -1 失败 | **加载全部工作参数**：解析 TOML 配置文件并校验，成功后整体替换内部 `RDP_parameter`；失败时当前参数保持不变并打印原因。建议 `GetB()` 后立即调用一次，重连/换配置时再次调用即可热重载（见 10.1） |
+| parameters_reload(const char* path) | 0 成功 / -1 失败 | **加载全部工作参数**：解析 TOML 配置文件并校验，成功后整体写入**全局对象 `rdp_parameter`**（零初始化，失败时保持原值）并打印原因。建议 `GetB()` 后立即调用一次，重连/换配置时再次调用即可热重载；重载应与处理调用互斥（与 BUG-03 线程模型一致，见 10.1） |
 | data_preprocess(DataRev[150]) | 0/1/2/3 | 输入一帧点迹并缓存，返回处理模式（见下表） |
 | track_process(Track[][10], &num, dieIdx[], &dieNum, model) | 1 | 按 data_preprocess 的返回值执行 TWS/TAS 处理 |
 | Beam_Ctrl(TrackingBeam*, Track[][10], &num) | — | TAS 波束控制（内部清零并重填航迹输出计数） |
@@ -980,9 +981,12 @@ $$
 ```text
 宿主：GetB() → parameters_reload("config/config_tmp.toml") → data_preprocess / track_process / Beam_Ctrl ...
      （重连或切换配置时再次 parameters_reload 即可热重载；成功返回 0，失败返回 -1）
-DLL ：rdp_parameter_load() 解析 TOML → 严格校验 → 全部通过后一次性赋值给 Data_Process::rdp_parameter
+DLL ：rdp_parameter_load() 解析 TOML → 严格校验 → 全部通过后一次性赋值给全局对象 rdp_parameter
+      （struct.h 中 extern 声明、data_process.cpp 中定义并零初始化）
 ```

+> **全局对象与线程模型**：`rdp_parameter` 是 DLL 内的**单实例全局对象**（静态存储期零初始化，定义于 `data_process.cpp:14`），所有处理模块直接读取、处理期间只读；`parameters_reload()` 会整体覆盖该对象，因此**重载配置必须与处理调用互斥**（宿主按单线程接口使用，见 11.2 的 BUG-03 / BUG-13）。
+
 配置段与 `RDP_parameter` 的注释分组一一对应，**键名 = 结构体成员名**：

 | 配置段 | 内容 |
@@ -1175,7 +1179,7 @@ DLL ：rdp_parameter_load() 解析 TOML → 严格校验 → 全部通过后一
 - **BUG-03**：工厂 GetB/Destroy 非线程安全，接口线程模型未定义（宿主应单线程调用）。
 - **BUG-07**：禁止区个数在实现内部仍未二次校验，配置过大仍可能越界读；但**配置入口已加防护**——加载器强制 `track_init_prohibite_area_num`/`tas_prohibite_area_num` 在 0~30 且 4 个数组长度等于 `*_num`，非法配置在 `parameters_reload` 阶段即返回 -1、不会进入处理流程（见 10.1）。
 - **BUG-08**：消亡航迹输出数组容量未传入，仅约定 ≤500。
- **BUG-13（参数初始化，已被本次改造改变）**：`Data_Process::rdp_parameter{}` 为零初始化，未加载配置时 `data_rate_tws`/`sigma_*` 等均为 0（非法）。宿主必须在**首次 `data_preprocess` 之前**调用 `parameters_reload()` 且确认返回 0；加载失败时保留的是上一次成功参数（首次失败则为全 0），DLL 不会自动纠正。
+- **BUG-13（参数初始化，已被参数配置方式改造改变）**：全局对象 `rdp_parameter` 为静态存储期零初始化对象（定义 `data_process.cpp:14`，未加载配置时 `data_rate_tws`/`sigma_*` 等均为 0，属非法值）。宿主必须在**首次 `data_preprocess` 之前**调用 `parameters_reload()` 且确认返回 0；加载失败时保留的是上一次成功参数（首次失败则为全 0），DLL 不会自动纠正。该全局对象是 DLL 内单实例可变状态：`parameters_reload()` 与处理调用之间**非线程安全**，配置重载须与处理互斥（与 BUG-03 的单线程接口约定一致）。
 - **BUG-18**：卡尔曼两点/三点初始化对零/负时间差无保护（起批时间戳必须严格递增）。
 - **BUG-20**：门限对马氏距离平方再次平方（e0bf227 把 `associate_threshold` 调为 4 后等效 d < 4），有意保留。
 - **BUG-25**：TWS 关联/输出未排除 Track_Mode==1 的 TAS 航迹（原 `manual_tracking_flag==0` 过滤代码块已于 fc49707 删除，未恢复过滤）。
@@ -1217,14 +1221,15 @@ DLL ：rdp_parameter_load() 解析 TOML → 严格校验 → 全部通过后一

 ## 12. 版本历史

-当前代码版本：**V1.5.9**（`parameters.h` 的 `PATCH_VERSION` = 9、`VERSION_INFO` = `"GENERIC"`，版本串 `V1.5.9.GENERIC`——机扫/相扫已合并为同一份构建，无体制后缀；对应提交 019af7a，2026-10-27）。版本号自 1.5.6 起可运行时读取（`version_info`，见 7.1）。中间状态 b4aed8a 曾把版本号置为 7，但未单独发布/记录。**1.5.8 之后又有若干未发版的代码改动**（构建脚本重构、记录性能优化、TAS 消亡圈数与高度平滑调整、质量入库、参数配置方式改造、机扫/相扫版本合并与构建脚本适配），已记入 CHANGELOG 的 `[Unreleased]`，下表前列为其提交/工作区状态。
+当前代码版本：**V1.5.9**（`parameters.h` 的 `PATCH_VERSION` = 9、`VERSION_INFO` = `"GENERIC"`，版本串 `V1.5.9.GENERIC`——机扫/相扫已合并为同一份构建，无体制后缀；对应提交 019af7a，2026-10-27）。版本号自 1.5.6 起可运行时读取（`version_info`，见 7.1）。中间状态 b4aed8a 曾把版本号置为 7，但未单独发布/记录。**1.5.8 之后又有若干未发版的代码改动**（构建脚本重构、记录性能优化、TAS 消亡圈数与高度平滑调整、质量入库、参数配置方式改造、机扫/相扫版本合并与构建脚本适配、**全局工作参数对象改造**），已记入 CHANGELOG 的 `[Unreleased]`，下表前列为其提交/工作区状态。

 近期提交（git log --oneline，新→旧；仅列代码改动，纯文档提交略）：

 | 提交 | 内容 |
 |---|---|
+| 工作区（全局工作参数对象改造，未提交） | **工作参数改为全局对象**：`struct.h` 在 `struct RDP_parameter` 之后新增 `extern RDP_parameter rdp_parameter;`（声明位于 `struct.h:285`），`data_process.cpp` 定义并零初始化（L14）；`Data_Process` 删除 `RDP_parameter rdp_parameter` 成员（`data_process.h` 保留注释说明）；`parameters_reload()` 改为直接调用 `rdp_parameter_load(path, rdp_parameter, &error)`（loader 仅在校验全部通过后写入，失败不写入，「失败保持当前参数」语义不变）；删除处理模块（kalman 11 个方法、dot_coh/dot_coh_tas、track_asso 系列、track_init 系列、track_die 系列、track_index_mangement、tas_ctrl，共 12 个模块的 24 个 .h/.cpp 文件）全部 `const RDP_parameter& rdp_parameter` 形参与调用实参，函数体内 `rdp_parameter.<field>` 一处未改、现直接解析全局对象；接口签名/公式/阈值/数值行为不变；全局对象为 DLL 内单实例、非线程安全（配置重载须与处理互斥，见 BUG-03/BUG-13）。验证（Lead 实测，2026-10-27）：4 配置（Release/Debug × REC_OFF/REC_ON）重建成功、0 warning 0 error；DLL 体积 Release REC_OFF 331,264 / Release REC_ON 1,652,736 / Debug REC_OFF 1,715,200 / Debug REC_ON 4,691,968 字节；导出表仍 31 项（`parameters_reload` 在列、全局 `rdp_parameter` 不导出）；加载器单测 233 项断言、公开接口运行期测试 4 配置 × 38 项断言全部通过；静态检查处理模块已无 `const RDP_parameter&` 形参（仅 loader 内部 `validate_parameter` 保留）。详见 CHANGELOG `[Unreleased]` |
 | 工作区（构建脚本适配机扫/相扫合并，未提交） | 构建不再区分 `PHASE_SCANNING` / `MECHANICAL_SCANNING`：`CMakeLists.txt` 删除 `RADAR_SCAN_MODE` 缓存变量与体制编译宏；构建目录改为 `build/<Debug\|Release>/<REC_AUTO\|REC_OFF\|REC_ON>`（去掉 PS/MS 维度）；`config_paths.bat`/`configure.bat`/`build.bat`/`clean.bat` 参数改为 `<Debug\|Release> [AUTO\|ON\|OFF]`，新增 `build_config.bat`（单配置配置+构建，取代 `build_all.bat`），`clean_all.bat` 同时清理旧版 `build/X256_PS`、`build/X256_MS`；`tasks.json` 5 个任务改为「清理全部」+ 4 个「配置并构建(...)」；`settings.json`（buildDirectory 去掉 scanMode 维度）、`cmake-variants.yaml`（移除 scanMode 变体）、`c_cpp_properties.json`（合并为单个 X256 配置）、`launch.json` 同步。验证：5 个任务返回 0，4 种配置（Release/Debug × REC_OFF/REC_ON）0 warning 0 error，编译命令无体制宏，增量重建 0 编译步骤 |
-| 423c200 / 019af7a（参数配置方式改造 + 机扫/相扫版本合并） | **参数配置方式改造：TOML 配置文件 → `RDP_parameter`**。新增 `rdp_parameter_loader.h/.cpp`（严格校验 11 个配置段、标量键必填、类型/范围校验、未知段/键拒绝、屏蔽区数组长度等于 `*_num`，失败 -1 且不改变当前参数）与示例 `config/config_tmp.toml`；内置 toml++ v3.4.0 单头文件 `third_party/toml/toml.hpp`；公开头删除 `struct RadarPara` 与 `track_process_parameters_initial/modify`，新增 `virtual int parameters_reload(const char*)`（`Data_Process` 实现为加载成功后整体替换 `rdp_parameter`）；`data_process.h` 删除 `Work_Parameter`，各模块（kalman 11 个方法、dot_coh、dot_coh_tas、track_asso(_tas/_direct_tracking)、track_init(_direct_tracking)、track_die(_tas)、track_index_mangement、tas_ctrl）改为 `const RDP_parameter& rdp_parameter`，宏与旧字段按映射等价替换；**新增配置项 `scan_mode`（0 相扫 / 1 机扫）**，`data_process.cpp` 的 TWS 判圈由编译期 `#ifdef PHASE_SCANNING` 改为按 `scan_mode` 运行时选择（行为逐分支等价）；019af7a 进一步把机扫/相扫合并为**同一份代码与同一份构建**（版本号 1.5.9、`VERSION_INFO` 改为 `GENERIC`，`PHASE_SCANNING`/`MECHANICAL_SCANNING` 不再参与任何功能）；`parameters.h` 仅保留 PI、版本/日志/记录宏、`MAX_TRACK_NUM`、`RDP_TAS_QUEUE_CAPACITY`、`Round`（`UNCONF_TARGET` 已删除，起批处 `Target_Type` 直接写 0）；`track_index_mangement` 航迹号表改按 `track_index_max` 分配，TAS 队列容量用 `RDP_TAS_QUEUE_CAPACITY`、运行期上限用 `tas_track_num_max`，波束类型用 `default_track_beam_type`。验证（Lead 实测，2026-10-27）：合并前 8 配置、合并后 4 配置均 0 warning 0 error；Release REC_OFF DLL 331,776 字节、Debug REC_ON 4,694,528 字节、导出表 31 项（新增 `parameters_reload`，旧参数接口与 `RadarPara` 符号消失）；加载器单测 233 项断言、公开接口运行期测试（含判圈运行时切换）全部通过；`RDP_parameter` 成员 / 加载器键 / TOML 键均为 63 个，11 个配置段不变。详见 CHANGELOG `[Unreleased]` |
+| 423c200 / 019af7a（参数配置方式改造 + 机扫/相扫版本合并） | **参数配置方式改造：TOML 配置文件 → `RDP_parameter`**。新增 `rdp_parameter_loader.h/.cpp`（严格校验 11 个配置段、标量键必填、类型/范围校验、未知段/键拒绝、屏蔽区数组长度等于 `*_num`，失败 -1 且不改变当前参数）与示例 `config/config_tmp.toml`；内置 toml++ v3.4.0 单头文件 `third_party/toml/toml.hpp`；公开头删除 `struct RadarPara` 与 `track_process_parameters_initial/modify`，新增 `virtual int parameters_reload(const char*)`（`Data_Process` 实现为加载成功后整体替换 `rdp_parameter`；**后于本工作区的「全局工作参数对象改造」改为写入全局对象**）；`data_process.h` 删除 `Work_Parameter`，各模块（kalman 11 个方法、dot_coh、dot_coh_tas、track_asso(_tas/_direct_tracking)、track_init(_direct_tracking)、track_die(_tas)、track_index_mangement、tas_ctrl）改为 `const RDP_parameter& rdp_parameter`（**后于本工作区的「全局工作参数对象改造」删除该形参、改为直接访问全局对象**），宏与旧字段按映射等价替换；**新增配置项 `scan_mode`（0 相扫 / 1 机扫）**，`data_process.cpp` 的 TWS 判圈由编译期 `#ifdef PHASE_SCANNING` 改为按 `scan_mode` 运行时选择（行为逐分支等价）；019af7a 进一步把机扫/相扫合并为**同一份代码与同一份构建**（版本号 1.5.9、`VERSION_INFO` 改为 `GENERIC`，`PHASE_SCANNING`/`MECHANICAL_SCANNING` 不再参与任何功能）；`parameters.h` 仅保留 PI、版本/日志/记录宏、`MAX_TRACK_NUM`、`RDP_TAS_QUEUE_CAPACITY`、`Round`（`UNCONF_TARGET` 已删除，起批处 `Target_Type` 直接写 0）；`track_index_mangement` 航迹号表改按 `track_index_max` 分配，TAS 队列容量用 `RDP_TAS_QUEUE_CAPACITY`、运行期上限用 `tas_track_num_max`，波束类型用 `default_track_beam_type`。验证（Lead 实测，2026-10-27）：合并前 8 配置、合并后 4 配置均 0 warning 0 error；Release REC_OFF DLL 331,776 字节、Debug REC_ON 4,694,528 字节、导出表 31 项（新增 `parameters_reload`，旧参数接口与 `RadarPara` 符号消失）；加载器单测 233 项断言、公开接口运行期测试（含判圈运行时切换）全部通过；`RDP_parameter` 成员 / 加载器键 / TOML 键均为 63 个，11 个配置段不变。详见 CHANGELOG `[Unreleased]` |
 | 1ffb287 | 增加航迹质量记录到数据库：`RdpRecTempTrack` 增 `quality`，`RdpRecTrustTrack` 增 `Quality`/`Unupdated_time`/`Point_sum`/`Valid_point_sum` 并同步注册 |
 | 6284f3f | 修改 TAS 模式高度平滑点数：`track_asso_tas.cpp` 分段偏移 `+2/+3/+4/+6` → `+6/+8/+10/+12`，相扫 `H_F_WIN_LEN` 3→6（相扫 TAS 窗口 12/14/16/18、机扫 9/11/13/15；TWS 相扫随之 8/9/10/12） |
 | 5d105d2 | 修改相扫模式下 TAS 航迹消亡圈数：`TRACK_DIE_ROUND_TAS` 10→20（机扫保持 96），相扫 TAS 实际连续 21 圈无实点才消亡 |