Battery CLI 工具使用说明

Battery CLI 是用于管理电池充电行为的命令行工具,支持状态查询、充电控制、电量维持、适配器电力控制、电池校准等功能。


1. 查看电池状态

命令

battery status

功能说明

输出当前电池的 SMC 状态、电量百分比以及剩余使用时间。


2. 维持电量(固定目标或区间)

固定维持至指定电量

命令

battery maintain LEVEL

  • LEVEL 取值范围:1–100

示例

battery maintain 80

说明

将电池维持在固定百分比,到达后自动停止充电。


设置电量维持区间

命令

battery maintain lower-upper

示例

battery maintain 70-80

说明

在电量下降至下限时开始充电,与达到上限时停止充电。


取消维持模式

命令

battery maintain stop


3. 控制电池充电功能

命令

battery charging SETTING

参数

  • on:启用充电
  • off:禁止充电

示例

battery charging off


4. 控制适配器输入电力

命令

battery adapter SETTING

参数

  • on:允许从适配器输入电力
  • off:禁止适配器供电

示例

battery adapter off


5. 执行电池校准

命令

battery calibrate

流程说明

  • 自动放电至 15%
  • 自动充电至 100%
  • 充至满电后保持 1 小时

用于校准传感器与电量估算精度。


6. 充电至指定电量后停止

命令

battery charge LEVEL

参数

  • LEVEL:1–100

示例

battery charge 90


7. 强制放电至指定电量

命令

battery discharge LEVEL

示例

battery discharge 90

说明

在电量下降到指定值前,禁止适配器提供电力。


8. 配置免 sudo 权限

命令

battery visudo

说明

配置系统权限,使运行 battery 命令无需 sudo。
安装脚本已自动执行,通常无需手动调用。


9. 更新工具

命令

battery update


10. 重新安装工具

命令

battery reinstall

说明

重新执行安装流程,用于修复异常。


11. 卸载工具

命令

battery uninstall

行为说明

  • 启用充电
  • 移除 smc 工具
  • 删除 battery 脚本