MenuBarMijia：米家设备菜单栏控制

项目简介

MenuBarMijia 是一款原生 macOS 菜单栏应用，用于控制小米 / 米家智能家居设备，并提供基于 Tauri v2 的 Windows 11 托盘版客户端。它的目标是让你在写代码、开会或日常办公时不必拿起手机，直接在电脑上开关灯、调空调、看传感器。

用米家 App 扫码即可直连米家，无需先搭建 Home Assistant；同时也支持接入 Home Assistant。macOS 端使用 Swift 6 原生开发，Windows 端为独立实现，两者共享协议与意图匹配的测试基准。

主要功能

• 扫码直连米家：用米家 App 扫码连接，支持 CN、SG、DE、US、RU 区域服务器。
• Home Assistant 集成：原生 WebSocket 连接，支持 xiaomi_home 实体合成与物理设备分组。
• 键盘搜索与控制（macOS）：⌥M 唤出面板，输入设备名或拼音首字母（如 sftd 找台灯），回车切换，方向键调亮度或空调温度。
• 按住说话语音控制：按住菜单栏图标或全局快捷键说话，松手执行；日常指令由本地解析规则处理，可选接入 AI 后端处理多步请求。
• 一键全关与撤销：按住「全关」0.6 秒触发；插座、扫地机、摄像头默认不参与，可撤销。
• 桌面事件自动化（macOS）：锁屏、休眠、唤醒、外接显示器等事件触发设备动作，规则默认全部关闭。
• Apple 快捷指令（macOS）：提供切换设备、运行场景、语音指令、查询房间温湿度 4 个动作，并支持 menumijia:// URL Scheme。
• 传感器趋势与能耗（macOS）：查看 24 小时 / 7 天温湿度曲线，智能插座显示用电记录。
• 米家空气净化器：支持 PM2.5、空气质量、温湿度、滤芯寿命与 1–100% 风速滑杆。
• 摄像头实时画面：macOS 使用 HLS / HA 快照，Windows 使用私有 P2P 桥接。
• 布局编辑：卡片右下角拖拽把手可切换半宽 / 全宽 / 整面板尺寸。

安装与使用

系统要求：macOS 14（Sonoma）及以上（Universal Binary，支持 Apple Silicon 与 Intel），或 Windows 11 64 位。

macOS 推荐用 Homebrew Cask 安装：

brew install --cask jryang1997/tap/menubarmijia

也可以从 GitHub Releases 下载 DMG，把 MenuBarMijia.app 拖入「应用程序」文件夹。

Windows 11 从 Releases 下载 x64 的 .exe 或 .msi 安装包。

安装后点击菜单栏图标打开面板，进入设置 ⚙️ 即可扫码或配置 Home Assistant 连接。

注意事项

• 项目未加入付费的 Apple Developer Program，macOS 首次启动若被 Gatekeeper 拦截，需要到「系统设置 → 隐私与安全性」中点击「仍要打开」。
• Windows 安装包没有 Authenticode 签名，SmartScreen 可能提示「Windows 已保护你的电脑」，需点击「更多信息 → 仍要运行」；每个 Release 附带 SHA-256 摘要供校验。
• macOS 的 DMG 带 Ed25519 更新签名，应用内更新会强制校验。
• 部分功能存在平台差异：键盘搜索、桌面事件自动化、快捷指令、URL Scheme、能耗记录目前仅 macOS 支持；Windows 语音仅支持免提模式。
• 项目基于 MIT 许可证开源。

本作品整理自 GitHub 开源项目 jryang1997/MenuBarMijia，原作者 @jryang1997，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。