# 故障频率兼容性改动版本说明

日期：2026-11-05  
分支：`feature/fault-frequency`

## 代码与文档版本

| 仓库 | 本地提交 | 内容 |
|---|---|---|
| `zhzn/Analysis_Multi` | `f52dd15` | 故障频率服务、接口、振动报警兼容改动 |
| `zhzn/energy-manage-platform` | `f1a9c1d` | 数据库迁移 SQL、接口文档 |
| `zhzn/energy-manage-platform` | `869c3f8` | 数据库设计说明 |
| `zhzn/WTOAAM` | 基线 `637bdb2` | 本次未改动 |
| 前端 `frontEnd_HD` | 未纳入 Git | 源码按要求暂不提交；构建产物用于本地部署 |

## 数据库

已应用：

- `component_fault_spec`
- `measurement_point_component`
- `vibration_alarm_event` 新增：
  - `fault_type`
  - `characteristic_freq`
  - `fault_order`
  - `spec_source`
  - `diagnosis_detail`

迁移文件：

```text
docs/database/20261105_fault_frequency.sql
```

设计说明：

```text
docs/database/fault-frequency-design.md
```

## 接口

```text
GET /AnalysisMulti/fault-frequency/resolve
```

说明：

```text
docs/api/fault-frequency.md
```

## 前端

- 振动分析页新增“特征频率”入口；
- 新增部件特征频率弹窗；
- 前端源码未加入 Git；
- 当前 `dist` 构建时间：2026-11-05 13:26。

## 2026-11-05 诊断正确性整改

- 修正转速折算：删除七台河硬编码，按机型传动比和测点所在轴计算；
- 逐条校验采样率：低于 12800 Hz 返回状态 -1，不再整批抛错或误判正常；
- 诊断异常不再返回状态 0，改为未定义并返回原因；
- 增加 `meta`/`unsupported` 返回，前端显示部件参数、轴转速和采样率不足提示；
- 新增 `vibration_diagnosis_result` 诊断结果追溯表；
- 移除 `temperature.py` 中重复的 `/autodiag/{type}` 路由，统一走 `autodiag.py`；
- 修复诊断日志占位符导致的 logging error。

## 远程推送状态


Gogs 读操作正常，`git push` 返回：

```text
HTTP 500
send-pack: unexpected disconnect while reading sideband packet
```

本地提交已生成，但未能推送到 Gogs；需要仓库写权限/SGogs 服务端检查后再执行：

```bash
git push -u origin feature/fault-frequency
```