nix：梳理屏幕布局管理行为

一、先看清：有三个主体在动布局

这是「改了没用」「莫名回弹」的根源 —— 不是 KScreen 一个人做主，nix 侧还有两个机制在抢方向盘。

三者的当前协作关系（ASCII 版）：

连接集合变化 ──▶ replay：命中有没有目标？ ──有──▶ 摆位 ──▶ guard accept（基准 = 新布局）
                        │
                        └──无──▶ 不干预

同场景、布局被改动（不是机制干的）
        └──▶ replay：挂起 60s 观察窗口（写 hold 文件）──▶ settle 到期
                  ├─ 仍在 ⇒ 记为该连接集合的用户意图 + guard accept
                  └─ 已回目标 / 机制噪声 ⇒ 只清窗口，不动手

屏黑 → 亮屏 ────▶ guard：基准 vs 当前 ──不一致──▶ 先看 hold；无 hold 才「纠正前 sleep 3 复核」→ 恢复快照 + 重启 KScreen
                                     └──一致────▶ 不动

KScreen 自己 ───▶ 每次应用后写 <集合哈希> 文件（下次同集合自动套用）

二、nix 配置里的文件清单（按「动不动布局」分三层）

2.1 主动干预布局（运行时改 X 布局 / 管 KScreen）—— 只有 2 个 .nix

2.2 影响「屏能不能亮 / 能不能出图」，但不改布局 —— 4 个 .nix

2.3 只取证 / 只提供能力 / 已停用 —— 4 个 .nix

三、时机对照：什么时候谁会动手

四、数据落点与排查命令

常用排查命令：

kscreen-layout-replay status                  # 当前输出 + 命中的目标 + 是否已符合（不动任何东西）
kscreen-layout-replay conforms; echo $?       # 0=当前布局正是目标（guard 纠正前问它）
kscreen-layout-guard  status                  # 基准（idle/lock）+ 当前实际 + 最近日志
xrandr --query                                # 第一行 current = 虚拟屏尺寸
kscreen-doctor -o                             # KScreen 视角的输出表（含 mode id）
systemctl --user is-active plasma-kscreen kscreen-layout-guard-watch kscreen-layout-guard-lock kscreen-layout-replay
rm ~/.local/state/kscreen-layout-hold         # 取消正在进行的观察窗口

五、用户手动改布局：从「改了没用」到「记住」（2026-10-19 21:0x 落地）

原现象：在「显示和监视器」里改布局 → 点「应用」→ 临时生效 → 确认倒计时点「接受」→ 变回老样子。（实测：把竖屏挪 100px，2 秒内被摆回。）

落地改动（gen263~gen265）

真机验证 A —— 机制侧（21:03~21:10，home 组合：eDP + P27H 横屏 + 竖屏）

真机验证 B —— 用户在系统设置里真改（21:14~21:15，改后：eDP 1440x900+1440+0、DP-7 2560x1440+1440+900 primary、DP-10 1440x2560+0+305 left）

运维口径

• 想让某个连接模式回到规则表：删 intent.json 里对应键（或整个文件）⇒ 下次事件起按规则表。
• 想取消正在进行的观察窗口：删 ~/.local/state/kscreen-layout-hold。
• 意图只对「该连接集合」生效，换插法/换屏走别的键，互不干扰。
• 限制：意图只恢复 enable / position / rotation，不恢复分辨率（mode）；改分辨率请进规则表。
• 系统设置若提示「没有找到 kscreen 后端」：见第七节（是旧窗口缓存，不是没装）。

六、规则表当前 4 条（/etc/kscreen-layout-rules.toml）

改规则的唯一入口：改 modules/system/service/kwin-data/kscreen-layout-rules.toml → nixos-rebuild switch；规则表本身不会被任何运行时动作改写。

七、系统设置提示「没有找到 kscreen 后端」

判据先行：不是后端丢了 —— plasma-kscreen active、DBus 上有 org.kde.KScreen、kscreen-doctor -o 能读到全部输出。