Yabai窗口管理器在macOS Sonoma系统中的智能工具提示处理方案

macOS Sonoma系统引入了一种新型的UI工具提示元素，用于指示文本输入状态和大写锁定等上下文提示。这类工具提示在某些应用程序中会频繁出现，导致与Yabai窗口管理器的交互出现异常。

问题现象

在Sonoma系统中，当用户激活文本输入框时，系统会自动生成两种类型的工具提示：

1. 基础输入提示（显示为向上箭头图标）
2. 长时间空闲后出现的扩展提示（显示为"A"图标）

这些工具提示在Yabai管理的窗口环境中会产生两个主要问题：

1. 工具提示出现时窗口会突然"跳动"或重新排列
2. 工具提示可能被错误地纳入窗口管理范围

技术背景

Yabai作为macOS的平铺式窗口管理器，默认会尝试管理所有可见窗口元素。在早期版本中(6.0.4及之前)，系统工具提示被识别为常规窗口元素，导致管理冲突。

解决方案演进

初期解决方案（Yabai 6.0.4及之前版本）

用户可以通过添加特定规则将应用程序置于"below"层：

yabai -m rule --add app="^应用程序名$" manage=on layer=below

但这种方案会导致工具提示出现时窗口位置重置的问题。

改进方案是将应用程序置于"above"层：

yabai -m rule --add app="^应用程序名$" layer=above

这种方法避免了工具提示被管理，同时保持其可见性。

现代解决方案（Yabai 6.0.6及之后版本）

新版本中已内置对系统工具提示的智能处理：

1. 默认不管理工具提示窗口(subrole=AXDialog)
2. 保持工具提示在正确层级显示
3. 无需额外配置即可正常工作

最佳实践建议

1. 确保使用Yabai 6.0.6或更新版本
2. 对于特殊需求，可使用子角色过滤规则精确控制：

yabai -m rule --add subrole=AXDialog manage=off

3. 避免不必要的层级调整规则，除非有特定UI定制需求

技术原理

Yabai新版本通过识别系统工具提示的特殊子角色属性(AXDialog)，实现了对这些临时UI元素的智能忽略。这符合macOS辅助功能API的设计规范，确保了系统原生UI元素与窗口管理器的和谐共存。

对于开发者而言，这展示了如何通过识别系统UI元素的元数据属性来实现精细化的窗口管理策略，值得在类似工具的开发中借鉴。