KiwiDesk：macOS 平铺窗口管理器

项目简介

KiwiDesk 是一个为 macOS 打造的平铺窗口管理器，目标是让窗口平铺体验像 macOS 自带功能一样自然。装好并授予一项权限、按下 Start Tiling 就能开始使用，无需先写配置文件；想深入定制时，还可以使用 Lua 配置、profile、高级布局和按 Space 规则。

它面向两类人：不想折腾 dotfiles 的普通 Mac 用户，以及想脚本化自己工作流的进阶用户。

主要功能

• 开箱即用：下载后授予辅助功能权限、点击 Start Tiling 即可，自带一套合理的默认工作流。
• 可定制的进阶能力：Lua 配置文件、正式的 CLI 与事件流，可以编写任意自定义布局与规则。
• 应用内更新：软件自己检查更新，无需手动维护。
• 保留原生桌面：原生 Desktops（Space）保持完整可用。
• 抗系统升级：每个 Apple 私有 API 都有公开的降级方案；系统升级后只有少数依赖 Apple 桥接的功能会自动关闭，而不是让整个桌面失效。
• 界面与性能并重：提供设置菜单与图形界面，同时保证响应轻快。

更多功能对比与逐项说明见官网 对比页 与 功能页。

安装与使用

要求：macOS 14 或更高版本，Apple silicon 芯片。

通过 Homebrew 安装：

brew install --cask kiwicanopy/tap/kiwidesk

也可以从官网下载 .dmg，是与 cask 相同的已签名、已公证应用；cask 额外会把 kiwidesk CLI 放进 PATH。两种方式都由 KiwiDesk 自行检查更新。

首次启动时会有向导引导你完成辅助功能权限授权；在你按下 Start Tiling 之前，窗口不会有任何变化。设置、CLI 与 Lua 的用法见官方 Quick Start。

从源码构建

适合贡献者或想运行未发布提交的用户。需要 Xcode 27+ / Swift 6.4（应用本身运行于 macOS 14+）。

git clone https://github.com/KiwiCanopy/KiwiDesk.git
cd KiwiDesk
swift build -c release
.build/release/KiwiDesk

注意事项

• 仅使用辅助功能（Accessibility）权限，不需要关闭 SIP。
• 支持平台为 macOS（Apple silicon），需要 macOS 14 及以上。
• 许可证为 Business Source License 1.1：个人与工作场景使用免费；以产品或服务形式提供、销售、捆绑或托管本项目或其衍生作品需要商业授权。每个版本发布四年后转为 MIT。

本作品整理自 GitHub 开源项目 KiwiCanopy/KiwiDesk，原作者 @KiwiCanopy。中文介绍由 AI 根据项目 README 整理，以原仓库为准。