关键事实
- PaperWM.spoon 是一个 Hammerspoon Spoon,而不是独立的 Mac 应用。
- 其 README 提供了克隆命令和 Lua 配置示例。
- README 要求用户修改两项调度中心设置:关闭空间的自动重新排列,并开启显示器的单独空间。
- 如果你希望使用可配置的、基于 Lua 的设置,它很适合;不想维护 Hammerspoon 配置的人,可能会选择其他工具。
先安装 Hammerspoon
从其官方网站获取 Hammerspoon,查阅日期为 2026 年 11 月 12 日。打开一次后,按照 macOS 的权限提示操作。Hammerspoon 会运行自动化脚本,因此在加载你选择的代码之前,请先检查你安装的内容。PaperWM.spoon 项目的 README 描述了这个插件及其设置。我们并未在每个 macOS 版本上测试这些步骤。
PaperWM.spoon 的官方 README(查阅日期为 2026 年 11 月 12 日)给出了以下安装命令:
``bash git clone https://github.com/mogenson/PaperWM.spoon ~/.hammerspoon/Spoons/PaperWM.spoon ``
在“终端”中运行它。它会把仓库克隆到 Hammerspoon 使用的 Spoons 文件夹中。如果你使用自定义的 Hammerspoon 配置目录,请把目标位置改为与之一致。
设置调度中心选项
README 指示你进入“系统偏好设置”→“桌面与程序坞”,并找到“调度中心”部分。在当前的 macOS 中,请打开“系统设置”→“桌面与程序坞”,然后向下滚动到“调度中心”。关闭根据最近使用情况自动重新排列空间,并开启显示器具有单独的空间。具体文字和位置可能因 macOS 版本而异。README 将这些选项列为设置的一部分。
这些是影响 macOS 如何处理空间的系统级选择。更改之前,请先判断它们是否符合你的设置。如果你使用多台显示器,请确认它们的空间行为符合你的预期。
加载并启动 Spoon
打开 Hammerspoon 的配置文件 ~/.hammerspoon/init.lua,添加以下 Lua 代码行:
``lua PaperWM = hs.loadSpoon("PaperWM") PaperWM:bindHotkeys(PaperWM.default_hotkeys) PaperWM:start() ``
保存文件。然后从 Hammerspoon 的菜单栏图标中选择重新加载配置。第一行加载 Spoon,第二行注册文档中记录的默认快捷键,第三行开始管理窗口。项目 README 还展示了 SpoonInstall 的安装方式和自定义快捷键示例。在修改按键之前,先使用它的默认设置,这样你才能判断设置是否已成功加载。
要停止 PaperWM.spoon,可以通过 Hammerspoon 的控制台或配置调用 PaperWM:stop()。如果启动时报告找不到 Spoon,请检查克隆的文件夹是否命名为 PaperWM.spoon,并且位于 Hammerspoon 使用的 Spoons 目录中。在同时修改多项设置之前,请先检查 Hammerspoon 控制台中是否有 Lua 错误。
检查快捷键并做一项更改
PaperWM.spoon 的README(查阅日期为 2026 年 11 月 12 日)记录了以下默认设置:用 Option–Command–方向键聚焦,用 Option–Command–Shift–方向键交换位置,用 Option–Command–R 循环切换宽度。它还展示了浮动、空间和窗口大小调整的快捷键。如果某个快捷键与其他应用冲突,请编辑 Lua 表,重新加载配置;如果插件停止响应,请检查 Hammerspoon 控制台。
Spoon 自身的配置可以筛选应用,并调整窗口比例。README 将 window_filter 和 window_ratios 列为配置项。只更改文档中能找到说明的设置,然后测试一个普通应用窗口,以及一个你希望排除的应用。维护者还指出,macOS 限制把窗口完全移到屏幕外,因此位于边缘的平铺窗口可能仍会部分可见。
这是一套基于 Lua 的工具链。它适合那些能够阅读配置文件、并希望利用 Hammerspoon 灵活性的人。如果你更喜欢独立应用和设置窗口,这种设置可能会让你觉得维护起来很费力。PaperWM.spoon 的权威说明是它的 README;开源项目可能会有变化,因此请在按照说明操作之前查看仓库。
PaperWM.spoon 的 README 称它“受 PaperWM 启发”,并链接到 PaperWM 项目,查阅日期为 2026 年 11 月 12 日。两个项目各自拥有独立的实现和设置说明。
我们开发了 SlidePane,这是一款 macOS 应用,适合希望在无需维护 Lua 脚本的情况下配置窗口布局的人。如果你更喜欢应用内设置和内置快捷键控制,它可能适合你;如果你想使用 PaperWM.spoon 所基于的 Hammerspoon 脚本模型,PaperWM.spoon 则更合适。应用的设置步骤请参阅安装 SlidePane 并开始免费试用。
相关页面
Mac 上的 Niri:分步复现相同的工作流比较了另一种滚动工作流。快捷键和键盘布局介绍了如何检查应用中的快捷键绑定。