software-mansion-labs/goldie

Goldie – 自动化 App Store 与 Google Play 截图及预览生成器

它是什么 Goldie 是一款命令行工具，可自动为 iOS App Store 和 Android Google Play 列表创建营销素材（截图、设备边框图像和短视频预览）。它在 iOS 模拟器或 Android 仿真器上（通过配套工具 Argent）重放 UI 流程，捕获屏幕，添加设备边框、背景、标题和布局，最后将所有内容拼接成可直接上架的视频。整个流程可以手动驱动，也可以通过 编码代理（例如 Cursor、Claude Code、Codex）驱动，由代理为您编写流程脚本和配置。

主要功能

功能	详情
跨平台	适用于任何移动框架 – SwiftUI、UIKit、Jetpack Compose、Flutter、React Native、Kotlin Multiplatform。
模拟器/仿真器驱动	使用 Argent 在 iOS 模拟器（仅 macOS）或 Android 仿真器（macOS、Linux、Windows）上重放预录流程。
设备边框与主题	添加逼真的设备边框（iPhone 17 Pro、iPad 13、Pixel 10 Pro 等）、自定义背景、字体和布局模板（编辑、展示、杂志、故事板等）。
本地化感知截图	默认情况下为所有语言环境生成一组捕获；可选的 `localizedCaptures` 标志按语言重新捕获。
预览视频生成	生成符合 App Store 预览要求的 15-30 秒 H.264 视频；同时为 Google Play 创建竖屏推广视频。
CLI 工作流	`goldie doctor`（环境检查）、`goldie all`（完整流程）、`goldie studio`（浏览器 UI 用于调整素材）。
AI 代理友好	提供技能，可添加到任何支持“技能”格式的编码代理平台，让代理发出自然语言命令，如 “使用 goldie 创建 App Store 截图”。
配置驱动	所有设置都位于 TypeScript 配置（`goldie.config.ts`）中 – 设备、语言环境、边框样式、主题、自定义字体、装饰、Android APK 路径等。

安装与先决条件

# Node 20+ 和 ffmpeg 必须在您的 PATH 中
npm i -g goldie

iOS – 装有 Xcode 的 macOS（iOS 模拟器）。
Android – Android 仿真器；在 Linux 上可能需要额外软件包（参见 Argent 文档）。
可选 – 将技能添加到您的编码代理：

npx skills add kacperkapusciak/goldie   # Cursor、Codex 等
/plugin marketplace add kacperkapusciak/goldie   # Claude Code
/plugin install goldie@goldie

典型工作流

创建配置 – 复制 goldie.config.example.ts → goldie.config.ts，并将每个场景指向一个 Argent 流程文件（.argent/flows/...）。
运行诊断 – goldie doctor 检查模拟器/仿真器和流程是否可访问。
生成素材 – goldie all 捕获、加框、渲染预览，并根据商店上传规则进行验证。
微调 – goldie studio 打开一个本地 Web UI，您可以在其中切换设备、背景、字体和文案；更改保存到 goldie.design.json 以确保可重现性。
查找输出 – 截图位于 out/screenshots/<device>/<locale>/；视频位于 out/previews/<device>/<locale>/。

如何与 AI / 编码代理集成

Goldie 本身不是 AI 模型，但它被构建为 代理就绪。该仓库附带一个技能，符合多个 LLM 驱动的编码助手使用的通用“技能”格式。当代理收到自然语言请求（例如 “使用 goldie 创建 App Store 截图”）时，它可以：

提示开发者选择目标商店和语言环境。
自动生成或更新 goldie.config.ts 和底层的 Argent 流程脚本。
调用 CLI（goldie all），然后将生成的素材呈现给用户。因此，Goldie 充当了 LLM 驱动的编码工作流与 App Store 营销所需的具体平台特定素材之间的桥梁。

谁可能使用它？

希望自动化生成符合商店要求的截图和预览视频这一繁琐过程的移动开发者。
已经使用 AI 编码助手并希望助手处理完整素材流程的团队。
需要为多个客户应用提供可重复、可定制解决方案的代理机构（如 Software Mansion）。

赞助

Goldie 由 Software Mansion 开发和赞助，该公司是底层流程重放引擎 Argent 的创建者。