diff --git a/docs/环路线圈健康评估_第三方应用设计依据_V1.0.md b/docs/环路线圈健康评估_第三方应用设计依据_V1.0.md
new file mode 100644
index 0000000..2af1835
--- /dev/null
+++ b/docs/环路线圈健康评估_第三方应用设计依据_V1.0.md
@@ -0,0 +1,451 @@
+# 环路线圈健康评估 — 第三方应用设计依据
+
+> **文档版本**：V1.0
+> **编制日期**：2026-08-24
+> **编制依据**：FHWA《Traffic Detector Handbook: Third Edition》Vol.I (FHWA-HRT-06-108) / Vol.II (FHWA-HRT-06-139)、NEMA TS 2-2003、Carlo Gavazzi LDP 系列手册、3M US4449115 专利实测值、明尼苏达大学 CTS-09-06 实测
+> **适用对象**：小程序 / 平台应用等第三方应用，基于车检器上报数据对环路线圈进行**运行状态评估**（判定线圈是否正常）
+
+---
+
+## 1. 文档定位
+
+### 1.1 解决什么问题
+
+第三方应用（小程序、平台）拿到车检器上报的数据后，需要回答：
+
+1. **这个线圈现在是否正常？**
+2. **如果不正常，问题可能出在哪**（断线 / 短路 / 受潮 / 匝间击穿 / 引线过长 / 钢筋影响 / 灵敏度设置不当）？
+3. **用户输入线圈几何参数（长、宽、匝数）后，上报的频率、电感量是否在合理范围？**
+
+### 1.2 评估原理（一句话）
+
+车检器与线圈构成 **LC 振荡器**，车辆进入线圈导致电感下降 → 频率/周期偏移 → 检测器判定"有车"。
+因此，**线圈的电气参数（电感 L、谐振频率 f、品质因数 Q、电阻 R）直接决定检测性能**，
+通过比对"理论值 / 安装基线 / 实时上报值"三者的偏差，即可评估线圈健康状态。
+
+### 1.3 三类测量来源
+
+| 来源 | 获取方式 | 说明 |
+|---|---|---|
+| **A. 车检器自检上报** | 检测器固件周期性/事件性上报 | 频率、电感量、ΔL、ΔL/L、Q 值、基线漂移等 |
+| **B. 用户人工输入** | 小程序表单 | 线圈长、宽、匝数、引线长度、线规、埋深 |
+| **C. 现场仪表测量** | 万用表 / LCR 表 / 示波器 | 直流电阻、电感、Q 值、峰峰值、波形 |
+
+> 本设计文档以 **A+B 为主**（平台侧可自动完成），C 作为**深度诊断**手段。
+
+---
+
+## 2. 评估参数体系总览
+
+| 参数 | 符号 | 单位 | 上报/测量方式 | 健康判据核心 | 优先级 |
+|---|---|---|---|---|---|
+| 谐振频率 | f | kHz | 检测器上报 | 理论频率 ±10~20% | ★★★ |
+| 电感量 | L | μH | 检测器上报 / LCR 表 | 理论电感 ±20~30% | ★★★ |
+| 电感变化量 | ΔL | μH | 检测器上报 | 车型对应典型值区间 | ★★★ |
+| 灵敏度 | ΔL/L | % | 检测器上报 | ≥检测器阈值，车型对应区间 | ★★★ |
+| 品质因数 | Q | — | 检测器上报 / LCR 表 | 10~40（正常），<5 异常 | ★★ |
+| 直流电阻 | R_DC | Ω | 万用表 / 检测器 | 理论线阻 + 接头余量 | ★★ |
+| 振荡峰峰值 | Vpp | V | 示波器 / 检测器 | 以厂商规格为准 | ★ |
+| 基线漂移 | Δf_base | Hz | 检测器上报 | 短期 <0.1%，长期 <5% | ★★ |
+
+---
+
+## 3. 参数详解与判定标准
+
+### 3.1 电感量 L（最核心的"身份"参数）
+
+#### 3.1.1 理论值计算（用户输入长、宽、匝数）
+
+矩形环路电感工程计算（FHWA 附录 B 电流片公式 + 附录 C 查表）：
+
+```
+L_loop = F' × (μ₀ × N² × A) / l      (FHWA 式 2-6)
+```
+
+其中：μ₀ = 4π×10⁻⁷ H/m，N = 匝数，A = 环面积(m²)，l = 环周长(m)，F' = 非均匀磁通修正因子。
+
+**工程实用路径（推荐）**：直接使用 FHWA 附录 C 查表值（20 kHz 标准激励）：
+
+**表 3-1 FHWA 附录 C：矩形环圈电感与 Q 值（6×6 ft = 1.8×1.8 m，@20kHz）**
+
+| 线规 AWG | 1匝 L/Q | 2匝 L/Q | 3匝 L/Q | 4匝 L/Q | 5匝 L/Q |
+|---|---|---|---|---|---|
+| 12 | 10 μH / 20 | 35 μH / 30 | 73 μH / 37 | 123 μH / 43 | 184 μH / 47 |
+| 14 | 11 μH / 16 | 36 μH / 24 | 74 μH / 30 | 125 μH / 35 | 186 μH / 40 |
+| 16 | 11 μH / 12 | 37 μH / 18 | 75 μH / 23 | 126 μH / 28 | 188 μH / 31 |
+| 18 | 11 μH / 8 | 37 μH / 13 | 77 μH / — | — | — |
+
+> 典型值记忆：**6×6 ft 三匝 ≈ 74 μH**，是行业基准（FHWA、NEMA 测试均用此规格）。
+
+#### 3.1.2 引线电感叠加
+
+```
+L_total = L_loop + L_leadin
+L_leadin ≈ 21 μH / 100 ft (#14 AWG 双绞引线, FHWA 式 2-14 示例)
+```
+
+| 引线类型 | 电感 |
+|---|---|
+| #14 AWG 双绞引线 | ≈21 μH / 100 ft (30.5 m) |
+| Belden 8718 (12 AWG 屏蔽) | ≈0.20 μH/ft |
+
+#### 3.1.3 串并联组合
+
+- **串联**：L = L₁ + L₂（互感可忽略时）
+- **并联**：1/L = 1/L₁ + 1/L₂
+- ⚠️ 设计下限：并联后总电感 **不得低于 50 μH**（FHWA 明确要求），否则检测灵敏度不足
+
+#### 3.1.4 判定标准
+
+| 判定 | 条件（实测 vs 理论） | 可能原因 |
+|---|---|---|
+| ✅ 正常 | 偏差 ≤ ±20% | — |
+| ⚠️ 关注 | ±20% ~ ±30% | 埋深、钢筋网、温漂、匝间距变化 |
+| ❌ 异常 | > ±30% 或 < -30% | 断线（电感骤降）、匝间短路（骤降）、受潮（升高）、引线破损 |
+| 🚨 严重 | 电感为 0 或检测器报开路 | 断线 / 接线脱落 |
+
+> **边界说明**：钢筋网可使电感升高 5~15%（FHWA 表 2-8 实测），埋深增加使电感略升。
+> 因此**现场应以上报值与"安装基线"比对为主**，理论值作为第一道校验。
+
+---
+
+### 3.2 谐振频率 f（最易获取的实时参数）
+
+#### 3.2.1 理论频率
+
+LC 振荡器谐振频率（FHWA 式 2-46，Q ≥ 5 时成立）：
+
+```
+f = 1 / (2π × √(L_total × C_detector))
+```
+
+其中 C_detector 为检测器内部输入电容（**厂商参数，第三方不可知时用频率基线代替**）。
+
+**频率-电感对应关系**（假设检测器内部电容典型值 C = 25 nF）：
+
+| L_total (μH) | f (kHz) |
+|---|---|
+| 50 | 142 |
+| 74 | 117 |
+| 100 | 101 |
+| 150 | 82 |
+| 200 | 71 |
+| 300 | 58 |
+| 500 | 45 |
+| 1000 | 32 |
+
+> 行业常见检测器工作频率范围：**20 kHz ~ 200 kHz**（多数在 50~150 kHz）。
+> 若上报频率超出此范围，直接判"异常"。
+
+#### 3.2.2 频率与电感的换算关系（重要！）
+
+车检器检测的本质是**电感变化 → 频率变化**（FHWA 式 2-47）：
+
+```
+Δf / f = -(1/2) × (ΔL / L) = -(1/2) × S
+```
+
+**即：频率相对变化量 = 电感相对变化量的一半。**
+第三方应用如果拿到的是频率，可按此公式换算成等效电感变化用于评估。
+
+#### 3.2.3 判定标准
+
+| 判定 | 条件 | 可能原因 |
+|---|---|---|
+| ✅ 正常 | 频率在理论值 ±10%（或有基线时 vs 基线 ±10%） | — |
+| ⚠️ 关注 | ±10% ~ ±20% | 温漂、受潮、车辆长期停留基线自适应 |
+| ❌ 异常 | > ±20% 或超出 20~200 kHz 范围 | 匝间短路（频率升高）、断线（频率异常/停振）、引线破损 |
+| 🚨 停振 | 无频率上报 / 报 0 | 完全断线、检测器故障 |
+
+> **频率是现场最好用的快速判据**：断线→停振；匝间短路→频率显著升高（电感降）；受潮→频率缓慢漂移。
+
+---
+
+### 3.3 电感变化量 ΔL 与灵敏度 ΔL/L（检测能力判据）
+
+#### 3.3.1 定义
+
+```
+ΔL = L_无车 - L_有车        (μH，车辆进入后电感下降，ΔL 为负值取绝对值)
+S  = ΔL / L × 100%          (%)
+```
+
+车辆进入线圈，涡流效应主导 → 电感下降（铁磁效应次要，被覆盖）。
+
+#### 3.3.2 标准参考值（NEMA TS 2 / FHWA Vol.II 附录 J，6×6 ft 三匝 + 100 ft 引线）
+
+| 车辆类别 | ΔL/L (%) | ΔL (μH) | 评估意义 |
+|---|---|---|---|
+| Class 1 小型摩托车 | 0.13% | 0.12 | 接近多数检测器最低阈值，临界 |
+| Class 2 大型摩托车 | 0.32% | 0.30 | 可靠检测下限 |
+| Class 3 汽车（典型最小） | 3.2% | 3.0 | 信号极强 |
+| Class 3 汽车（最大响应） | 5.4% | 5.0 | 上限 |
+
+**3M 专利实测（US4449115，6 ft 方环 ≈70 μH）**：
+
+| 车型 | ΔL (μH) | ΔL/L |
+|---|---|---|
+| 汽车 | ~3.5 | ~5.0% |
+| 小型摩托车 | ~0.07 | ~0.10% |
+| 自行车 | ~0.015 | ~0.02% |
+
+#### 3.3.3 检测器灵敏度阈值
+
+- 多数数字检测器可响应 **0.02%** 以上电感变化
+- 常见可调灵敏度范围：**0.01% ~ 1.28%**
+- NEMA 要求：灵敏度设置 2 档（presence 模式）应有可靠检测能力
+
+#### 3.3.4 判定标准
+
+| 判定 | 条件 | 可能原因 |
+|---|---|---|
+| ✅ 正常 | 轿车场景 S ≥ 1%；摩托车场景 S ≥ 0.1% | — |
+| ⚠️ 关注 | 轿车 S 在 0.3~1% | 高底盘车、灵敏度档位偏低、引线过长稀释 |
+| ❌ 异常 | 轿车 S < 0.3%；或全部车型无法触发 | 线圈尺寸与车型不匹配、灵敏度设置过低、引线过长、钢筋影响、线圈受潮 |
+| ❌ 异常（反向） | ΔL 为正（电感升高） | 铁磁效应异常主导（罕见），或检测器判据配置错误 |
+
+> **引线稀释公式**（FHWA）：系统灵敏度 S_P = S_L × L_L / (L_L + L_S)。
+> 引线电感 L_S 越大，检测灵敏度越低——200 ft (60 m) 引线可使 6×2 ft 小线圈灵敏度下降 50%+。
+
+---
+
+### 3.4 品质因数 Q（线圈"健康度"的电气指标）
+
+#### 3.4.1 定义与计算
+
+```
+Q = 2πfL / R  ≈ ω₀L / R
+```
+
+FHWA 图 2-7 完整算例（3 匝 6×6 ft + 100 ft Belden 8718 引线，20 kHz）：
+
+```
+L_total = 74 + 20 = 94 μH
+R_total = 0.25 Ω(环) + 0.62 Ω(引线) = 0.87 Ω
+Q₀(空载) = √(L/(R²C)) - 1 ≈ 13.5
+Q_L(加载1kΩ并联) ≈ 11.7
+```
+
+#### 3.4.2 典型 Q 值范围
+
+| 条件 | Q 值 |
+|---|---|
+| 短引线环路（20 kHz） | 20 ~ 40 |
+| 长引线环路（100 ft） | 10 ~ 20 |
+| 埋设后（受地面/钢筋损耗） | 8 ~ 15 |
+| **Q < 5** | 🚨 频率公式失效，检测性能严重劣化 |
+
+> 注意：**Q 值随频率变化**（附录 C 表给出 1/20/40/60 kHz 四档），评估时须按工作频率对应。
+
+#### 3.4.3 判定标准
+
+| 判定 | Q 值 | 可能原因 |
+|---|---|---|
+| ✅ 正常 | ≥ 10 | — |
+| ⚠️ 关注 | 5 ~ 10 | 引线过长、埋设损耗大、受潮 |
+| ❌ 异常 | < 5 | 匝间短路、严重受潮、屏蔽层破损接地、接头氧化 |
+
+---
+
+### 3.5 直流电阻 R_DC（现场万用表可测）
+
+#### 3.5.1 理论线阻（FHWA 表 2-1）
+
+| 电缆 | 用途 | 线规 AWG | DC 电阻 |
+|---|---|---|---|
+| Belden 9438 | 环路线 | 14 | 0.0025 Ω/ft (0.0083 Ω/m) |
+| Belden 8718 | 引线 | 12 | 0.0019 Ω/ft |
+| Belden 8720 | 引线 | 14 | 0.0029 Ω/ft |
+| Belden 8719 | 引线 | 16 | 0.0045 Ω/ft |
+
+**估算公式**：R_DC ≈ 环线长(m) × 0.0083 Ω/m（#14 单导体）× 2（往返）+ 引线长 × 单位电阻 × 2
+
+**算例**：6×6 ft(1.8×1.8 m) 三匝 #14，周长 7.2 m × 3 匝 = 21.6 m
+→ R_环 ≈ 21.6 × 0.0083 × 2 ≈ 0.36 Ω；加 100 ft 引线(0.62 Ω) ≈ **1.0 Ω 总量级**
+
+#### 3.5.2 判定标准
+
+| 判定 | 条件 | 可能原因 |
+|---|---|---|
+| ✅ 正常 | 实测 ≈ 理论线阻（±50% 内） | — |
+| ⚠️ 关注 | 偏高 50% ~ 2 倍 | 接头氧化、线缆受损、受潮 |
+| ❌ 异常 | > 2 倍理论值 或 < 理论值 30% | 接头严重氧化/虚接（偏高）、匝间短路（偏低） |
+| 🚨 开路 | ∞ | 断线 |
+
+> ⚠️ **注意**：万用表测的是 DC 电阻；环路工作在 20~150 kHz 时因趋肤效应交流电阻更高，
+> 且**高频下不能简单用 DC 电阻算 Q**，须用 LCR 表在对应频率测（FHWA 附录 D 说明）。
+
+---
+
+### 3.6 振荡峰峰值 Vpp（需示波器/检测器支持，深度诊断用）
+
+#### 3.6.1 行业参考（非强制标准）
+
+| 参数 | 典型范围 | 说明 |
+|---|---|---|
+| 环路激励电流 | 数十 mA 量级 | 检测器恒流激励 |
+| 振荡峰峰值 | 2 ~ 15 Vpp（多数 5~10 Vpp） | 视检测器设计 |
+| 波形 | 正弦波 | 若严重削顶/失真 → 异常 |
+
+> ⚠️ **此参数无 FHWA 统一标准，完全取决于检测器硬件设计**。
+> 第三方应用若支持该参数评估，**必须接入厂商规格表**，不能套用通用阈值。
+> 建议：检测器固件直接上报"激励电压是否在自检正常范围"这一布尔量，而非原始 Vpp。
+
+#### 3.6.2 判定逻辑（有厂商规格时）
+
+```
+Vpp 在 [厂商下限, 厂商上限]      → ✅ 正常
+Vpp < 厂商下限                   → ⚠️ 线圈负载过重 / 匝间短路 / 引线过长 / Q 过低
+Vpp > 厂商上限                   → ⚠️ 线圈开路 / 接触不良（振荡器空载）
+```
+
+---
+
+### 3.7 基线漂移（长期健康监测的关键）
+
+#### 3.7.1 机理
+
+- **温漂**：线圈电感温度系数，铜线约 +0.4%/100℃（电阻），电感随温度缓慢变化
+- **受潮**：水进入槽缝/接线盒 → 电容、损耗变化 → 频率缓慢漂移
+- **车辆长期停留**：检测器自动基线跟踪会"忘记"该车（自动复位功能），属正常
+
+#### 3.7.2 判定标准
+
+| 判定 | 条件 | 可能原因 |
+|---|---|---|
+| ✅ 正常 | 短期（分钟级）漂移 < 0.1%；日内漂移 < 1~2% | 正常温漂 |
+| ⚠️ 关注 | 日漂移 2~5% 且持续单向 | 受潮、环境干扰、电缆破损 |
+| ❌ 异常 | 日漂移 > 5% 或阶跃突变 > 5% | 进水短路、断线、电磁干扰（变频器等） |
+| 🚨 突变 | 频率瞬间跳变后不回 | 线缆被压断/剪断、接头脱落 |
+
+---
+
+## 4. 第三方应用评估流程设计
+
+### 4.1 输入参数采集
+
+**用户输入（表单）**：
+
+| 字段 | 必填 | 校验 |
+|---|---|---|
+| 线圈长 (m) | ✅ | 0.3 ~ 10 |
+| 线圈宽 (m) | ✅ | 0.3 ~ 5 |
+| 匝数 | ✅ | 1 ~ 10 |
+| 线规 AWG | 推荐 | 12/14/16/18 |
+| 引线长度 (m) | 推荐 | 0 ~ 500 |
+| 埋深 (cm) | 可选 | 3 ~ 10 |
+
+**车检器上报（自动）**：频率、电感量、ΔL、ΔL/L、Q（如有）、基线、车辆事件
+
+### 4.2 评估计算流程
+
+```
+输入：长 W、宽 L、匝数 N、引线长
+ │
+ ├─ Step 1: 计算理论电感 L_theory
+ │    ├─ 查 FHWA 附录 C 表（6×6ft 基准 × 面积比修正）
+ │    └─ 或电流片公式直接计算
+ │
+ ├─ Step 2: 叠加引线电感 L_leadin（21μH/100ft）
+ │    → L_expected = L_theory + L_leadin
+ │
+ ├─ Step 3: 计算理论频率范围 f_expected
+ │    ├─ 若已知检测器内部电容 C：f = 1/(2π√(LC))
+ │    └─ 否则用 20~200kHz 行业范围 + 基线
+ │
+ ├─ Step 4: 对比上报值
+ │    ├─ 频率偏差 ≤10% → ✅
+ │    ├─ 10~20% → ⚠️
+ │    └─ >20% → ❌（转诊断）
+ │
+ ├─ Step 5: 检测能力评估（有车辆事件时）
+ │    ├─ 计算 ΔL/L，对照车型区间表
+ │    └─ 低于阈值 → 提示灵敏度/匹配问题
+ │
+ └─ Step 6: 输出评估报告
+      ├─ 综合评级：正常 / 关注 / 异常 / 严重
+      ├─ 各参数明细 + 理论值/实测值对比表
+      └─ 疑似故障原因 + 处理建议
+```
+
+### 4.3 综合评级规则
+
+| 综合评级 | 规则 |
+|---|---|
+| ✅ 正常 | 所有 ★★★ 参数正常，无 ★★ 异常 |
+| ⚠️ 关注 | ≥1 个参数"关注"，无"异常" |
+| ❌ 异常 | ≥1 个 ★★★ 参数"异常" |
+| 🚨 严重 | 开路 / 停振 / 电感为 0 / 断线特征 |
+
+---
+
+## 5. 故障特征速查表（反向诊断）
+
+| 故障现象 | 频率 | 电感 | ΔL/L | Q | R_DC | 峰峰值 |
+|---|---|---|---|---|---|---|
+| **完全断线** | 停振/0 | 0/开路 | 无事件 | 0 | ∞ | 0 或极高 |
+| **匝间短路** | ↑ 显著升高 | ↓ 显著下降 | ↓ | ↓ | ↓ | ↓ |
+| **受潮/进水** | ↓ 缓慢漂移 | ↑ 缓慢升高 | ↓ | ↓ | ↑ | ↓ |
+| **接头氧化** | 不稳定 | 微变 | ↓ | ↓ | ↑ | ↓ |
+| **引线过长** | ↓（电容效应） | ↑（引线电感） | ↓ 稀释 | ↓ | ↑ | ↓ |
+| **钢筋网影响** | ↓ | ↑ | ↓ | ↓ | 不变 | 不变 |
+| **变频器干扰** | 抖动/突变 | 抖动 | 误触发 | 波动 | 不变 | 波动 |
+| **车辆长时间停留** | 基线自适应回落 | 正常 | 事件丢失 | 正常 | 正常 | 正常 |
+
+---
+
+## 6. 参考数据附录
+
+### 6.1 FHWA 附录 C 完整表（矩形环圈 @20kHz，6×6 ft）
+
+见 3.1.1 表 3-1。其余频率档（1/40/60 kHz）及四极/圆环表见手册原文附录 C。
+
+### 6.2 中国工程实践典型值
+
+| 场景 | 线圈尺寸 | 匝数 | 总电感估算 | 来源 |
+|---|---|---|---|---|
+| 标准车位/小车 | 1.0×2.0 m | 5~7 | 150~250 μH | 苏江/德立达 |
+| 一般车道 | 2.4~2.8 × 0.6 m | 5~6 | ≈180 μH | 苏江 |
+| 一般大车 | 1.5×3.0 m | 4~5 | 200~300 μH | 苏江 |
+| 超大车辆 | 1.8×3.0 m 或 8 字形 | 4~5 | 250~350 μH | 苏江 |
+
+### 6.3 检测器通用规格参考
+
+| 参数 | 典型值 | 来源 |
+|---|---|---|
+| 输入电感范围 | 20 ~ 1000 μH | Carlo Gavazzi LDP 系列 |
+| 可调灵敏度 | 0.01% ~ 1.00%（10 档） | Carlo Gavazzi |
+| 工作频率 | 20 ~ 200 kHz | 行业通用 |
+| 并联电感下限 | ≥50 μH | FHWA |
+
+### 6.4 灵敏度与频率换算
+
+```
+Δf/f = -(1/2) × (ΔL/L)     (FHWA 式 2-47, Q≥5)
+```
+
+---
+
+## 7. 待厂商确认项（本设计文档的开放边界）
+
+| 项目 | 原因 | 建议 |
+|---|---|---|
+| 检测器内部电容 C | 决定 f-L 对应关系 | 厂商提供规格；否则用基线法 |
+| 振荡峰峰值范围 | 硬件设计相关，无行业标准 | 厂商提供自检布尔量代替原始值 |
+| Q 值上报方式 | 部分检测器不上报 | 无 Q 上报时用 R_DC + 频率间接评估 |
+| 灵敏度档位定义 | 各厂商档位含义不同 | 评估时用百分比阈值，不依赖档位号 |
+| 基线自适应策略 | 影响长期漂移判定 | 需厂商说明自动复位/跟踪时间常数 |
+
+---
+
+## 8. 版本记录
+
+| 版本 | 日期 | 修订内容 |
+|---|---|---|
+| V1.0 | 2026-08-24 | 初稿：基于 FHWA/NEMA 权威数据建立评估参数体系、判定标准、评估流程 |
+
+---
+
+*编制说明：本文档中所有公式与数据均标注来源，优先引用 FHWA 手册、NEMA TS 2 等权威标准；
+涉及硬件厂商特定参数（峰峰值、内部电容、Q 上报）处已明确标注"待厂商确认"。
+现场环境（埋深、钢筋、温漂）影响大，最终判定应以"实测 vs 安装基线"为准，理论值作为首道校验。*