对于 云栈社区 的 Mac 玩家来说，苹果全家桶的电量查看一直很割裂：iPhone 需要解锁下拉，AirPods 得开盖，Apple Watch 要抬腕，键鼠还得翻蓝牙设置。AirBattery 可以把这些设备电量统一收进 Mac 的 状态栏 / Dock / 桌面小组件，零配置自动发现、隔空读取。
注意：网上同名“AirBattery”还有 Android 端 AirPods 弹窗工具（airbattery.de），下面只讲 Mac 版 lihaoyun6/AirBattery。
一、项目定位
- 平台：仅 macOS 11.0（Big Sur）及以上
- 协议：AGPL-3.0 开源
- 原版仓库：github.com/lihaoyun6/AirBattery（TechThings 镜像同名）
- 核心痛点：苹果设备电量太分散——iPhone 要解锁下拉、AirPods 要开盖、Watch 要抬腕、键鼠藏在蓝牙设置里；AirBattery 让 Mac 成为“全家桶电量仪表盘”
二、支持设备与数据来源
1. 支持范围
- 本机 Mac / MacBook
- iPhone / iPad（含蜂窝版）
- Apple Watch（通过配对 iPhone 中继）
- AirPods / Beats 等耳机
- 妙控键盘、妙控板、Magic Mouse 等蓝牙外设
- 其他局域网 Mac（Nearcast 功能）
- Apple Pencil（实验功能，解析 iPad 系统日志，默认关）
2. 电量获取路径
- 蓝牙外设：抓广播包解析电量，需蓝牙权限
- iPhone / iPad：基于 libimobiledevice 通信，首次数据线信任配对，之后走局域网
- Apple Watch：iPhone 走 WiFi / USB 被发现时自动中继，纯蓝牙发现 iPhone 读不到手表
- 局域网多 Mac：MultipeerKit 近场通信（Nearcast）
- 蜂窝设备离线：v1.1.2+ 可开“iPhone / iPad(Cellular) over BT”纯蓝牙读
三、主要功能
- 状态栏图标：可切换“系统风格实时电量图标 + 百分比”
- Dock 菜单 / 状态栏下拉：设备列表、充电状态、左右耳 / 充电盒分列
- 桌面小组件：Small / Medium / Large，多设备聚合
- Nearcast：查看同局域网其他 Mac 及其外设电量
- 低电量提醒：可设阈值，比如低于 20% 弹通知
- 设备隐藏 / 显示：临时不关心的设备可屏蔽
- 自动更新：基于 Sparkle 框架
四、安装部署
方式一：Homebrew（推荐）
brew install lihaoyun6/tap/airbattery
装完在“应用程序”里打开。
方式二：下载 DMG 手动装
- 打开 Releases 页：github.com/lihaoyun6/AirBattery/releases/latest
- 下载
.dmg → 拖进“应用程序”
- 首次打开若报证书 / 恶意软件提示：
- 系统设置 → 隐私与安全性 → 仍要打开
- 或终端执行：
xattr -dr com.apple.quarantine /Applications/AirBattery.app
方式三：源码编译（开发者）
依赖：Xcode 13+、macOS SDK、Swift 包管理
git clone https://github.com/lihaoyun6/AirBattery.git
cd AirBattery
open AirBattery.xcodeproj
# Xcode 里选目标 AirBattery，编译运行
内部用 libimobiledevice 可执行文件、MultipeerKit，不需要你手动装依赖，Xcode 工程已带 Helper / widget / abt 命令行工具。
五、首次配置流程
-
启动 AirBattery
- 默认同时显示 Dock 图标 + 状态栏图标
- 设置里可改为：仅 Dock / 仅状态栏 / 都关，只靠小组件
-
授权权限
- 蓝牙：必须，用于抓取外设广播
- 本地网络：必须，用于发现局域网设备
- 通知：可选，用于低电量提醒
-
iPhone / iPad 首次配对（关键）
- 数据线连接 Mac
- 手机点“信任此电脑”并输入锁屏密码
- AirBattery 运行时完成一次配对
- 之后同局域网自动出现，不用再插线
-
Apple Watch
- 不用单独配对，iPhone 在 WiFi / USB 下被发现即自动读取手表电量
-
蜂窝 iPhone 没 WiFi 时
- 设置 → 打开
iPhone / iPad(Cellular) over BT → 保持蓝牙开启
六、使用技巧
- 状态栏图标改“实时电量”：偏好设置 → 状态栏样式 → 系统电池图标
- 隐藏设备：菜单里右键，或在设置里隐藏临时不看的设备
- ⚠️ 图标含义：超过 10 分钟没刷新，可能离线或关机
- 低电量通知：给常用设备设 15%～20% 阈值
- 多 Mac 场景：都装 AirBattery，通过 Nearcast 互看外设电量
- 小组件：桌面放“8 合 1”聚合卡，一眼扫完全家桶
七、常见坑位
- iPhone 不显示：没数据线配对过 / 没信任 / 不在同一网络
- Watch 不显示：iPhone 是纯蓝牙发现的（非 WiFi / USB），读不到手表
- 蓝牙权限弹了还空：检查设置 → 隐私与安全性 → 蓝牙，确认 AirBattery 在列表
- 局域网发现不到：Mac 防火墙挡了本地网络，或不在同一 VLAN
- 证书拦截：从非官方渠道下载的 dmg 别装，只用 GitHub Releases 或 Homebrew
- AGPL 注意：改源码分发或做联网服务，需开源对应修改
八、资源占用与适用边界
- 轻量：菜单栏常驻，后台近场扫描，日常无感
- 适用：Mac 用户、苹果全家桶、开发者 / 运维桌面、不想逐台解锁看电量
- 不适用：Windows / Linux 用户；不愿做首次数据线配对的人
- 隐私：纯本地运行，不走云端，蓝牙 / 局域网数据不对外传
九、相关链接
一句话总结：
Mac 上 brew install 装好 → 授权蓝牙 / 网络 → iPhone 插线信任一次 → 状态栏点开，全家苹果设备电量全在眼里，装完基本不用管。 | 
发表于 1 小时前
|
查看: 2|
回复: 0
/1 
