yabai窗口管理器中sub-layer属性的正确使用方式

背景介绍

yabai作为macOS平台的平铺式窗口管理器，其规则系统允许用户通过精细配置控制窗口行为。在版本迭代过程中，部分配置属性发生了重要变更，其中layer属性在v0.7.x版本中被sub-layer替代，这一改动直接影响窗口层级管理策略。

属性变更解析

在早期版本中，用户可通过layer=normal规则确保应用程序窗口保持标准显示层级。典型应用场景包括：

1. 防止未托管应用（如Eclipse）遮盖已托管应用（如Finder）
2. 维持特定应用的窗口堆叠顺序
3. 解决IDE类应用与系统窗口的显示冲突

版本升级至0.7.x后，该属性调整为sub-layer，旧配置会导致"unknown key 'layer'"错误。新属性不仅保持原有功能，还提供了更精确的层级控制粒度。

配置迁移方案

基础迁移

将原有规则：

yabai -m rule --add app=".*" layer=normal

更新为：

yabai -m rule --add app=".*" sub-layer=normal

进阶配置建议

1. 优先级设置
   结合manage=off规则处理特殊应用：

yabai -m rule --add app="^Eclipse$" manage=off sub-layer=below

2. 多层级控制
   利用sub-layer的枚举值实现精细控制：

• above：保持在常规窗口之上
• normal：标准显示层级（默认）
• below：始终显示在常规窗口之下

3. 应用分组
   对同类应用批量设置：

# 开发工具组
yabai -m rule --add app="^(Xcode|VSCode|IntelliJ)$" sub-layer=above

# 系统工具组  
yabai -m rule --add app="^(Finder|Calculator|Activity Monitor)$" sub-layer=normal

技术原理

sub-layer属性基于macOS的CoreGraphics层级系统实现，通过修改窗口的CGWindowLevel属性值实现层级控制。相比旧版layer实现，新版本：

1. 直接映射到系统API的kCGNormalWindowLevel等常量
2. 增加与mission control的兼容性
3. 优化了与全屏应用的交互逻辑

故障排查

若遇到窗口显示异常，建议：

1. 通过yabai -m query --windows查看实际生效的sub-layer值
2. 检查规则加载顺序（后加载规则可能覆盖前者）
3. 使用yabai -m rule --list验证最终生效规则

最佳实践

1. 为终端类应用保持normal层级确保输入焦点
2. 将通知类应用设为above避免被遮盖
3. 对视频播放器等全屏应用单独配置

通过合理运用sub-layer属性，用户可以构建更稳定高效的窗口管理环境，充分发挥yabai的平铺式布局优势。