SuperAPI AI 工具集

screenshot

测试与质量

查看项目

更新于 10-16 01:33

技能介绍

用途:在 iOS Simulator 上捕获截图,用于文档、调试和视觉验证。基于原生 xcrun simctl 命令,无需外部依赖,只需安装 Xcode。

主要能力:可保存模拟器当前画面为 PNG;在提供参数时,读取截图并按指令分析,如描述屏幕内容、检查特定 UI 元素是否存在、验证某项内容、提取全部可见文字,或执行任意其它指令;每次执行都会报告保存路径。

使用方式:先创建目录:mkdir -p llmtemp/screenshots;然后捕获:TIMESTAMP=$(date +%Y%m%d_%H%M%S);xcrun simctl io booted screenshot llmtemp/screenshots/screenshot_${TIMESTAMP}.png。若 $ARGUMENTS 为空,仅保存并报告路径;若提供参数,则保存后读取截图并执行对应指令。示例:screenshot;screenshot take a look;screenshot is there a login button?;screenshot extract all visible text。

高级选项:多模拟器运行时用 UDID 替代 booted;格式 --type=png(默认)或 --type=tiff;画面 --display=1(主屏)、--display=2(副屏,如 Apple Watch);iOS 15+ 可用 --mask=black 遮蔽敏感数据。更多用例见 references/advanced.md。

适用场景:为文档、调试、视觉回归或 UI 验证快速获取模拟器画面,并按需进行内容分析。

限制与排障:报错 “No such device: booted” 表示没有运行中的模拟器,可用 xcrun simctl list devices | grep Booted 检查;截图空白或全黑时等待内容加载并确保模拟器未最小化;截错模拟器时改用具体 UDID。截图保存在 llmtemp/screenshots(已被 gitignore),文件名带时间戳避免覆盖,捕获的帧缓冲不含模拟器外框,PNG 为无损格式。具体收费、跨平台支持等信息暂未提供。