Hammerspoon

概述

Hammerspoon 是一款功能强大的 macOS 自动化工具，它将操作系统与 Lua 脚本引擎桥接起来，让用户能够通过编写 Lua 脚本来深度控制和自动化 macOS 的各个方面。

核心功能

• 系统 API 桥接：通过一系列扩展模块，将 macOS 的系统功能暴露给 Lua 脚本引擎
• 全面覆盖：支持应用程序、窗口、鼠标指针、文件系统、音频设备、电池、屏幕、键盘/鼠标事件、剪贴板、定位服务、Wi-Fi 等
• 事件驱动自动化：通过 Lua 配置文件将系统事件与自定义操作连接起来

主要特性

🎯 窗口管理

• 自定义键盘快捷键控制窗口布局和位置
• 实现应用程序窗口的快速排列和切换
• 创建复杂的窗口操作序列

⌨️ 输入设备控制

• 低级键盘和鼠标事件监控与重映射
• 创建全局快捷键触发复杂操作
• 实现自定义的输入设备行为

🌐 网络自动化

• 根据 Wi-Fi 网络连接状态触发操作
• 自动执行网络相关的配置和任务
• 基于网络环境的变化调整系统设置

🔋 系统状态监控

• 电池电量监控和提醒
• 系统事件触发器（如屏幕锁定、用户切换等）
• 硬件状态变化的自动化响应

🔧 深度集成

• 与 AppleScript 无缝集成
• 访问 macOS 原生 API
• 支持位置服务触发（如基于地理位置的自动化）

优势特点

💪 强大灵活

• 无限制的自动化：几乎可以控制 macOS 的任何方面
• Lua 脚本支持：使用轻量级但功能强大的 Lua 语言进行编程
• 模块化设计：通过扩展模块轻松添加新功能

🎨 高度可定制

• 个性化配置：每个用户都可以创建完全独特的自动化设置
• 社区插件：支持使用“Spoons”（预制的插件包）
• 渐进式学习：从简单脚本到复杂系统都可以实现

🔄 响应式架构

• 事件驱动：实时响应系统状态变化
• 后台运行：低资源占用，持续监控
• 即时生效：配置更改无需重启立即应用

使用场景示例

1. 工作效率提升：一键整理所有工作窗口布局
2. 智能环境适应：根据连接的网络自动切换工作模式
3. 健康提醒：定时提醒休息，调整屏幕亮度
4. 创意自动化：当检测到特定地理位置时自动播放音乐
5. 开发辅助：自定义开发环境的热键和自动化流程

社区与生态

• 活跃社区：拥有 Discord 服务器供用户交流讨论
• 丰富文档：完整的 API 文档和入门指南
• 开源贡献：欢迎开发者贡献新的扩展和功能
• 插件生态系统：大量的“Spoons”插件可供选择使用

技术基础

• 核心语言：Lua 5.3/5.4
• 系统支持：需要 macOS 10.12 或更高版本
• 架构：Objective-C + Lua 的混合架构
• 配置方式：~/.hammerspoon/init.lua 主配置文件

适合人群

• 追求工作效率极致的专业人士
• 喜欢自动化重复任务的用户
• 开发者和技术爱好者
• 需要对 macOS 进行深度定制的用户

Hammerspoon 不仅仅是一个自动化工具，它更像是给 macOS 赋予了一个可编程的智能大脑，让用户能够真正按照自己的方式使用电脑。虽然上手需要一定的学习成本，但一旦掌握，它将成为你提升 macOS 使用体验的终极利器。

提示：新手建议从官方入门指南开始，逐步探索各种可能性。社区非常友好，遇到问题可以随时在 Discord 或 GitHub 上寻求帮助。