diff --git a/README.md b/README.md index 16a3285..b2aa77b 100644 --- a/README.md +++ b/README.md @@ -1,16 +1,53 @@ -# battery_health +# MEIZU Battery Healthy -A new Flutter project. +> 专机专配 · 仅针对魅族独家开发 -## Getting Started +一个简洁的手机电池健康度监测工具 +通过读取 BMS 日志(`/storage/emulated/0/mbattery_charger/`)直接获取电池真实数据 +不依赖系统 API 估算。 -This project is a starting point for a Flutter application. +--- -A few resources to get you started if this is your first Flutter project: +## 功能 -- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab) -- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook) +- 读取 BMS 日志,解析 `learned_cap`、`cycle`、`tbat`、`vbat` 等关键字段 +- 显示电池健康度(当前容量 / 设计容量) +- 显示循环次数、电压、温度(含当日极值) +- 近 15 天容量百分比趋势柱状图 +- 实时充电状态识别(有线 / 无线、PPS / SDP / EPP) +- 充电功率、电压、电流实时显示 +- 充电详情页(协议 / 功率 / 电压 / 电流 / 档位) -For help getting started with Flutter development, view the -[online documentation](https://docs.flutter.dev/), which offers tutorials, -samples, guidance on mobile development, and a full API reference. +--- + +## 当前状态 + +| 版本 | 主题 | 状态 | +| :--- | :--- | :--- | +| 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 \ No newline at end of file