# Qfod 标定分析（Q值 → 标定 ΔQ 阈值）

> 本文档单独记录 Qfod 标定分析的分析口径、阶段区分限制与交付方式。
> 内容独立于既有需求文档 `docs/requirement/WCT数据需求分析.md`，不与原文档合并。

---

## 1. 核心口径

Q 值由日志直接记录，日志格式 `X#:Q A->B C D E F`：

| 字段 | 名称 | 说明 |
|------|------|------|
| X | ChargerIndex | 充电器索引（0, 1） |
| A | CoilIndex | 线圈索引（0, 1, 2） |
| B | ΔQ (DeltaQ) | Q 值变化量 |
| C | CurrentQ | 当前 Q 值 |
| D | RawQ | 原始 Q 值 |
| E | FodType | 异物类型编码 |

**关键点**：「纯手机」与「手机+异物」分别对应**两个日志文件（两个测试场景）**：

- 日志文件 A：纯手机充电
- 日志文件 B：手机 + 异物

标定分析需**先区分这两个日志文件**，再计算标定 ΔQ 阈值。

---

## 2. 标定 ΔQ 阈值计算

1. 分别从两个日志文件提取 ΔQ：
   - 文件 A（纯手机）：取该文件 ΔQ **最大值**（示例：25）
   - 文件 B（手机+异物）：取该文件 ΔQ **最小值**（示例：40）
2. 计算标定阈值：`Threshold = (25 + 40) / 2 = 32`

---

## 3. 分析步骤

1. 提取日志中 `#Q` 开头的行
2. 绘制 ΔQ 时序曲线，叠加 Y=Threshold 水平线
3. 验证余量：纯手机最高点 vs 阈值、有异物最低点 vs 阈值

---

## 4. 文件区分方式（现状与后续计划）

### 4.1 当前限制

暂无可自动区分「纯手机」/「手机+异物」两个日志文件的可靠依据，因此**当前版本无法自动计算标定 ΔQ 阈值**。

### 4.2 后续计划

日志文件将写清楚所对应的场景（文件名 Purpose 段或文件内标记），届时据此区分两个文件再计算标定阈值。

**待办**：定义日志文件区分标识，解析时识别并关联配对的两个场景。

---

## 5. 交付方式

- 标定 ΔQ 阈值属**独立分析**，**不进入发布库聚合**（发布库现有 Q值/Q基值 列仍为 CurrentQ/RawQ 全量平均，保持不变）。
- 计划通过**新建 CLI 分析命令**（`analyze-qfod`）承载/输出，命令**尚未实现**。

---

## 6. 实测佐证

`data/test_input/singleMold-v1.0-hex2_1-iPhone15-qfod_test-20260710-1.log`（示例日志含 Phase 标记）：

| Phase | 含义 | ΔQ 范围 | FOD Type(E) |
|---|---|---|---|
| 1 正常充电 | 纯手机 | 20~30（均值 24.9） | 0 |
| 2 异物检测 | 手机+异物 | 35~55（均值 44.6） | 1/2/3 |
| 3 边界值 | 临界区 | 30~35（均值 32.5） | — |
| 4 负数 | 异常 | -25~0 | — |

> 说明：示例日志为生成的测试数据，仅作 ΔQ 数值区间的参考；真实数据中「纯手机」与「手机+异物」分属两个日志文件。