# MEIZU Battery Healthy

> 专机专配 · 仅针对魅族独家开发

一个简洁的手机电池健康度监测工具
通过读取 BMS 日志（`/storage/emulated/0/mbattery_charger/`）直接获取电池真实数据
不依赖系统 API 估算。

---

## 功能

- 读取 BMS 日志，解析 `learned_cap`、`cycle`、`tbat`、`vbat` 等关键字段
- 显示电池健康度（当前容量 / 设计容量）
- 显示循环次数、电压、温度（含当日极值）
- 近 15 天容量百分比趋势柱状图
- 实时充电状态识别（有线 / 无线、PPS / SDP / EPP）
- 充电功率、电压、电流实时显示
- 充电详情页（协议 / 功率 / 电压 / 电流 / 档位）

---

## 当前状态

| 版本 | 主题 | 状态 |
| :--- | :--- | :--- |
| 1.2.0 | UTC 时区基础修正 | ✅ 已发布 |
| 1.3.0 | 时间窗口 + real_type 优先级 | 🚀 测试中 |
| 1.4.0 | SAF 权限改造 | 📋 规划中 |
| 1.5.0 | 功率计算优化 | 📋 规划中 |
| 2.0.0 | 数据看板扩展（月/季/年趋势） | 📋 远景 |

---

## 环境要求

- Flutter SDK: ^3.9.2
- Android: 8.0+ (API 26+)
- 仅支持魅族手机（15 系列 ~ 25 系列）

---

## 如果需要基于此源代码构建

```bash
# 拉取依赖
flutter pub get

# Debug 版本
flutter run

# Release APK
flutter build apk --release