Third_Dev_Dept/StandardSence

Fork 0

Files

T

zhaowei.huang c8e540d272 init commit

2026-06-14 11:19:15 +08:00

9.1 KiB

Raw Blame History

充电策略配置说明

功能概述

充电策略配置界面用于管理和配置充电系统的各项参数，包括 SOC 阈值、时间参数、任务参数和开关参数。配置保存在 JSON 文件中，系统启动时自动加载。

打开配置界面

在充电桩管理界面点击 "策略配置" 按钮（绿色按钮）即可打开配置界面。

配置参数说明

1. SOC 参数（电量百分比）

参数名称	默认值	说明	取值范围
必充电量	20%	低于此电量必须充电	0-100%
空闲充电电量	90%	车辆空闲时开始充电的电量阈值	0-100%
任务可用电量	60%	可以执行任务的最低电量	0-100%
满电电量	90%	充电目标电量	0-100%
允许中断电量	45%	允许中断充电任务的最低电量	0-100%

逻辑关系：

必充电量 < 空闲充电电量
任务可用电量 > 必充电量
满电电量 ≥ 空闲充电电量
允许中断电量 > 必充电量

2. 时间参数

参数名称	默认值	说明	单位
空闲充电时间	30	车辆空闲多久后开始充电	秒 (sec)
空闲时间	5	判断车辆空闲的时间阈值	秒 (sec)
必充时间	60	必须充电的持续时间	秒 (sec)
补电时间	5	补电操作的持续时间	分钟 (min)

3. 任务参数

参数名称	默认值	说明
允许空闲车充电的最小任务数	0	当任务数量大于此值时，允许空闲车辆充电

4. 开关参数

参数名称	默认值	说明
允许中断充电任务	否	是否允许中断正在进行的充电任务
优先使用低电量车辆充电	是	优先选择电量较低的车辆进行充电
启用充电错误检测	否	是否启用充电过程中的错误检测
使用充电站点筛选	否	是否根据站点筛选充电桩

操作说明

保存配置

修改所需参数
点击 "保存" 按钮
系统会验证参数的有效性
验证通过后保存到配置文件

配置文件位置：Config/ChargeStrategyConfig.json

应用配置

点击 "应用" 按钮可以保存配置但不关闭窗口，方便继续调整参数。

恢复默认配置

点击 "恢复默认" 按钮
确认恢复操作
所有参数恢复为默认值
注意：恢复后需要点击"保存"才会生效

取消修改

点击 "取消" 按钮关闭窗口，不保存任何修改。

配置文件格式

配置以 JSON 格式保存，示例：

{
  "MustChargeSoc": 20.0,
  "IdleChargeSoc": 90.0,
  "TaskAvailableSoc": 60.0,
  "FullChargeSoc": 90.0,
  "AllowInterruptSoc": 45.0,
  "IdleChargeSeconds": 30.0,
  "IdleSeconds": 5.0,
  "MustChargeSeconds": 60.0,
  "TopUpMinutes": 5.0,
  "MinAllowFreeCarToChargeTaskCnt": 0,
  "AllowInterruptTask": false,
  "UseLowerSocForCharge": true,
  "EnableErrorChargeDetection": false,
  "UseChargeSiteFilter": false
}

参数验证规则

系统会在保存时自动验证配置的有效性：

SOC 参数验证

✅ 所有 SOC 值必须在 0-100 之间
✅ 必充电量 < 空闲充电电量
✅ 任务可用电量 > 必充电量
✅ 满电电量 ≥ 空闲充电电量
✅ 允许中断电量 > 必充电量

时间参数验证

✅ 所有时间值必须 ≥ 0

任务参数验证

✅ 最小任务数必须 ≥ 0

使用场景示例

场景 1：紧急任务模式

适用于任务紧急，需要快速周转车辆的情况。

必充电量: 15%
空闲充电电量: 80%
任务可用电量: 50%
满电电量: 85%
允许中断充电任务: 是

场景 2：节能模式

