docs: document fault frequency evidence and alarm linkage

docs/VERSION.md

@@ -67,6 +67,13 @@ docs/api/fault-frequency.md
 - 移除 `temperature.py` 中重复的 `/autodiag/{type}` 路由，统一走 `autodiag.py`；
 - 修复诊断日志占位符导致的 logging error。
 
+## 2026-11-05 峰值证据与报警联动
+
+- 新增 `/fault-frequency/evidence`：包络谱/速度谱峰值、谐波、相对基线；
+- 振动分析“特征频率”弹窗展示峰值证据表；
+- 批次报警对越限记录补充 `fault_type/characteristic_freq/fault_order/spec_source/diagnosis_detail`；
+- 诊断日志占位符和重复路由问题已修复。
+
 ## 远程推送状态
 
 

docs/api/fault-frequency.md

@@ -87,6 +87,40 @@ http://127.0.0.1:8888/fault-frequency/resolve
 3. `unit_bearings` / `unit_dynamo` / `unit_gearbox_structure` / `unit_gearbox_bearings` 提供具体部件品牌型号和齿数；
 4. `measurement_point_component` 提供测点与部件/位置映射。
 
+## 峰值证据接口
+
+```http
+GET /AnalysisMulti/fault-frequency/evidence
+```
+
+参数：
+
+| 参数 | 必填 | 说明 |
+|---|---|---|
+| `windCode` | 是 | 风场编号 |
+| `recordId` | 是 | 波形记录 ID |
+| `engineCode` | 是 | 风机编号 |
+| `pointName` | 是 | 测点英文键 |
+| `rpm` | 否 | 备用转速；优先使用波形记录中的转速 |
+| `millTypeCode` | 否 | 机型编号 |
+
+返回每条故障频率的：
+
+```json
+{
+  "faultType": "BPFO",
+  "targetFreq": 8.63,
+  "peakFreq": 8.3,
+  "peak": 0.000004,
+  "ratio": 5.36,
+  "method": "envelope",
+  "harmonics": [],
+  "status": "normal|watch|alarm"
+}
+```
+
+采样率低于 12800 Hz 返回 `supported=false`，不给出峰值结论。
+
 ## 约束
 
 - 缺参数时返回 `supported=false`，不生成频率、不参与故障判定；