（综合版本：Mac v1.6.0 / 安卓 v1.5.2，更新至2025年5月）
一、AirBattery 项目概述
AirBattery 是一款跨平台设备电量管理工具，支持 macOS 与安卓系统，旨在集中显示苹果设备（如 iPhone、AirPods、Apple Watch）及兼容蓝牙耳机的实时电量信息。通过“Nearbility Engine”技术自动搜索设备，无需复杂配置即可在 Dock、状态栏或小组件中展示数据。其开源特性（AGPL-3.0 协议）与社区支持，确保了安全性与功能迭代的透明度。
二、核心功能与特点
1. 多设备兼容性
2. 显示模式多样化
3. 安全性与开源生态
三、系统要求与准备
Mac 版
安卓版
四、官方下载渠道与安全验证
1. Mac 版官方下载
bash
brew install lihaoyun6/tap/airbattery
优势：自动校验签名，避免文件损坏或篡改。
2. 安卓版官方下载
⚠️ 安全提示
五、Mac 版安装与配置教程
步骤 1：环境准备
1. 安装 Xcode：通过 App Store 下载后，运行 `xcode-select install` 激活命令行工具；
2. （可选）安装 Homebrew：
bash
/bin/bash -c "$(curl -fsSL )
步骤 2：选择安装方式
双击 `.dmg` 文件，拖拽至“应用程序”文件夹；首次启动需右键选择“打开”以绕过 macOS 安全限制。
bash
git clone
cd AirBattery
make install 自动执行依赖检测与编译
步骤 3：权限配置
六、安卓版安装与配对指南
步骤 1：安装与授权
1. 下载 APK 后点击安装，授予“位置权限”（BLE 功能必需）；
2. 启用“悬浮窗权限”以显示电量弹窗。
步骤 2：设备配对
1. 打开蓝牙并进入 AirBattery，选择耳机型号（如 AirPods Pro）；
2. 长按耳机充电盒按钮至白灯闪烁，完成配对；
3. 返回应用查看实时电量（精度为 10% 间隔）。
⚠️ 兼容性注意
七、进阶配置与故障排查
Mac 版自定义设置
常见问题解决
1. 设备未显示：
2. 频繁断连：
八、版本更新与社区支持
AirBattery 通过简洁的交互与开源生态，解决了多设备电量管理的痛点。遵循本指南从官方渠道下载并配置，可最大限度保障安全性与功能完整性。建议用户定期更新版本，并参与社区讨论以解锁更多高级功能。