[zouyingfeng]

插件简介

电量与音量（bluetooth-battery）v1.1.0：在灵动岛上显示已连接蓝牙设备（耳机/鼠标/键盘等）的电量与系统音量。

• 小岛第一行：电量最低的设备（型号 + 电量）；第二行：系统音量（音量条 + 百分比，静音显示「静音」）
• 展开：逐台列出设备电量（显示完整品牌名）；点岛体打开聚光卡，可查看全部设备、系统音量、手动刷新、跳转系统设置
• 低电量提醒（阈值可调）、刷新间隔可调、可单独关闭音量显示
• 无网络请求、无第三方依赖、不需要管理员权限

测试环境

• WinIsland 版本：1.1.3（宿主 SDK 2.4.0，API v2，Windows 11 build 26300）
• 已在本机实际安装并启用测试：读取到两副蓝牙耳机真实电量（40% / 80%）与系统音量，展开/聚光卡/设置页正常，日志无错误
• 是否需要管理员权限：不需要
• 插件要求宿主 ≥ 2.3.0（使用了 IIslandTheme 主题适配）

权限与数据

• 是否访问网络：否
• 读写哪些文件：无；只读 Windows PnP 设备属性与 Core Audio 音量状态，设置项走宿主的插件作用域（bluetooth-battery.*）
• 蓝牙电量读的是设备上报给 Windows 的缓存值（与「设置 → 蓝牙」同一份数据），不伪造数据

截图

小岛（任务栏胶囊）

展开（设备明细）

聚光卡（全部设备 + 系统音量）

链接

• 源码：https://github.com/zouyingfeng/winland-battery-volume
• 使用说明：https://github.com/zouyingfeng/winland-battery-volume/blob/main/%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md
• 2.4G 键鼠电量实测记录：https://github.com/zouyingfeng/winland-battery-volume/blob/main/docs/2.4g-report.md

校验

• 目录名 = id = bluetooth-battery，plugin.json 与包内那份完全一致，版本 1.1.0
• 包内只有入口 dll / deps.json / pri / plugin.json / README，不含宿主运行时