用途:在 macOS 上对原生应用做桌面自动化与端到端测试,例如调试 macOS 应用、测试原生应用、自动化 macOS 工作流。不适用于 Web 应用测试(应改用 Chrome MCP 或 Playwright)、跨平台测试或 Linux 桌面自动化。
主要能力:通过 hs.eventtap 模拟键盘与鼠标(keyStrokes、keyStroke、leftClick、scrollWheel 等);通过 hs.application 启动、聚焦、隐藏、终止应用及点击菜单项;通过 hs.window 获取、移动、缩放、最大化、最小化窗口;通过 screencapture 或 hs.screen 截图取证;也可用 cliclick 做简单键鼠控制。
使用方式:先确认已安装 hs CLI 与 Hammerspoon.app,缺失则停止。一次性配置 ~/.hammerspoon/init.lua 加入 require("hs.ipc"),授予辅助功能权限,并在控制台执行 hs.ipc.cliInstall()。可用 hs -c '...' 执行内联 Lua,或 hs /path/to/script.lua 运行脚本。执行截图或 E2E 前必须先完成 dev-tdd 的六道门禁:BUILD、LAUNCH(文件日志)、WAIT、CHECK PROCESS、READ LOGS(不可跳过)、VERIFY LOGS。
限制:辅助功能权限为一次性设置,跳过则无自动化证据;每次测试需在 LEARNINGS.md 记录脚本、输出、结果与截图路径。cliclick 缺少应用控制能力,复杂测试应优先用 Hammerspoon。具体安装命令与价格信息资料未完整提供。