docs: 添加AnalyzeCommand使用指南并更新需求文档

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs/AnalyzeCommand使用指南.md

@@ -0,0 +1,238 @@
+# WCT DataAnalyzer 使用指南
+
+## 快速开始
+
+### 1. 准备日志文件
+
+将日志文件放入 `Datas` 文件夹（与 `Gpulse.WCT.DataAnalyzer.exe` 同级目录）：
+
+```
+Gpulse.WCT.DataAnalyzer.exe
+analyze.bat
+Datas/
+├── 奇瑞-E5-singleMold-A00-V001-iPhone15-无-ploss_test-2026081701.dat
+├── 奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701.log
+└── 奇瑞-E5-singleMold-A00-V001-iPhone15-硬币-qfod_foreign-2026081701.log
+```
+
+### 2. 运行分析
+
+双击 `analyze.bat`，自动执行：
+
+1. **Ploss 分析** - 批量分析所有日志文件
+2. **Qfod 标定** - 自动配对纯手机和异物日志
+
+```
+========================================
+  WCT DataAnalyzer 分析工具
+========================================
+
+[1/2] 执行 Ploss 分析...
+扫描 Datas 文件夹:
+  总计: 4 个日志文件
+  纯手机: 2 个
+  异物: 2 个
+
+=== Ploss 分析 ===
+[OK] Output\奇瑞\E5\iPhone15\奇瑞-E5-singleMold-A00-V001-iPhone15-无-ploss_test-2026081701.xlsx
+...
+
+[2/2] 执行 Qfod 标定...
+扫描 Datas 文件夹:
+  总计: 4 个日志文件
+  纯手机: 2 个
+  异物: 2 个
+
+=== Qfod 标定 ===
+[OK] Output\奇瑞\E5\iPhone15\奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701_qfod.xlsx
+...
+
+========================================
+  分析完成
+========================================
+
+输出目录: ...Output
+```
+
+---
+
+## 文件命名规范
+
+日志文件名格式：
+
+```
+车厂-车型-TX面板-TX硬件-TX软件-RX类型-异物类型-测试目的-年月日测试次数.扩展名
+```
+
+### 字段说明
+
+| 位置 | 字段 | 说明 | 示例 |
+|-----|------|------|------|
+| 1 | 车厂 | 制造商名称 | 奇瑞、比亚迪 |
+| 2 | 车型 | 车型代号 | E5、汉 |
+| 3 | TX面板 | 发射端面板类型 | singleMold |
+| 4 | TX硬件 | 发射端硬件版本 | A00 |
+| 5 | TX软件 | 发射端软件版本 | V001 |
+| 6 | RX类型 | 接收端类型（手机名） | iPhone15 |
+| **7** | **异物类型** | **区分纯手机/异物** | **无**=纯手机，**硬币**=异物 |
+| 8 | 测试目的 | 测试类型 | ploss_test、qfod_pure |
+| 9 | 日期序号 | yyyyMMddNN | 2026081701 |
+
+> **第9段约束**：必须为连续的 8 位日期（`yyyyMMdd`）+ 序号（至少 1 位整数），**日期与序号之间无分隔符**。
+> 正例：`2026081701`（2026-08-17，序号 01）、`202608172`（序号 2）。
+> 反例：`20260817-01`（含分隔符，会被 FileNameParser 拒绝）、`2026-08-1701`（含短横线）。
+
+### 异物类型（第7字段）
+
+- `无` → 纯手机日志
+- 其他值（如`硬币`、`钥匙`）→ 异物日志
+
+---
+
+## 分析类型
+
+### 1. Ploss 分析
+
+批量分析所有日志文件，生成 Excel 报告。
+
+**输出目录结构**：
+```
+Output/
+└── {车厂}/
+    └── {车型}/
+        └── {手机名}/
+            └── {原文件名}.xlsx
+```
+
+**示例**：
+```
+输入: Datas/奇瑞-E5-singleMold-A00-V001-iPhone15-无-ploss_test-2026081701.dat
+输出: Output/奇瑞/E5/iPhone15/奇瑞-E5-singleMold-A00-V001-iPhone15-无-ploss_test-2026081701.xlsx
+```
+
+**Excel 内容**：
+- 9 个功率段（350/500/750/1000/1250/1500/1750/2000/2250 W）
+- 每个功率段：理论Δp、VPA
+- 统计值：最大值、最小值、平均值、中位数、标定值
+
+---
+
+### 2. Qfod 标定
+
+自动配对纯手机日志和异物日志，计算标定阈值。
+
+**自动识别规则**：
+- 文件名第7字段 = `无` → 纯手机日志
+- 文件名第7字段 ≠ `无` → 异物日志
+
+**输出**：
+- 阈值计算：`Threshold = (纯手机ΔQ最大值 + 异物ΔQ最小值) / 2`
+- 统计值：ΔQ 绝对值的最大/最小/平均/中位数
+
+> **阈值与统计的量纲**：阈值使用**有符号 ΔQ**（纯手机为正、异物为负时阈值可为负，如样例 `Threshold: -22`）；
+> 统计行（Q最大/最小/平均/中位数）使用 **|ΔQ| 绝对值**。两者刻意不同，勿混用。
+
+---
+
+## 命令行用法
+
+除双击 `analyze.bat` 外，也可直接使用命令行：
+
+```bash
+# 自动扫描 Datas 文件夹并分析
+Gpulse.WCT.DataAnalyzer.exe analyze --type ploss --auto
+Gpulse.WCT.DataAnalyzer.exe analyze --type qfod --auto
+
+# 指定单个文件
+Gpulse.WCT.DataAnalyzer.exe analyze --type ploss --file "日志文件路径.dat"
+
+# 指定输出路径
+Gpulse.WCT.DataAnalyzer.exe analyze --type ploss --file "日志路径" --output "输出路径.xlsx"
+
+# Qfod 标定（指定纯手机和异物日志）
+Gpulse.WCT.DataAnalyzer.exe analyze --type qfod --pure "纯手机日志" --foreign "异物日志"
+```
+
+---
+
+## 输出示例
+
+### 默认输出文件名规则
+
+| 命令 | 默认输出名（未指定 `--output` 时） |
+|------|----------------------------------|
+| Ploss | `{原文件名}.xlsx`（如 `…-ploss_test-2026081701.xlsx`） |
+| Qfod | `{纯手机文件名}_qfod.xlsx`（如 `…-qfod_pure-2026081701_qfod.xlsx`，自动加 `_qfod` 后缀） |
+
+指定 `--output/-o` 时按用户给定路径输出（父目录不存在会自动创建）。
+
+### Ploss 分析
+
+```
+扫描 Datas 文件夹:
+  总计: 4 个日志文件
+  纯手机: 4 个
+  异物: 0 个
+
+=== 批量 Ploss 分析 ===
+
+Excel report saved to: Output\奇瑞\E5\iPhone15\奇瑞-E5-singleMold-A00-V001-iPhone15-无-ploss_test-2026081701.xlsx
+
+=== Ploss Analysis: 奇瑞-E5-singleMold-A00-V001-iPhone15-无-ploss_test-2026081701.dat ===
+Total: 35, Errors: 0
+Power segments found: 350, 500, 750
+
+[完成] 已分析 4 个文件
+```
+
+### Qfod 标定
+
+```
+扫描 Datas 文件夹:
+  总计: 4 个日志文件
+  纯手机: 2 个
+  异物: 2 个
+
+=== Qfod 标定 ===
+
+自动配对:
+  纯手机: 奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701.log
+  异物: 奇瑞-E5-singleMold-A00-V001-iPhone15-硬币-qfod_foreign-2026081701.log
+
+Excel report saved to: Output\奇瑞\E5\iPhone15\奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701_qfod.xlsx
+
+=== Qfod Calibration ===
+  Pure phone: 奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701.log
+  Foreign object: 奇瑞-E5-singleMold-A00-V001-iPhone15-硬币-qfod_foreign-2026081701.log
+  Threshold: -22
+  Pure margin: 27, Foreign margin: -27
+```
+
+---
+
+## 常见问题
+
+### Q: 没有生成 Excel 文件？
+
+检查：
+1. `Datas` 文件夹是否存在
+2. 日志文件扩展名是否为 `.DAT` 或 `.log`
+3. 日志文件格式是否正确
+
+### Q: Qfod 标定提示"未找到纯手机日志"？
+
+确保文件名第7字段为 `无`：
+```
+正确: 奇瑞-E5-singleMold-A00-V001-iPhone15-无-qfod_pure-2026081701.log
+错误: 奇瑞-E5-singleMold-A00-V001-iPhone15-硬币-qfod_pure-2026081701.log
+```
+
+### Q: Excel 文件在哪里？
+
+输出目录：`Output/{车厂}/{车型}/{手机名}/`
+
+---
+
+## 联系支持
+
+如有问题，请联系开发团队。