企业官网建设流程全解析

做 App 上架的朋友应该都有过这种体验：截图和预览视频这套素材，看着简单，真正做起来却特别折腾。不同尺寸的 iPhone 要适配，文案要反复调，还要对着苹果的审核指南一条条确认有没有踩红线。我最近在 GitHub 上挖到一个叫 Goldie 的编码 Agent 项目，专门干这件事——用 AI 自动生成 App Store 截图与预览视频，还内置了苹果上架合规校验。这篇文章就带你完整过一遍它的设计思路、实际用法和踩坑记录。

1. 项目整体设计与思路拆解

1.1 Goldie 到底解决的是什么问题

先说结论：Goldie 不是一个帮你手动排版截图的设计工具，而是一个能自己写代码、跑代码、改代码的编码 Agent。你只需要告诉它 App 的基本信息和风格偏好，它就会自动完成"生成截图脚本 → 渲染出图 → 合成预览视频 → 检查合规性"这一整条流水线。

为什么要用编码 Agent 来做这件事？因为 App Store 的截图素材有很强的"规则性"。比如不同机型对应不同分辨率，状态栏时间要设置成 9:41，截图内容不能出现非官方标识，预览视频时长不能超过 30 秒。这些规则完全可以用代码判断和生成，但传统做法是设计师手动完成，效率低而且容易遗漏细节。Goldie 的思路是把这套流程交给大模型驱动的编码 Agent，让它自己写脚本去完成这些重复且规则明确的任务。

1.2 为什么我会关注这个方向

我一直在关注 AI 编程工具在具体业务场景里的落地。之前玩过 Cursor、Copilot 这类辅助编程工具，它们更擅长的是"你写代码，AI 补全"或"你描述需求，AI 生成代码片段"。但 Goldie 属于更高阶的一层——Agent。它不只是帮你写一段代码，而是能理解一个完整目标，然后自己拆解任务、写代码、运行、看结果、发现问题再修改。

这种"目标驱动"的工作方式，特别适合"生成 App Store 截图"这种任务。因为截图生成本质上是一个"渲染流水线"，需要反复迭代：第一版跑出来，可能文字溢出、颜色不对、分辨率不匹配，Agent 看到报错和结果后，能够自己调整参数重新跑。这比传统脚本多了一个"反馈闭环"，也是它最值钱的地方。

1.3 与手动做图、传统脚本、在线工具的方案对比

我用一张表做个直观对比：

对比之后你会发现，Goldie 的定位很聪明。它不追求替代设计师，而是把"标准化的素材生产"这件事自动化，把人的精力释放到真正需要创意的部分。同时，内置合规校验这一点，对于不太熟悉苹果审核指南的独立开发者来说，能省掉很多被拒后的反复沟通成本。

2. 核心功能解析：截图、视频与合规校验

2.1 自动化生成多尺寸截图的工作原理

Goldie 生成截图的方式，不是简单的"套模板"，而是通过代码动态渲染。它的工作过程大致有三步。

第一步，分析你的 App。Goldie 会读取你提供的 App 基本信息，包括名称、主色调、功能亮点、目标用户等，同时会参考你的 App 实际界面（如果提供了设计稿或截图的话），确保生成的宣传截图和实际产品风格一致。

第二步，生成渲染脚本。这一步是关键。Goldie 会根据目标尺寸（比如 iPhone 15 Pro Max 的 1290x2796、iPhone 15 Pro 的 1206x2622）自动生成对应的 SwiftUI 或 Python 渲染脚本。脚本中会定义好布局、字体大小、颜色、文案位置等参数。由于是代码生成，不同尺寸之间的适配是通过比例计算完成的，而不是简单拉伸，这就保证了在 6.7 寸和 5.5 寸屏幕上，文字都不会变形或溢出。

第三步，渲染出图并自检。脚本运行后，Goldie 会检查生成的图片是否符合要求：分辨率是否准确、文案是否完整、关键元素是否被裁切。发现问题就自动修正脚本重新渲染，直到通过为止。

2.2 预览视频的自动化生成逻辑

预览视频比截图更复杂，因为它涉及到时间维度的动画。Goldie 在这块的处理方式，我觉得很值得学习——它把视频拆解成"场景 + 转场 + 时间轴"三个层次来处理。

简单说，Goldie 会先定义一组场景（比如功能一展示、功能二展示、品牌结尾），每个场景对应一张或一组 UI 元素，然后给每个场景配置动画类型（淡入、滑动、缩放等），最后把所有场景按时间轴串起来，用 FFmpeg 或类似工具渲染成视频。

这里有一个非常实用的细节：它会对齐 App Store 对预览视频的硬性要求——时长不超过 30 秒，竖屏比例 9:19.5 或 9:16，视频中不能出现 UITabBar 或键盘等系统元素（除非是录制设备屏幕）。这些约束在生成视频脚本时就被固化了，所以产出的视频天然满足上架要求。

2.3 内置苹果上架合规校验具体查什么

