codingsamss/peekaboo

Peekaboo 视觉分析 Skill

通过peekaboo进行macOS截图和视觉分析，帮助调试UI问题。

截图保存目录

默认目录变量：

PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"

所有截图保存到: ${PEEKABOO_IMG_DIR}/

自动触发条件

当遇到以下情况时，主动使用peekaboo截图分析：

• 用户描述UI/界面问题但未提供截图时
• 调试前端/客户端代码遇到视觉相关bug时
• 用户提到"看看"、"界面"、"显示"、"样式"、"报错弹窗"等词汇时
• 命令执行后需要确认GUI状态时
• 用户描述的问题可能通过视觉信息更容易理解时

截图策略

• 默认使用 --mode frontmost 截取当前活动窗口
• 用户提到具体应用时，使用 --app "应用名" 指定
• 需要分析内容时，使用 --analyze "分析目标" 直接获取AI分析
• 需要定位UI元素时，使用 --annotate 生成带标注的截图
• 必须使用 --path 参数指定保存路径到 peekabooImg 目录

常用命令

截取当前窗口

PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
peekaboo see --mode frontmost --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --json

截取指定应用

PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
peekaboo see --app "IntelliJ IDEA" --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --json
peekaboo see --app "Safari" --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --json
peekaboo see --app "Terminal" --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --json

截图并AI分析

PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
peekaboo see --mode frontmost --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --analyze "描述界面内容"

列出所有窗口

peekaboo list windows --json

截取指定标题窗口

PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
peekaboo see --window-title "窗口标题" --path "${PEEKABOO_IMG_DIR}/screenshot_$(date +%s).png" --json

清理规则

重要：截图任务完成后，必须执行清理操作：

# 清理截图文件
PEEKABOO_IMG_DIR="${HOME}/Documents/peekabooImg"
rm -f "${PEEKABOO_IMG_DIR}"/*.png

# 清理peekaboo快照缓存
peekaboo clean --all-snapshots 2>/dev/null || true

清理时机：

• 截图分析完成并向用户反馈结果后
• 用户明确表示不再需要截图时
• 任务结束时

使用原则

• 截图前简要说明原因
• 优先截取相关窗口而非全屏
• 分析结果要结合代码上下文给出建议
• 任务完成后务必清理截图文件和缓存

前置条件

1. peekaboo已安装: brew install steipete/tap/peekaboo
2. 已授予屏幕录制权限: 系统设置 > 隐私与安全性 > 屏幕与系统音频录制