【开源分享】MiMonitorLightTray：在 Windows 任务栏优雅调节米家挂灯

它能做什么？#

• 多灯并行管理：一个实例即可管理任意数量的米家 / Yeelight 灯具，弹窗中每盏灯独占一节滑杆与电源开关，窗口高度随设备数量自适应；面板底部还集成「关闭所有灯」一键总闸（⏻）与设置入口（⚙）。
• 托盘小窗，随开随走：左键单击托盘图标弹出控制面板，点击外部区域或按 Esc 即可自动隐藏。
• 滚轮微调，精准控光：亮度（1–100%）与色温双滑杆，色温范围自动读取设备实际支持的区间；光标悬停在滑条上滚动滚轮即可 ±1 精细调节。灯未点亮时拖动滑杆，会自动先开灯再生效，避免「白拖一通」。
• 联动开关灯：每盏灯可独立配置——跟随软件启动/退出、显示器休眠/唤醒、系统睡眠/唤醒时自动开关灯；显示器休眠走 Windows 电源广播，看视频、听歌不会误关。
• 全局快捷键：为每盏灯单独绑定亮度/色温增减组合键（如 Ctrl+Alt+↑/↓/←/→），基于系统级热键注册，全屏游戏里也能响应。
• 纯局域网直连，零延迟响应：底层走本地 miio/MIoT 协议通信，数据不经由云端服务器中转，响应几乎瞬时完成；Token 仅存放于本地。
• 动态 IP 容错：即便路由器重启后 DHCP 给挂灯分配了新 IP，程序也会根据 Device ID 在局域网内自动找回，无需频繁重设。
• 桌面小部件与自动更新：可将控制面板固定在桌面任意位置（支持拖动、锁定、记忆位置）；启动时自动检测 GitHub Release 新版本。

快速上手#

第一步：下载程序

• 前往 GitHub Releases 下载打包好的 MiMonitorLightTray.exe，免安装直接运行。
• 备用下载（内含软件本体及 Token 提取工具）：百度网盘（提取码：4cwk）

第二步：添加设备

• 云端一键导入（推荐）：点击「云端导入」，用米家 App 扫码登录小米账号，在设备列表中勾选一盏或多盏灯具，即可带着 IP / Token / 型号批量导入设备列表。
• 手动添加：也可点击「+ 添加设备」逐个填写——
  • 设备 IP：米家 App → 挂灯详情页 → 右上角 ··· → 设备信息中即可查看。
  • 设备 Token（32 位密钥）：推荐使用开源工具 Xiaomi-cloud-tokens-extractor，运行 Windows 版 EXE 后按提示登录小米账号，即可自动列出名下所有设备的 Token。
  • 填写后点击「测试连接」验证连通性，保存即可加入列表（型号可留空，连接后自动识别）。

第三步：个性化设置

设备列表支持拖拽排序，顺序与弹窗中的滑杆顺序实时同步；每盏灯还有独立的二级编辑菜单，可按需关闭亮度或色温滑杆的显示、配置联动开关灯策略与专属快捷键。首次启动程序会自动弹出配置向导；从旧版本升级无需动配置，单设备设置会自动迁移到多设备格式。

设备兼容与开源协议#

• 协议自动适配：按设备型号在 legacy 与 MIoT 双协议间自动分发，已内置约 2100 个 MIoT 灯具的协议映射与色温范围，覆盖 Yeelight、小米、米家及大量第三方品牌。
• 兼容性兜底：未收录的新机型默认按 legacy 处理，也可在设备编辑器中勾选「启用 MIoT（实验性）」手动试探。
• 开源协议：本项目基于 MIT License 开源。

第一次将个人造轮子的项目完整开源，代码仓库已开放： 👉 GitHub：MiMonitorLightTray

欢迎在仓库提交 Issue 反馈 bug 或优化建议；如果这个小工具刚好解决了你的痛点，不妨顺手点个 Star 支持一下。