Goldie 是一个面向 iOS 应用的 App Store 截图与预览视频生成工具，使用 TypeScript 编写。它通过 iOS Simulator 驱动应用流程，捕获界面后自动套用设备边框、背景、标题文案和模板，并生成符合 Apple 上传规则的截图与 H.264 预览视频。它既可以由开发者手动配置使用，也可以作为 coding agent 的 skill，让 AI 代理自动探索应用、编写流程和生成素材。
适用领域
iOS 应用开发 / App Store 上架与营销素材 / 自动化截图生成 / 移动端 UI 展示 / AI Coding Agent 工具链 / 开发者效率工具 / 跨框架移动应用交付
配置难度
中等。对于熟悉 iOS、Node.js、CLI 和模拟器的开发者，上手难度不高；但如果要稳定维护 Argent flows、多语言素材和视频输出，需要一定自动化测试和发布流程经验。
商业价值
对需要频繁发布 iOS 应用的团队具有较高业务价值。Goldie 可以显著减少手工截图、套壳、排版和视频制作时间，提高 App Store 素材的一致性与可复现性，尤其适合多语言、多版本、快速迭代的产品。结合 coding agent 后，还可以把素材生成纳入 AI 辅助开发流程，降低上架准备成本。不过它主要解决 App Store 素材生产问题，并不是完整的 ASO、设计或发布平台，因此商业价值更集中在提升开发与发布效率。
01
技术亮点
- 框架无关，适用于 SwiftUI、UIKit、Flutter、React Native 和 Kotlin Multiplatform 应用。
- 通过真实 iOS Simulator 回放流程，比静态 mock 更接近真实产品状态。
- 同时支持 App Store 截图和预览视频生成。
- 内置 Apple 上传规则校验，减少素材被拒风险。
- 提供浏览器 Studio，可视化调整背景、模板、边框、字体和文案。
- 支持 coding agent skill，适合结合 AI 自动生成流程和素材。
- 支持多 locale 输出，便于国际化应用上架。
- MIT 许可证，商业项目使用限制较少。
- 项目定位清晰，专注解决 App Store 素材自动化问题。
02
目标用户
- iOS 独立开发者
- 需要频繁发布 App Store 版本的移动开发团队
- 使用 SwiftUI、UIKit、Flutter、React Native 或 Kotlin Multiplatform 的应用团队
- 需要自动化生成多语言 App Store 截图的团队
- 使用 Cursor、Codex、Claude Code 等 coding agent 的开发者
- 负责 App Store 素材、增长和产品展示的设计或运营人员
03
配置要求
- 必须在 macOS 上运行，因为依赖 iOS Simulator。
- 需要 Node.js 20 或更高版本。
- 需要安装 ffmpeg 用于视频处理。
- 需要可用的 iOS 模拟器。
- 需要配置 Argent flows，通常位于 .argent/flows。
- 需要 goldie.config.ts 指定场景、流程、本地化和视觉配置。
- 建议使用 Release 构建，避免 Debug 构建中的 LogBox 或调试浮层污染截图。
- 可通过 goldie.design.json 保存 Studio 中调整后的设计。
- 输出默认包含 6.9 英寸截图，尺寸为 1320 x 2868。
- 预览视频输出为 886 x 1920 H.264，时长需满足 Apple 要求的 15 到 30 秒。
- 可配置设备边框，例如 17-pro-blue、17-pro-silver、17-pro-orange，或使用自定义 bezel 图片。
- 可配置模板，包括 editorial、showcase、magazine、storyboard、dynamic，以及 classic、hero、minimal 等布局序列。
- 可配置字体栈，内置 Merriweather、DM Mono、Lato、DM Sans、Montserrat。
- 可配置 decorations，在设备后方叠加徽章或图片。
04
适用场景
- 为 iOS 应用自动生成 6.9 英寸 App Store 截图
- 生成 15 到 30 秒的 App Store 预览视频
- 基于模拟器自动回放用户流程并截图
- 为不同 locale 生成本地化 App Store 素材
- 通过浏览器 Studio 调整背景、模板、字体、设备边框和文案
- 将截图生成流程集成到 AI coding agent 工作流中
- 在应用界面变更后快速重新生成上架素材
- 检查输出结果是否符合 Apple 上传规格
05
部署与配置
- 准备 macOS 环境，并安装可用的 iOS Simulator。
- 安装 Node.js 20 或更高版本。
- 安装 ffmpeg。
- 全局安装 Goldie CLI：npm i -g goldie。
- 如果配合 coding agent 使用，可执行：npx skills add kacperkapusciak/goldie。
- 如果使用 Claude Code，可通过插件市场添加：/plugin marketplace add kacperkapusciak/goldie，然后执行 /plugin install goldie@goldie。
- 手动使用时，将 goldie.config.example.ts 复制为 goldie.config.ts。
- 在 goldie.config.ts 中将 scenes 指向 .argent/flows 中的 Argent 流程。
- 运行 goldie doctor 检查依赖、模拟器和流程配置。
- 运行 goldie all 捕获截图、加框渲染、生成预览视频并校验。
- 运行 goldie studio 在浏览器中预览和调整视觉素材。
06
风险与注意事项
- 强依赖 macOS 和 iOS Simulator，无法在普通 Linux CI 环境中直接运行。
- 依赖 Argent flows，如果应用 UI 或导航变动，流程可能失效，需要修复或重录。
- 对 ffmpeg、Node 版本、模拟器环境有要求，新手配置可能有一定门槛。
- 项目 stars 约 640，生态和社区规模中等，遇到复杂问题时可参考资料可能有限。
- README 未展示完整配置示例细节，复杂项目接入前可能需要阅读源码或示例。
- 自动生成的视觉质量仍取决于模板、文案和设计配置，不能完全替代专业 App Store 设计。
- 如果 Debug 构建带有调试横幅、日志浮层或测试数据，可能影响最终截图质量。
- Apple 规则未来变化时，需要项目及时更新校验逻辑。
2026-08-31
第13名
新收录 · github_search
