[REC] batt | [FEA] 增加 mac battery 模块：封装 macli battery 遥测与充电限制能力 | [mod=mac]

[edwinjhlee]

背景

macOS 上缺乏一个统一的命令行入口来做电池管理：

• macli battery（https://github.com/ljh-sh/macli）提供了非常详细的电池遥测 JSON/TSV：电量、健康度、电芯电压、内阻表、PD 适配器、生命周期数据等。
• 充电限制方面：
  • macOS 26.4+ 原生支持 80%–100% 可调（System Settings → Battery → 充电 → 充电上限）。
  • 旧版 macOS 或需要 <80% 时，要用 batt（Apple Silicon）或 bclm（Intel）等第三方工具。

提议

新增一个 x mac battery 模块，统一封装以上能力：

1. 状态查看：调用 macli battery，输出关键指标（healthPercent、cycleCount、temperature、cellVoltageDelta、raTableRaw 等）。
2. 充电限制设置：
   • macOS 26.4+：优先调用原生 API/System Settings 设置 80%–100%。
   • 旧系统 / Apple Silicon / 需要 <80%：自动检测并调用 batt。
   • Intel：检测并调用 bclm。
3. 常用工作流：
   • x mac battery status：一眼看健康与充电状态。
   • x mac battery limit 80：设上限。
   • x mac battery limit auto：根据插电时长建议最优上限。
   • x mac battery monitor：持续监控温度/功率/循环。

价值

• 用户不需要记多个工具（macli、batt、bclm、pmset）。
• 自动选择最合适的底层实现。
• 为 x-cmd 增加一个实用的 macOS 专属模块。

参考

• macli battery docs: https://ljh-sh.github.io/macli/battery
• batt: https://github.com/charlie0129/batt
• bclm: https://github.com/zackelia/bclm

[edwinjhlee]

这件事我得到了很多互相冲突的信号。我也想有一个好的方案让我的老 mac 用得更久一点 。 但显然我需要一个周末来查看实验使用。

[edwinjhlee]

https://github.com/charlie0129/batt#enabledisable-power-adapter

我认真地看了一下可能的实现，我意识到这个需求的实现有点昂贵，这种方案留给更专业或者有极致需求的 poweruser.

x-cmd 在这方面可以通过 x install batt 来提供一些支持。但大概率不会在 m battery 上提供支持 。