用途:面向智能体驱动的 iOS 截图工作流,用 Xcode CLI 构建并启动应用,用 AXe 驱动界面,用 asc 上传截图。当前已实现构建/运行、AXe 计划采集、加框合成与上传;设备发现通过 asc screenshots list-frame-devices 内置;本地截图自动化命令在 asc CLI 中属实验性;加框固定使用 Koubou 0.20.0 以保证输出确定性。
默认配置:设置文件 .asc/shots.settings.json,采集计划 .asc/screenshots.json,原始截图目录 ./screenshots/raw,加框目录 ./screenshots/framed,默认加框设备 iphone-air。
主要能力与用法:先创建设置 JSON,再用 xcrun simctl boot、xcodebuild、simctl install/launch 构建运行;采集优先用 asc screenshots run --plan;AXe 原语包括 axe describe-ui、axe tap、axe type、axe screenshot。加框前需 pip install koubou==0.20.0 并验证 kou --version,必要时运行 kou setup-frames;用 asc screenshots frame 加框,支持 iPhone、iPad、mac、watch、apple-tv 等设备值。上传前可 review-generate、review-open、review-approve,多语言批量建议用 asc screenshots plan 与 apply,再执行 asc screenshots upload。
多语言与并行:不要用 simctl launch -e AppleLanguages 切换语言,应按 UDID 设置模拟器全局语言与区域,每个语言对应独立模拟器,可并行采集、加框与上传。
限制:截图本地自动化命令为实验性;运行前需用 --help 确认参数;上传前确保文件存在;加框版本错误需重装固定版本 Koubou,缺少设备边框需联网运行 kou setup-frames。反馈地址见 https://github.com/rorkai/App-Store-Connect-CLI/issues/new/choose。