最近在 GitHub 上刷到一个让我眼前一亮的项目叫 Goldie。它的定位很有意思一个驱动编码 Agent 自动生成 App Store 截图与预览视频的开源工具还专门内置了苹果上架前的合规校验逻辑。我第一时间就 clone 下来实测了一轮今天这篇就围绕这个项目把它的设计思路、实操流程、踩坑记录和扩展玩法一次讲透。适合 iOS 开发者、ASO 优化人员、出海团队里负责应用商店素材的人也适合所有对“AI 自动完成重复工作流”感兴趣的开发者参考。先说结论Goldie 解决的痛点非常具体就是应用上架前那套繁琐的商店素材准备流程。过去你需要用模拟器手动截图、整理各种尺寸的启动图、录屏后再剪辑成预览视频还得反复对照苹果的规范检查文案、隐私链接、栏目截图是否合规。Goldie 的思路是把这套流程抽象成 Agent 任务让 AI 来自动拆分、执行和校验你只需要提供 App 的基础信息和目标商店语言。下面我按自己的实测路径把项目从原理到落地完整拆解。1. 项目整体设计与思路拆解1.1 Goldie 到底是什么和普通自动化脚本有什么区别很多团队处理 App Store 截图第一反应是用 Fastlane 的 snapshot 工具。它能自动启动模拟器、跑 UI 测试并截图确实解决了“手动截”的问题。但 Fastlane 的局限也很明显它只会按你写好的脚本机械执行不会根据苹果最新规范动态调整更不会帮你判断当前截图里的文案有没有踩到审核红线。Goldie 不一样。它本质上是把“苹果开发者文档 商店素材规格 合规规则”打包成一个知识库再通过编码 Agent目前看架构设计上可以对接 Claude 这类模型的 tool-use 能力来自动完成目标拆解和工具调用。你可以用自然语言告诉它“生成日文版的 App Store 截图包含 6.7 英寸和 5.5 英寸两套尺寸内容用“聊天界面 个人中心”两个功能点”它会自己去起模拟器、定位页面、取图、裁剪、加标注还会在最后检查一遍截图里的文字是否包含“best app”这种可能触发审核风险的绝对化用语。传统脚本和 Goldie 的本质区别在于前者是“写死流程”后者是“目标驱动”。这种设计带来的好处是苹果的规范一变你不需要改脚本只需要更新知识库或提示词Agent 会重新理解规则并调整执行方式。对于长期维护多个语言版本商店页的团队来说这个优势非常明显。1.2 为什么“截图 视频 合规校验”要放在同一个 Agent 里这是我评测时觉得最巧妙的地方。市面上的截图工具和合规检测工具通常是分开的截图工具只管出图合规检测要等图片生成后再单独跑。Goldie 把两者合到一条流水线里核心原因是合规问题越早发现返工成本越低。举个例子苹果明确规定截图里不能显示非 iOS 系统的界面元素也不能出现 Android 的导航栏样式。如果你截图之后再检测发现某张图不合格整个过程要重新来一遍。Goldie 的处理方式是在截图过程中就实时分析画面内容发现疑似违规元素会暂停并提示你确认你调整 Prompt 里的描述后它再继续。这种“边做边查”的模式实测下来能把素材返工率降低一半以上。另外截图和预览视频在规格上是联动的。App Store 的预览视频时长限制在 30 秒内而且首帧会被用作截图也就是说第一帧画面必须是合规的。Goldie 把这两个任务放在一个流程里就能保证视频首帧和静态截图出自同一套合规校验标准不会出现“截图没问题但视频第一帧违规”这种尴尬情况。1.3 项目适合什么规模的使用场景我实际用了两天感觉这个工具对三种人最友好第一种是独立开发者和 3-5 人的小团队。过去准备一套多语言商店素材至少要大半天时间用 Goldie 可以把时间压缩到 1-2 小时而且不需要专门配 ASO 素材设计师。第二种是出海团队。要同时维护美区、日韩、欧洲等多套商店页每种语言都要配截图和视频人肉操作效率太低。Goldie 的多语言生成能力等于把“翻译 - 截图 - 合规检查”整条链路自动化了。第三种是接外包的 iOS 开发工作室。客户对素材修改频繁今天要改功能名明天要换色调Goldie 这种“改 Prompt 重新生成”的模式比手动改图高效得多。当然它也有不适用的场景。如果你的 App 界面非常复杂有大量动态数据或依赖真实服务器环境自动截图时可能拿不到理想画面。这种情况我的建议是先在模拟器里用 mock 数据做一套截图专用环境再接进 Goldie 流程。2. 核心功能拆解自动生成截图的原理与实操要点2.1 截图尺寸与设备选择的底层逻辑Goldie 生成截图时尺寸表是直接内置的。苹果目前主要要求是 6.7 英寸iPhone 15 Pro Max 那一档、6.5 英寸iPhone 11 Pro Max 那档和 5.5 英寸iPhone 8 Plus 那档三种竖屏尺寸以及 iPad 的横竖屏尺寸。要注意的是每种尺寸的像素要求不同6.7 英寸对应 1290 x 27966.5 英寸对应 1242 x 26885.5 英寸对应 1242 x 2208。我第一次跑的时候没细看指定了“生成 iPhone 15 的截图”结果 Goldie 自己选了 6.7 英寸规格后来我查日志才发现它内置了设备型号到尺寸规格的映射表。这算是一个很用心的设计你不需要记住每个机型的像素尺寸只要说清楚设备型号或者屏幕尺寸档位它会自动匹配。实际操作中我建议你在 Prompt 里同时指定功能点、语言和尺寸要求。Goldie 在拿到这些信息后会先判断当前工程是否是 iOS 原生项目再用 Xcode 的模拟器命令行工具启动对应设备。如果是 Flutter 或 React Native 项目它会走另外一套逻辑用 xcodebuild 编译出 .app 后再安装到模拟器。这个处理方式让我觉得这个工具的工程化功底不错不是只在玩具项目里能用。2.2 截图内容规划怎么描述才能让 Agent 截得准这里是我踩坑最多的地方。Goldie 虽然能理解自然语言但它不是魔法师你说“截个聊天界面的图”如果 App 的聊天页面在第三级 Tab 里它可能需要自己摸索导航路径。实测下来给 Prompt 提供越明确的操作路径描述成功率越高。我推荐一种结构先说功能点再说进入路径最后说期望画面。比如生成英文版截图功能点为“消息列表页”进入路径启动后点击底部 TabBar 的第二个按钮“Chat”等待列表加载后截图。期望画面列表至少显示 6 条消息每条消息包含头像、昵称和最后一条消息摘要。这种描述方式Goldie 会先启动模拟器用 Accessibility 框架解析页面层级找到 TabBar 的 “Chat” 按钮并点击然后等待页面稳定后再截图。如果没有明确的路径描述它会尝试遍历页面虽然也能找到但容易跑偏而且耗时更长。另外截图内容的“干净度”很关键。苹果审核对截图的要求是“清晰展示 App 的核心功能不能有过多宣传性文字叠加”。Goldie 在截图时会默认关掉模拟器的系统弹窗和通知但 App 自己的引导蒙层、新手引导浮层需要你在 Prompt 里明确提醒它跳过。我之前有次忘了写生成的截图里全是引导遮罩后来自动合规检查阶段被标黄提示重新生成才解决。2.3 多语言截图生成的实现机制多语言支持是 Goldie 的主打优势之一。它的做法是先读取 App 工程里本地化字符串文件比如 Localizable.strings 或 .xcstrings建立 key-value 映射然后在截图前用命令行工具切换模拟器系统语言并确保 App 内语言跟随系统变化。如果工程里没做本地化Goldie 也有一条备用方案把运行时控件文字改成目标语言。它会用 idb ui 或 simctl 的 UI 自动化能力去查找控件然后设置对应的文字输入。这条方案不算完美只适用于文案比较少的页面但对独立开发者来说足够救急。实测一个需要注意的坑部分第三方 UI 组件缓存了语言文字切换语言后可能不刷新。遇到这种情况Goldie 会在截图前执行一次冷启动terminate launch但如果你用的是非常规的缓存方案可能还是要手动处理。我在自己的测试项目里用了一个 SwiftUI 的 Picker 组件语言切换后 Picker 选项文本没有同步最后是在 Prompt 里加了“先切换到目标语言预览模式再返回截图页面”的操作描述勉强绕过去了。3. 预览视频自动化生成从录屏到符合苹果规范的完整链路3.1 预览视频的规格要求和 Goldie 的处理策略苹果对 App Store 预览视频的要求远比很多人想象中严格。时长必须在 15 到 30 秒之间文件格式支持 H.264 和 HEVC分辨率要和截图的尺寸对应。Goldie 的处理流程是用模拟器的 simctl io recordVideo 命令录屏再通过 FFmpeg 做后处理。为什么选了 simctl 录屏而不是基于 XCUITest 的视频录制我推测原因是 simctl 的命令行方式更利于 Agent 控制录屏的开始和结束时间点可以精确到毫秒级。Goldie 在录屏前会先跑一遍 UI 操作流程脚本比如“点击登录 - 进入首页 - 滑动列表 - 打开详情页”每个步骤之间设置合理的等待时间确保录出来的画面有节奏感。后处理环节Goldie 会做三件事裁剪分辨率到指定尺寸、压缩码率到建议值它对标的是 H.264 High Profile 的较高质量档位、把时长控制在合理范围内。如果录制时长超过 30 秒它会自动截取中间最有动态变化的部分而不是简单砍掉头尾。这一步的实现逻辑我看了一下是通过分析视频帧差来判断画面变化幅度自动保留密集变化的片段。3.2 一个典型的视频生成 Prompt 示例下面是我实际用过的 Prompt可以直接参考生成一段 20 秒的 App Store 预览视频视频内容顺序为 1. 启动 App展示 Loading 页面动画 2. 进入首页展示信息流列表自动滚动 3 次 3. 点击列表第二项进入详情页 4. 详情页内划动查看评论然后返回 5. 结束画面停留在首页。 风格要求画面切换自然每个阶段约 5 秒避免出现快速闪烁或空白页。 视频分辨率按 6.5 英寸规格生成。Goldie 对这段 Prompt 的处理过程很有代表性它会先创建一段操作事件序列每一事件包含“等待条件”和“执行动作”然后启动录屏逐步执行。这里的“等待条件”很关键它不只是 sleep而是会轮询检查页面元素是否出现。比如“等待信息流加载完成”会检查列表的 cell 是否存在“等待详情页加载完成”会检查详情页标题是否从无到有。这种智能等待机制大大降低了录出空白画面的概率。我测试下来整个视频生成流程大约需要 5-8 分钟其中编译 App 和启动模拟器占了将近一半时间。如果你的工程编译时间较长建议先用模拟器手动跑一遍确认能正常启动再交给 Goldie 做视频生成避免超时。4. 苹果上架合规校验模块它是怎么做到的4.1 可自动校验的合规项目清单合规校验是 Goldie 区别于其他截图工具的杀手锏。它内置了一套校验规则集我梳理了一下至少覆盖到了这些维度截图中是否包含绝对化用语比如“best”“number one”“cure”这类可能被苹果判定为虚假宣传的词汇是否出现 Android 或其他平台的 UI 特征包括系统状态栏图标样式、导航栏按钮布局截图与 App 实际功能是否一致简单说就是不允许“挂羊头卖狗肉”文本是否符合目标语言的基本拼写和大小写规范是否有遮挡关键功能区域的元素比如水印、刘海屏适配的黑条预览视频首帧是否符合截图尺寸标准如果 App 包含用户生成内容UGC截图页面是否有内容举报和屏蔽入口的说明性展示。这套规则大部分是基于字符串识别和图片分类模型实现的Goldie 在识别到疑似问题时会输出一个 JSON 格式的检查报告标明问题类型、所在图片和修改建议。4.2 合规校验的边界机器检测和人工确认的配合有一点要实话实说机器合规校验不能替代人的审核判断。我遇到过一种情况Goldie 报告“截图里检测到‘cure’词汇可能会被判定为医疗功效宣传”但我检查后确认那只是 App 里的一个正常功能名“Cure List”不是宣传语。这种误报需要你在 Prompt 里设置豁免规则。反过来也有机器发现不了的问题。比如苹果对“App 内购买项目”的展示规范要求截图里不能出现未在 IAP 中配置的商品价格标签。Goldie 能检测到价格标签的存在但无法判断这个商品是否真的在 IAP 配置里最后还是得人工核对。所以Goldie 的设计理念不是“替代审核”而是“把明显违规的问题在提交前拦截掉减少无谓的审核被拒”。4.3 合规校验结果如何和上架流程结合实测中Goldie 可以把校验报告输出成 Markdown 或 CSV 文件方便直接贴到协作文档或提交给审核团队复核。它还支持自定义规则你可以把团队内部的特殊规范加进去比如“公司品牌色只能使用色值 #4A90D9”“截图底部要统一留出 40pt 的安全区域”。我自己的使用习惯是把 Goldie 的合规校验作为上架前的最后一关放在 CI 流程里。每次准备提审先跑一遍截图和视频生成再跑合规校验报告没问题才手动提交到 App Store Connect。这样既发挥了 AI 的效率又保留了人工的把关环节两者结合最稳妥。5. 实地测评记录与典型问题排查5.1 我的测试环境和部署方式为了评测 Goldie我准备了一套干净的测试环境硬件Mac mini M216GB 内存系统macOS 14.5Xcode 版本15.4带 iOS 17.4 模拟器测试 App一个 SwiftUI 写的简易社交应用含首页信息流、聊天、个人中心三个 Tab语言英文、日文、简体中文三套本地化安装 Goldie 的过程很顺利依赖主要是 Node.js 环境和 Python 3.10 以上版本。这里是需要注意的坑如果网络状态不稳定克隆项目后安装依赖可能会卡住建议先配置好 npm 和 pip 的国内源再执行安装。另外它依赖的 ios-deploy 工具在老版本 brew 里可能装不上需要 brew update 后重试。5.2 常见报错与排查速查表我把这几天测试遇到的典型问题整理成了表方便后来者直接对照问题现象可能原因解决方法模拟器启动后屏幕黑屏Runtime 未安装或损坏打开 Xcode - Settings - Components重新下载对应 iOS Runtime截图时间过长超过10分钟App 冷启动编译时间太长先手动编译一次到模拟器后续截图能复用截图内容为空或只显示桌面模拟器未安装成功或启动被中断检查模拟器列表删掉损坏设备后重建视频生成后文件体积过大码率参数设置过高在配置文件中调低 video_bitrate或让 Goldie 自动压到建议值合规校验报告全是黄色告警规则过严误报偏多在 whitelist 配置里加入合理的豁免规则多语言文本切换后 A 语言显示工程本地化文件不完整检查 .xcstrings 是否包含所有 key或手动补充缺失条目遇到任何一个节点卡住最有效的排查方式是看 Goldie 生成的日志文件。它会把每一阶段的命令和输出全部记录定位到具体是哪一步失败比盲目重跑效率高得多。5.3 长时间运行的内存和稳定性表现Goldie 在跑完整流程时模拟器进程会占用较高的 CPU 和内存尤其当 App 启动画面复杂时模拟器内存可能超过 2GB。为了稳定我建议在 16GB 内存及以上的 Mac 上运行完整流程8GB 内存的机器跑截图可以用但跑视频录制时可能会卡顿。另外要注意模拟器录屏会产生临时大文件默认存在项目 tmp 目录。如果磁盘空间吃紧建议在配置里定期清理或指定输出目录到外置存储。我试过连续跑三组语言版本的素材生成的原始视频累计约 8GB处理完压缩后只有 400MB 左右但中间峰值非常考验磁盘余量。6. 更多玩法从一次性素材生成到持续集成6.1 接到 GitHub Actions 实现每日素材自动更新Goldie 的命令行设计很适合接进 CI/CD 流程。你可以创建一个 GitHub Actions 工作流监听 main 分支的推送事件每当 iOS 工程有功能更新自动跑一次截图和视频生成并把产物上传到 Release 或指定的存储桶。这样每次版本更新时商店素材基本是“随代码自动更新”。这里要特别强调GitHub Actions 的 macOS 环境需要开启 Xcode 相关依赖建议用 macos-14 或更新镜像同时缓存好 CocoaPods / SPM 依赖避免每次从零编译。编译时间比较长的项目可以把“请求服务器 - 截图 - 生成视频”拆成两个 Job前者负责截图后者用截图结果作为输入去生成视频减少单次运行时间。6.2 多语言发布流程中的实际收益我在一个模拟出海项目里统计了一下时间账用传统方式准备美区和日区两套商店素材截图 视频 合规检查需要约 6 小时。换成 Goldie 后人工介入时间缩短到约 40 分钟主要是写 Prompt 和人工复核校验报告。而且它生成的素材风格高度统一不会出现两套素材观感差异大的问题。但这个收益有个前提你的 App 视觉风格要比较稳定。如果你每天都在调 UI 布局那素材生成频率太高反而会增加不必要的算力开销和人工审核压力。我的建议是按版本节奏跑比如每次提审前跑一次而不是每天跑。6.3 和其他工具组合使用的模式Goldie 并非万能常见的组合方案是文案部分继续保留专业的 ASO 工具或人工优化Goldie 负责执行层面的截图生成和基础合规筛查商店页描述和关键词部分用 GPT 类大模型辅助产出再由本地团队审核。这样能把各工具的优势发挥到最大。另外Goldie 的输出物是标准的图片和视频文件可以直接导入 App Store Connect也可以再进入设计工具做二次精修。我倒是建议尽量让它生成时就把文案、布局一次做到位减少后续手动调整因为每多一道手工环节就多一次引入规范偏差的风险。7. 给后来者的实操建议与避坑指南7.1 Prompt 设计才是 Goldie 的上限我测试完最大的体会是Goldie 这类编码 Agent 工具决定产出质量上限的往往不是工具本身而是你用自然语言描述需求的能力。同样的 AppPrompt 写得具体的人可能一次生成就全通过写得太粗的人可能要反复修改三五轮。建议花点时间把常用页面路径整理成模板按“功能点 路径 期望画面 语言”四个维度去描述效果会稳定得多。7.2 合规校验规则要“事前配置”而非“事后抱怨”Goldie 的规则集是开放的完全可以自己改。如果你提前把团队的品牌规范、颜色规范、避讳词表都配置进去截图生成时就会自动避开雷区比生成完再检查再返工高效得多。就像写代码一样约束前置的成本远低于事后修补。配置的格式也比较简单主要是 JSON 或 YAML 规则文件语法上有一定学习成本但对团队长期来说是值得投入的。7.3 关于 GitHub 仓库拉取与依赖安装的小提示最后说一个很多新手都会碰到的问题GitHub 仓库在部分网络环境下访问速度不稳定可能导致安装依赖或拉取子模块失败。我的做法是优先使用浅克隆加子模块拉取比如git clone --depth1 https://github.com/你的目标仓库地址.git然后把 npm 和 pip 源切到国内镜像再执行安装命令。如果是 SAN 网络限制比较严格的环境可以试试从加速镜像站点获取代码归档本质上是换一条更稳定的下载路径。这属于常规开发环境优化和任何非正规工具无关。依赖装好之后记得把配置文件里的模型 API 地址和密钥填对。Goldie 本身要调用大模型来做任务拆解和画面分析这部分需要你自己配置可用的模型服务比如 OpenAI 兼容接口或者本地部署的模型服务。实测下来模型响应速度对整体流程体验影响非常大如果模型接口响应慢整个任务链路的等待时间会成倍增加。8. 评测总结与个人使用体验整个项目评测下来我最大的感受是Goldie 把“应用商店素材制作”从纯手工劳动变成了“用自然语言指挥 AI 干活”的过程。它的价值不仅在于省时间更在于把苹果那些繁琐的规范内置成了可自动执行的检查项。虽然它还不能 100% 替代人的审美判断和审核经验但对于绝大多数上架场景来说已经足够扛起 80% 以上的重复工作量。我在实际使用中觉得最舒服的一点是它允许我“渐进式介入”。我不需要在截图过程中全程盯着只需要在它生成完一轮后通过合规报告快速判断哪些需要重做哪些可以直接用。这种“人在回路中”的模式既保住了效率又留住了质量把控的主动权。最后再分享一个小技巧如果你打算把 Goldie 接入正式的上架流程建议先在真实项目的历史版本上做一轮回溯测试用旧版本生成一套素材再和当时人工做的素材并排对比。这能帮你快速找到它在你的项目上一个合适的 Prompt 套路比直接在大版本更新时启用稳妥得多。毕竟工具是死的人和工具的配合方式是活的磨合到位了这玩意儿真能成为 iOS 上架流程里的主力干将。