Yabai窗口管理：实现应用窗口固定布局的技术方案

在macOS窗口管理工具Yabai的使用过程中，许多用户会遇到一个常见需求：如何在多窗口布局中保持特定应用的固定位置。本文将以邮件客户端和日历应用为例，深入探讨实现这一需求的技术方案。

问题背景分析

当用户使用Yabai管理窗口布局时，特别是对于工作空间中的关键应用（如左侧邮件、右侧日历），系统重启后窗口位置可能会发生交换。这是由于macOS系统本身不记录窗口位置信息，而Yabai默认也没有提供"主窗口"(master layout)功能。

现有解决方案评估

目前社区中主要有两种技术思路来解决这个问题：

1. 窗口查询与交换方案
   通过查询空间中的第一个窗口ID，检查其应用名称，如果不匹配预期则执行交换操作。这种方法理论上可行，但在实践中存在可靠性问题，主要因为：

   • 窗口ID查询可能不稳定
   • 交换操作时机难以精确控制

2. 信号触发与动态布局方案
   更完善的方案是通过Yabai的信号系统，结合动态布局调整脚本。核心组件包括：

   • 基础配置参数（分割比例、窗口放置策略）
   • 事件信号绑定（窗口创建/销毁/最小化等）
   • 动态布局调整脚本

技术实现详解

基础配置

建议设置以下Yabai配置参数作为基础：

yabai -m config split_ratio 0.30
yabai -m config split_type auto
yabai -m config window_placement first_child

信号系统绑定

通过Yabai的信号机制，可以在各种窗口状态变化时触发布局调整：

# 窗口创建事件
yabai -m signal --add event=window_created \
    action='yabai-panes; yabai -m window --warp first; yabai -m window --warp prev; yabai -m space --balance x-axis'

# 其他相关事件...

动态布局脚本

核心的yabai-panes脚本应当包含以下功能：

1. 获取当前显示器和空间信息
2. 统计有效窗口数量（排除浮动窗口和特定应用）
3. 根据窗口数量动态调整布局参数

示例逻辑结构：

case $windowcount in
    1) yabai -m config split_ratio 0.30 split_type vertical ;;
    2) yabai -m config split_ratio 0.5 split_type horizontal ;;
    *) # 默认处理
esac

优化建议与实践经验

1. 应用排除列表
   在脚本中添加需要排除的应用列表（如系统颜色选择器），避免影响布局计算。

2. 窗口可见性处理
   正确处理隐藏窗口和最小化窗口，确保布局计算的准确性。

3. 平衡操作
   在关键操作后执行space --balance命令，保持布局整齐。

4. 调试技巧
   建议先通过命令行手动测试各个操作，确认效果后再集成到自动化脚本中。

未来展望

虽然当前方案能够部分解决问题，但最理想的解决方案还是Yabai原生支持主窗口布局功能。社区已有相关PR提交，用户可以关注项目更新以获取更完善的解决方案。

通过本文介绍的技术方案，用户可以在现有Yabai功能基础上，实现相对稳定的应用窗口布局，提升工作效率和操作体验。