WCTDataMiner/docs/architecture/parser/Qfod解析器.md

Qfod 解析器

所属模块：解析器设计

---

1. 日志格式

格式： X#:Q A->B C D E

示例： 0#:Q 1->25 45.5 20.5 2

---

2. 字段定义

字段标识	字段名称	数据类型	取值范围	说明
X	ChargerIndex	byte	0, 1	充电器索引
A	CoilIndex	byte	0, 1, 2	线圈索引
B	DeltaQ	int	-	Q值变化量（ΔQ = CurrentQ - RawQ）
C	CurrentQ	float	-	当前实时Q值
D	RawQ	float	-	原始Q值
E	FodType	byte	见Table 2	异物类型编码

---

3. 正则表达式

// Parsers/QfodParser.cs
private static readonly Regex QfodPattern = new(
    @"^(\d)#:Q\s+(\d+)->(-?\d+)\s+([-\d.]+)\s+([-\d.]+)\s+(\d+)$",
    RegexOptions.Compiled
);

捕获组映射：

捕获组	字段	类型转换
Group 1	ChargerIndex	byte.Parse()
Group 2	CoilIndex	byte.Parse()
Group 3	DeltaQ	int.Parse()
Group 4	CurrentQ	float.Parse()
Group 5	RawQ	float.Parse()
Group 6	FodType	byte.Parse()

---

4. 解析器实现

// Parsers/QfodParser.cs
using System.Text.RegularExpressions;
using WCTDataMiner.Models;

namespace WCTDataMiner.Parsers;

public class QfodParser : IParser<QfodRecord>
{
    private static readonly Regex QfodPattern = new(
        @"^(\d)#:Q\s+(\d+)->(-?\d+)\s+([-\d.]+)\s+([-\d.]+)\s+(\d+)$",
        RegexOptions.Compiled
    );

    public bool CanParse(string line) => QfodPattern.IsMatch(line);

    public ParseResult<QfodRecord> Parse(string line, Guid scenarioId)
    {
        var match = QfodPattern.Match(line);
        if (!match.Success)
        {
            return ParseResult<QfodRecord>.Failure(
                "FORMAT_MISMATCH",
                "Line does not match Qfod pattern"
            );
        }

        try
        {
            var record = new QfodRecord
            {
                ScenarioId = scenarioId,
                ChargerIndex = byte.Parse(match.Groups[1].Value),
                CoilIndex = byte.Parse(match.Groups[2].Value),
                DeltaQ = int.Parse(match.Groups[3].Value),
                CurrentQ = float.Parse(match.Groups[4].Value),
                RawQ = float.Parse(match.Groups[5].Value),
                FodType = byte.Parse(match.Groups[6].Value)
            };

            return ParseResult<QfodRecord>.Success(record);
        }
        catch (Exception ex)
        {
            return ParseResult<QfodRecord>.Failure(
                "TYPE_CONVERSION",
                $"Failed to convert field: {ex.Message}"
            );
        }
    }
}

---

5. 检测通道组合

ChargerIndex + CoilIndex 组合唯一标识一个检测通道：

ChargerIndex	CoilIndex	检测通道
0	0	充电器0 线圈0
0	1	充电器0 线圈1
0	2	充电器0 线圈2
1	0	充电器1 线圈0
1	1	充电器1 线圈1
1	2	充电器1 线圈2