# Walkthrough - Phase 2.5（可演示级 MVP）

Phase 2.5 将系统从“框架可跑”推进到“可演示、可做现场巡检”的状态，重点补齐真实算法、海试专属流程与异常聚合能力。

## 1) 真实水声算法库
实现于 `src/sample_algorithms.py`：
- `dc_removal_and_bandpass`: 去直流 + 带通滤波（含参数与短序列兜底）
- `stft_magnitude`: STFT 幅度谱
- `snr_estimation`: 简易 SNR 估计（dB）
- `quality_check`: 掉点/饱和巡检，输出 `quality_score` 等指标

对应元数据已更新至 `data/algorithms.json`（含中文描述与输入输出字段映射）。

## 2) 海试专属（⛴️ 一键质量巡检）
实现于 `main.py` 的“海试专属”页：
- 内置固定流程：去直流+带通 → 质量巡检 → SNR 估计
- 指标看板：SNR、最大幅值、质量得分
- 一键导出 `CSV` 报告

## 3) 异常中心（🚑）
实现于 `main.py` 的“异常中心”页：
- 聚合最近一次链路校验结果（字段/类型/维度/完整性/兼容性）
- 聚合最近一次执行结果（状态、错误信息、执行日志）
- 支持导出 `issue_bundle.json`
- 环境自检入口：`src/env_detect.py`

## 4) 加固项
- `src/bridges.py`: `normalize` 预处理算子增加除零与空数组保护
- `src/models.py`: 日志统一写入 UTC 时间戳

## 5) 验证
运行 `python tests/test_core.py` 覆盖：
- 基础链路集成测试
- 校验拦截（缺字段/类型/维度）
- 海试一键巡检链路（含真实算法调用）