init commit

StandardScene.Core/Docs/Charge/README.md

@@ -0,0 +1,987 @@
+# StandardScene - Charge 模块逻辑文档
+
+本文档用于梳理 `StandardScene/Charge/` 充电桩管理与充电业务的整体逻辑，重点包含：
+
+- 充电桩配置（数据模型与持久化）
+- 通信报文解析与 `ChargeStation` 状态落库
+- `StandardChargeMission` 的充电业务循环
+- 相关 WinForms 界面如何展示与交互
+
+---
+
+## 1. 目录/模块职责速览（Charge/ 内）
+
+### 数据与配置层
+- `ChargeStation.cs`：充电桩数据模型（`ChargeStation`）及相关枚举（`ChargeStationStatus`、`CommunicationStatus`、`ChargeCommandStatus` 等）
+- `ChargeStationDataService.cs`：`ChargeStation` 的持久化与查询/更新（JSON 文件存储）
+- `AlarmConfig.cs`：报警配置模型（`AlarmConfig`）
+- `AlarmConfigDataService.cs`：报警配置的持久化与查询/更新（JSON 文件存储）
+- `ChargeStrategyConfig.cs`：充电策略配置模型
+- `ChargeStrategyConfigService.cs`：充电策略配置的持久化（JSON 文件存储）
+
+### 运行时与通信层
+- `CommunicationMessageService.cs`：通信报文“记录 + 解析 + 更新 ChargeStation”的核心服务
+- `ChargeUdpService.cs`：UDP 监听入口，将 UDP 收到的数据转为 `CommunicationMessageService.AddReceiveMessage(...)`
+- `StandardChargeMission.cs`：主业务进程（初始化充电站实例、500ms 循环下发充电指令）
+
+### WinForms 界面层
+- `ChargeStationManagementForm.cs`：充电桩管理窗口（列表、增删改、跳转其它窗口）
+- `ChargeStrategyConfigForm.cs`：充电策略参数配置窗口
+- `CommunicationMonitorForm.cs`：通信报文监控窗口（订阅 `MessageAdded` 并刷新表格）
+- `AlarmConfigManagementForm.cs`：报警配置管理窗口（增删改、筛选与搜索）
+
+---
+
+## 2. 数据模型（ChargeStation / AlarmConfig / 策略）
+
+### 2.1 `ChargeStation`（`Charge/ChargeStation.cs`）
+
+`ChargeStation` 是所有界面展示与通信落库的核心对象。与本模块强相关的字段包括：
+
+- 身份与配置
+  - `StationId`：充电桩编号（用于唯一标识，UI 校验 1-99）
+  - `Name`、`Type`（充电桩类型：`FRLDTall` / `FRLDShort` / `MuXing`）
+  - `ChargeMethod`（地充/尾充/侧充）
+  - `IpAddress`、`Port`：通信地址
+  - `SetVoltage`、`SetElectricCurrent`：设定值
+  - `Enabled`：是否启用
+  - `GroupCarType`、`SiteId`：与调度系统站点配置绑定
+
+- 通信与状态（用于 UI 展示）
+  - `Status`（`ChargeStationStatus`）：`Idle` / `Charging` / `Fault` / `Battery`
+  - `CommStatus`（`CommunicationStatus`）：UI 中展示用的通讯状态（通常由 UI Ping 计算）
+  - `ChargeCommandStatus`（`ChargeCommandStatus`）：最近一次“启动/停止充电指令”的状态
+  - `MechanismStatus`：机构伸缩状态
+  - `HasAlarm`、`AlarmLevel`、`AlarmMessage`：报警相关
+
+- 实时数值
+  - `LastSendTime`、`LastReceiveTime`
+  - `RealTimeVoltage`、`RealTimeCurrent`
+  - `BatteryLevel`、`CurrentVehicle`
+
+### 2.2 枚举含义（`ChargeStation.cs`）
+
+主要枚举：
+
+- `ChargeStationStatus`：空闲/充电中/报警中/AGV电池已接入
+- `CommunicationStatus`：未知/正常/延迟/超时/断开/错误
+- `ChargeCommandStatus`：停止/启动
+- `MechanismStatus`：伸出/缩回/运动中
+- `AlarmLevel`：无/低/中/高/严重
+- `ChargeMethodType`：地充/尾充/侧充
+
+### 2.3 报警配置 `AlarmConfig`（`Charge/AlarmConfig.cs`）
+
+报警配置用于 UI 管理与展示（`AlarmConfigManagementForm` 管理）。字段包括：
+
+- `AlarmId`、`AlarmCode`、`AlarmContent`
+- `Level`（报警级别）、`Enabled`
+- `Remarks`
+
+### 2.4 策略配置 `ChargeStrategyConfig`（`Charge/ChargeStrategyConfig.cs`）
+
+策略配置包含 SOC 阈值、时间参数、以及开关项（例如 `AllowInterruptTask`、`UseLowerSocForCharge` 等），由 `ChargeStrategyConfigForm` 编辑、由 `ChargeStrategyConfigService` 持久化。
+
+---
+
+## 3. 持久化与服务层（DataService）
+
+### 3.1 充电桩数据持久化：`ChargeStationDataService`
+
+入口与关键能力（来自实现）：
+
+- 获取：`GetAllStations()`、`GetStationById(...)`、`GetStationByIp(ip,port)`
+- 增加：`AddStation(...)`
+- 更新：`UpdateStation(...)`（可选 `isSave`）、`UpdateStationStatus(...)`
+- 删除：`DeleteStation(...)`
+- 刷新：`Reload()`
+
+落库逻辑特点：
+
+- 通信解析后会调用 `ChargeStationDataService.UpdateStation(station, out errorMessage)`，最终把 `ChargeStation` 新状态写回 JSON。
+
+### 3.2 报警配置持久化：`AlarmConfigDataService`
+
+入口与关键能力：
+
+- 获取：`GetAllAlarmConfigs()`、`GetAlarmConfig(alarmId)`、`GetAlarmConfigByCode(...)`
+- 增加：`AddAlarmConfig(...)`
+- 更新：`UpdateAlarmConfig(...)`
+- 删除：`DeleteAlarmConfig(...)`
+- 刷新：`Reload()`（实现中一般会重新从文件加载）
+
+---
+
+## 4. 通信报文解析与落库：CommunicationMessageService
+
+`Charge/CommunicationMessageService.cs` 是本模块最核心的“桥梁”：
+
+1. 把发送/接收报文记录到内存队列（`LinkedList`）
+2. 根据报文原始 hex 字符串与协议类型 `type` 解析出结构化数据
+3. 更新对应的 `ChargeStation` 字段
+4. 调用 `ChargeStationDataService.UpdateStation(...)` 落库到 JSON，并触发 UI 展示更新
+
+### 4.1 报文记录与订阅
+
+- `MessageAdded` 事件：当新报文加入时触发
+- UI 通信监控窗体（`CommunicationMonitorForm`）订阅该事件，并在 UI 线程刷新表格
+
+### 4.2 发送报文路径（AddSendMessage -> 更新 ChargeCommandStatus 等）
+
+- 外部调用：`AddSendMessage(ipAddress, port, rawData, type, stationId?)`
+- 内部流程：
+  - `ParseSendRawData(rawData, type)` 解析
+  - `UpdateStationFromSendData(station, parsedData)` 更新：
+    - `LastSendTime = SendTime`
+    - 根据 `ChargeCommand`（启动/停止）更新 `ChargeCommandStatus`
+    - 更新 `BatteryLevel` 与 `CurrentVehicle`
+  - `ChargeStationDataService.UpdateStation(station, out errorMessage)` 落库
+
+### 4.3 接收报文路径（AddReceiveMessage -> 更新状态/机构/告警）
+
+- 外部调用：`AddReceiveMessage(ipAddress, port, rawData, type, stationId?)`
+- 内部流程：
+  - `ParseReceiveRawData(rawData, type)` 解析
+  - `UpdateStationFromReceiveData(station, parsedData)` 更新：
+    - `LastReceiveTime`
+    - `MechanismStatus`、`RealTimeVoltage`、`RealTimeCurrent`
+    - `Status`（`Idle/Charging/Fault/Battery`）
+    - `HasAlarm`、`AlarmLevel`、`AlarmMessage`
+  - `ChargeStationDataService.UpdateStation(...)` 落库
+
+### 4.4 协议类型 `type`
+
+解析分支中常见类型示例：
+
+- `FRLDShort`
+- `FRLDTall`
+
+不同类型会使用不同索引位置从报文字节数组中解析字段。
+
+---
+
+## 5. 通信接入入口
+
+### 5.1 UDP 接入：ChargeUdpService
+
+`Charge/ChargeUdpService.cs`：
+
+- 创建线程监听 UDP：`UdpClient(40001)`
+- 循环接收并转发：
+  - `CommunicationMessageService.AddReceiveMessage(remoteIp, 40001, hexString, "FRLDShort")`
+- 同时会通过 `SimpleProject.proj.Missions` 找到 `StandardChargeMission` 实例，并在 `chargeMission.ChargeStations` 中按 IP 找到对应站点
+- 对特定站点类型（例如 `PCBChargeStation`）进一步更新站点字段（例如 `IsSafe`、`IndexReceive`）
+
+### 5.2 TCP 接入：以 FLChargeStation 为例（ChargeStationType）
+
+以 `ChargeStationType/FLChargeStation.cs` 为例：
+
+- `OnPlaintextReceived(...)` 在收到 TCP 明文后：
+  - 提取报文字节（示例中 `Take(35)`）
+  - 更新站点内的一些运行时字段（例如 `IsSafe`）
+  - 调用 `CommunicationMessageService.AddReceiveMessage(...)`，并把 `type` 传为对应协议类型（例如 `"FRLDTall"`）
+
+> 说明：具体 TCP 断连/重连机制由底层 TCP 客户端与对应站点实现决定；无论 TCP/UDP，最终都会汇聚到 `CommunicationMessageService` 完成解析与落库。
+
+---
+
+## 6. 运行时充电业务循环：StandardChargeMission
+
+`Charge/StandardChargeMission.cs` 负责把“调度系统中的车的状态 + 充电策略 + 站点配置”组合成周期性的充电指令下发。
+
+### 6.1 初始化充电桩实例（创建 station 对象）
+
+关键步骤（来自实现片段）：
+
+1. 遍历系统 `Site` 中带有 `fields["Charge"]` 的站点，构建 station 配置
+2. 根据 `ChargeStationType` 使用反射创建 `AbstractChargeStation` 实例
+3. 给站点对象赋值：
+   - `SiteId`、`Ip`、`Port`
+   - `CommunicationType`
+     - 示例：`FRLDShort` 时设置为 `"UDP"`；否则使用配置中的 `CommunicationType`（默认走 TCP）
+4. 调用 `chargeStation.CreateCommunication(ipAddress, port)` 建立通信通道
+5. 把站点对象加入 `ChargeStations` 字典：`Dictionary<int, AbstractChargeStation>`
+
+如果存在任何 UDP 站点，会创建 `UdpService ??= new ChargeUdpService()`。
+
+### 6.2 500ms 业务循环（选择车辆 -> 下发指令）
+
+主循环（实现中包含 `Thread.Sleep(500)`）逻辑大致如下：
+
+1. 对每个 `chargeStationEntry`（按站点遍历）：
+   - 通过 `SimpleLib.GetAllCars()` 查找：
+     - 车辆当前所在站点 `c.GetLastSite() == siteId`
+     - 或车辆正在竞争锁/持有锁（`aquiringLock == siteId` 或 `holdingLocks.Contains(siteId)`）
+2. 若找到车辆：
+   - 判断车辆状态：`Commons.GetVehicleStatus((Car)car) == VehicleStatus.Normal`
+   - 判断是否正在“充电标记”（`car.tags.Contains("charging")`）
+   - 结合锁状态与 tag 状态计算 `openCharge`（0/1）
+3. 当未屏蔽交互（`shieldInterLock == false`）时下发指令：
+   - `chargeStation.SendToChargeStation(openCharge, (Car)car)`
+
+### 6.3 Stop/ShieldInterLock/管理界面入口
+
+- `Stop()`：中止 mission 线程，并对每个 station 调用 `CloseCommunication()`
+- `ShieldInterLock()`：切换“是否屏蔽充电桩交互”
+- `OpenManagementWindow()`：打开 `ChargeStationHelper.OpenManagementWindow()`
+
+---
+
+## 7. WinForms 界面与交互细节
+
+### 7.1 充电桩管理：ChargeStationManagementForm
+
+文件：`Charge/ChargeStationManagementForm.cs`
+
+#### 核心展示数据来源
+
+- 列表数据来源：`ChargeStationDataService.GetAllStations()`
+- UI 侧通讯状态：
+  - 在 `LoadStations()` 中对每个 station 执行 `Ping.Send(station.IpAddress, 1000)`
+  - Ping 成功则 `station.CommStatus = CommunicationStatus.Normal`，否则 `CommunicationStatus.Error`
+- 电气/运行时信息来源：
+  - `ChargeCommandStatus`、`Status`、`MechanismStatus`、`HasAlarm/AlarmLevel/AlarmMessage`、`RealTimeVoltage/Current` 等都来自 `CommunicationMessageService` 解析并落库后的 `ChargeStation` 字段
+
+#### 自动刷新
+
+- `autoRefreshTimer.Interval = 3000`
+- `AutoRefreshTimer_Tick`：
+  - 保存当前选中行的 `StationId`
+  - 调用 `LoadStations()` 重绘
+  - 恢复选中行
+
+#### 关键编辑与保存逻辑（btnSave）
+
+- `btnSave.Text == "修改"`：先切换为编辑模式 `SetEditMode(true)`
+- 新增/保存时校验：
+  - `StationId` 不能为空且必须是 1-99 范围整数
+  - 新增时禁止重复 `StationId`
+  - `SiteId` 必须存在于调度系统站点集合（`SimpleLib.GetSite((int)numSiteId.Value)`）
+- 保存调用：
+  - 新增：`dataService.AddStation(...)`
+  - 更新：`dataService.UpdateStation(..., isSave:true)`
+- 同步到调度系统 `Site.fields`：
+  - `setVoltage`、`setElectricCurrent`
+  - `group`：根据 `Enabled` 设置为 `"禁用"` 或 `GroupCarType`
+
+#### 删除逻辑（btnDelete）
+
+- 调用 `dataService.DeleteStation(stationId, out errorMessage)`
+- 同步清理 `Site.fields`：
+  - 移除 `setVoltage`、`setElectricCurrent`、`Charge`、`group`
+
+#### 列表交互
+
+- `dgvStations_CellDoubleClick`：
+  - 根据 `StationId` 查找 `ChargeStation`
+  - 调用 `LoadStationToFields(station)`
+  - 进入编辑模式 `SetEditMode(true, true)`
+
+#### 其它窗口入口按钮
+
+- `btnStrategyConfig_Click`：打开 `ChargeStrategyConfigForm`
+- `btnCommMonitor_Click`：打开 `CommunicationMonitorForm`
+- `btnAlarmConfig_Click`：打开 `AlarmConfigManagementForm`
+- `btnExport_Click`：导出 JSON 或 CSV（从 `GetAllStations()` 读取）
+
+### 7.2 策略配置：ChargeStrategyConfigForm
+
+文件：`Charge/ChargeStrategyConfigForm.cs`
+
+- 初始化：`config = configService.LoadConfig()`
+- 保存：把 UI 控件值写入 `ChargeStrategyConfig` 后调用 `configService.SaveConfig(config)`
+- 恢复默认：调用 `ChargeStrategyConfig.CreateDefault()` 并重新加载到界面
+
+### 7.3 通信监控：CommunicationMonitorForm
+
+文件：`Charge/CommunicationMonitorForm.cs`
+
+- 初始化：
+  - `messageService = CommunicationMessageService.Instance`
+  - 窗体加载完成后订阅：`messageService.MessageAdded += OnMessageAdded`
+- 新报文到达：`OnMessageAdded(...)`
+  - 若 `InvokeRequired` 则 `BeginInvoke` 回 UI 线程
+  - 根据当前 IP 筛选条件刷新消息列表（调用 `LoadMessages()`）
+- 消息列表展示：
+  - 从 `messageService.GetAllMessages()` 或 `GetMessagesByIp(ip)` 取出数据
+  - 根据 `Direction`（发送/接收）设置行颜色
+- 统计信息：
+  - `lblStatistics.Text = $"显示: {displayCount} | 总数: ... | 发送: ... | 接收: ..."`
+
+### 7.4 报警配置管理：AlarmConfigManagementForm
+
+文件：`Charge/AlarmConfigManagementForm.cs`
+
+- 界面加载：
+  - 初始化级别下拉框与筛选下拉框
+  - 调用 `LoadAlarmConfigs()`
+- 列表加载逻辑：
+  - 从 `AlarmConfigDataService.GetAllAlarmConfigs()` 获取全量
+  - 按筛选条件（等级 `cmbLevelFilter`、搜索框 `txtSearch`）过滤
+  - 填充 `dgvAlarmConfigs` 并根据 `AlarmLevel` 设置行颜色
+- 保存：
+  - `selectedAlarmConfig == null` -> 新增 `dataService.AddAlarmConfig`
+  - 否则 -> 更新 `dataService.UpdateAlarmConfig`
+- 删除：
+  - `dataService.DeleteAlarmConfig(selectedAlarmConfig.AlarmId, out ...)`
+- 双击列表：
+  - `dgvAlarmConfigs_CellDoubleClick` 读取 `AlarmId` 并加载到编辑区
+
+---
+
+## 7（代码一致性修订）：UI 窗体导航与更新流
+
+### 7.1 `ChargeStationManagementForm`（充电桩管理）
+
+入口/导航
+
+- 通过 `ChargeStationHelper.OpenManagementWindow()`（单例 `Show()`）或 `ChargeStationHelper.OpenManagementDialog()`（`ShowDialog()`）打开。
+- 窗体内通过按钮打开：
+  - `btnStrategyConfig_Click` -> `ChargeStrategyConfigForm.ShowDialog()`
+  - `btnCommMonitor_Click` -> `CommunicationMonitorForm.Show()`
+  - `btnAlarmConfig_Click` -> `AlarmConfigManagementForm.ShowDialog()`
+
+更新/刷新
+
+- 列表自动刷新：`autoRefreshTimer.Interval = 3000`，`AutoRefreshTimer_Tick` 会保存当前选中 `StationId`、重建 `dgvStations`（`LoadStations()`）、再恢复选中行。
+- 关闭窗体：`OnFormClosing` 停止并释放 `autoRefreshTimer`。
+- `LoadStations()` 的状态刷新点：
+  - 数据：`ChargeStationDataService.GetAllStations()` + 按 `cmbStatusFilter` 过滤。
+  - 通讯状态：逐个对站点执行 `Ping.Send(station.IpAddress, 1000)`，成功/失败分别写入 `station.CommStatus`，再刷新行颜色。
+- 搜索/筛选：`txtSearch_TextChanged` 与 `cmbStatusFilter_SelectedIndexChanged` 都会触发 `ApplyFilters()`，清空并重建 `dgvStations`（包含行颜色规则）。
+- 手动刷新：`btnRefresh_Click` -> `dataService.Reload()` -> `LoadStations()`。
+
+编辑与保存
+
+- 双击列表：`dgvStations_CellDoubleClick` -> `LoadStationToFields(station)` -> `SetEditMode(false)`（查看模式，`btnSave.Text="修改"`）。
+- `btnSave_Click` 两段式：
+  - `btnSave.Text=="修改"`：仅切到编辑模式 `SetEditMode(true)`。
+  - 否则执行保存：校验 `StationId`（1-99）、新增时校验唯一性、校验 `SiteId` 存在，然后调用 `AddStation` / `UpdateStation(..., isSave:true)`。
+  - 保存成功后同步调度系统 `Site.fields`：`setVoltage`、`setElectricCurrent`、`group`（启用写 `GroupCarType`，禁用写 `"禁用"`），再刷新列表并清空编辑区。
+- 删除：`btnDelete_Click` 确认后 `DeleteStation`，并同步清理 `Site.fields`（`setVoltage`、`setElectricCurrent`、`Charge`、`group`）。
+
+### 7.2 `ChargeStrategyConfigForm`（充电策略配置）
+
+入口/导航
+
+- 通常由管理窗体打开：`ChargeStationManagementForm` 的 `btnStrategyConfig_Click` 使用 `ShowDialog()`。
+
+更新/刷新
+
+- 初始化：`configService = ChargeStrategyConfigService.Instance`，构造时 `LoadConfig()` 把文件配置加载到界面控件。
+- 保存/应用：`btnSave_Click` 与 `btnApply_Click` 都会先 `ValidateConfig()` 校验阈值关系，再把控件值写回 `config` 并调用 `configService.SaveConfig(config)`。
+- 恢复默认：`btnRestoreDefaults_Click` 确认后 `config = ChargeStrategyConfig.CreateDefault()`，调用 `LoadConfig(true)` 刷新界面，但不自动保存（状态提示“未保存”）。
+- 取消：`btnCancel_Click` -> `Close()`。
+
+### 7.3 `CommunicationMonitorForm`（通信监控）
+
+入口/导航
+
+- 由管理窗体 `btnCommMonitor_Click` 打开：`Show()`（非阻塞）。
+
+更新/刷新（事件驱动）
+
+- 构造中拿到 `messageService = CommunicationMessageService.Instance`；`FormClosing` 退订 `MessageAdded`。
+- `CommunicationMonitorForm_Load`：
+  - `InitializeForm()` + `LoadMessages()` 后设置 `isFormLoaded=true`
+  - 再订阅 `messageService.MessageAdded += OnMessageAdded`
+- `OnMessageAdded`：
+  - `InvokeRequired` 时 `BeginInvoke` 回 UI 线程
+  - 新 IP 则刷新 `cmbIpFilter`（`RefreshIpFilter()`）
+  - 若当前筛选匹配（“全部”或等于当前消息 IP）则调用 `LoadMessages()` 重建消息列表
+- 手动操作：
+  - `cmbIpFilter_SelectedIndexChanged` -> `LoadMessages()`
+  - `btnRefresh_Click` -> `RefreshIpFilter()` + `LoadMessages()`
+  - `btnClear_Click`：确认 -> `messageService.Clear()` -> 刷新列表并清空 `txtParsedData`
+- 列表选择与解析展示：
+  - `dgvMessages_SelectionChanged` 根据所选行构造临时 `CommunicationMessage`，再调用 `ParseMessage()`，并将解析结果写入 `txtParsedData`。
+
+### 7.4 `AlarmConfigManagementForm`（报警配置管理）
+
+入口/导航
+
+- 由管理窗体 `btnAlarmConfig_Click` 打开：`ShowDialog()`。
+
+更新/刷新（加载 + 筛选/搜索）
+
+- 构造：`dataService = AlarmConfigDataService.Instance`，并订阅 `this.Load += AlarmConfigManagementForm_Load`。
+- `InitializeForm()`：
+  - 初始化 `cmbLevel` 与 `cmbLevelFilter`
+  - 调用 `LoadAlarmConfigs()` 加载列表
+  - 调用 `ClearEditFields()` 初始化编辑区（默认新增态）
+- `LoadAlarmConfigs()`：
+  - 数据源：`dataService.GetAllAlarmConfigs()`
+  - 过滤：`cmbLevelFilter`（映射到 `AlarmLevel`）与 `txtSearch`（匹配 `AlarmId/AlarmCode/AlarmContent`）
+  - 填充 `dgvAlarmConfigs` 并按 `AlarmLevel` + `Enabled` 设置行颜色/样式，同时更新统计与标题
+- 实时刷新：`txtSearch_TextChanged` 与 `cmbLevelFilter_SelectedIndexChanged` 都直接调用 `LoadAlarmConfigs()`；`btnRefresh_Click` 会 `dataService.Reload()` 后重新加载。
+
+编辑与保存
+
+- 双击列表：`dgvAlarmConfigs_CellDoubleClick` 读取 `AlarmId` -> `dataService.GetAlarmConfig(alarmId)` -> `LoadAlarmConfigToFields()`（编号不可编辑，切为编辑态）。
+- 保存：`btnSave_Click` 校验 `numAlarmCode >= 0`、`txtAlarmContent` 非空；根据是否选中项决定 `AddAlarmConfig` 或 `UpdateAlarmConfig`；成功后刷新列表并清空编辑区。
+- 删除：`btnDelete_Click` 确认后 `DeleteAlarmConfig(selectedAlarmConfig.AlarmId)`，成功后刷新列表并清空编辑区。
+- 取消/关闭：`btnCancel_Click` 清空编辑区，`btnClose_Click` 关闭窗体。
+
+---
+
+## 8. 关键调用链（建议排查/理解用）
+
+### 8.1 周期循环下发充电指令 -> 发送报文记录 -> ChargeCommandStatus 更新
+
+```mermaid
+flowchart TD
+  A[StandardChargeMission 500ms循环] --> B[chargeStation.SendToChargeStation(openCharge, car)]
+  B --> C[chargeStation 内部构造发送报文]
+  C --> D[CommunicationMessageService.AddSendMessage(...)]
+  D --> E[ParseSendRawData(type)]
+  E --> F[UpdateStationFromSendData]
+  F --> G[ChargeStationDataService.UpdateStation]
+  G --> H[ChargeStation 字段落库]
+  H --> I[ChargeStationManagementForm(3s刷新) 展示]
+```
+
+### 8.2 TCP/UDP 接收报文 -> 解析 -> ChargeStation 状态与告警更新 -> UI 展示
+
+```mermaid
+flowchart TD
+  A[TCP 收到明文 或 UDP 收到报文] --> B[CommunicationMessageService.AddReceiveMessage(...)]
+  B --> C[ParseReceiveRawData(type)]
+  C --> D[UpdateStationFromReceiveData]
+  D --> E[ChargeStationDataService.UpdateStation]
+  E --> F[ChargeStation 字段落库]
+  F --> G[ChargeStationManagementForm(3s刷新) 展示 Status/告警/电压电流]
+```
+
+### 8.3 通信监控界面订阅报文事件
+
+```mermaid
+flowchart TD
+  A[CommunicationMessageService.AddMessage/MessageAdded] --> B[CommunicationMonitorForm.OnMessageAdded]
+  B --> C[BeginInvoke 切到UI线程]
+  C --> D[LoadMessages 刷新 dgvMessages]
+```
+
+---
+
+## 9. 常用调试点（建议）
+
+- 通信解析落库：
+  - 看 `CommunicationMessageService` 的 `UpdateStationFromSendData/ReceiveData` 更新了哪些字段
+- UI 展示：
+  - `ChargeStationManagementForm.LoadStations()` 中的 `Ping.Send(...)` 会影响 `CommStatus` 展示
+- 如果“列表里状态不变”：
+  - 优先确认报文是否真的进入 `CommunicationMessageService.AddSendMessage/AddReceiveMessage`
+  - 再确认解析是否返回非 null（解析失败会直接 `return null`）
+
+# StandardScene/Charge：充电桩数据模型与持久化（仅数据层）
+
+本页聚焦 `StandardScene/Charge/` 中与“数据模型 + DataService 持久化/更新 API”相关的部分，覆盖：
+
+1. `ChargeStation`：充电桩配置/运行时状态字段含义与 `JsonIgnore` 持久化边界
+2. `ChargeStationDataService`：`Config/ChargeStations.json` 的读取/保存、增删改与状态更新
+3. `AlarmConfig` 与 `AlarmConfigDataService`：`Config/AlarmConfigs.json` 的读取/保存、增删改
+
+---
+
+## 1. 数据模型：`ChargeStation`
+
+文件：`Charge/ChargeStation.cs`
+
+### 1.1 配置/计算字段说明（按 `JsonIgnore` 区分）
+
+`ChargeStation` 的下列字段用于“充电桩配置”，在 JSON 里会被序列化（即：未标注 `JsonIgnore`）：
+
+- `StationId`：充电桩编号（唯一标识）
+- `Name`：充电桩名称
+- `Type`：充电桩类型（`ChargeStationType`）
+- `ChargeMethod`：充电方式（`ChargeMethodType`）
+- `IpAddress`：IP 地址
+- `Port`：端口号
+- `CommunicationType`：通讯类型（属性初始值为 `"TCP"`，但构造函数会覆盖为 `"UDP"`）
+- `SetVoltage`：额定电压（V）
+- `SetElectricCurrent`：额定电流（A）
+- `Enabled`：是否启用
+- `GroupCarType`：停靠车辆类型（`ChargeStationCarType`）
+- `SiteId`：关联站点 ID（可选）
+- `ShieldSiteMechanismStatus`：屏蔽机构状态交互
+- `Remarks`：备注
+- `CreatedTime`：创建时间
+- `ModifiedTime`：最后修改时间
+- `Power`：计算属性（`SetVoltage * SetElectricCurrent`），标注了 `[JsonIgnore]`，不会写入 JSON
+
+### 1.2 运行时状态字段（不会被持久化到 JSON）
+
+以下字段标注了 `[JsonIgnore]`，因此不会写入 `Config/ChargeStations.json`（重启后这些运行时状态通常会丢失）：
+
+- `RealTimeVoltage`、`RealTimeCurrent`：实时电压/电流
+- `LastSendTime`、`LastReceiveTime`：最后发送/接收时间
+- `HasAlarm`、`AlarmMessage`、`AlarmLevel`：报警标记/报警文本/报警级别
+- `CommStatus`、`LastCommunicationTime`：通讯状态/最后通讯时间（注意：当前代码里通讯状态字段的更新路径不在本节展开）
+- `MechanismStatus`：机构伸缩状态
+- `CurrentVehicle`：当前充电车辆编号
+- `BatteryLevel`：当前电量百分比
+- `ChargeCommandStatus`：发送充电指令状态（停止/启动）
+- `Status`：充电桩状态（空闲/充电中/报警中/AGV电池已接入）
+
+### 1.3 校验：`IsValid(out errorMessage)`
+
+`ChargeStation.IsValid()` 约束：
+
+- `StationId`、`Name`、`IpAddress` 不能为空
+- `IpAddress` 需为可解析的 IP
+- `Port` 必须在 `1-65535`
+- `SetVoltage` 必须在 `(0, 64]`
+- `SetElectricCurrent` 必须在 `(0, 101]`
+
+---
+
+## 2. 数据服务：`ChargeStationDataService`
+
+文件：`Charge/ChargeStationDataService.cs`
+
+### 2.1 单例与持久化文件
+
+- 单例：`ChargeStationDataService.Instance`
+- 内部数据：`private List<ChargeStation> chargeStations`
+- JSON 文件路径：基于运行目录写入
+  - `AppDomain.CurrentDomain.BaseDirectory/Config/ChargeStations.json`
+- 构造函数会确保 `Config/` 目录存在，并执行 `LoadData()`
+
+### 2.2 读取：`LoadData()`
+
+行为：
+
+- 若文件存在：读取文本并 `JsonConvert.DeserializeObject<List<ChargeStation>>(json)`
+- 若文件不存在：初始化为空列表（并不会自动生成默认样例）
+- 异常：记录诊断日志并回退到空列表
+
+### 2.3 保存：`SaveData()`
+
+行为：
+
+- 在锁 `lockObj` 下序列化整个 `chargeStations` 列表
+- 写入文件 `Config/ChargeStations.json`（`Formatting.Indented`）
+- 保存失败：返回 `false` 并由调用方回滚内存状态（部分方法会回滚）
+
+### 2.4 查询 API
+
+- `List<ChargeStation> GetAllStations()`：返回列表副本（拷贝）
+- `ChargeStation GetStationById(string stationId)`：按 `StationId` 查找
+- `ChargeStation GetStationByIp(string ipAddress, int port)`：按 `IpAddress + Port` 查找
+- `List<ChargeStation> GetIdleStations()`：过滤 `Enabled && Status == Idle`
+- `int GetChargingCount()`：统计 `Status == Charging`
+- `void Reload()`：重新执行 `LoadData()`
+
+### 2.5 新增：`AddStation(ChargeStation station, out string errorMessage)`
+
+关键点：
+
+- `station == null` 返回失败
+- 先执行 `station.IsValid(out errorMessage)`
+- 唯一性校验：
+  - `StationId` 不可重复
+  - `IpAddress + Port` 组合不可重复
+- 写入字段：
+  - 设置 `CreatedTime` / `ModifiedTime` 为当前时间
+- 成功后：`SaveData()`；失败则将新增对象从内存移除
+
+### 2.6 更新：`UpdateStation(ChargeStation station, out string errorMessage, bool isSave = false)`
+
+该方法同时被用作“配置更新”与“运行时状态合并后再落盘”的入口之一（不同调用方会用不同的 `isSave` 值）。
+
+核心流程：
+
+- 校验：`station.IsValid(out errorMessage)`
+- 找到原对象：`existingStation = chargeStations.FirstOrDefault(s => s.StationId == station.StationId)`
+- 冲突校验：`IpAddress + Port` 不能被其它站点占用
+- 时间处理：
+  - 保留 `existingStation.CreatedTime`
+  - 更新 `station.ModifiedTime = DateTime.Now`
+- 赋值策略取决于 `isSave`：
+  - `isSave == true`：仅将“配置类字段”拷贝到 `existingStation`（并令 `station = existingStation`）
+  - `isSave == false`：不进行字段级拷贝，直接用传入的 `station` 替换列表里的对应项
+- 之后无论 `isSave` 为何都会执行 `SaveData()` 并落盘整个列表
+- 保存失败：回滚为 `existingStation`
+
+持久化边界提醒（结合 `ChargeStation` 的 `JsonIgnore`）：
+
+- 因为 `Status / Alarm / 实时电压电流 等运行时字段` 都是 `JsonIgnore`，即使 `UpdateStation` 被用于合并运行时字段，重启后这些运行时字段仍不会出现在 JSON 中
+- 但 `ModifiedTime`（未 `JsonIgnore`）会被写入，因此会出现“通信上报频繁导致 JSON 文件 `ModifiedTime` 刷新”的现象
+
+### 2.7 删除：`DeleteStation(string stationId, out string errorMessage)`
+
+- 按 `stationId` 找到对象并移除
+- 成功后保存；失败则将对象重新加入内存
+- 代码中原本有“如果正在充电则禁止删除”的检查，但被注释掉了
+
+### 2.8 状态更新（运行时）：`UpdateStationStatus(string stationId, ChargeStationStatus status)`
+
+- 修改内存对象的 `Status` 与 `ModifiedTime`
+- 然后 `SaveData()`
+- 由于 `Status` 标注了 `JsonIgnore`，因此重启后站点 `Status` 通常不会从 JSON 恢复（但 `ModifiedTime` 会更新）
+
+---
+
+## 3. 数据模型：`AlarmConfig`
+
+文件：`Charge/AlarmConfig.cs`
+
+### 3.1 字段含义（会被持久化）
+
+`AlarmConfig` 没有 `JsonIgnore`，因此以下字段都能写入 `Config/AlarmConfigs.json`：
+
+- `AlarmId`：报警编号（构造函数自动生成，格式类似 `ALMyyyyMMddHHmmssxxx`）
+- `AlarmCode`：报警编码值（int）
+- `AlarmContent`：报警内容描述（文本）
+- `Level`：报警级别（`AlarmLevel`：None/Low/Medium/High/Critical）
+- `Enabled`：是否启用
+- `Remarks`：备注
+- `CreatedTime` / `ModifiedTime`：创建与修改时间
+
+### 3.2 校验：`IsValid(out errorMessage)`
+
+- `AlarmId` 不能为空
+- `AlarmCode >= 0`
+- `AlarmContent` 不能为空
+
+---
+
+## 4. 数据服务：`AlarmConfigDataService`
+
+文件：`Charge/AlarmConfigDataService.cs`
+
+### 4.1 单例与持久化文件
+
+- 单例：`AlarmConfigDataService.Instance`
+- 数据文件路径：`AppDomain.CurrentDomain.BaseDirectory/Config/AlarmConfigs.json`
+- 构造函数调用 `LoadData()`；若目录不存在则创建
+
+### 4.2 读取：`LoadData()`
+
+行为：
+
+- 文件存在：读取并反序列化为 `List<AlarmConfig>`
+  - 若反序列化结果为 `null`，回退为空列表
+- 文件不存在：初始化默认报警配置 `InitializeDefaultAlarms()`，随后 `SaveData()`
+- 异常：记录 `Debug.WriteLine`，回退到空列表并初始化默认报警配置
+
+默认报警包含（示例）：
+
+- 1001：电压过高
+- 1002：电压过低
+- 1003：电流过大
+- 2001：温度异常
+- 3001：通讯超时
+- 3002：连接断开
+
+### 4.3 保存：`SaveData()`
+
+- 序列化整个 `_alarmConfigs` 并写入 `AlarmConfigs.json`
+- 保存失败会抛出异常（不只是返回 `false`）
+
+### 4.4 查询 API
+
+- `List<AlarmConfig> GetAllAlarmConfigs()`：返回列表副本
+- `AlarmConfig GetAlarmConfig(string alarmId)`：按 `AlarmId` 查找
+- `AlarmConfig GetAlarmConfigByCode(int alarmCode)`：按 `AlarmCode` 查找
+
+### 4.5 新增：`AddAlarmConfig(AlarmConfig alarmConfig, out string errorMessage)`
+
+- 先执行 `alarmConfig.IsValid(out errorMessage)`
+- 校验 `AlarmCode` 唯一性（不允许重复）
+- 添加到列表后 `SaveData()`
+
+### 4.6 更新：`UpdateAlarmConfig(AlarmConfig alarmConfig, out string errorMessage)`
+
+- 校验：`IsValid`
+- 查找目标：按 `AlarmId` 找到索引；不存在则失败
+- 冲突校验：`AlarmCode` 不能被其它报警配置占用
+- 设置 `alarmConfig.ModifiedTime = DateTime.Now`
+- 替换列表项并 `SaveData()`
+
+### 4.7 删除：`DeleteAlarmConfig(string alarmId, out string errorMessage)`
+
+- 按 `AlarmId` 找到并移除
+- 然后 `SaveData()`
+
+### 4.8 重新加载：`Reload()`
+
+- 在锁下重新执行 `LoadData()`
+
+---
+
+## 5. 与“更新路径”的关系（为何运行时变化也会触发落盘）
+
+虽然本页主要讲 DataService，但为了说明“哪些字段会/不会出现在 JSON 里”，需要点到调用关系：
+
+- 通讯层（`Charge/CommunicationMessageService.cs`）在解析发送/接收报文后，会：
+  - 更新 `ChargeStation` 的运行时字段（例如 `HasAlarm`、`Status`、`RealTimeVoltage/Current` 等）
+  - 然后调用 `ChargeStationDataService.UpdateStation(station, out errorMessage)`（使用默认 `isSave=false`）
+- UI 保存站点配置（`Charge/ChargeStationManagementForm.cs`）在“保存/修改配置”时会调用：
+  - `ChargeStationDataService.UpdateStation(station, out errorMessage, true)`
+- 报警配置的 UI 增删改（`Charge/AlarmConfigManagementForm.cs`）直接调用：
+  - `AddAlarmConfig / UpdateAlarmConfig / DeleteAlarmConfig`
+
+因此你会观察到：
+
+- `ChargeStations.json` 中的“运行时字段”不会被写入（因为它们带 `JsonIgnore`）
+- 但 `ModifiedTime` 这类未忽略字段会被写入，所以文件仍会频繁变化
+
+---
+## 6. 通讯报文解析：`CommunicationMessageService` 如何更新 `ChargeStation`
+
+本节重点解释 `Charge/CommunicationMessageService.cs` 中“报文解析 -> 更新充电桩运行时字段”的完整链路（并说明当前实现里哪些字段没有被真正落到 `ChargeStation`）。
+
+### 6.1 入口与站点匹配规则
+
+`CommunicationMessageService` 通过两个入口接收外部报文，并在内部完成“解析 + 更新 + 落盘（通过 DataService）”：
+
+- 发送报文入口：`AddSendMessage(ipAddress, port, rawData, type, stationId)`
+- 接收报文入口：`AddReceiveMessage(ipAddress, port, rawData, type, stationId)`
+
+两条链路在解析前都会做同样的站点匹配：
+
+- 先拿到单例：`ChargeStationDataService.Instance`
+- 通过 `GetStationByIp(ipAddress, port)` 找到对应 `ChargeStation`
+- 找不到站点直接返回（此时只会记录报文，不会更新该站点运行时字段）
+
+解析成功后才会调用：
+
+- `ChargeStationDataService.UpdateStation(station, out errorMessage)`（该调用在当前代码里使用默认参数，最终会落盘整个 `ChargeStations.json`；但由于运行时字段多为 `JsonIgnore`，重启后这些运行时值不会恢复）
+
+异常处理方面：
+
+- `ParseSendDataAndUpdateStation` / `ParseReceiveDataAndUpdateStation` 都使用 `try/catch` 并“静默吞掉异常”，因此解析失败通常表现为：报文列表有记录，但充电桩字段没有变化。
+
+### 6.2 发送报文解析与字段更新（`UpdateStationFromSendData`）
+
+发送报文完整调用链如下：
+
+`AddSendMessage` -> `ParseSendDataAndUpdateStation`
+ -> `ParseSendRawData(rawData, type)`
+ -> `UpdateStationFromSendData(station, parsedData)`
+ -> `ChargeStationDataService.UpdateStation(...)`
+
+#### 6.2.1 `ParseSendRawData` 输入格式与 `type` 支持
+
+`ParseSendRawData` 的输入要求：
+
+- `rawData` 以空格分隔字节 token（例如：`"BB 01 42 ..."`）
+- 每个 token 会按十六进制解析：`byte.TryParse(token, NumberStyles.HexNumber, ...)`
+- 发送报文最少 token 数：`parts.Length >= 10`
+
+当前实现里，`type` 仅对以下两种有明确字节位映射：
+
+- `FRLDShort`
+- `FRLDTall`
+
+其他 `type`（例如 `MuXing`）不会命中映射分支，此时解析出来的数值保持默认值，然后仍可能触发 `UpdateStationFromSendData` 的“默认覆盖”逻辑（见下文“已知限制”）。
+
+#### 6.2.2 从发送报文写入哪些 `ChargeStation` 字段
+
+`UpdateStationFromSendData` 实际更新的字段如下（直接对应代码赋值）：
+
+- `station.LastSendTime = parsedData.SendTime`
+- `station.ChargeCommandStatus`
+  - `parsedData.ChargeCommand == 1` -> `ChargeCommandStatus.Started`
+  - `parsedData.ChargeCommand == 0` -> `ChargeCommandStatus.Stopped`
+- `station.BatteryLevel = parsedData.BatteryLevel`
+- `station.CurrentVehicle = parsedData.CurrentVehicleId.ToString()`
+
+注意：
+
+- `UpdateStationFromSendData` 里 `SetVoltage` / `SetElectricCurrent` 的赋值被注释掉了（即：发送报文不会更新 `ChargeStation.SetVoltage` / `ChargeStation.SetElectricCurrent` 的配置目标值）。
+
+### 6.3 接收报文解析与字段更新（`UpdateStationFromReceiveData`）
+
+接收报文完整调用链如下：
+
+`AddReceiveMessage` -> `ParseReceiveDataAndUpdateStation`
+ -> `ParseReceiveRawData(rawData, type)`
+ -> `UpdateStationFromReceiveData(station, parsedData)`
+ -> `ChargeStationDataService.UpdateStation(...)`
+
+#### 6.3.1 `ParseReceiveRawData` 输入格式与 `type` 支持
+
+`ParseReceiveRawData` 的输入要求：
+
+- `rawData` 以空格分隔字节 token（`rawData.Split(' ')`）
+- 接收报文最少 token 数：`parts.Length >= 30`
+- 每个 token 的解析使用的是 `byte.TryParse(parts[i], out bytes[i])`（没有显式 `NumberStyles.HexNumber`）
+
+因此当 `rawData` token 形如十六进制字节（例如 `0A`、`FF`）时，可能出现解析失败导致 `parsedData == null`（从而不会更新站点字段）的情况。
+
+`type` 的字节位映射同样只实现了两种：
+
+- `FRLDShort`
+- `FRLDTall`
+
+#### 6.3.2 从接收报文写入哪些 `ChargeStation` 字段
+
+`UpdateStationFromReceiveData` 实际更新的字段如下：
+
+- `station.LastReceiveTime = parsedData.ReceiveTime`
+- `station.MechanismStatus = parsedData.MechanismStatus`
+- `station.RealTimeVoltage = parsedData.RealTimeVoltage`
+- `station.RealTimeCurrent = parsedData.RealTimeCurrent`
+- `station.Status = parsedData.Status`
+- `station.HasAlarm = parsedData.HasAlarm`
+- `station.AlarmLevel = parsedData.AlarmLevel`
+- `station.AlarmMessage`
+  - `parsedData.HasAlarm == true` -> `报警级别: {GetAlarmLevelText(parsedData.AlarmLevel)}`
+  - 否则 -> `string.Empty`
+
+与报警相关的映射：
+
+- `ParseReceiveRawData` 里 `HasAlarm = chargeStationStatus == 2`
+- `ParseStationStatus` 将 `statusByte == 2` 映射为 `ChargeStationStatus.Fault`
+
+当前实现里 `AlarmLevel` 的来源有一个明显限制：
+
+- `ParseReceiveRawData` 中 `AlarmLevel = ParseAlarmLevel(bytes[20])` 被注释掉了
+- 因此 `parsedData.AlarmLevel` 多半保持默认值（`AlarmLevel.None`），但只要 `HasAlarm == true`，`AlarmMessage` 仍会按默认 `AlarmLevel` 生成文本
+
+同时，`ParsedReceiveData` 中的以下字段虽然会解析出来，但 `UpdateStationFromReceiveData` 没有把它们写入 `ChargeStation`：
+
+- `ParsedReceiveData.CommStatus`
+- `ParsedReceiveData.ChargeCommandStatus`
+- `ParsedReceiveData.ChargeID`
+- `ParsedReceiveData.BatteryAH`
+
+### 6.4 已知限制/行为总结（影响“字段是否更新”）
+
+1. 解析失败只影响“字段更新”，不影响“报文记录与 UI 列表展示”
+   - 报文一定会先进入 `_messages`（并触发 `MessageAdded`）
+   - 但解析函数返回 `null` / 站点找不到 / 异常时，字段更新不会发生
+
+2. 站点匹配使用 `IP + Port`
+   - `GetStationByIp(ipAddress, port)` 找不到对应 `ChargeStation` 时，不会更新该站点运行时字段
+
+3. `type` 只对 `FRLDShort` / `FRLDTall` 完成了映射
+   - 发送侧对未知 `type` 仍会返回默认 `ParsedSendData`，从而可能覆盖 `ChargeCommandStatus` / `BatteryLevel` / `CurrentVehicle` 为默认值
+   - 接收侧未知 `type` 也可能产生默认 `ParsedReceiveData`，但前提是 `rawData.Split(' ')` 后仍满足 `parts.Length >= 30`
+
+4. 接收侧 token 解析方式可能与输入十六进制格式不一致
+   - `ParseReceiveRawData` 未使用 `NumberStyles.HexNumber`
+   - 如果 `rawData` token 是十六进制字节（如 `0A`），可能导致 `parsedData == null`，进而不更新实时字段
+
+
+
+## 7. 运行时充电业务：StandardChargeMission
+
+本节聚焦 `Charge/StandardChargeMission.cs` 中的“充电进程启动 + 500ms 充电业务循环”，并跟踪 `SendToChargeStation(...)` 的真实调用路径到具体充电桩实现类。
+
+### 7.1 启动入口：`Execute()`
+
+`StandardChargeMission.Execute()` 负责启动充电进程，核心流程：
+
+- 设置进程状态：`status.status = "已启动"`
+- 防重复启动：通过 `myStarted` 判断，避免重复创建线程
+- 初始化运行时字典：`ChargeStations = new Dictionary<int, AbstractChargeStation>()`
+- 创建后台线程：`ChargeThread = new Thread(() => { ... })`
+  - 在线程内部完成“充电站初始化 + 500ms 业务循环”
+- 启动辅助任务：定期上传带 `unavailable` 标签的站点到迷毂系统（同样是 `Thread.Sleep(500)` 周期）
+- 最后调用 `base.Execute()`，让基类调度/联锁逻辑继续工作
+
+### 7.2 初始化：后台线程 Step1（创建/重建 `AbstractChargeStation`）
+
+在 `ChargeThread` 的 `while (true)` 内部，每一轮都会先执行“步骤1：初始化充电站”：
+
+- 读取配置：`ChargeStationHelper.GetAllStationConfigs()`
+  - 底层来自 `ChargeStationDataService.Instance.GetAllStations()`
+- 遍历每个充电桩配置项，执行校验与创建：
+  - `Enabled == false`：跳过
+  - 校验 `SiteId > 0`、`IpAddress` 可解析、`Port` 在 `1-65535`
+  - 若字典里已存在相同 `siteId` 的站点：
+    - 当 IP/Port 发生变化：`existingStation.CloseCommunication()` 后更新 `Ip/Port` 并重新 `CreateCommunication(...)`
+    - IP/Port 未变化：直接 `continue`（复用原连接）
+  - 若不存在：
+    - 使用 `GetChargeTypeString(stationConfig.Type)` 映射到具体站点类名：
+      - `FRLDTall` -> `FLChargeStation`
+      - `FRLDShort` -> `PCBChargeStation`
+      - `MuXing` -> `MuXingChargeStation`
+      - 默认回退 -> `PCBChargeStation`
+    - `Activator.CreateInstance(type)` 创建对象，设置：
+      - `SiteId / Ip / Port`
+      - `CommunicationType`：`FRLDShort` 强制 `UDP`，其它使用配置里的 `CommunicationType`
+    - 调用 `CreateCommunication(ipAddress, port)` 建立通信连接
+    - 放入字典：`ChargeStations.Add(siteId, stationInstance)`
+
+同时，线程内部还会做 UDP 服务初始化：
+
+- 若存在任意站点 `CommunicationType == "UDP"`：
+  - `UdpService ??= new ChargeUdpService();`
+
+### 7.3 500ms 业务循环：后台线程 Step3 + `SendToChargeStation(...)`
+
+`ChargeThread` 的主循环结构（简化）：
+
+1. 读取互锁开关：`var shieldInterLock = ((StandardChargeMissionStatus)status).ShieldInterLock`
+2. 更新/清理配置绑定：
+   - 若 `ChargeStationHelper.GetStationBySiteId(siteId) == null`：从 `ChargeStations` 移除该站点
+   - 对 `SimpleLib.GetAllSites()` 中仍带 `fields["Charge"]` 但不在 `ChargeStations` 配置里的站点：
+     - 移除 `Charge / setVoltage / setElectricCurrent / group` 等字段
+3. 遍历每个站点，执行“车辆搜索 -> openCharge 计算 -> 下发”：
+   - 取站点配置：`chargeStationSetting = ChargeStationHelper.GetStationBySiteId(siteId)`
+   - 若 `!chargeStationSetting.Enabled`：跳过
+   - 将站点配置绑定回 `site.fields`：
+     - `site.fields["Charge"] = "True"`
+     - `site.fields["setVoltage"] = chargeStationSetting.SetVoltage.ToString("0.0")`
+     - `site.fields["setElectricCurrent"] = chargeStationSetting.SetElectricCurrent.ToString("0.0")`
+    - `site.fields["group"]`：启用时写 `GroupCarType`，禁用时写 `"禁用"`
+   - 设置站点进入/离开权限：
+     - `ChargeMethodType.Side` 分支：`SetAllowEnter / SetAllowExit` 与 `ShieldSiteMechanismStatus` / `MechanismStatus == Retracted` 联动
+     - 非 `Side`：直接 `SetAllowEnter(true) / SetAllowExit(true) / SetAcknowledgeLeave(true)`
+   - 查找与该站点相关的车辆（在站/获取锁/持有锁）：
+     - `GetLastSite() == siteId` 或 `aquiringLock == siteId` 或 `holdingLocks.Contains(siteId)`
+   - 计算 `openCharge`：
+     - 默认 `0`
+     - 仅当车辆存在且 `Commons.GetVehicleStatus((Car)car) == VehicleStatus.Normal`
+     - 并且满足充电条件：
+       - `charging` 标记存在
+       - 未被占用：`!car.tags.Contains("occupied")`
+       - 锁状态匹配：`holdingLocks.Length == 1` 且 `pendingLocks.Length == 0`
+     - 则 `openCharge = 1`
+   - 互锁门控后下发指令：
+     - 若 `!shieldInterLock`：
+       - `chargeStation.SendToChargeStation(openCharge, (Car)car);`
+4. 循环尾部固定节拍：`Thread.Sleep(500)`
+
+### 7.4 `SendToChargeStation` 调用链（下发路径）
+
+在 500ms 循环中，下发的调用路径是：
+
+`StandardChargeMission(ChargeThread 500ms loop)`
+-> `AbstractChargeStation` 子类 `SendToChargeStation(int isCharge, Car car)`
+-> 子类内部组包 + 记录发送报文：`CommunicationMessageService.Instance.AddSendMessage(...)`
+-> 通过 TCP/UDP 通道真正发送报文
+
+各站点实现类的“发送端”关键点：
+
+- `FLChargeStation.SendToChargeStation`
+  - 依赖 `IsConnected && Client != null`，否则不发送
+  - 读取 `Car` 的 `Soc/Voltage/ElectricCurrent`，并可覆盖 `site.fields["setVoltage"]/["setElectricCurrent"]`
+  - `AddSendMessage(..., "FRLDTall", site?.name)` 后 `Client.Send(msg)`
+
+- `MuXingChargeStation.SendToChargeStation`
+  - 计算 `openChargePort = (isCharge == 1 ? 2 : 3)` 并组包（包含时间戳与 CRC）
+  - `AddSendMessage(..., "MuXing")` 后写入 TCP `stream`
+
+- `PCBChargeStation.SendToChargeStation`（`FRLDShort`）
+  - 使用 `UdpClient` 发送
+  - `AddSendMessage(..., "FRLDShort", site?.name)` 后 `udpClient.SendAsync(msg, msg.Length, _endPoint)`
+
+```mermaid
+flowchart TD
+  A[StandardChargeMission.Execute\n启动 ChargeThread] --> B[ChargeThread while(true)]
+  B --> C[Step1 初始化/重建 ChargeStations]
+  B --> D[Step3 遍历每个站点]
+  D --> E[计算 openCharge(0/1)]
+  E --> F{!ShieldInterLock}
+  F -->|false| Z[跳过下发]
+  F -->|true| G[chargeStation.SendToChargeStation(openCharge, car)]
+  G --> H[站点子类组包]
+  H --> I[CommunicationMessageService.AddSendMessage]
+  I --> J[TCP/UDP 发送报文]
+```
+