# V1.2.4 更新日志

- **更新日期**: 2026年06月17日
- **版本号**: 1.2.4

##  新增功能

### 1. 数据修正系数支持正负值分组配置
- **新增正负值双组修正系数**：每个距离配置下，分别维护“正值配置”和“负值配置”两套 `xK/xB/yK/yB`
- **按原始值符号自动应用**：当原始采集值大于等于 `0` 时使用正值配置，小于 `0` 时使用负值配置
- **X/Y 独立判断**：`xReal` 和 `yReal` 分别按各自原始值符号选择对应修正系数，不共享判断结果
- **保持历史冻结语义**：修正系数变更后仅影响后续新采集数据，已进入历史链路的数据保持采集当时的修正结果

### 2. 修正系数配置界面升级
- **卡片内新增正负值配置区**：每张距离配置卡片内新增“正值配置”和“负值配置”两个分组
- **支持 8 项参数编辑**：每个距离可分别编辑正值组和负值组的 `xK/xB/yK/yB`
- **保留多距离管理能力**：继续支持距离配置的新增、编辑、删除和当前应用项切换
- **保留控制台调试输出**：修正计算时继续输出原始值、命中的正负组、K、B 和修正后值，便于排查数据口径

##  技术细节

### 本地存储结构
```json
{
  "profiles": [
    {
      "distance": 10,
      "positive": { "xK": 1, "xB": 0, "yK": 1, "yB": 0 },
      "negative": { "xK": 1, "xB": 0, "yK": 1, "yB": 0 }
    }
  ],
  "activeDistance": 10
}
```

### 数据处理策略
- `0` 归入正值配置
- 正负值判断基于传感器原始值，而不是修正后的结果
- 空值、缺失值或不可转数字的原始值不参与修正计算，保持“无数据”语义
- 页面曲线、实时数据显示、报警判断、实时 CSV、报警 CSV 继续共享冻结后的 `correctedX/correctedY`

##  影响范围
- 系统设置中的数据修正系数配置区域
- 多距离修正系数本地持久化结构
- 挠度采集页 X/Y 曲线与右侧实时数据
- 报警判断逻辑
- 实时数据 CSV 导出
- 报警数据 CSV 导出

##  依赖更新
- 无依赖包更新

##  注意事项
1. 本版本不兼容 V1.2.3 的单组修正系数本地结构，读取到旧结构或异常结构时会重建为新的默认 `10 米` 正负值双组配置。
2. 距离仍仅作为上位机修正系数配置的管理维度，不会根据设备状态或测点距离自动切换。
3. 当前应用项切换后，仅影响后续新采集数据；历史数据仍保持采集当时的修正结果。
4. 设备侧“测点设置”中的“计算系数”仍为独立参数，与本地正负值数据修正系数不互相替代。

---

**完整更新内容请查看项目 Git 提交记录**