蓝牙设备监控

核心用法

bluetooth-monitor 是一款面向 macOS 用户的蓝牙设备管理命令行工具，基于 blueutil 底层实现，提供设备连接状态的实时监控与操作能力。核心功能覆盖四大场景：

1. 状态查询：connected 查看当前在线设备，paired 列出历史配对记录，power 检测蓝牙开关状态
2. 设备操控：connect/disconnect 配合 MAC 地址实现精准连接管理，power on/off 控制系统级蓝牙电源
3. 地址管理：通过连字符格式（如 08-65-18-B9-9C-B2）标识设备，支持从查询结果直接复制使用

显著优点

• 零配置开箱即用：仅需 brew install blueutil 单依赖，无复杂权限申请流程
• 精准操控：MAC 地址级操作避免设备名称冲突，适合多同型号设备环境
• 脚本友好：纯文本输出便于与 Shell 脚本、自动化工具链（如 Alfred、Hammerspoon）集成
• 轻量无侵入：不常驻后台，执行即释放资源

潜在局限

• 电量信息缺失：macOS 12+ 系统 API 变更，无法读取蓝牙设备剩余电量（Magic 系列键盘/鼠标等）
• 地址格式敏感：必须严格使用连字符分隔的 12 位十六进制格式，冒号格式不被识别
• 无 GUI 反馈：连接失败时仅依赖命令行返回码，错误原因需人工排查
• 依赖外部工具：blueutil 更新滞后可能导致新版 macOS 兼容性问题

适合人群

• 频繁切换蓝牙设备的开发者/多设备用户
• 需要自动化蓝牙管理的效率工具爱好者
• 通过终端管理外接设备的极简主义用户

常规风险

• 误断关键设备：断开操作立即生效，可能中断正在进行的外接键盘/鼠标操作
• 地址输入错误：错误 MAC 地址可能导致命令静默失败或连接到非预期设备
• 系统兼容性：macOS 大版本升级后需验证 blueutil 适配状态

核心用法

bluetooth-monitor 是一款专为 macOS 设计的蓝牙设备管理命令行工具，通过调用系统级工具 blueutil 实现硬件层面的蓝牙操作。用户可通过简洁的子命令完成设备状态监控与连接管理：

• 状态查询：connected 列出当前活跃连接设备，paired 查看所有历史配对记录，power 检测蓝牙模块开关状态
• 连接控制：connect 与 disconnect 配合 MAC 地址（XX-XX-XX-XX-XX-XX 格式）实现精准设备操控
• 电源管理：支持 power on/off 快速切换蓝牙模块，无需进入系统设置

使用前需通过 brew install blueutil 安装底层依赖，该工具与 macOS 系统蓝牙服务深度集成，操作响应即时。

显著优点

1. 效率提升：告别系统设置的多层级菜单，一条命令完成耳机、键盘、鼠标等设备的快速切换，尤其适合在会议室、咖啡馆等多场景切换外设的用户
2. 纯本地安全：零网络通信能力，所有操作局限于本机蓝牙协议栈，杜绝数据外泄风险
3. 资源轻量：仅 217 行 Shell 脚本，无重型依赖，启动毫秒级响应
4. 脚本化友好：输出格式规范，易于被其他自动化脚本调用，适合集成到 dotfiles 或工作流工具链
5. 透明可控：开源脚本结构清晰，用户可完全审查每一行执行逻辑

潜在缺点与局限性

1. 平台受限：仅支持 macOS，Windows/Linux 用户无法使用
2. 版本兼容：macOS 12+ 系统 API 变更导致无法读取设备电量信息，功能有所缩水
3. 输入容错弱：MAC 地址格式验证不足，大小写或分隔符错误可能导致命令失败
4. 依赖外部工具：必须预先安装 blueutil，未做自动依赖检测与安装引导
5. 无交互界面：纯命令行操作，对非技术用户门槛较高

适合的目标群体

• 开发者/极客用户：习惯终端操作，追求键盘驱动的效率最大化
• 多设备管理者：频繁切换 Magic Keyboard、AirPods、蓝牙鼠标等外设的创意工作者
• 自动化爱好者：需要将蓝牙设备管理纳入脚本工作流（如自动断连回家耳机、连接办公键盘）
• 系统管理员：批量排查 Mac 设备蓝牙连接问题的运维场景

使用风险

• 功能风险：输入格式错误可能导致命令静默失败，建议操作前先用 paired 确认地址
• 版本风险：macOS 系统更新可能破坏 blueutil 兼容性，需关注依赖工具更新
• 权限风险：首次使用可能触发系统蓝牙权限弹窗，需在「系统设置-隐私与安全性」中授权
• 来源风险：T3 级个人开发者项目，虽经代码审查安全，但建议关注后续维护活跃度