Shopify 使用指南文章配方
使用指南文章的任务是让已经拥有或正准备使用某件商品的人，完成一件具体的事：安装、调节、清洁保养，或排除一个故障。它属于 article template type，读者通常从商品页的“使用说明”、搜索或支持入口进入：知道自己遇到什么问题，不确定型号版本是否适用。类型入口与选择判据见Article 文章页配方索引；购买前的选择问题读购买指南文章。
页面内容清单
| 类别 | 优先级 | 页面内容 | 回答的问题 | 来源边界 |
|---|---|---|---|---|
| 编辑 | 核心 | 适用商品、型号与版本 | 这篇文章是否适用于我的商品 | 与产品支持导航一致；不确定型号时给识别方法 |
| 编辑 | 核心 | 前置条件与所需物品 | 开始前要具备什么 | 包含物见包装清单，工具与耗材单列并标为另备或另售 |
| 编辑 | 核心 | 有序步骤 | 一步一步怎么做 | 与实物与当前版本核对过的操作 |
| 编辑 | 核心 | 每步的预期结果 | 我做对了吗 | 可观察的现象，不写“应该没问题” |
| 编辑 | 核心 | 作者、发布与复核日期 | 谁写的、多久没复核 | 每篇指定作者与复核负责人 |
| 编辑 | 可选 | 安全与损坏提醒 | 哪些情况要停下 | 与正式说明书与保证一致 |
| 编辑 | 可选 | 图片与视频 | 看图或看操作 | 商品视频中的教学类，不含 TVC |
| 编辑 | 可选 | 常见问题回链 | 边缘情况怎么办 | FAQ子集，链接而非复制 |
| 编辑 | 可选 | 支持升级入口 | 做不下去找谁 | 客服渠道与保证详情 |
| 运行时 | 可选 | 配件与耗材的价格、库存 | 需要补买什么 | 读取商品与变体，不在正文里手抄 |
页面组合
顺序是待验证假设，不是必备清单。
| 序 | 模块 | 回答的问题 | 缺失时 |
|---|---|---|---|
| 1 | 标题、适用型号与复核日期 | 是否适用、是否新 | 不可缺；版本不明确的文章不发布 |
| 2 | 前置条件与所需物品 | 开始前要准备什么 | 无需任何物品时删除，不写“无” |
| 3 | 安全提醒 | 哪些情况先停下 | 无安全相关风险时删除；有风险时不可缺，且在相关步骤之前 |
| 4 | 有序步骤（配图或视频） | 怎么做、做对了什么样 | 不可缺；关键步骤必须有文字，不只放视频或 PDF |
| 5 | 故障排查 | 没成功时看什么 | 没有已验证的排查分支时删除，不写泛泛建议 |
| 6 | FAQ 回链 | 边缘情况怎么办 | 没有真实重复问题时删除 |
| 7 | 支持升级入口 | 还是不行找谁 | 不可缺；至少一个可用渠道 |
| 8 | 相关配件与耗材 | 还需要买什么 | 无可解释关系时整块删除，不用促销填充 |
最小成立组合：标题、适用型号与复核日期 → 有序步骤 → 支持升级入口。
不应默认出现：促销条幅与折扣码、与任务无关的推荐商品、订阅弹窗、遮挡步骤的浮层、只为营销存在的“使用技巧”长文。
步骤结构：一步一个动作，动词开头；每步写清预期结果；前置条件在步骤之前，安全提醒紧邻相关步骤；型号或版本不同的分支用小标题分开，不混在同一步里。支持导航模块写明，需要多步骤、版本条件或诊断分支的内容应拥有独立正文，而 FAQ 只链接过去；本类文章正是这种正文。问题可能涉及安全或损坏时，模块的建议是停止通用排查，优先给出支持升级路径。
内容 × 展现形式
| 内容 | 首选形式 | 适用条件 | 退化方式 |
|---|---|---|---|
| 前置条件与所需物品 | List（无序，标注包含与另备） | 有两项以上 | 一句话 |
| 有序步骤 | List（有序）加步骤图 | 顺序影响结果 | 编号小节 |
| 操作演示 | 视频加逐字或步骤文字 | 有字幕与加载失败的替代 | 只留文字步骤与图片 |
| 图片 | Media Gallery或行内图 | 图能减少误操作 | 文字描述 |
| 型号差异 | Table | 多型号步骤不同 | 分小节 |
| 故障排查 | 症状 → 检查 → 处理 的分组 | 分支不超过几项 | 单条建议 |
| FAQ 回链 | Accordion或链接列表 | 问题可独立理解 | 静态链接 |
图片提供文本替代，关键步骤以网页正文提供，不能把安装说明只做成图片或 PDF。视频提供字幕或等效文字步骤，外部视频不可用时仍要有完整的文字路径。
状态与退化
| 状态 | 页面级处理 |
|---|---|
| 型号版本不匹配 | 页首说明适用范围；不适用时链接到对应版本的文章或客服，不让读者猜 |
| 商品已停售但仍有售后 | 保留文章并标明适用版本与停售状态 |
| 复核过期 | 标注“待复核”，或先撤下有风险的步骤，保留安全提醒 |
| 视频或图片加载失败 | 文字步骤仍完整 |
| 排查后仍失败 | 直接给支持升级入口，写明需要提供的信息（型号、订单号、现象） |
| 跨市场与多语言 | 只展示已有该语言正式内容的版本；安全说明以对应市场的正式版本为准 |
| 评论 | 按 blog 设置，评论是公开发言，不当作经过核验的内容 |
文章结构化数据
Google HowTo 富结果（核验于 2026-09-29）：Google Search Central 的 How-to 结构化数据文档地址当前跳转到更新日志的 how-to-deprecation 条目。该条目写明，文档被移除，因为该富结果不再在搜索结果中显示，桌面与移动端均如此；相关案例研究也因该功能已弃用而移除；结构化数据画廊未列出 HowTo。据此，本配方不把 HowTo 标记作为发布要求，不承诺富结果展示。该条目位于更新日志的 2023 年 9 月分组，日期标为 9 月 14 日，读取自更新日志页面全文。
FAQ 富结果：更新日志的 2026 年 5 月 8 日条目写明，FAQ 富结果的文档加入弃用通知，该功能自 2026 年 5 月 7 日起不再出现在 Google Search；2026 年 6 月的条目称已删除该功能的文档，理由是它不再显示。（此前的 2023 年 9 月条目曾写为仅对知名的权威政府与健康类网站显示。）据此，使用指南里的 FAQ 回链是为读者服务，不为富结果；站内 FAQ 内容类型也记录了同一结论。
Article 结构化数据（核验于 2026-09-29，Google 页面标注更新日期 2026-09-08，摘要读取）：页面写明没有必需属性，推荐 headline、image、datePublished、dateModified 与 author；支持 Article、NewsArticle、BlogPosting。作者建议使用 Person 或 Organization，author.name 只写名字，不含职衔。文章模板里的 article 对象提供 author、published_at、updated_at、image 等字段，可作为这些属性的数据来源；但 updated_at 是平台时间戳，不等于内容实质复核，dateModified 应对应真实的实质复核。
未核验：Shopify 各主题的文章模板是否输出 Article 结构化数据；输出与否、字段映射不能凭此推断，需要检查具体主题的渲染结果。
Shopify Theme 实现
| 层次 | 官方页面所写 / 建议职责 |
|---|---|
| 资源 | Article 保存正文、作者、摘要、封面与标签；适用型号、复核日期与关联商品放正文或文章元字段，元字段定义与编辑入口未核验 |
| Template | 默认 article.json 即可；使用指南成批且组成稳定不同时，才建立如 article.how-to.json 的 alternate，分配入口在 Content > Blog posts 的 Theme template 下拉，规则见Article 索引 |
| Main Section | 输出文章标题、作者、日期与正文；JSON 模板中的 HTML 与 Liquid 必须放在被引用的 Section 内 |
| Sections | 所需物品、步骤、故障排查、支持入口、相关配件分成可排序模块 |
| Blocks | 单个物品、单个步骤、单个故障分支 |
| Settings | 内容选择与布局；不开放隐藏安全提醒或支持入口的开关 |
| 数据来源 | 支持资源按产品支持导航组织；文章字段见博客与文章 |
当支持中心需要跨型号查找、版本比较或人工服务时，用 Page 承载支持导航，本文类文章作为其中的资源；退换申请、保修登记这类表单由应用提供时，边界见原生配置、应用与开发。
什么时候删掉这一篇
没有实物核对过的步骤不要发布。出现下列情况之一，应撤下文章或改为支持入口：
- 无法确认适用的型号与版本；
- 步骤没有经过实际操作核验，也无法给出预期结果；
- 操作涉及安全风险，却没有与正式说明书一致的提醒；
- 内容只是把商品卖点改写成“使用技巧”。
发布检查
- 按文章从零开始操作一遍，步骤、预期结果与实物一致；
- 前置条件与所需物品逐项对得上包装清单，另备与另售物品已区分；
- 安全提醒紧邻相关步骤；
- 去掉图片与视频后，步骤仍可完成；
- FAQ 与支持入口的链接可用，写明需要提供的信息；
- 每篇有作者、发布日期与复核日期，版本变化后已复核；
- 结构化数据若存在，字段与页面可见内容一致；
- 各市场的安全与保证表述：需要合规确认。
待继续完善
- 缺少真实商家的使用指南样例，也缺标注为虚构的样稿；
- HowTo 与 FAQ 富结果的现状会变化，需定期回到 Google Search Central 复核；Article 结构化数据页经摘要读取；
- 主题是否输出 Article 结构化数据未核验；
- 文章元字段的定义、编辑入口与主题读取方式未核验。