BatteryRecorder

BatteryRecorder 是一款侧重低功耗与精准度的电池监测应用。它把 CPU 占用压得很低，同时完成功率数据采集和续航时长估算，适合日常观察，也适合需要深入调试设备功耗的用户。

产品定位与基础能力

· 主要做电池功率记录和剩余续航预测，采集过程对 CPU 的占用控制得比较克制。

· 参数可以按设备特性和个人习惯自定义，监测口径能调得更贴合实际使用。

· 图表提供原始功耗和趋势分析两种视图，既能看瞬时波动，也能观察长期耗电走向。

· 息屏状态下依然记录功耗，待机时的真实耗电情况也能被捕捉到。

服务启动方式

1. 先启动服务

BatteryRecorder 需要独立服务进程来完成数据采集。首页若还没有连接服务，按提示选择一种启动方式：

· Root 启动

· ADB 启动，推荐使用 nohup 版本

· App 启动，依赖无障碍服务

App 启动走系统 API，兼容性不错，但资源占用更高，后台存活也不稳定。Root 和 ADB 方式直接访问底层 API，开销更低，运行在特权进程中，不需要刻意保后台。只有在前两种方式都无法访问底层 API 时，才建议改用 App 启动。

2. 回首页确认记录状态

服务跑起来以后，首页会显示当前记录、充电总结或放电总结，以及续航预测卡片。充电状态下不会出现续航预测入口。

3. 需要提前确认的设置

进入设置页后，先检查两个分组：

· “常规”里的校准相关项目，对应校准说明。

· “预测”里的高负载 App 排除项，对应排除高负载 App。

前者关系到功率显示是否正常，后者影响续航预测的准确度。

校准入口与触发条件

1. 入口位置

设置页的“常规”分组里可以找到这些选项：

· 串联双电芯

· 放电也显示正值

· 电流单位校准

· 电池状态校准

2. 需要校准的情况

出现下面任意一种情况时，优先考虑校准：

· 第一次使用

· 功率数值明显不对

· 功率一直显示 0.00W

· 当前记录状态长期是“未知”或“未充电”

· 始终没有记录文件生成

3. 校准影响范围

电流校准改变的是 App 内功率换算的显示结果。如果显示口径不对，软件各项功能都会受影响。

状态校准影响记录器对电池状态的判断。判断错误时，可能出现一直不生成记录文件的情况。

4. 各选项说明

给双电芯设备做显示换算用。设备不是这种结构的话，不要随意开启。

只调整展示时的正负号，方便阅读，不改变采样逻辑。

会改变电流换算口径，进而影响功率数值。功率异常或显示 0.00W 时，可以试着调整这项来修正。

影响记录器对电池状态的判定。一直无记录文件，或状态长期显示“未知/未充电”时，可在异常持续期间通过这项修正。

核心功能一览

· 低开销精准记录：采用轻量采集机制，后台持续记录功率，对系统负载影响不大。

· 智能续航预测：结合实时功耗趋势和历史数据建模，动态估算剩余可用时间。

· 原始功耗曲线图：展示未经处理的瞬时功率波形，方便分析底层能耗特征。

· 趋势平滑图表：对原始数据做滤波处理，呈现长期变化趋势，整体耗电规律更直观。

· 自定义曲线显隐：按需开关数据图层，减少信息干扰，聚焦关键指标。

· 息屏功耗监测：专门记录关屏后的后台耗电，帮助识别异常的待机消耗。

· 精细化参数调校：开放采样频率、滤波系数等配置，适配不同机型和场景。

功能优势

· 低功耗设计让后台运行对续航的影响很小，避免监测本身成为额外耗电源。

· 续航预测基于实测数据动态校准，使用时间越长，估算越接近实际。

· 曲线显示可定制程度高，无关指标可以隐藏，坐标范围也能调整，关键信息更容易看清。

产品亮点

· 原始数据导出功能比较完整，进阶用户可以配合第三方工具做深入分析，或建立自己的设备功耗模型。

· 界面简洁，没有冗余广告，功能都围绕监测需求展开，操作路径清晰。

· 兼容主流安卓机型和系统版本，不依赖 root 也能拿到可靠的功率读数。

版本更新记录

记录器（Server）

· 适配“公平运行内存”机制。

· 适配 Android 10 至 17。

· 新增无障碍服务模式。

· 新增实时功耗悬浮窗。

· 新增充放电电量报警。

· 新增状态栏图标数据显示。

· 新增电池状态校准。

· 新增点击实时通知打开 App。

· 新增 Magisk 自启动模块。

· 新增“兼容设置”：轮询获取前台 App。

· 修复 HyperOS 打开通知崩溃、通知不显示等问题。

· 移除“批量大小”和“写入延迟设置”。

· 优化 OneUI / AOSP 系统下通知图标。

· 通知独立分组，避免与 Metric 通知折叠。

· 不再记录小窗 App。

查看器（App）

· 适配“公平运行内存”机制。

· 新增续航预测分数。

· 新增记录详情长截图设备信息。

· 新增 Alpha 版本更新检测。

· 新增更新检测时大陆加速。

· 新增 App 内置离线手册。

· 新增独立“兼容设置”页，包含：

· 轮询获取息屏状态，HyperOS / MagicOS / OriginOS 默认开启。

· 轮询获取前台 App，HyperOS 默认开启。

· 通知兼容模式，OriginOS 默认开启。

· 新增独立“关于”页，支持手动检查更新，加入开源许可声明。

· 新增独立“主题”设置页，包含预测性返回手势开关、多种主题、HDR 实时曲线。

· 新增充电时也可查看续航预测。

· 新增历史列表标记最近查看的记录。

· 新增历史记录备注。

· 新增手动重启服务按钮。

· 修复温度曲线 0 度以下被截断的问题。

· 优化首页统计、续航预测与息屏功耗统计算法。

通用

· 部分架构重构。

· 优化异常捕获与崩溃处理。