告别突然断电：Mac Mouse Fix低电量通知完全自定义指南

你是否经历过无线鼠标突然断电导致工作中断的尴尬？Mac Mouse Fix提供了灵活的低电量通知系统，让你可以提前掌握电池状态。本文将详解如何通过App/UI/Notifications/AlertCreator.h和Helper/Utility/模块提供的功能，打造个性化的低电量提醒方案。

通知系统工作原理

Mac Mouse Fix的低电量监测基于内核级设备事件监听，通过Helper/Core/Buttons/模块实时跟踪鼠标电池状态。当电量低于阈值时，系统会触发AlertCreator.m中的showPersistenNotificationWithTitle:markdownBody:maxWidth:stayOnTop:asSheet:方法，该方法通过NSAlert子类MFAlert实现置顶通知功能：

+ (void)showPersistenNotificationWithTitle:(NSString *)title markdownBody:(NSString *)bodyRaw maxWidth:(int)maxWidth stayOnTop:(BOOL)isAlwaysOnTop asSheet:(BOOL)asSheet {
    // 创建持久化通知
    MFAlert *alert = [[MFAlert alloc] init];
    alert.alertStyle = NSAlertStyleInformational;
    alert.messageText = title;
    // 设置通知内容与样式
    // ...
}

通知文本内容来自Localization/zh-Hans.lproj/Localizable.strings，通过NSLocalizedString实现多语言支持。

自定义通知阈值设置

1. 修改默认配置文件

   编辑Shared/Config/default_config.plist，找到batteryWarningThreshold字段，设置预警百分比（默认15%）：

   <key>batteryWarningThreshold</key>
   <integer>20</integer> <!-- 修改为20%时触发提醒 -->
   

2. 通过代码动态调整

   在Shared/Config/Config.m中提供了API接口，可通过以下代码在运行时修改阈值：

   [Config sharedInstance].batteryWarningThreshold = 25;
   [[Config sharedInstance] saveToDefaults];
   

个性化通知样式

修改通知文本内容

1. 打开Localization/zh-Hans.lproj/Localizable.strings
2. 找到电池相关字符串键值对：

   "battery.low.warning.title" = "鼠标电量不足";
   "battery.low.warning.message" = "当前电量仅余%@%%，请及时充电";
   

3. 修改为自定义文本，支持Markdown格式：

   "battery.low.warning.message" = "⚠️ 鼠标电量不足%@%%\n建议立即连接充电器，避免工作中断";
   

调整通知显示方式

在AlertCreator.m中，showPersistenNotificationWithTitle方法支持多种显示参数：

• stayOnTop: 设置为YES使通知始终置顶
• asSheet: 设置为YES以窗口 sheet 形式显示
• maxWidth: 调整通知窗口宽度（默认300）

// 示例：创建置顶通知
[AlertCreator showPersistenNotificationWithTitle:title 
                                    markdownBody:body 
                                        maxWidth:350 
                                       stayOnTop:YES 
                                         asSheet:NO];

高级功能：电池使用统计

通过Helper/Utility/HelperUtility.m中的电池监控功能，你可以查看历史使用数据：

// 获取电池使用记录
NSArray *batteryHistory = [HelperUtility getBatteryUsageHistoryWithDays:7];
// 分析数据并生成报告
NSString *report = [BatteryAnalyzer generateUsageReport:batteryHistory];

结合App/UI/CustomUIElements/SensitivityDisplay.swift的图表组件，可以实现电池使用趋势可视化。

故障排除：通知不工作怎么办

1. 检查辅助功能权限

   确保应用已获得辅助功能权限，路径：系统设置 > 隐私与安全性 > 辅助功能 > Mac Mouse Fix

2. 查看日志文件

   电池监控相关日志位于~/Library/Logs/Mac Mouse Fix/battery.log，可通过Helper/Utility/EventLoggerForBradMacros.h定义的接口查看详细调试信息。

3. 重置通知设置

   执行Helper/Utility/HelperUtility.m中的重置方法：

   [HelperUtility resetNotificationPreferences];
   

通过以上步骤，你可以完全掌控Mac Mouse Fix的低电量通知系统，让无线鼠标使用体验更加顺畅。所有配置修改均基于项目开源代码实现，具体可参考Shared/Config/ConfigReadme.md获取更多高级配置选项。