用途：在 macOS 上用 Hammerspoon 与 Lua 脚本实现桌面自动化，包括窗口管理、快捷键绑定、应用控制与插件（Spoon）管理。
主要能力：配置文件入口为 ~/.hammerspoon/init.lua，启动时自动加载；可用 hs.loadSpoon 加载 Spoon 插件；支持 hs.hotkey.bind 绑定快捷键；常用模块有 hs.window（移动、缩放、最大化、居中）、hs.application（启动或聚焦应用）、hs.alert（屏幕提示）、hs.notify（系统通知）、hs.caffeinate（防止休眠、监听睡眠事件）。ShiftIt 是常用的窗口平铺 Spoon，可绑定左右上下半屏、四分之一屏、最大化、全屏切换、居中、跨屏移动与缩放等快捷键；修饰键在 Lua 中写作 'cmd'、'ctrl'、'alt'、'shift'。
使用方式：在 init.lua 中加入 require("hs.ipc") 以启用 hs 命令行，首次需手动重载一次；随后可用 hs -c 'hs.reload()' 重载配置、hs -c 'hs.alert("Hello from CLI")' 显示提示或执行任意 Lua 代码。Spoon 安装可手动解压到 ~/.hammerspoon/Spoons/名称.spoon/，也可用 SpoonInstall 从官方或自定义仓库安装，例如 spoon.SpoonInstall:andUse("ReloadConfiguration", { start = true })。配置重载可用菜单栏图标、绑定快捷键或 ReloadConfiguration/pathwatcher 自动监听 .lua 文件变化触发 hs.reload()。
适用场景：macOS 桌面窗口整理、快捷键自动化、应用快速切换、系统事件响应等。
限制与注意：IPC 报“can't access Hammerspoon message port”时需确认 init.lua 已加 require("hs.ipc") 并手动重载；Spoon 不加载需检查路径与 Lua 语法；快捷键需排查与系统快捷键冲突，修饰键名须为小写字符串；未保存到变量中的对象可能被垃圾回收。调试可用 print、hs.inspect 与菜单栏控制台。官方资料未提供收费、价格与平台版本信息，此处暂未提供。