yabai

<img width="75%" src="https://yellow-cdn.veclightyear.com/835a84d5/11716043-e6e2-4c32-b33d-0ffd6de884f2.svg" alt="横幅"> Mac系统的平铺式窗口管理工具。 <a href="https://github.com/koekeishiya/yabai/blob/master/LICENSE.txt"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/b5284ac3-a2ac-4570-b8a6-4aa11fff571c.svg?color=green" alt="许可证徽章"> </a> <a href="https://github.com/koekeishiya/yabai/blob/master/doc/yabai.asciidoc"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/6c818198-d799-4a49-ae4c-604b89d3a219.svg" alt="文档徽章"> </a> <a href="https://github.com/koekeishiya/yabai/wiki"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/3d32ee0d-df20-4444-9444-3fb201983f88.svg" alt="维基徽章"> </a> <a href="https://github.com/koekeishiya/yabai/blob/master/CHANGELOG.md"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/9ab73329-8c81-4bcd-ae84-0d46bee83461.svg" alt="更新日志徽章"> </a> <a href="https://github.com/koekeishiya/yabai/releases"> <img src="https://yellow-cdn.veclightyear.com/835a84d5/97c13f7f-ac31-4166-a137-803c8f45a522.svg?color=green" alt="版本徽章"> </a>

关于

yabai 是一个窗口管理工具，旨在作为 macOS 内置窗口管理器的扩展。yabai 允许你使用直观的命令行界面自由控制窗口、空间和显示器，还可以选择使用 [↗ skhd][gh-skhd] 和其他第三方软件设置用户自定义的键盘快捷键。

yabai 的主要功能是平铺式窗口管理；使用二叉空间分割算法自动修改窗口布局，让你专注于窗口内容而不受干扰。yabai 的其他功能包括鼠标跟随焦点、禁用切换空间的动画、创建超过 16 个空间的限制等等。

安装和配置

[↗ yabai wiki][yabai-wiki] 提供了多种安装方法的简要和详细说明，还解释了如何完全卸载 yabai。
在 [↗ examples][yabai-examples] 目录中可以找到示例配置文件。更多信息请参考 [↗ 文档][yabai-docs] 或 wiki。
可以使用 [↗ skhd][gh-skhd] 或其他适合的软件定义键盘快捷键。

要求和注意事项

请仔细阅读以下要求。在提交问题之前，请确保满足所有要求。

要求	说明
操作系统 Intel x86-64	支持 Big Sur 11.0.0+、Monterey 12.0.0+、Ventura 13.0.0+ 和 Sonoma 14.0.0+。
操作系统 Apple Silicon	支持 Monterey 12.0.0+、Ventura 13.0.0+ 和 Sonoma 14.0.0+。
辅助功能 API	yabai 必须获得使用辅助功能 API 的权限，并将在启动时请求访问。授予权限后必须重启应用程序。
屏幕录制	如果你想启用窗口动画，yabai 必须获得屏幕录制权限，并在必要时请求访问。授予权限后必须重启应用程序。
系统偏好设置（macOS 11.x, 12.x）	在调度中心面板中，必须启用"显示器具有单独的空间"设置。
系统设置（macOS 13.x, 14.x）	在桌面与程序坞标签中的调度中心面板内，必须启用"显示器具有单独的空间"设置。

请同时注意以下事项。

注意事项	说明
系统完整性保护（可选）	可以（部分）禁用系统完整性保护，让 yabai 将脚本添加注入到 Dock.app 中，以使用需要提升权限的函数控制窗口。这样可以控制窗口服务器（所有窗口连接的唯一所有者），并启用 yabai 的其他功能。
代码签名	从源代码构建（或从 HEAD 安装）时，必须对二进制文件进行代码签名，以便在更新或重新构建时保留其辅助功能和自动化权限。
访达桌面	有些人使用未公开的 defaults write 命令禁用了访达桌面窗口。这会导致无法聚焦空白空间，使用 yabai 时应避免这样做。要重新激活访达桌面，请运行："defaults write com.apple.finder CreateDesktop -bool true"。
基于 NSDocument 的应用程序	使用原生 macOS 标签的窗口（如终端和访达）在创建标签时无法正常工作。避免在这些应用程序中创建标签，考虑使用不使用 NSDocument 标签系统的替代方案，或使用规则使这些窗口浮动。
系统偏好设置（macOS 11.x, 12.x）	在调度中心面板中，应禁用"根据最近使用情况自动重新排列空间"设置，以确保依赖空间排序的命令可靠工作。
系统设置（macOS 13.x, 14.x）	在桌面与程序坞标签中的调度中心面板内，应禁用"根据最近使用情况自动重新排列空间"设置，以确保依赖空间排序的命令可靠工作。
系统设置（macOS 14.x）	在桌面与程序坞标签中的桌面与舞台管理器面板内，应启用"在桌面上显示项目"设置，以确保在多显示器配置中显示和空间聚焦命令可靠工作。
系统设置（macOS 14.x）	在桌面与程序坞标签中的桌面与舞台管理器面板内，"点击壁纸以显示桌面"设置应设为"仅在舞台管理器中"，以确保显示和空间聚焦命令可靠工作。