2288×1048 OLED 的事件优先级、全局控制与任务接入

关键规则与设计选择

专业定义

在唯一非主 2288×1048 显示器的动态壁纸上，以透明卡片显示媒体、任务、手机、音量、游戏和告警；Win+F1 清场、Win+F2 切换时钟，长任务由发起脚本显式登记。

当前怎样实现

• Core 项目拥有事件、优先级、寿命、去重、布局与告警纯逻辑。
• WinUI 3 应用创建逐像素透明、无激活、鼠标穿透窗口。
• Wallpaper Engine 或 Windows 当前背景负责底层画面；浮层不连接或修改其设置。
• `NeteaseLocalMediaProbe` 读取窗口标题、完整 playing list（播放列表）与音频会话；只在同歌名/全部歌手的精确候选内用歌词缓存新鲜度消歧。`MediaSessionSource` 发布 MediaActive 与 8 秒 MediaTrackChange，按曲目 URI 异步缓存封面，ArtworkGenerationGate 阻止上一首的迟到封面覆盖当前曲目。
• `SteamGameSource` 从本地 appmanifest 清单和 gameprocess_log.txt 匹配仍存活的 Steam 会话；`SteamGameTracking` 解析日志本地时区和夏令时，显示统一 UTC+8。运行卡随本次起点计算时长，结束后生成独立 GameSummary；OverlayPolicies 规定 60 个可见秒，封面异步完成也必须仍属于同一会话。
• `PhoneBatterySources` 每 5 秒同时启动小米妙享与手机连接探测，各自有 2 秒超时及 single-flight（单飞）保护。小米读界面与近期日志、手机连接读伴随文件与界面；PhoneBatteryProbeReadingCache 分开 ObservedAt（来源证据时间）与 ConfirmedAt（最近确认时间），重复读旧日志不会刷新证据时间。
• `PhoneBatteryArbitration` 先排除未连接、越界或确认超过 15 秒的读数，再比较证据时间：小米不比手机连接旧超过 15 秒时优先小米，否则选择更新的手机连接。小米界面电量可合并近期日志充电趋势；一个探测故障不阻断另一个，只有均不可用才收起电量。
• `PhoneNotificationSource` 通过 Windows UserNotificationListener 读取小米妙享和手机连接实际通知；`PhoneNotificationReconciler` 按 ID 对账活动状态、启动基线与移除事件，并为来电/传输保留 5 分钟安全租约。PhoneNotificationClassification 规范 Unicode、空白和标点后跨源近似去重，数字序列不同不合并。
• `PhoneVerificationCodeDetector` 要求验证码/OTP（一次性密码）上下文并排除非验证码数字；固定验证码事件 ID 让新码原位替换，同码去重不重置寿命。OverlayPolicies 定义普通/动态 60 秒、连接 5 秒、验证码 15 秒；OverlayScheduler 累计真实可见时间、限制最新三条通知与三分钟墙钟队列，不把正文或验证码写日志。
• 音量来自 Windows 默认音频端点变化，显示 6 秒且不带设备名；U 盘和网络事件显示 12 秒，网络断开需连续确认。硬件告警来自 TURZX/LHM，异常常驻、恢复提示 10 秒；这些来源与媒体、Steam、任务和手机各自隔离。
• GlobalHotkeyCoordinator 优先 RegisterHotKey；只有 Win+F1 的 1409 冲突进入低级键盘 hook（钩子），手势状态机过滤注入按键、Ctrl/Alt 和重复 keydown。
• GlanceSource 把 GlanceVisible 写入 ApplicationData 本地设置；默认显示 HH:mm，启动、解锁和每个整分钟边界刷新。
• OverlayScheduler 的 ClearDismissible 只移除可清类型，并按内容指纹保存至少 10 秒、手机中继 3 分钟的抑制状态。
• Publish-HS2Task.ps1 把有界 JSON 写入 `HS2.CrystalOverlay.Tasks`；协议层校验 Id、字段类型与范围，投影层管理活动/完成身份，租约表每 5 秒清理超时任务。
• max-six、sparse、reflow、overflow 等 demo 使用合成数据。

执行流程

1. 1

   发现并验证目标显示器。

2. 2

   从每个本地 adapter（执行适配器） 和任务命名管道形成事件候选。

3. 3

   任务生产者用稳定 Id 上报 active；进度续报刷新租约，completed 或 cancelled 明确收口。

4. 4

   标准化、去重并应用来源新鲜度。

5. 5

   按优先级、寿命和六卡上限选择。

6. 6

   布局到曲面安全区域并透明显示。

7. 7

   Win+F1 只清可清内容并建立复活抑制；Win+F2 只切换并保存时钟状态。

8. 8

   事件结束、租约到期或显示器失效后收起。

真实入口

如何验证

• 源码列出 max-six 等 15 类纯软件 demo 场景，并明确全部使用合成数据。
• 当前main的GlobalHotkeyGestureStateTests与OverlaySchedulerTests覆盖物理Win+F1一次触发、注入/冲突组合透传、活动媒体/游戏/任务/来电/传输/告警保留及同一手机中继内容不复活；其既有测试证据不由本次TURZX恢复冒充为新的HS2实机验收。
• ImportantTaskProtocolTests、ImportantTaskProjectionTests 与 BoundedLineReaderTests 覆盖明确进度单位、completed/cancelled、同 Id 重开、五分钟租约续报、并发到期、静默客户端超时和下一客户端恢复；本轮未用真实生产任务做用户可见 E2E（端到端验证）。
• 2026-09-02 只读核对 NeteaseLocalMedia、SteamGameTracking、PhoneBattery、PhoneNotificationReconciler、PhoneNotificationClassification 与 OverlayScheduler 对应源码/测试定义；本次没有重跑这些来源测试，也没有读取真实媒体、手机电量或通知。
• 8 月 31 日历史回读曾确认 2288×1048 HS2、wallpaper64 和 HS2.CrystalOverlay 同时在线及浮层落点；实体动态壁纸只沿用 2026-08-30 本人历史确认，没有读取通知正文。
• 实体动态壁纸本轮未重验；透明合成性能、全部事件寿命、真实 Win+F1/Win+F2、生产任务异常退出、睡眠与异常重启恢复也仍未重演。

与其他模块的关系

安装与换机模块先建立本机 HS2 绑定；本模块读取指标异常、接收显式任务并管理用户控制，与电源恢复模块共享显示器模式边界，但不依赖机箱屏渲染。