发布说明

解决普通开机（区别于休眠唤醒）后的体验问题：开机时首次刷新若因网卡/扩展坞未就绪而失败，程序此前不会自动重试，状态一直停在"离线"，直到用户再次点开托盘才重新连接。本次仿照 v1.5.1 的唤醒刷新机制，给普通开机也加上补偿轮次。

✨ 开机补偿刷新（三轮重试）

• 开机对全部设备做三轮刷新（t+0s / +3s / +8s） — 覆盖开机瞬间 WiFi / 扩展坞网卡晚就绪的平均 1~3s 延迟，首轮失败不再"一锤定音"，首次打开托盘看到的就是实时状态
• 开机自启开灯改为并行 + 逐轮重试 — 原为串行处理，一台设备 UDP 超时会拖慢整体；改每台设备独立线程并行，且每一轮都会补开灯，不再"失败一次就放弃"

🧹 其它

• 点击托盘（Flyout）保持先显示缓存 + 后台静默并行刷新，弹窗秒开、刷新自动校正

v1.5.1 休眠恢复大改之后的稳定性修复版。集中修复两个严重 Bug：并发字典迭代导致的偶发崩溃，以及冷启动时托盘图标状态不刷新。同时完成 GitHub 用户名从 Martlnez → awakaze 的全线迁移。

🐛 关键修复

• 字典并发 re-key 崩溃 — 冷启动 model 为空的设备首次连接成功后做原地 re-key，Flyout 与 App 的 5 处 live dict view 遍历抛 RuntimeError: dictionary changed size during iteration，导致弹窗中断或进程退出。修复：统一改用 list(self._lights.items()) 快照遍历
• MonitorSleepListener 重启后双回调 → 唤醒不复原 — 旧 stop() 未 join 旧窗口线程，新旧两个 HWND 同时订阅同一广播，on_monitor_sleep 被触发两次后 pre_sleep_state 被覆盖成 False，唤醒时直接跳过恢复。修复：stop() 新增 join(timeout=3.0) + 消息泵安全帽
• 灯启动时托盘图标没有变亮 — 启动路径中状态推送窗口过早创建 / 事件顺序错乱，灯明明是开的但图标仍暗色。重构启动时的状态推送流程，确保初始状态完整传递后再刷新聚合态

🔧 工程 & 基础设施

• CI Release Job 自动从 release-notes/RELEASE_NOTES_<tag>.md 读取 Markdown 作为 GitHub Release Body，不用再手工粘贴
• 新增 tests/test_concurrency_regressions.py — 4 passed · 1 skipped，覆盖 list() 快照并发安全、stop() 等待线程退出、卡死泵不会死锁，并含阳性对照用例

🧭 账号迁移

• GitHub 用户名 Martlnez → awakaze
• 仓库地址、所有源码、文档、Release Notes 中的 URL 全线同步更新

集中修复 v1.5.0 上线后反馈最强烈的两类问题：电脑从休眠/显示器息屏恢复后，灯一直显示"离线"，以及弹窗（Flyout）打开时滑块跳变、刷新卡顿、总开关不好用。

🐛 关键修复 · 恢复后永不离线

• 电源事件监听器改为常驻 — v1.5.0 里只有勾选了"息屏/休眠开关灯"才会启动监听窗口，三个都不勾的用户永远收不到 PBT_APMRESUMEAUTOMATIC，恢复后 UDP 会话过期 → 一直离线。v1.5.1 常驻监听，刷新无条件执行，开关灯按勾选决定
• 系统唤醒 → 三轮补刀刷新（t+0s / +3s / +8s） — 覆盖 WiFi/扩展坞网卡平均 1~3s 才就绪的场景；只有第 0 秒会按"唤醒开灯"发 power-on，后面两轮只 refresh，不覆盖用户中途关的灯
• 显示器点亮 → 刷新全部设备 — 之前只对勾选了"息屏关灯"的设备做还原；现在所有设备并行 refresh，息屏期间用户用物理按钮改的参数也会同步回来
• 显示器息屏时 完整记录每台设备 pre-sleep 开关状态，不再只记录托管设备

✨ Flyout / 托盘 体验全面优化

• 打开弹窗秒显缓存值 + 每设备独立线程并行刷新 — 旧版串行逐个 refresh，一台离线卡死整列；新版先同步显示最后已知值，再后台并行校正，单台慢不阻塞
• 亮度/色温滑块用缓存初始化（旧版硬编码 50 / 4000，肉眼可见先跳 50 再跳到真实值）
• 离线状态保留最后已知开关信息：旧版直接显示「离线 — error」，新版显示 已开灯 (离线) / 已关灯 (离线)，用户一眼看清真实状态
• 底部 ⏻ 智能总开关：有灯亮 → 高亮（点=全关）；全灭 → 暗色（点=全开）。不再跳过 cached unreachable 的设备（修复"唤醒后按了没反应"）
• 托盘图标启动时默认暗（旧版先亮 2~3 秒再闪暗，对用户造成"程序自动开了灯"的误解）
• 设备名截断放宽到 34 字符，Mijia Computer Monitor Light Bar 2 这种官方长名完整显示，取消固定列宽