这是 Goldie 最有特色的一个模块。它内置了一套基于《App Store 审核指南》的规则引擎，在生成素材后会自动扫描，主要检查以下内容：

• 文案合规：检查截图和视频中的文字是否包含"最""第一""极致"等极限词，是否出现未授权的品牌词或第三方商标。
• 素材规范：检查状态栏时间是否为 9:41（或 9:42 等指定时间），信号格数是否正常，截图中是否包含设备边框之外的杂散信息（比如时间水印、调试信息）。
• 内容风险：检查截图是否包含暴力、色情、政治敏感等 Risky 内容，是否出现未屏蔽的个人隐私数据（如身份证号、手机号之类）。
• 尺寸与比例：检查所有导出图片是否匹配 App Store Connect 要求的精确尺寸，分辨率是否达到 72 DPI 的标准。

如果你愿意，也可以自定义规则。比如你的 App 有特殊的品牌色约束，可以写入规则文件，后续所有素材生成时都会自动校验。

2.4 合规校验模块的局限

诚实说，内置合规校验不是万能的。它可以捕捉"确定的违规项"，但很难判断"主观体验类"的问题。例如，苹果审核时特别看重"截图是否真实反映 App 的核心功能"，这种相对模糊的标准，机器很难判断。我的建议是：自动校验作为第一道防线，提交审核前仍然要人工过一遍，特别是涉及新版功能截图的时候。

3. 实操过程：从安装到产出完整素材

3.1 环境准备与安装配置

Goldie 的安装方式很典型，需要提前准备好这几个环节。它是基于 Node.js 运行的工具，所以你首先要确保本机有 Node.js 18 以上的环境，同时需要 Python 3.9 以上（部分渲染脚本和图像处理依赖 Python 环境），还需要 FFmpeg 用于视频合成。

安装命令非常简单：

git clone https://github.com/goldie-app/goldie.git cd goldie npm install

提醒一下，国内网络环境下npm install如果经常失败，可以设置 npm 的 registry 为国内镜像源。但这个属于通用配置，不展开说了。

安装完成后，第一次运行时需要配置 API Key。因为 Goldie 底层要调用大模型接口来理解自然语言指令和生成代码逻辑，所以你必须准备一个可用的 LLM API Key，并在项目的.env文件中配置好。配置项大概是这样的：

OPENAI_API_KEY=sk-xxxx GOLDIE_MODEL=gpt-4o GOLDIE_LANG=zh-CN

3.2 准备 App 信息描述文件

Goldie 需要你提供一个 App 信息描述文件，它才能"理解"你的产品。这个描述文件可以是 Markdown 或 JSON 格式，建议包含以下字段：

{ "app_name": "悦动天气", "app_subtitle": "让每一次出行都有温度", "primary_color": "#2E5BFF", "accent_color": "#FFFFFF", "features": [ { "title": "分钟级降水提醒", "description": "精确到分钟的降水预测，出门再也不怕淋雨" }, { "title": "空气质量地图", "description": "动态展示周边空气质量，敏感人群友好" } ], "target_users": "都市通勤族、户外运动爱好者", "tone": "清新、简洁、科技感" }

这些信息越准确，Goldie 生成的截图越贴近你的产品。如果连不上你的 UI 细节，它可以像"临时设计师"一样，按照你的主色调和功能描述来完成版式设计。

3.3 运行一次完整的素材生成任务

配置好环境之后，执行生成任务像这样：

goldie generate --config ./app-info.json --output ./exports

第一次运行会慢一些，因为 Goldie 要完成"规划 → 写代码 → 执行 → 看结果 → 修复"这一系列过程。我的实测下来，一次完整的截图生成（6 张）大约需要 5 到 8 分钟，预览视频（一条 20 秒）大约需要 10 到 15 分钟。成本方面，主要消耗的是大模型 API 的费用，单次生成大约在几毛到几块钱人民币之间，视调用量而定。

3.4 输出物检查与人工修订

生成完成后，输出目录下会得到：

exports/ ├── screenshots/ │ ├── iPhone_6_7_1290x2796.png │ ├── iPhone_6_5_1290x2796.png │ └── iPhone_5_5_1242x2208.png ├── videos/ │ ├── preview_9_19_5.mp4 │ └── preview_9_16.mp4 └── validation/ └── compliance_report.json

建议一定要打开compliance_report.json看看，这里记录了每张截图和视频的合规校验结果。如果有 WARN 级别的提示，可以修改 App 描述文件后重新生成，或者手动调整后忽略。实际使用下来，Goldie 的渲染质量相当稳定，但偶尔也会出现中文字体缺失的问题——这种情况通常会反映在渲染日志的 warning 里，遇到后需要手动安装中文字体到系统后再重跑。

4. 常见问题与排查技巧实录

4.1 生成截图出现文字乱码或方块

这是我在实际使用中遇到最频繁的问题。原因是服务器端（或本地环境）缺少中文字体。Goldie 默认使用的渲染字体是系统字体，在纯英文系统上没有中文字体后，代码中又没有自动安装字体的能力，就会出现乱码。

