用途：在 macOS 上安装、配置、修复并验证 Hammerspoon，实现键盘驱动的多显示器窗口摆放、Spaces 控制、Chrome 搜索范围等。以捆绑的模块化配置为唯一事实来源，模块位于 assets/hammerspoon/modules/，分别处理显示器移动、窗口布局、Spaces、窗口选择器、Chrome 与 Claude 桌面行为。
安装或刷新：运行 scripts/install-hammerspoon-config.sh。安装脚本要求 macOS 与 Homebrew；在缺失时安装 Hammerspoon；修改前备份已有受管配置；将 ~/.hammerspoon/init.lua 与 ~/.hammerspoon/modules 符号链接到本技能捆绑资源，同时保留 Spoons/ 等无关条目；启动 Hammerspoon 并通过配置启用登录时启动。符号链接使已安装技能成为实时事实来源，更新仓库或刷新 SkillPort 后，用 ctrl+alt+cmd+r 重载 Hammerspoon 生效；当链接已指向当前版本时重复运行安装脚本是幂等的。不要将凭据、私有机器清单、显示器序列号或账户数据写入此公开配置；显示器按虚拟桌面位置动态编号。
权限：Hammerspoon 需要 macOS 辅助功能权限。权限被禁用时打开系统设置 → 隐私与安全性 → 辅助功能。通过 Computer Use 启用该设置需要操作时确认。权限变更后重启 Hammerspoon。仅勾选权限行不足以证明，需验证 hs.accessibilityState() 并执行真实窗口操作。
常用绑定：ctrl+alt+left/right/return 分别为左半屏、右半屏、最大化；ctrl+alt+cmd+j/k/l/ö 将窗口发送并最大化到显示器 1–4（按从左到右、再从上到下排序）；ctrl+alt+cmd+u/i/o/p 聚焦显示器 1–4；ctrl+alt+cmd+h 标识编号显示器；ctrl+alt+cmd+/ 打开可搜索窗口选择器；ctrl+alt+cmd+r 重载配置。显示器模块优先使用标准 macOS 窗口 → 移到菜单，以规避 macOS Tahoe 下辅助功能返回零尺寸 AXApplication 占位符的问题；对无标准菜单的应用回退到直接 hs.window 移动。
验证：检查运行时状态可运行 /opt/homebrew/bin/hs -c 'return tostring(hs.accessibilityState()) .. "|" .. tostring(hs.autoLaunch()) .. "|" .. tostring(#hs.hotkey.getHotkeys())'。随后向一个可丢弃的可见窗口发送实际快捷键，并在每次按键后验证可观察结果：目视确认左半屏、右半屏与最大化；通过检查目标显示器在应用的“移到”菜单中消失来确认每个已连接显示器按键；未连接的第四台显示器视为未测试，不得声称移动成功；确认 AltTab 及所需启动器在排障后仍在运行。不要仅因热键已注册或函数无错误返回就报告成功。