Hammerspoon macOS 上的可编程自动化引擎：以 ~/.hammerspoon/init.lua 为入口，把窗口位置大小（hs.window / hs.layout）、快捷键（hs.hotkey）、剪贴板、菜单栏控件、屏幕抓取、音频与设备事件等系统 API 开放给 Lua 脚本。适合把「到某个 Wi-Fi 就切换工作模式」「插入耳机自动调音量」「写代码时把编辑器固定左半屏」这类零碎规则固化下来，配置可进 Git 跨机器同步。
核心亮点
- 配置即代码：init.lua 可进 Git/Sync，换机一条命令恢复全部工作流
- hs.layout 精确指定窗口位置尺寸，实现自定义平铺方案
- hs.hotkey 把任意组合键绑定到脚本动作，绕过系统快捷键限制
- Wi-Fi、电源、USB/蓝牙设备变化可触发自动化（如插耳机调音量、接电源改配置）
- 模块丰富：剪贴板历史、菜单栏控件、屏幕抓取、AppleScript 桥均可直接调用
适用人群
愿意写一点 Lua、想把 Mac 工作流彻底固化的进阶用户与开发者。
安装前请注意
需要授予辅助功能、屏幕录制等系统权限才生效；本身没有图形界面与配置面板，门槛高于 Rectangle/Loop 这类成品工具，改坏了要会看 Console 报错。
极速安装方式
方式一：macOS Homebrew
brew install hammerspoon
