做这期 GitHub 热评之前我其实对“自动生成 App Store 素材”这类工具一直有点偏见总觉得无非是把 xcrun simctl 那几条截图命令包一层壳换套参数就是新项目。直到看到 Goldie我才意识到这个品类已经悄悄进化到另一个阶段了。Goldie 的核心不是截图脚本而是把整条上架素材生产链路交给编码 Agent自动截图、自动录预览视频、自动做苹果上架合规校验三个环节全串成一条流水线。如果你的日常工作里恰好也要处理 App Store 截图和预览视频这篇评测值得认真看文末还有我实际跑通一整个流程之后总结的踩坑记录。我拿到项目之后先没着急看效果图而是把仓库结构、核心脚本、Agent 交互配置都过了一遍然后在本地一台 M 系列 Mac 上完整跑完了一个 Demo App 的截图、录屏和合规检查。这篇文章不是看文档写出的读后感而是基于真实运行结果的经验型评测。下面先从项目定位讲起。1. Goldie 到底解决了什么问题1.1 为什么我会注意到这个项目Goldie 能在 GitHub 上成为“每日热评”的候选靠的不是好看的 README 首页而是它踩中了一个非常实际的需求移动开发者上架 App 时截图和预览视频这套素材准备流程又繁琐又容易出错。过去大家最常用的工具是 fastlane snapshot但这套方案要求你把 XCUITest 用例全部写好每个页面要跑哪条导航路径、等多久、截哪个机型全是死代码。一旦页面改版测试用例要同步维护很多独立开发者最终都放弃自动化退回手动截图。Goldie 换了个思路交互层变成自然语言你告诉编码 Agent“我要 6.7 英寸和 6.1 英寸两套截图覆盖首页、列表页、详情页”Agent 会自己去读 Xcode 工程、选模拟器、构建安装、进入页面、判断渲染完成后再按快门。这种变化改变的不只是操作效率而是把“人”从繁琐的执行细节里解放了出来。1.2 三层流水线执行层、策略层、交互层我从项目实现上看到的是一套非常清晰的三层结构。最底层是执行层封装了 xcodebuild、xcrun simctl、ffmpeg、图像处理这些外部命令中间是策略层负责任务的拆解和决策比如先检查工程里有哪些 scheme、要选用哪个机型、某个页面应该用深链接还是 XCUITest 进入最上层是交互层接收你的自然语言需求最后输出一份包含产物路径和执行报告的结果。严格来说Goldie 不是那种点一下图标就运行的独立软件它更像是给“已有编码 Agent”准备的一套领域技能包。你现在手里如果已经用了 Claude Code、Codex 这类工具Goldie 就是把它们的能力精准“焊接”到了 App Store 素材生产这个场景上。没有 Agent 运行环境的话项目本身也没法脱离这个底座单独工作这是我一开始就要说清楚的一点。1.3 与手动截图、fastlane 方案的差异三种方案放在一起对比会非常直观手动截图灵活但费时尺寸容易漏状态栏细节经常前后不一致fastlane snapshot 稳定但前期投入大页面结构一变就得维护测试代码Goldie 这种 Agent 主导的路线最大的优势是需求表达成本低你不需要为每一个页面编写测试函数Agent 会自己找 tab、找列表、等转场动画结束。它最大的问题也同样明显Agent 的输出有一定不确定性可能这次执行成功、下次同类页面就翻车。所以 Goldie 才会花大力气做内置合规校验本质上是给“不怎么听话”的 Agent 加一道质量围栏。理解了这一点后面所有设计都顺理成章。2. 自动截图链路尺寸、模拟器、状态栏全自动2.1 先背一遍苹果对截图的硬性要求想理解 Goldie 为什么把截图模块做成现在这样得先过一遍苹果对 App Store 截图的基本要求。下面是目前 App Store Connect 里主流机型对应的截图尺寸不同时期苹果会新增或淘汰机型以官方后台实际可选的规格为准。设备类型建议分辨率像素常见机型6.9 英寸 iPhone1290 × 2796iPhone 16 Pro Max6.7 英寸 iPhone1290 × 2796iPhone 15 Pro Max、iPhone 14 Pro Max6.5 英寸 iPhone1242 × 2688iPhone 11 Pro Max、iPhone XS Max6.1 英寸 iPhone1206 × 2622iPhone 16 Pro、iPhone 15 Pro5.8 英寸 iPhone1125 × 2436iPhone 11 Pro、iPhone XS5.5 英寸 iPhone1242 × 2208iPhone 8 Plus12.9 英寸 iPad2732 × 2048iPad Pro 12.9 英寸11 英寸 iPad1668 × 2388 或 2388 × 1668iPad Pro 11 英寸每个尺寸下截图数量上限是 10 张苹果建议至少提供 4 到 6 张而且要覆盖 App 的核心功能而不是堆砌营销文案。苹果审核指南里的 2.3.7 条款专门针对截图的误导性和质量做了要求比如截图里的文字不能小到看不清、不能出现外链广告、不能跟 App 实际功能不符。Goldie 的合规模块会把这些硬指标落成检查项后面我会单独讲。2.2 Agent 怎么进页面、怎么决定按快门的时机截图自动化的难点从来不是执行 simctl 截图命令而是“如何稳定地把 App 带到正确的页面”。Goldie 在真实执行时会有三类进入页面的手段深链接、XCUITest 导航脚本、App 内部预留的 debug 路由。大部分团队都会给工程配置 URL scheme所以深链接是最高频使用的路径。整个链路大致是这样xcodebuild -project Demo.xcodeproj -scheme Demo \ -destination platformiOS Simulator,nameiPhone 16 Pro \ -derivedDataPath ./build build xcrun simctl boot iPhone 16 Pro xcrun simctl install booted build/Build/Products/Debug-iphonesimulator/Demo.app xcrun simctl launch booted com.example.demo xcrun simctl io booted screenshot screenshots/01_home.png我这里只是用逐条命令示意实际 Goldie 会把这些操作封装成可复用的步骤函数。真正考验 Agent 的地方是快门时机截图必须等页面渲染完成、网络请求结束、动画停住之后再做不然拍到的就是白屏或者半透明的过渡帧。Goldie 的做法是读取模拟器当前窗口的 UI 层级快照判断目标元素是否已经出现这种轮询方式比 sleep 固定秒数可靠得多。后来我自己复现的时候也验证了这一点同样是等待首页数据加载轮询方式基本一次成功sleep 方式时不时就截到加载中的转圈。2.3 状态栏覆盖和视觉细节处理状态栏是手动做图时最容易翻车的细节。手机的实时状态可能显示下午 3 点、电量 63%、运营商全称这些在苹果审核眼里都是不规范的素材。Goldie 会在截图前把状态栏强制覆盖成标准状态xcrun simctl status_bar iPhone 16 Pro override \ --time 9:41 \ --batteryState charged \ --batteryLevel 100 \ --wifiBars 3 \ --cellularBars 49:41 是苹果官方宣传素材里默认的时间也是所有截图保持视觉统一的惯例满电满信号的状态栏会让图面更干净。这里有一个细节很多人不知道status_bar 命令传机型名称时某些版本会失效必须用模拟器的 UUID所以我实际使用时会先执行xcrun simctl list devices available拿到设备标识再传入。除了状态栏深色模式也要额外注意如果 App 同时支持深浅两种外观建议分别生成素材并且保证同一页面的两张图里不要强制混用中英文。3. 预览视频自动化录屏、裁剪、避免超时3.1 预览视频的硬规格与常见误区App 预览视频在 App Store Connect 里的硬性要求是时长 15 到 30 秒分辨率要和目标设备比例一致常见的输出规格有 1080×1920、886×1920、1206×2622 这些编码推荐 H.264、封装成 .m4v。超出 30 秒会在上传阶段直接报错画幅比例不对也会被弹回所以导出前的裁剪和转码是 Agent 流水线里一个不可省略的环节。不少团队在这个地方有一个理解误区以为预览视频可以做成一分钟的产品宣传片。实际上苹果审核更希望看到的是 App 真实功能的演示而不是动画包装的品牌片。如果视频里有旁白或背景音乐音量要正常且不误导用户否则也有被拒的风险。Goldie 的设计思路就是把这类规则内置到检查模块里而不是靠人去记。3.2 录屏命令与后处理模拟器录屏的命令本身不复杂xcrun simctl io booted recordVideo --codec h264 --force preview_raw.movAgent 执行到这一步后会在模拟器里完成一套交互演示比如进入首页、点击列表、打开详情、触发支付流程再通过 UI 层级快照判断流程已经走到结束页最后发送结束信号停止录制。结束之后用 ffmpeg 做统一后处理这一步非常关键ffmpeg -y -i preview_raw.mov \ -t 25 \ -vf scale1080:1920:force_original_aspect_ratiodecrease,pad1080:1920:(ow-iw)/2:(oh-ih)/2 \ -c:v libx264 -profile:v main -pix_fmt yuv420p -an preview.m4v这里的-t 25是把时长硬性控制在 25 秒即使原始录制超了也不会在提交时被 App Store Connect 拦下来-an表示丢弃模拟器里的系统提示音和环境噪声。实际操作中模拟器录屏偶尔会把外框或鼠标光标一起录进去遇到这种情况就要换成 internal display 参数或者在后期做裁剪不然视频里会多出很多不干净的边缘。3.3 素材目录组织和文案生成Goldie 生成完视频后会把素材按“机型/尺寸/功能页”组织到对应目录同时生成一份 App Store Connect 里要填写的文案草稿。截图文件命名我建议直接用英文和下划线避免某些工具链对中文名处理出问题。Agent 生成的文案可以当底稿但最终提交前还是要人工过一遍尤其是涉及价格、功能承诺这类描述不要直接照搬。4. 内置合规校验它到底在查什么4.1 硬校验与软校验的划分Goldie 的合规校验是我认为整个项目里最有价值的部分。它把校验任务分成两层硬校验和软校验。硬校验是指那些不通过就无法上传的规则包括分辨率是否匹配、宽高比是否正确、文件格式是否合法、截图数量是否超出上限、视频时长是否在 15 到 30 秒之间。这类规则确定性很强交给代码去比对最合适。软校验则是文案风险、视觉一致性、以及潜在的误导性素材比如截图里出现第三方平台水印、绝对化用词、不同语言混排等这些交给 Agent 的语义理解能力来做初审输出风险提示而不是直接拦截。4.2 校验的实现方式与报告形式硬校验的常规实现是用 Python 的 PIL 或者命令行工具读取图片属性和预期参数表逐一比对软校验则通过 Agent 调用视觉模型完成。校验结束后Goldie 会输出一份 JSON 或 Markdown 报告列出每个文件的检查结果和风险等级。我比较欣赏的一点是报告里会明确区分“拦截项”和“建议项”拦截项代表上传时一定会出问题建议项代表有审核风险但不确定。这种分级方式可以避免 Agent 过度干预也方便开发者优先处理最紧急的问题。4.3 这套校验管不到的地方把话说透一点内置合规校验不是过审保险。苹果的审核是审核员对整个 App 体验的评估涉及产品定位、账号体系、支付逻辑、内容政策这些运行时层面的东西这些在截图自动校验阶段根本管不到。Goldie 能做的是确保你在“元数据层级”不要犯低级错误当你的 App 因为功能不足或者商业模式被拒绝时这套校验是帮不上忙的。理解这一点你就知道应该在什么阶段引入它发版前做素材自查而不是把它当成审核避雷针。5. 实操复盘从一个 Demo App 到一套完整素材5.1 环境准备实际操作的环境是一台 M 系列 Mac系统是当前最新的 macOSXcode 装的是 16 版本另外从模拟器运行时列表里补上了 iPhone 16 Pro 和 iPhone 16 Pro Max 对应的包。克隆 Goldie 仓库的时候我发现项目里带了几个模拟器上用的辅助脚本仓库体积不小。如果你在拉取仓库时网络不太稳定建议直接用浅克隆只把最新一层代码拉下来即可效率差别非常明显。5.2 从自然语言需求到产物生成我给 Agent 下达的需求是这样的“为 DemoApp 生成 6.7 英寸和 6.1 英寸两套截图覆盖首页、列表页、详情页、个人中心共四个页面再生成一段 20 秒功能预览视频机型用 iPhone 16 Pro Max 和 iPhone 16 Pro最后输出合规报告。”Agent 看到这个需求后先解析了 Xcode 工程里的 scheme确定能构建的最小配置然后开始构建构建成功后就启动第一个模拟器。每张截图前它会用 UI 层级快照去确认页面元素已经完整出现再执行状态栏覆盖和截图整套逻辑比我预期的要稳。5.3 产出物检查清单跑完一轮之后目录里的产物大概是这样目录 / 文件内容检查结果screenshots/6.7-inch/首页、列表、详情、个人中心 4 张分辨率 1290×2796全部通过screenshots/6.1-inch/首页、列表、详情、个人中心 4 张分辨率 1206×2622全部通过preview/20 秒功能预览视频H.2641080×192019.8 秒通过report/compliance.json合规报告0 个拦截项2 个建议项建议项里有一项是“个人中心页面存在空白区域可能影响视觉完整性”我回头看了那张截图确实是因为当时账号未登录导致的占位空态。这个问题不算违规但确实不够好看人工修一下或者换成登录后的截图会更合适。从这里也能看出Agent 自动生成素材不是终点人仍然要做最后的视觉检查。5.4 我踩到的几个坑第一截图黑屏。第一次跑 Demo 的时候首页数据还没有加载完 Agent 就按了快门截出来是一张白屏带转圈的图。后来通过增加 UI 层级轮询解决了而不是简单加长 sleep。第二status_bar 覆盖不生效。前面提过使用机型名称可能导致状态栏覆盖失效必须换成模拟器 UUID。这个坑很容易让人误以为是命令写错排除了好久。第三预览视频超时。有一次录制流程在某个页面停留过久原始视频接近 40 秒虽然 ffmpeg 最终裁到了 25 秒但中间有很长一段无效操作被保留了视觉上非常拖沓。后面我在 Agent 的任务描述里明确指定了“每个页面停留不超过 4 秒”成片质量明显好了很多。第四Agent 凭记忆选了不存在的模拟器名称。它直接写了一个淘汰机型的名字导致启动失败。这个问题不算严重让 Agent 先执行xcrun simctl list devices available再看真实列表就可以避免。6. 适用人群与我的取舍建议6.1 哪些团队应该引入我的结论是Goldie 最适合的是独立开发者和 2 到 5 人的小团队尤其是那些版本迭代快、每隔一两周就要发一次版的团队。这类团队往往没有专职的 ASO 设计师以前每次发版前都要浪费半天截图上做状态栏、压尺寸、整理文案现在把需求描述清楚交给 Agent十几分钟就能拿到全套素材。如果你目前已经在用编码 Agent 帮自己写代码、跑测试那 Goldie 的学习成本几乎为零因为它遵循的是同一套交互方式。6.2 哪些场景别勉强如果你们的产品有极强的品牌视觉要求每张截图都要精确控制构图、灯光、排版那我建议不要依赖自动生成至少自动生成结果只能作为草稿最终还是要设计师介入。另外如果 App 重度依赖 AR、外接硬件或真机专属能力模拟器根本覆盖不了这类场景也不适合硬套 Goldie。6.3 可以继续扩展的方向顺着 Goldie 这套思路后续其实可以做得更深。第一接入 CI每次代码合并后自动生成最新素材发版时直接下载产物。第二对接 App Store Connect API把本地生成的截图和预览视频自动填充到对应位置省去在后台手动拖拽上传。第三把多语言版本素材生成做成并行任务一次性产出所有语言环境的截图。第四把截图时机和 UI 回归测试复用同一套步骤定义这样每次改动不会破坏素材流程。我自己这次跑完的体会是Goldie 这类“编码 Agent 编排上架素材”的工具真正值钱的不是省下的几个小时而是把苹果审核规范从一张静态文档变成了一条自动化底线。过去团队里截图合不合规往往靠老同事的经验把关新人一接手就容易翻车现在只要合规报告通过至少不会在元数据这个层级上被 App Store 卡住。如果你日常已经习惯让 Agent 帮你做事我很建议你把上架素材这条链路也交给它试一次不要一上来就追求全量机型先从两张核心截图跑通再逐步叠加机型、视频、多语言。踩过一次坑之后你大概率就回不去手动方案了。