Dannyjay-hub/Battery-Guardian-for-Mac
GitHub: Dannyjay-hub/Battery-Guardian-for-Mac
一款 macOS 原生电池取证分析工具,用于检测 MacBook 电池伪造、固件篡改和数据欺骗问题。
Stars: 0 | Forks: 0
# Battery Guardian v1.0
一款原生 macOS 应用,用于检测假冒、重写或伪造的 MacBook 电池。
## 功能特性
- **电池健康评分 (0-100)** — 综合取证评分
- **快速扫描 (10秒) & 完整扫描 (60秒)** — 两种扫描模式
- **伪造检测** — 零熵、电压平线、里程回滚、时间悖论检查
- **趋势跟踪** — 通过 ↑↓→ 箭头随时间比较扫描结果
- **自动化** — 通过 launchd 安排静默的每日扫描
- **分享报告** — 将结果复制到剪贴板
- **原生窗口** — 作为真正的 macOS 应用运行(无需浏览器)
## 安装说明
### 选项 A:DMG(推荐)
1. 下载 `BatteryGuardian_v1.0.dmg`
2. 打开 DMG
3. 将 **Battery Guardian** 拖到 **Applications**(应用程序)
4. 双击启动
### 选项 B:从源码运行
1. 安装 Python 3(如果尚未安装)
2. 安装 pywebview:`pip3 install pywebview`
3. 运行:`python3 battery_guardian_web.py`
## CLI 选项
- `python3 battery_guardian_web.py` — 启动 GUI
- `python3 battery_guardian_web.py --auto` — 无头扫描(仅记录日志)
- `python3 battery_guardian_web.py --no-window` — 使用浏览器代替原生窗口
- `python3 battery_guardian_web.py --enable-automation 30` — 安排 30 天的每日扫描
## 系统要求
- macOS 11+ (Big Sur 或更高版本)
- 配备内置电池的 MacBook(不支持 Mac Mini/iMac/Mac Pro)
- Python 3.9+
- pywebview (`pip3 install pywebview`)
## 故障排除
- **"Permission Denied"(权限被拒绝)**:运行 `chmod +x "Double Click To Run.command"`
- **"File is damaged"(文件已损坏)**:运行 `xattr -cr "Double Click To Run.command"`
- **没有窗口出现**:尝试 `python3 battery_guardian_web.py --no-window` 使用浏览器回退模式
## 从源码构建
```
chmod +x build_dmg.sh
./build_dmg.sh
```
这将创建 `Battery Guardian.app` 和 `BatteryGuardian_v1.0.dmg`。
## 许可证
MIT
## 作者
[@Dannyjay-hub](https://github.com/Dannyjay-hub)
标签:MacBook, Python, pywebview, Zenmap, 伪造检测, 原生应用, 固件篡改, 数据完整性, 无后门, 时间冻结, 欺骗检测, 电池健康, 电池循环, 电量监控, 硬件安全, 硬件检测, 系统诊断, 逆向工具