MiBar 💡

专为 macOS 设计的米家智能显示器挂灯 1S 菜单栏控制工具

---

MiBar 是一款轻量、优雅的 macOS 菜单栏应用，让你可以直接在 Mac 菜单栏中无缝调节米家智能显示器挂灯 1S（型号：yeelink.light.lamp22）的开关、亮度、色温以及预设情景模式。

• 🌐 官方主页：https://mibar.pages.dev/
• 📦 最新发布：GitHub Releases

无需每次打开手机 App 或使用物理旋钮，随时在桌面即可完成灯光调控。

---

✨ 核心特性

• 🖥️ 纯正原生体验：常驻 macOS 菜单栏，采用原生毛玻璃材质与丝滑弹簧动效，轻巧无感。
• ⚡ 局域网直连控制（miIO）：基于 local UDP 加密通信，低延迟秒级响应，无需依赖外网中转。
• 🎛️ 细腻调节体验：
  • 开关控制：一键点亮或熄灭挂灯。
  • 无级亮度调节：1% ~ 100% 胶囊滑块平滑调节，支持滚轮/拖拽与快捷预设。
  • 色温微调：2700K 暖黄光到 6500K 冷白光自然渐变。
  • 常用情景预设：一键切换专注、阅读、影音、休闲等模式。
• 📲 米家扫码快速配对：
  • 支持米家账号二维码扫码登录，一键获取局域网内挂灯 IP 与 Token，免去繁琐抓包步骤。
  • 临时会话，不保留账号密码，仅在内存中解析设备列表。
• 🔒 安全隐私：
  • 设备 Token 采用系统级 macOS 钥匙串（Keychain）安全隔离存储。
  • 局域网本地直连，数据不上报。
• 🛠️ 现代 Swift 架构：
  • 纯 SwiftUI + Observation (@Observable) 数据流。
  • Swift Concurrency 严格并发安全（Sendable、Actor、nonisolated）。

---

🛠️ 支持设备

设备型号	型号标识 (Model Identifier)	连接方式
米家智能显示器挂灯 1S	yeelink.light.lamp22	局域网 miIO (UDP 54321)

---

🚀 快速上手

1. 扫码一键配置（推荐）

1. 启动 MiBar，点击菜单栏图标打开配置面板。
2. 选择 「米家扫码登录」，使用手机「米家 App」或「微信」扫描生成的登录二维码。
3. 授权确认后，MiBar 会自动检索名下的挂灯设备，并自动填入局域网 IP 与 32 位 Token。
4. 点击保存，即可开始畅快控制！

2. 手动填写配置

如果你已有通过抓包或网关获取的设备 IP 和 Token：

1. 打开配置页面，在输入框中填入：
   • 设备 IP：挂灯在当前局域网分配的 IPv4 地址（如 192.168.1.100）。
   • 设备 Token：32 位十六进制字符串（由 16 字节密钥转换而来）。
2. 点击 「保存并连接」 即可。