Hammerspoon

Hammerspoon 是一款 macOS 桌面自动化应用，通过 Lua 脚本引擎连接系统 API。它面向熟悉编写小型脚本、希望自定义键盘快捷键、窗口工作流和事件驱动自动化的用户。仅安装应用并不会提供一套现成的自动化功能：具体行为取决于你的配置。

功能

• 绑定快捷键，并自动调整窗口位置、执行应用操作和桌面工作流。
• 通过 Lua 回调响应屏幕、网络、电源及其他系统事件。
• 检查并控制受支持的音频设备、剪贴板和输入行为。
• 通过可用 API 显示通知、菜单和自定义界面。
• 集成 shell 任务、AppleScript 以及受支持的应用或系统扩展。
• 安装可选的可复用 Lua 插件 Spoons；每个 Spoon 都有自己的设置和依赖项。

安装与配置

安装 brew install --cask hammerspoon，或下载官方 ZIP，解压后将 Hammerspoon.app 移至“应用程序”。启动应用并创建 ~/.hammerspoon/init.lua。使用菜单编辑并重新加载配置；通过控制台检查错误并进行交互式 Lua 实验。可以从将快捷键绑定到通知这样的简单配置入手，再逐步扩展为窗口或应用自动化。官方入门指南和 API 文档提供了可运行的示例。

如果要自动化桌面应用或输入操作，请在 macOS“系统设置”中为 Hammerspoon 授予“辅助功能”权限。其他操作可能需要各自的系统权限，例如“自动化”或“屏幕录制”。仅启用配置所需的权限。脚本和 Spoons 会以你的用户权限运行；安装前请审查代码。

cask 还会链接到随附的 hs 命令行工具。命令行通信通过 Hammerspoon 的 IPC 模块配置；仅建立链接并不会启用所有 IPC 功能。

系统与依赖项

当前的1.1.1版本和 Homebrew Cask 要求 macOS13 或更高版本。Cask列出的平台包括 Intel 和 Apple Silicon Mac。Hammerspoon仅适用于 Mac；其 macOS API 集成不提供 Windows、Linux、iOS 或 Android 客户端。旧版本的要求不能代替1.1.1的要求。官方资料未规定最低 RAM 或磁盘空间。

官方1.1.1 ZIP 根据 GitHub 发布资源元数据，大小为9,704,557字节。已安装的应用、脚本和缓存还会占用额外空间。Lua 和应用扩展已随应用提供；cask未声明额外的 formula 依赖项，也未明确说明存在 cask 冲突。编译源代码需要 Xcode 和构建工具，但使用发布版应用不需要这些工具。可选的 Spoons、shell 命令和集成可能需要另行安装工具或服务账户。

自定义快捷键和窗口自动化可能与其他地方配置的快捷键或窗口管理器相冲突。这类交互取决于具体配置，并非已声明的软件包冲突。必要时请禁用或调整重复绑定。操作系统变更以及目标应用的辅助功能行为可能影响个别自动化 API。

数据、账户、费用与许可证

核心本地自动化不需要 Hammerspoon 账户或订阅。该项目免费且采用 MIT 许可证；在保留规定声明的前提下，允许使用和修改，包括商业用途。随附库和可选 Spoons 各自遵循其许可证；脚本调用的托管服务可能另有费用和账户要求。官方常见问题说明，崩溃报告默认启用，可在“偏好设置”中关闭；请查阅项目的隐私政策。

Homebrew zap 包含 ~/.hammerspoon、应用偏好设置、缓存和已保存状态。该配置目录包含自定义 Lua 脚本和 Spoons，因此进行彻底清理前请先备份。移除应用不会撤销脚本执行的所有外部操作，也不会删除集成所用的账户。

官方参考资料

• 产品：https://www.hammerspoon.org/
• 入门指南：https://www.hammerspoon.org/go/
• API 文档：https://www.hammerspoon.org/docs/
• 常见问题与隐私：https://www.hammerspoon.org/faq/ 和 https://www.hammerspoon.org/privacy.html
• 源代码、MIT 许可证和发布版本：https://github.com/Hammerspoon/hammerspoon
• 官方 Spoon 仓库：https://github.com/Hammerspoon/Spoons