用途:面向智能体驱动的 iOS 截图工作流,串联构建运行、UI 操作、截图采集、加框与上传。当前已实现构建/运行、AXe 计划采集、加框合成与上传;设备发现通过 asc screenshots list-frame-devices 内置;本地截图自动化命令在 asc CLI 中属实验性;加框固定 Koubou 0.18.1 以保证输出确定性。
主要能力与默认值:设置文件 .asc/shots.settings.json,采集计划 .asc/screenshots.json,原始截图目录 ./screenshots/raw,加框目录 ./screenshots/framed,默认加框设备 iphone-air。支持 --device 值:iphone-air、iphone-17-pro、iphone-17-pro-max、iphone-16e、iphone-17、mac。
使用方式:先用 xcodebuild 构建、simctl 安装启动;再用 asc screenshots run --plan 或 AXe 原语(describe-ui、tap、type、screenshot)采集;加框前执行 pip install koubou==0.18.1 并 kou --version 校验,缺设备框时运行 kou setup-frames;加框用 asc screenshots frame;上传前可用 review-generate/review-open/review-approve 审核,多语言批量建议用 asc screenshots plan 与 apply,上传用 asc screenshots upload。多语言采集应使用模拟器级 locale 默认值(按 UDID 分配),不要用 simctl launch -e AppleLanguages;可按 UDID 并行执行。
限制:截图本地自动化命令为实验性,需在交付说明中标注;运行前用 --help 确认参数,命令路径可能快速变化;机器步骤默认 JSON 输出;上传前确保文件存在;加框版本错误需重装固定版本 Koubou。收费、价格与平台支持等资料暂未提供。