FastOG 平台指南
FastOG 会生成当有人分享你的某个页面时显示的图片——产品页、分类页、首页、博客文章。它用一张实时封面图取代静态默认图：产品照片、当前价格、评分、你的 logo 以及你选择的任意标题。
本指南是全局地图。它涵盖每项功能的作用、在各平台上到哪里修改它，以及哪项套餐包含它。关于 API、HMAC 签名和框架教程，请从 API 参考 开始。
FastOG 的运行位置
| 平台 | 应用所在位置 | 商家打开的内容 |
|---|---|---|
| WooCommerce | WordPress 后台 → FastOG | Studio 用于编辑封面，Plan 用于更改套餐，Support 用于提交工单，Tools 用于管理连接 |
| Shopify | Shopify 后台 → Apps → FastOG | Covers、Plan、Support；高级连接详情位于应用底部 |
| Wix | Wix 仪表板 → Apps → FastOG | Covers、Customize、Plans |
首次打开应用时，它会提供简短的设置流程：请选择哪些页面类型需要封面，并选择一个初始外观。这两项之后都可以更改——设置中的任何内容都不是永久性的。
封面如何选择
FastOG 会为被分享的页面签署一个 URL。请求中携带店铺和页面类型，服务器则应用为该页面类型保存的规则：
- 页面类型规则 —— 您在 Covers 下为产品、集合/分类、首页或博客文章编辑的封面。
- 更具体的规则（如果匹配） —— 针对标签、分类、供应商或集合的规则优先于页面类型规则。
- 单个产品的封面（如果已保存） —— 所有规则中最具体的一条；在 Pro 及以上版本中可用。
如果以上规则都不匹配，页面将保留其主题的图片。每个平台都会为每种页面类型提供各自的封面，因此更改产品封面不会影响首页。
封面与页面类型
请打开 Covers（Shopify、Wix）或 FastOG → Studio（WooCommerce），然后在预览上方选择页面类型。
| 平台 | 页面类型 |
|---|---|
| WooCommerce | 产品、分类、首页、博客文章 |
| Shopify | 产品、集合、首页、博客文章 |
| Wix | 产品、集合、首页、博客文章、站点页面 |
每个标签页都有各自的外观、各自的文案和各自的实时开关。保存一个页面类型绝不会改变另一个页面类型。预览就是真实的封面：它使用与线上页面相同的模板和 props 渲染。
WooCommerce 还会在产品编辑界面上放置一个小型封面面板，这样您无需离开产品页面即可查看和修改封面。出于同样的原因，Shopify 会在后台的产品页面上放置一个 FastOG 区块。Wix 则将所有内容都保留在应用内。
选择外观
外观是封面所绘制的布局——即模板。选择器会展示完整目录，锁定的外观会标注解锁它所需的套餐。
| 套餐 | 外观 |
|---|---|
| Community | 免费集合 |
| Starter | 精选的 Starter 集合 |
| Pro | 所有模板 |
| Scale | 所有模板，外加优先渲染 |
锁定的外观是橱窗展示，而非可选项：您可以预览它，升级提示会指明解锁它所需的套餐。保存会在服务端被拒绝，因此预览与线上封面不会出现不一致。
从设置向导开始时使用的也是同一个选择器，并且您可以更改某一页面类型的外观而不影响其他页面类型。
复制与样式
外观之后，编辑器有两组字段：
- 内容 — 标题、副标题、徽章、功能行、图片以及该模板打印的其他任何内容。留空的字段在模板能够填充时会回退到店铺自身的数据。
- 样式 — 主题、颜色、字体、图案和收尾效果。样式是按模板独立的：在一种布局中合理的值不会被强加到另一种布局上。
在 WooCommerce 和 Shopify 上，所有套餐都可以编辑店铺级规则的文案和样式。在 Wix 上，自由形式的内容和样式字段属于 Pro 自定义构建器：Starter 选择外观，预设的固定字段仅展示而不可自由编辑。
Pro 专属的按产品编辑器是将相同字段应用于单个商品（见下文），外加 logo 覆盖。
标记为永不填充的字段是 FastOG 拒绝凭空编造的字段。评分是常见情况：空星行不会被填入虚假的平均值。
实时信号
实时信号是封面下的开关，而不是您输入的文案。它们决定封面是否可以在分享时绘制 FastOG 已经知道的值：
| 信号 | 显示内容 | 套餐 |
|---|---|---|
| 价格 | 当前价格，当商品正在促销时包含划线对比价 | 所有套餐 |
| 促销 | 促销缎带 / 对比价处理 | 所有套餐 |
| 库存 | 低库存（“仅剩 3 件”）和售罄 | 所有套餐 |
| 评分和评论数 | 店铺的真实平均评分和评论数量 | Starter 及以上 |
| 评分下限 | 低于最低评分或评论数时完全隐藏星级行 | Pro 及以上 |
这个开关的意义在于，让您可以在布局中保留某个字段，但在数据较弱时将其隐藏。一个 3.1 星、只有两条评论的商品，通常不显示星级行比在价格旁边显示一个较弱的星级行更好。
关闭某个信号不会删除任何内容：该值仍会从店铺读取，只是封面不再打印它。重新开启后，它会在下一次渲染时再次显示。
按产品和按商品的封面
按产品封面是为单个商品保存的封面，叠加在页面类型规则之上。这是 Pro 和 Scale 功能。
| 平台 | 打开位置 |
|---|---|
| WooCommerce | 产品编辑界面 → FastOG 封面面板 → 自定义封面 |
| Shopify | 在 Shopify 后台打开产品 → FastOG 产品区块 → 自定义封面 |
| Wix | 暂不支持按商品设置；请使用页面类型封面，或选择一种对每个产品都效果良好的外观 |
在 Pro 上，您可以为该单个产品更改外观、文案、徽章和样式。未设置覆盖的产品会继续使用页面类型规则。清除产品上的覆盖会恢复共享封面；如果之后套餐发生变化，已保存的选择会被保留，而不会被销毁。
产品面板还提供了指向 Studio 的链接，因此当产品不需要自己的封面时，只需点击一次即可访问店铺级规则。
产品线规则
作用域规则（scoped rule）用于为一组产品细化产品封面——一个标签、一个分类、一个产品类型、一个集合（Shopify）或一个供应商。它是 Scale 功能。
请打开 Covers → Covers for specific products（该标题在 WooCommerce 和 Shopify 上相同）。添加一条规则，选择作用域和外观，然后保存。匹配的产品会使用该规则的外观和文案；其他所有产品则保留页面类型封面。
最具体的匹配优先，因此您无需管理顺序。规则计数器会显示您已使用套餐额度的多少；规则可随时删除。Wix 目前尚未提供作用域规则。
营销活动与定时恢复
定时恢复是营销活动中安全的那一半：您现在发布黑色星期五或季节性封面，并选择它应恢复为之前上线封面的日期和时间。恢复这一半在所有方案上都可用，包括 Community。
定时开始是 Scale 的那一半。在 Scale 上，您还可以设置营销活动封面上线的日期；低于 Scale 的方案中，开始会被暂停，但设计和日期会保留，以便升级后恢复。两个转换每五分钟检查一次，时间使用字段下方显示的时区。
两半都需要一个结束时间：只有开始而没有结束的营销活动永远不会下线，因此表单会拒绝它。清除结束时间会取消营销活动。方案失效不会删除任何内容——日期和设计都会保留。
导出 PNG
下载 PNG 操作会将您当前查看的封面渲染为 1200×630 并下载。这是 WooCommerce 和 Shopify 中的 Pro 和 Scale 功能；Wix 暂不支持。
该文件基于编辑器自身的模板和 props 构建，因此与预览一致，而非使用单独的导出模板。当您无法使用实时 URL 时，可将其用于市场列表、演示文稿或手动发帖。
套餐、覆盖范围与限制
FastOG 售卖的是覆盖范围，而非渲染额度。套餐覆盖一定数量的自有目录条目和一组能力；渲染次数不设上限。
| Community | Starter | Pro | Scale | |
|---|---|---|---|---|
| 价格 | 免费 | $19 / 月 | $49 / 月 | $119 / 月 |
| 覆盖条目 | 100 | 250 | 1,000 | 无限制 |
| 页面类型 | 全部 | 全部 | 全部 | 全部 |
| 外观 | 免费套装 | 精选套装 | 全部 | 全部 |
| 价格、促销与库存 | 是 | 是 | 是 | 是 |
| 评分（星级 + 数量） | — | 是 | 是 | 是 |
| 评分下限 | — | — | 是 | 是 |
| 按产品封面 | — | — | 是 | 是 |
| Metafield 映射 | — | — | 是 | 是 |
| PNG 导出 | — | — | 是 | 是 |
| 产品线规则 | — | — | — | 是 |
| 活动开始 | — | — | — | 是 |
| 定时恢复 | 是 | 是 | 是 | 是 |
| 优先渲染 | — | — | — | 是 |
覆盖范围面板显示套餐覆盖了多少条目，并按产品、分类、首页和博客文章细分。如果目录增长超出限制，面板会提示下一个套餐及其限制；它不会静默停止渲染。请从 Plan（WooCommerce、Shopify）或 Plans（Wix）升级。
按年计费为同一档位，12 个月按 10 个月计费。Wix 通过 Wix 计费；WooCommerce 和 Shopify 通过应用内的套餐视图计费。
Wix 使用相同的档位阶梯，但尚未提供按产品覆盖、限定范围规则或 PNG 导出。在那里，套餐仍然控制覆盖范围、外观、评分和自定义构建器。
健康检查与缓存刷新
应用会运行一次简短的检查，并将完整列表放在 Details / What we checked 下。它回答的是真正会导致预览失效的问题：
- FastOG 能否读取此商店的数据和商品目录？
- 商店前台的
og:image是否指向 FastOG，还是某个主题或 SEO 插件在起作用？ - 示例商品是否真实存在，预览是否使用了它？
- 签名密钥和连接是否仍然有效？
每项检查结果在存在修复方案时都会附带修复方法。report 是应复制到支持消息中的内容块；它设计为可直接粘贴，无需解读。
封面发生变化，并不代表平台已经重新读取了封面。签名 URL 是确定性的，因此图片本身会更新；被缓存的是平台对页面预览的副本。请重新抓取或等待平台缓存过期——参见缓存指南和强制刷新 Facebook。如果页面的 og:image 仍是主题的，健康检查会显示另一个插件或主题正在起作用。
支持
遇到设置、封面交付、账单或产品问题时，请使用支持。请附上受影响的页面或产品、您的预期以及实际发生的情况；健康报告是最快的附件。这是异步产品支持，不是实时聊天或一般咨询。
在提交工单之前，请先尝试健康检查：它可以发现常见原因（未连接、未提供封面、某个 SEO 插件覆盖了 og:image、平台缓存过期）。
一页式故障排查
| 症状 | 首先检查 |
|---|---|
| 分享链接没有图片 | 健康检查 → 店面是否由 FastOG og:image？页面类型是否已覆盖？ |
| 预览显示旧价格 | 平台的缓存；实时 URL 在每次渲染时签名。请重新抓取页面 |
| 封面外观不对 | 页面类型规则、作用域规则或按产品覆盖（最具体的优先） |
| 锁定的外观无法保存 | 它属于更高套餐；选择器会标明套餐 |
| 评分缺失 | 产品尚无评价，或套餐低于 Starter，或评分开关已关闭 |
| 按产品的更改没有生效 | 按产品封面属于 Pro/Scale，低于该套餐时服务器会拒绝保存 |
| 封面在 WhatsApp 中模糊 | 请参阅 OG 图片尺寸 和 WhatsApp 预览 |