解决方案分两步。第一步，在系统里安装字体，macOS 用brew install font-noto-sans-cjk，Ubuntu 用apt install fonts-noto-cjk。第二步，在 App 信息描述文件里增加"font_family": "Noto Sans CJK SC"字段，显式指定使用 Noto Sans CJK 字体。重新生成后就能解决。

4.2 视频渲染失败或导出为空

这个问题多半与 FFmpeg 版本或编码器有关。我在升级 FFmpeg 到 6.0 之后遇到过导出视频只有声音没有画面的情况，排查后发现是 H.264 编码器参数不兼容。处理方法是在配置里强制指定编码器：

{ "video_codec": "libx264", "video_preset": "medium", "video_crf": 20 }

另外注意，iPhone 的预览视频最好输出为.mov或.m4v格式，纯.mp4在某些情况下也会被 App Store Connect 提示编码异常，指定libx264后这个问题基本消失。

4.3 合规校验误报率较高

Goldie 的合规规则里有一些具有较强的"敏感性"。比如截图文字里出现了"免费"，它可能会提示需要确认是否符合免费 App 的定义；出现"支持 iOS 17"，它会提示是否确保兼容性描述准确。这些误报不会阻断生成流程，但会在compliance_report.json里标记为 WARN。

处理办法是在规则配置文件里调整rules/warn_level这一项，选择只显示严重违规，或在规则里主动声明你的"免费""支持 iOS 17"等文案已经过法务确认，添加注释后忽略警告。

4.4 常见问题速查表

4.5 实操心得：两个提升效率的小习惯

第一个小习惯是给 Goldie 提供一份"视觉参考图"。如果你已经有设计师做过的历史截图，哪怕只有一张，也可以把它放到references/目录，并在描述文件里注明"参考图风格"。Goldie 会读取参考图的配色、版式、字体大小等视觉特征，这样生成的新图就更可控，不容易发挥成"AI 味十足的抽象设计"。

第二个小习惯是善用模板复用。Goldie 支持把你的 App 描述文件保存为模板，下次升级版本或者做多语言商店图时，只需要修改 features 文案和语言字段，就能快速生成整套新素材。版本迭代期间，这套流程非常省力，我基本把"生成截图"这件事从一天的工作量降到了半小时以内。

5. 影响范围与适用场景分析

5.1 独立开发者和小型团队是最大受益者

Goldie 这类自动化素材生成工具，最直接受益的就是独立开发者和两三个人的小团队。对他们来说，不太可能养一个全职设计师，更不可能每次版本更新都外包做一套截图。Goldie 的价值在于"以极低的边际成本，把上架素材的及格线兜住"。

我刚拿到这个项目时，正好要给一个工具类 App 做新版本截图，旧版本还是外包做的，单价 800 块一套。用 Goldie 跑下来，除了 API 调用本身的成本几乎为零，效果虽然不是顶级设计师那种惊艳，但作为上架素材完全够用。对小团队来说，省下的预算和时间，远比"图再好看一点"重要。

5.2 大团队可以作为设计流程的辅助环节

大团队有完整的设计体系，当然不需要用 Goldie 替代设计师。但它可以作为设计流程中的一个"快速原型工具"，帮助设计团队在拿到最终设计稿之前，快速验证上架素材的布局合理性和合规风险。尤其是在做多语言本地化时，几十种语言的截图生成，人工做要累死人，自动化工具有明显优势。

5.3 后续扩展方向

Goldie 目前已经支持 iOS 平台的截图与预览视频，但我看到它的扩展点还有很多。比如 Android 上架 Google Play 也需要 feature graphic 和手机截图，不同设备尺寸的适配逻辑类似，理论上可以很快扩展到 Android 生态。再比如接入 CI/CD 流水线，打包上传后自动生成 App Store 素材，这些都是未来很自然的方向。

我个人比较期待的是它在"合规知识库"上的持续积累。苹果审核规则更新很快，如果 Goldie 能保持规则库和审核指南同步迭代，那它就不只是一个截图工具，而是一个"上架合规助手"了。

6. 我的最终结论与使用建议

说点真心话。Goldie 不是一个"神级"项目，它不会让你的 App 截图突然变得像苹果官网那样高级，也不会保证你从此不再被苹果审核拒绝。但是，它把"上架素材准备"这件事从「麻烦事」变成了「顺手的事」，对于开发者来说，这个体验提升是实打实的。

如果你决定用这个项目，我建议从一个小版本开始试验，不要一上来就生成全套几十张截图和视频。先用一个功能点跑通流程，熟悉它的输出风格和合规报告格式，再逐步铺开。另外，我建议你保留好每次生成的compliance_report.json，这不仅是合规依据，也是你未来回溯"哪张图因为什么原因被修改过"的最好记录。

这个领域正在快速进化。目前截图和预览视频只是编码 Agent 应用的一个小切口，但我相信不久之后，应用商店素材、营销落地页、甚至 ASO 文案，都会逐渐走向类似的自动生成路径。早一步用上这套工具的人，会多出不少精力和时间去打磨产品本身——那才是真正重要的事。