macOS界面自动化

技能简介

Peekaboo 是一款 macOS 界面自动化命令行工具，支持屏幕捕获、UI 元素检测、鼠标键盘模拟、应用窗口管理及系统交互操作。

业务背景

Peekaboo C 帮助团队将重复性的 macOS 界面操作转化为可复用的自动化脚本，无需人工值守即可完成批量数据处理、跨应用协作和定时任务执行。业务人员可通过命令行快速搭建工作流，降低手动操作出错率，释放人力投入高价值分析决策。

落地案例：某运营团队每日需从财务系统导出报表并上传至内部平台。使用 Peekaboo C 编写脚本：自动启动财务软件、定位下载按钮完成点击、模拟快捷键保存文件至指定路径、切换浏览器窗口完成上传提交。全程无需人工干预，早晨上班即可获取处理结果，避免因漏操作导致的数据延迟。

能做什么

• 捕获屏幕、窗口或菜单栏区域图像，支持标注与分析
• 模拟点击、拖拽、滚动、滑动等鼠标操作
• 模拟键盘输入、快捷键、特殊按键序列
• 启动、退出、切换、隐藏应用及调整窗口状态
• 读取和写入剪贴板内容
• 执行 JSON 格式的自动化脚本
• 检查屏幕录制和辅助功能权限状态

使用说明

安装指令：

brew install steipete/tap/peekaboo

基础使用流程：

1. 检查权限：peekaboo permissions
2. 查看应用列表：peekaboo list apps --json
3. 捕获带标注的界面图：peekaboo see --annotate --path /tmp/see.png
4. 点击指定元素：peekaboo click --on B1
5. 输入文本并回车：peekaboo type "Hello" --return

所有命令支持 --json 输出便于脚本集成，运行 peekaboo <cmd> --help 查看具体参数。

输入与输出

见下方输入与输出表格。

风险提示

• 需要开启屏幕录制和辅助功能权限，否则无法捕获界面或模拟输入
• 自动化操作可能影响当前工作状态，建议在测试环境验证脚本
• 坐标和元素 ID 可能随界面变化而失效，需配合快照机制使用
• 部分操作（如应用退出、窗口关闭）可能导致未保存数据丢失

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/steipete/peekaboo/SKILL.md
来源类型：开源社区技能库