majiayu000 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
清理时机：
- 截图分析完成并向用户反馈结果后
- 用户明确表示不再需要截图时
- 任务结束时
使用原则
- 截图前简要说明原因
- 优先截取相关窗口而非全屏
- 分析结果要结合代码上下文给出建议
- 任务完成后务必清理截图文件和缓存
前置条件
- peekaboo已安装:
brew install steipete/tap/peekaboo - 已授予屏幕录制权限: 系统设置 > 隐私与安全性 > 屏幕与系统音频录制