✨ 启动即并行刷新

旧版只对缺 model / device_id 的设备 refresh，其余全是"默认离线"，托盘图标启动后长期是错的。新版启动后立刻并行刷新所有完整配置的设备，图标几秒内落到真实聚合态。

一次围绕 多灯并行管理 的大重构。核心从"一个实例控制一盏灯"升级为"一个实例控制任意多盏灯，每盏独立配置、独立控制"。

✨ 新功能 · 多灯连接

• 无上限的设备数量 — 一个实例可同时管理任意多盏米家 / Yeelight 灯，共享一份托盘图标、一份弹窗、一份快捷键路由
• 图形化设备列表 — 全新的设置界面，卡片式展示每盏灯的名称 / IP / 型号 / 状态；支持添加、编辑、删除
• 拖拽排序 — 按住每张卡片左侧的 ⋮⋮ 图标即可拖动，顺序决定弹窗中的显示位置
• 云端一键多选导入 — 扫码登录小米账号后可勾选多盏设备，一次性批量添加，Token 全部自动填入
• 配置自动迁移 — 从 v1.4.x 升级时，旧的顶层 device 单对象会被无感转换为 devices: [...] 数组

✨ 新功能 · 弹窗重构

• 每设备一节 — 弹窗按设备列表顺序为每盏灯渲染独立的一节：设备名、状态、⏻ 开关按钮、亮度 / 色温滑杆
• 窗口高度自适应 — 一盏灯与旧版差不多，两盏灯约翻倍高，以此类推
• 关闭所有灯一键按钮 — 底部新增 ⏻ 按钮，一次关掉所有在线设备
• 设备名智能截断 — 名称过长时自动截断为 xxxx...，按钮位置保持固定
• 每设备独立防抖器 — 多盏灯拖滑杆时互不干扰

✨ 新功能 · 每设备独立配置

• 五项电源策略独立开关：软件启停、显示器休眠、系统休眠 / 唤醒
• 两项显示控制：亮度 / 色温滑杆的可见性
• 四个全局快捷键：亮度 +/-、色温 +/-，以及独立的调整步进值
• 快捷键在输入框内按下即捕获；右键输入框直接清空

🐛 修复

• 设置页"检查更新"按钮走完整的托盘菜单同款流程（含"已是最新版本"弹窗、缓存更新、菜单刷新徽标）
• 恢复了 v1.4.3 的按键捕获实现（event.state 位掩码解析 + 特殊键 keysym 映射），并接到每设备 hotkey_manager 上
• 修正 _on_config_saved 保存后重建的灯回调签名（(state) → (state, device_id)）
• 清理弹窗遗留的 self._light 引用，色温 clamp 时不再报 AttributeError

✨ 新功能

• 灯随显示器休眠开关 — Windows 关闭显示器时灯自动关，唤醒时恢复到关闭前的状态
• 系统休眠时关灯 — 电脑进入睡眠 / 休眠时自动关灯
• 系统唤醒时开灯 — 电脑从睡眠 / 休眠恢复时自动开灯
• 三个独立开关，可根据需要自由组合

🐛 修复

• 修正 GUID_MONITOR_POWER_ON（Win8 已废弃）改用 GUID_CONSOLE_DISPLAY_STATE，Modern Standby 系统也能触发
• 移除 55 秒空闲判断，避免播放视频时误关灯
• 使用顶级窗口而非 HWND_MESSAGE，确保能收到系统级广播
• 调用 RegisterSuspendResumeNotification 显式订阅休眠事件

🐛 Bug 修复

• 在快捷键输入框上右键，可通过"清空快捷键"菜单禁用不需要的快捷键

🎮 全局快捷键

使用系统级热键调节亮度和色温，全屏游戏中也能响应。支持长按连续调整、按键录入配置。

🔔 自动更新检测

启动时后台检查 GitHub Release，有新版本弹窗提示，可在托盘菜单手动检查或关闭。

v1.4.0 之前的历史版本可以在 GitHub Releases 页面 查看，包括：

• v1.4.0 — 云端 Token 提取、桌面小部件（感谢 @zengzoxiong PR #1）
• v1.3.x — bulk MIoT 设备库（2100+ 机型）、CT 单位过滤、灯随软件启停
• v1.2.x — 开机自启动、Flyout 体验完善、多网卡广播
• v1.1.x / v1.0.x — 初期版本，基础托盘与滑杆功能