VigilWatt

English | 简体中文

Windows 无线设备电量一览：蓝牙设备、2.4G 键鼠手柄和可选的本机电池，都能在托盘与历史记录中查看。

设备列表与电量：

统计、历史和设置：

_{历史统计 · 历史管理 · 设置}

桌面小组件：

任务栏电量贴片：

• 读取 BLE GATT 电池服务、经典蓝牙 HFP 网关节点电量和已适配 2.4G 设备协议。
• 托盘显示在线设备的最低电量，低于可配置阈值时提醒（默认 20%）。
• 可选显示桌面小组件、任务栏贴片和本机电池电量；本机电池不计入托盘最低电量。
• 保存电量历史，提供 24 小时、7 天和 30 天统计，并可按设备管理记录。
• 可设置开机启动。

设备协议开关： MCHOSE 与 Logitech 插件默认关闭，因为读取需要发送查询帧；可在设置中按品牌启用。其他纯被动插件不会主动向设备写入。

从 GitHub Releases 下载，或使用 Gitee 镜像：

• VigilWattApp-win-Setup.exe：当前用户安装版，包含 Velopack 自动更新。
• VigilWattApp-win-Portable.zip：免安装便携版。

安装包为 self-contained，无需另外安装 .NET 运行时。仓库不包含生成的 dist/ 安装包。

1. 启动应用后，在任务栏通知区域找到 VigilWatt 图标；首次可能收在 ^ 溢出区。
2. 左键打开主窗口，右键打开托盘菜单。
3. 需要监控笔记本电池时，在设置中开启「监控本机电量」。

下表区分已验证设备与已实现但尚待对应设备验证的协议：

弱水时砂炽天使 2.4G（38FF:0001）经主机侧与 RoseLink 检查确认没有电量通道，因此不支持显示电量。其他型号是否可用取决于其协议是否已适配。

上表里标着「贡献者真机」的适配，都来自社区贡献者的抓包与真机验证。谁做了什么见 CONTRIBUTORS.md。

需要 .NET 8 SDK；在 Windows x64 上从解决方案构建：

dotnet build VigilWatt.sln -c Debug
dotnet publish src/VigilWatt.App -c Release -p:Platform=x64 -o publish

构建、测试和发布说明见 docs/dev/build.md。

VigilWatt.sln
src/
  VigilWatt.Core/       # 设备发现、BLE/HID、协议插件、历史存储与日志
  VigilWatt.App/        # WinUI 3 界面、托盘、桌面小组件和任务栏贴片
  tests/
    VigilWatt.Core.Tests/       # xUnit 单元测试
    VigilWatt.BleScan/          # BLE 诊断工具
    VigilWatt.ProtocolCapture/  # 协议采集工具
assets/                 # README 截图与应用资源
docs/                   # 项目、开发、硬件与审查文档
scripts/                # 构建、打包及临时调试脚本

GitHub 主仓库 · Gitee 镜像 · MIT License © 2026 evren