适用于任务不紧急，优先保证电池寿命的情况。

必充电量: 25%
空闲充电电量: 95%
任务可用电量: 70%
满电电量: 95%
允许中断充电任务: 否

场景 3：平衡模式（默认）

平衡任务效率和电池寿命。

必充电量: 20%
空闲充电电量: 90%
任务可用电量: 60%
满电电量: 90%
允许中断充电任务: 否

配置生效时机

立即生效：保存配置后立即生效
自动加载：系统启动时自动加载配置
实时更新：充电逻辑会实时读取最新配置

常见问题

Q1: 修改配置后没有生效？

检查项：

确认已点击"保存"按钮
检查状态栏是否显示"配置保存成功"
查看配置文件是否已更新

Q2: 配置文件丢失怎么办？

系统会自动创建默认配置文件，无需担心。

Q3: 如何备份配置？

配置文件位于 Config/ChargeStrategyConfig.json，直接复制此文件即可备份。

Q4: 参数验证失败怎么办？

根据错误提示调整参数，确保满足所有验证规则。

Q5: 可以手动编辑配置文件吗？

可以，但建议使用配置界面，因为界面会自动验证参数有效性。

技术细节

配置服务（单例模式）

var configService = ChargeStrategyConfigService.Instance;
var config = configService.LoadConfig();
configService.SaveConfig(config);

配置模型

public class ChargeStrategyConfig
{
    // SOC 参数
    public double MustChargeSoc { get; set; }
    public double IdleChargeSoc { get; set; }
    // ... 其他参数
    
    // 验证方法
    public bool Validate(out string errorMessage);
}

配置文件路径

Windows: 应用程序目录\Config\ChargeStrategyConfig.json
自动创建: 首次运行时自动创建配置目录和默认配置文件

界面布局

┌─────────────────────────────────────────────────────────┐
│                    充电策略配置                          │
├─────────────────────────────────────────────────────────┤
│ ┌─ SOC 参数 ─────────────────────────────────────────┐ │
│ │ 必充电量: [20.0] %    空闲充电电量: [90.0] %       │ │
│ │ 任务可用电量: [60.0] %  满电电量: [90.0] %        │ │
│ │ 允许中断电量: [45.0] %                            │ │
│ └───────────────────────────────────────────────────┘ │
│                                                         │
│ ┌─ 时间参数 ─────────────────────────────────────────┐ │
│ │ 空闲充电时间: [30.0] 秒  空闲时间: [5.0] 秒       │ │
│ │ 必充时间: [60.0] 秒  补电时间: [5.0] 分钟         │ │
│ └───────────────────────────────────────────────────┘ │
│                                                         │
│ ┌─ 任务参数 ─────────────────────────────────────────┐ │
│ │ 允许空闲车充电的最小任务数: [0]                   │ │
│ └───────────────────────────────────────────────────┘ │
│                                                         │
│ ┌─ 开关参数 ─────────────────────────────────────────┐ │
│ │ ☐ 允许中断充电任务    ☑ 优先使用低电量车辆充电    │ │
│ │ ☐ 启用充电错误检测    ☐ 使用充电站点筛选          │ │
│ └───────────────────────────────────────────────────┘ │
├─────────────────────────────────────────────────────────┤
│ 就绪...          [恢复默认] [保存] [应用] [取消]      │
└─────────────────────────────────────────────────────────┘

注意事项

⚠️ 参数调整建议：

不建议频繁修改配置
修改前建议备份当前配置
修改后观察系统运行情况
根据实际情况逐步调整参数

⚠️ 安全提示：

必充电量不宜设置过低（建议 ≥ 15%）
满电电量不宜设置过高（建议 ≤ 95%）
允许中断任务需谨慎开启

版本历史

v1.0 (2026-01-25): 初始版本，支持所有充电策略参数配置

提示：配置界面提供了完整的参数验证和默认值恢复功能，建议通过界面进行配置管理。

9.1 KiB Raw Blame History Unescape Escape