Lua 驱动的 macOS 桌面自动化

从重复点击到一行脚本

macOS 的桌面本身并不缺效率工具，但真正消耗注意力的，往往是那些每天要重复好几次的「小动作」：把窗口拖到左半屏、切到右半屏，打开特定应用，然后手动调整层级。每次只花几秒，累积起来却足够打断心流。Hammerspoon 的价值在于，它把窗口、快捷键、系统事件这些原本需要鼠标点的接口，变成 Lua 可调用的函数，让你能用脚本描述「当按下某个键时，应该发生什么」。

四大能力域

这个技能把自动化分成四个方向，方便按需组合：

• 窗口：通过 hs.window 和 hs.layout 实现平铺、聚焦、跨屏移动，甚至一键切换整套布局预设。
• 输入：用 hs.hotkey 绑定全局热键，配合 hs.menubar 在菜单栏提供入口。
• 系统：hs.wifi、hs.pasteboard 等模块支持监听 Wi-Fi 变化、电源状态、剪贴板内容，触发条件或后续动作。
• 提示：hs.notify 和 hs.alert 负责在后台任务完成或异常发生时给出通知。

从痛点到可维护的配置

落地时建议先定一个高频痛点，比如「终端放左、浏览器放右」，再用 hs.hotkey.bind 绑到顺手的组合键。验证手感后，把 ~/.hammerspoon 拆成多个 require 文件，按功能模块划分，避免单个配置文件膨胀。之后可以继续用 hs.layout 定义几套工作场景，比如「写作」「调试」「演示」，用热键一键切换。

为了稳定，给每条热键脚本加上错误保护，避免某个模块崩溃导致整个 Hammerspoon 退出。

边界与注意点

桌面自动化脚本以 macOS 官方 API 行为为准，涉及键盘记录、剪贴板监听等能力时，应仅限本地自用，并遵守系统隐私授权规范。

部署前检查四件事：配置是否拆模块、支持 hs.reload 热加载；热键是否与常用 App 冲突；是否有「一键关闭所有自动化」的紧急开关；敏感监听是否只走本地、不外传。