MEIZU-Battery-Healthy/README.md

MEIZU Battery Healthy

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

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

---

功能

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

---

当前状态

版本	主题	状态
1.5.0	功率计算优化	✅ 已发布
1.5.2	部分场景字体替换	✅ 已发布
1.6.0	更新日志独立页面	📋近期开发
1.7.0	适配夜间模式	📋近期开发
2.0.0	数据看板月份显示扩展等系列更新	📋 远景
3.0.0	搭配PC上位机记录充电信息等	📋 远景

---

环境要求

• Flutter SDK: ^3.9.2
• Android: 8.0+ (API 26+)

---

机型匹配情况

目前据群友反馈已知：

• 魅族22无mbattery_charger目录生成，无法实时计算相应百分比，因此已在最近版本去除相关匹配信息
• 魅族18在后续的版本中关闭了mbattery_log生成，疑似无效，老版本可能支持
• 最完美的支持版本至少可覆盖魅族20/21系机型（20inf已确认，机型匹配ID已更新）

---

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

# 拉取依赖
flutter pub get

# Debug 版本
flutter run --debug

# Release APK
flutter build apk --release --target-platform android-arm64