服务：闲置超时黑屏，再次点亮桌面布局混乱

现象

• 闲置超时导致屏幕关闭后，再点亮时桌面布局错乱：
• 竖屏消失，只剩两块屏在用
• 剩下的两块被重排去填补空位（位置整体偏移）
• 不会自愈 —— 亮屏后一直是错的，必须手工把竖屏拉回来

根因（三层，逐层可追）

① 屏黑期间，显示链路的 MST 下游分支 flap（连接器报 connected 但拿不到 mode）
      ↓
② KScreen 全程在跑，收到 RandR 事件就重放布局 ⇒ 把「缺一块」当成事实写进配置
      ↓
③ 亮屏只恢复 DPMS，不重新枚举 MST 下游 ⇒ 缺的那块屏不会自己回来
      ↓
   布局保持错乱，而且机制以为一切正常

关键在③：「亮屏」不等于「重新探测」。所以缺屏是持久状态，不是暂时现象。

为什么锁屏那条路没出问题

因为锁屏有可监听的状态信号，可以在屏黑之前把 KScreen 停掉；而闲置熄屏没有。

这也是为什么最终方案不是「等信号」，而是两套触发源共用一份机制：锁屏用信号，闲置熄屏用显示配置事件（有事件且零轮询）。

机制设计

核心是自己维护一份「正确布局」的基准，而不是指望显示守护进程自动同步当前状态 —— 因为「当前状态」可能已经是坏的。

布局快照同时备份显示配置目录，恢复时直接把配置换回去、再启动守护进程 —— 让它在启动时读到的就是正确布局，而不是「先启动、再被纠正」。

行为语义

不轮询：靠显示配置的变更事件驱动，事件到了才查一次屏幕电源状态。空闲时不产生任何定时唤醒。

纠正有节流：同一次不一致在 10 分钟内只纠正一次，避免和用户的手动调整反复抢。

验证与手工出口

# 看两份基准、当前实际布局、守护进程与屏幕状态、最近的纠正记录
kscreen-layout-guard status

# 如果你故意改成更少的屏（不再要那一块），把当前布局设为新基准
kscreen-layout-guard accept

# 只抓一次快照（不改基准以外的东西）
kscreen-layout-guard snapshot

状态与日志落在用户态状态目录下的 lock/ 与 idle/ 两个子目录，各含布局快照与显示配置备份；不一致的现场记录在 mismatch.log。

边界

• 显示配置按「输出组合」分文件。若屏黑期间输出集合本身变了，直接换回配置可能落空；这时靠校验发现，日志会记下「纠正后仍不一致」。
• 它分不清「故障 flap」和「用户真插了设备」 —— 锁屏期间真插扩展坞，解锁后会被回退到锁屏前那份。
• 基准是「历史上见过的最好布局」。换工位后若要长期用新布局，跑一次 accept。
• 这不是驱动层修复：MST 下游在亮屏后不重新枚举的行为仍在，本机制只是保证结果正确。

涉及组件