Goldie

为什么需要

出海做移动端产品，App Store 和 Google Play 上架前最磨人的一关不是写代码，是出图。苹果要求 iPhone 端 1320×2868 截图，谷歌要求 1080×1920，预览视频还要压在 15-30 秒之间。每个尺寸都要套设备框、写文案、换背景、做不同语言版本，做一遍够呛，做十种语言直接劝退。

Goldie 把这整套流程压成一条命令。它驱动 iOS 模拟器和 Android 模拟器回放你的应用流程，截下真实界面，套上设备框和背景文案，按商店上传规范自动校验，输出一份能直接传的截图包。对独立开发者来说，省掉的不只是几个小时人工，是一个反复调整尺寸-导出-校验的死循环。

怎么用

1. 安装 CLI：npm i -g goldie
2. 在 App 仓库里把示例配置 goldie.config.example.ts 复制成 goldie.config.ts，把场景指向 argent 流程文件
3. 三条核心命令：
   bash复制

   goldie doctor    # 检查工具链、模拟器、流程是否就绪
   goldie all       # 抓图 → 加框 → 渲染预览 → 校验规范
   goldie studio    # 浏览器里预览和微调素材
   

4. 给 Coding Agent 装 Skill：
   复制

   npx skills add kacperkapusciak/goldie
   

   然后在仓库里直接说 "create app store screenshots using goldie"，Agent 会自动探索 App、写流程、打开 studio。

输出落在 out/screenshots/<device>/<locale>/ 和 out/previews/<device>/<locale>/，按设备和 locale 分目录，方便做多语言版本。

界面

Studio 是一个浏览器里的可视化编辑器：切换设备、背景、模板、设备框、字体、每张图的文案都能改，改完存到 goldie.design.json，CLI 用同一份配置渲染。模板库自带 editorial / showcase / magazine / storyboard / dynamic 五种风格，也支持自定义布局序列（classic / copy-below / hero / offset / tilt / duo / panorama / minimal）。

设备框内置 iPhone 17 Pro 的蓝/银/橙三色，可换自定义框图。字体打包了 Merriweather / DM Mono / Lato / DM Sans / Montserrat / Noto Sans SC（含中文），海外小语种可以直接换字体栈。

使用案例

出海开发者做多语言版本：一套流程 10 种语言，过去要切 10 次导出；goldie 把 locale 做成配置项，CLI 跑一次产出 10 个目录。改一个文案不需要重抓图，studio 里改完保存，CLI 再跑一遍就出新版本。

MVP 阶段没专职设计：debug 构建上 LogBox 横幅会糊进截图里（这点 README 明确提醒要用 Release 构建），但 goldie 不依赖设计稿，直接对真实界面截图套框，省下外包或自己拼 Figma 的成本。

注意事项

• 环境要求：macOS + iOS 模拟器 + Node 20+ + ffmpeg，Google Play 还需要 Android 模拟器（推荐 Pixel 10 Pro 或 Pixel 9 Pro 硬件配置，AVD 1280×2856 屏）
• 依赖 argent：goldie 通过 argent 在模拟器里回放 UI 流程，argent 流程变化时需要让 Coding Agent 修复或重新录制
• 开源协议：MIT License
• 赞助方：Software Mansion（argent 背后的团队）