Battery Toolkit 使用与安装指南

项目概述

Battery Toolkit 是专为苹果Silicon芯片设计的macOS应用程序，提供对平台电源状态的精细控制。该项目通过菜单栏额外项和命令菜单，让用户能够手动控制Mac的电池充电状态，设定充电上限阈值，以及管理电源适配器的启用和禁用。

系统要求

• 仅支持Apple Silicon芯片的Mac设备
• 需要macOS Ventura或更高版本
• 需要关闭系统的"优化电池充电"功能以避免冲突

安装方法

手动安装

1. 从GitHub releases页面下载最新版本的Battery Toolkit应用包
2. 解压缩下载的ZIP文件
3. 将"Battery Toolkit.app"拖拽到应用程序文件夹中

Homebrew安装

1. 确保已安装Homebrew包管理器
2. 在终端中运行：brew tap mhaeuser/mhaeuser
3. 运行：brew install battery-toolkit

应用启动

由于应用未经过苹果公证，需要按以下步骤启动：

macOS 14 Sonoma及以下版本：

1. 右键点击Battery Toolkit.app
2. 选择"打开"
3. 在对话框中点击"打开"

macOS 15 Sequoia及以上版本：

1. 尝试打开应用，系统会提示应用被阻止
2. 进入系统设置 > 隐私与安全
3. 滚动到底部点击"仍要打开"
4. 在下一个对话框中验证身份
5. 从应用程序文件夹再次打开Battery Toolkit

核心功能

电池充电上限限制

允许设置电池充电的上限阈值（最低50%），防止电池长期处于满电状态而加速老化。

电池放电下限限制

设置充电重新启动的下限阈值（最低20%），避免频繁的短时充电对电池造成损害。

电源适配器控制

可以禁用电源适配器而不需要物理拔掉电源线，便于电池放电校准。

手动控制命令

通过菜单栏提供丰富的控制命令：

• 启用/禁用电源适配器
• 请求完全充电
• 充电至指定上限
• 立即停止充电
• 暂停所有后台活动

图1：电源设置界面

图2：菜单栏额外项显示充电状态

使用说明

1. 打开Battery Toolkit应用程序
2. 菜单栏会显示应用菜单和额外状态项
3. 通过主菜单或设置对话框配置参数
4. 可以使用命令菜单快速执行电源管理操作

应用支持后台运行，即使关闭GUI界面，Battery Toolkit仍会在后台继续工作。需要更改设置时，只需重新打开应用即可。

图3：应用主菜单界面

图4：菜单栏命令选项

技术特点

• 基于IOPowerManagement事件，最大限度减少资源使用
• 支持macOS Ventura的守护进程和登录项机制
• 采用XPC通信确保安全性
• 特权操作通过守护进程进行身份验证

卸载方法

1. 聚焦Battery Toolkit应用
2. 打开主菜单选择"禁用后台活动"
3. 将应用移至废纸篓并清空

注意事项

• 使用前务必关闭系统的"优化电池充电"功能
• 应用在充电期间会禁用睡眠功能
• 关机状态下无法控制充电状态
• 禁用电源适配器时建议同时禁用睡眠以避免立即休眠

项目结构

Battery Toolkit采用模块化设计，主要包含：

• BatteryToolkit: 应用核心逻辑和用户界面
• BatteryToolkitService: 系统服务组件处理特权操作
• 守护进程: 执行需要权限的操作
• 通用模块: 共享代码和协议定义
• 资源文件: 图标和本地化资源

该项目为苹果Silicon Mac用户提供了精细的电源管理能力，帮助延长电池寿命并提供更好的使用体验。