Peekaboo

Peekaboo 是什么

为 macOS 提供命令行 UI 感知与操作能力，从截图和元素标注到点击、输入、菜单、窗口、Dock、剪贴板和 Space 管理。

适用场景

适合桌面应用自动化、截图文档、可视化测试、跨应用重复操作和难以通过 API 完成的流程。

核心能力与工作机制

完整清单覆盖 see 快照、元素 ID 与坐标定位、图像捕获分析、鼠标键盘、系统对话框、应用窗口、脚本运行和 JSON 输出。

执行流程

先检查屏幕录制与辅助功能权限，用 list/see 获取应用、窗口和标注快照；优先按元素 ID 操作，动作后重新观察并验证状态。

输入与输出

需要目标应用、窗口或元素、操作序列、可接受等待和输出路径。输出截图、快照 ID、JSON 状态或实际桌面操作结果。

依赖、账号与权限

仅适用于 macOS，依赖 Peekaboo CLI、Screen Recording 与 Accessibility 权限；分析功能可能还需模型配置。

副作用、限制与风险

GUI 状态易变化，坐标点击可能误触；剪贴板、文件选择和对话框可能暴露敏感数据。会真实点击、输入、启动或退出应用、移动窗口、读写剪贴板和保存截图。

不适用边界

不能绕过系统权限或登录验证，也不应在未确认目标时执行删除、提交、付款等高影响动作。

失败处理与验收

重新执行 see 获取新快照，检查焦点、窗口 ID、权限和等待条件；不要复用失效坐标连续点击。每个关键动作后重新读取 UI 或截图，核对目标应用、元素状态和最终文件。

适合谁使用

适合 macOS 自动化、测试和桌面 Agent 开发者。

来源、版本与许可

本条目依据 SkillHub 热门榜、发布者详情和版本 1.0.0 的完整 SKILL.md 整理，核验日期为 2026 年 9 月 21 日。完整 SKILL.md 未声明许可证，公开可下载不代表可以任意复制、修改或再分发。 SkillHub 当前两套安全扫描状态为 benign、benign；该状态只是平台信号，不能替代对脚本、凭据、网络请求、数据外送与后续版本的人工审查。

常见问题

1. Peekaboo 主要解决什么问题？

为 macOS 提供命令行 UI 感知与操作能力，从截图和元素标注到点击、输入、菜单、窗口、Dock、剪贴板和 Space 管理。适合桌面应用自动化、截图文档、可视化测试、跨应用重复操作和难以通过 API 完成的流程。是否采用它，应以实际任务边界和可核验材料为准，不要因为榜单热度而跳过来源审查。

2. 开始前需要准备什么？

需要目标应用、窗口或元素、操作序列、可接受等待和输出路径。准备阶段不要代替用户猜测关键事实；缺少会改变路线、费用或权限的输入时，应先补齐再执行。

3. 它怎样完成任务并交付结果？

先检查屏幕录制与辅助功能权限，用 list/see 获取应用、窗口和标注快照；优先按元素 ID 操作，动作后重新观察并验证状态。每个阶段都要保留输入、决策、输出和检查点，不能把计划、预览或排队状态描述成最终交付。

4. 需要哪些工具、账号或权限？

仅适用于 macOS，依赖 Peekaboo CLI、Screen Recording 与 Accessibility 权限；分析功能可能还需模型配置。凭据应放在安全环境中，并按最小权限授权；账号、网络或本地依赖不满足时应明确停止条件。

5. 它会产生哪些外部操作或副作用？

会真实点击、输入、启动或退出应用、移动窗口、读写剪贴板和保存截图。涉及外部写入、上传、发送、付费或持久配置时，应在实际动作前说明影响范围并取得相应确认。

6. 哪些情况不适合使用？

不能绕过系统权限或登录验证，也不应在未确认目标时执行删除、提交、付款等高影响动作。超出来源明确能力、专业资质或授权范围时，应切换到更合适的工具或交给专业人员处理。

7. 失败或结果异常时怎样恢复？

重新执行 see 获取新快照，检查焦点、窗口 ID、权限和等待条件；不要复用失效坐标连续点击。恢复时优先查询已有任务、日志或备份，避免无上限重试、重复扣费、重复发送或覆盖唯一原件。

8. 如何验收结果并控制风险？

每个关键动作后重新读取 UI 或截图，核对目标应用、元素状态和最终文件。验收应基于真实文件、页面、任务终态或权威来源，并把未能实际检查的部分明确标记出来。