案例作品集 浏览精选项目

WESWOO 提供 Shopify Plus 项目开发费抵扣,至多 US$4,800

指南

Shopify 产品说明书怎么管理:型号、硬件修订、版本与下载验收

发布日期: 编辑复核:2026-11-17

产品页有一个“下载说明书”按钮,并不意味着顾客拿到了适用文件。相似型号、不同硬件批次和语言文件可能共用封面;一次替换也可能让旧入口失效。可靠的做法是先建立适用关系,再让商品页、型号索引和可阅读步骤引用同一份手册记录。本文给出公开说明书的内容与验收设计,字段名称是示例,不是 Shopify 预装的手册系统。

先把四种身份分开

型号是顾客识别产品的名称;硬件修订是同一型号内部可能影响操作、接口或配件的变化;手册版本是文档自身的发布版本;语言是这份具体文件和正文的语言。文档版本更新不一定表示硬件改变,英文文件也不能因为出现在中文页面就标成中文版。

例如,虚构设备 AX-20 的硬件修订 B,适用手册 1.2,语言为简体中文。这只是映射示例,不是客户案例。若修订 A 与 B 的接口不同,应分别核对适用资料,不能仅按 AX-20 名称给所有商品指向最新 PDF。硬件标识应从商家确认的位置读取,如铭牌或包装;找不到标识时展示识别说明和联系路径,不猜测兼容性。

建议一个公开手册记录对应一个明确的“型号+适用修订+手册版本+语言”组合。多个商品可以引用同一条记录;不同文件语言分别维护,避免复制后忘记更换 PDF。目录展示当前推荐项,同时保留仍服务旧设备的历史项,并醒目标注适用范围。

示例字段映射表

下表是实施建议,类型和验证需在目标店铺实际确认。Shopify 支持多字段 metaobject、文件与 URL 等字段及 metafield 引用,具体手册关系由团队建模。Metaobjects

示例字段建议类型或记录位置示例与核对规则
model_code单行文本AX-20;保留大小写、别名另列
hardware_revision单行文本B;没有资料时写“待确认”,不自动匹配
manual_version单行文本1.2;不得与硬件修订混为一项
language_code单行文本zh-CN;由文件实际语言确认
title / applicability文本显示型号、修订与适用限制
key_steps富文本或独立页面正文已批准的安装、操作、排错步骤
pdf_file文件引用选择允许的通用文件类别,确认 PDF 实体
released_on / change_note日期/文本商家确认发布日期及变更内容
supersedes元对象引用或发布台账指向被替代记录,保留旧设备适用关系
custom.manual_records商品 metafield 的元对象引用列表选择此商品实际适用条目
file_sha256 / reviewer内部发布台账比对下载内容;不必公开审核人信息

文件名可包含型号、修订、文档版本和语言,但文件名不是唯一真相。实际下载后检查封面、修订页和正文;摘要、目录、按钮标签也必须一致。若一个商品包含多种硬件配置,先说明如何识别配置,再列各自适用记录,不能让顾客凭文件日期猜。

用 HTML 完成关键任务,用 PDF 补充完整资料

顾客应能直接在网页看到适用型号、识别硬件修订的方法、开始前条件、主要操作、停止操作并寻求帮助的条件,以及文件版本。PDF 可承载打印排版、完整图表和较长附录。不要只提供图片截图或把每一步藏在 PDF 中。

HTML 步骤必须来自商家确认的真实说明书。编写时逐步列出动作、需要观察的结果与下一步;例如“按本型号说明书确认接口标识,再连接对应配件”仍需替换成真实产品的具体说明,不能作为生产操作指令。涉及电源、安装承重或拆机时保留原制造商警告,不为了缩短页面删除前置条件。更新 PDF 时同步检查网页步骤是否受影响。

下载按钮建议显示“AX-20 · 修订 B · 手册 1.2 · 简体中文 · PDF”。文件大小来自实际文件,不编一个数字。HTML 页面保留目录锚点和普通链接;JavaScript 只增强筛选或交互,不能成为看到型号、步骤和下载入口的唯一条件。这是页面实现要求,不是 Shopify 自动提供的保证。

店面访问、发布状态和文件公开性分别检查

Shopify 的 Storefronts access 允许主题 Liquid 或 Storefront API 使用对应内容;Active-draft 是可选能力;将条目发布为独立网页又是另一项选项,需要店面访问。开启这些设置不会自动完成手册页面设计。Custom data options

启用 publishable 能力后,Liquid 访问 Draft 条目返回 nil,Active 才可访问。因此“后台已保存”不能代替未登录店面验证。Liquid metaobject

商品引用也需要单独验证:定义对应商品 metafield,限制引用的元对象类型,选择商品真正适用的记录,再把内容连接到主题可用区块;具体显示取决于主题。创建并连接元对象

Content > Files 用于公开材料,不能存放客户个人信息或内部文档。把手册记录改为 Draft,不应被当成撤销已知 PDF 直链访问的权限措施。官方文件指南还说明:替换文件后文件名保持但链接变化;更改文件 URL handle 后旧 URL 不再工作。因此每次替换或改名都应重新取得并实测实际地址。Uploading and managing files

发布新版本与回滚检查

  1. 发布前备份现有记录、商品引用、HTML 正文、文件副本、实际 URL 和旧入口清单。记录版本、语言、适用修订、审核结果与文件哈希。
  2. 由资料负责人确认新版本改变了哪些步骤、哪些硬件仍适用。先准备新记录或受控修改副本,更新 HTML 与 PDF,核对翻译。历史版本仍适用旧硬件时,不直接全量覆盖。
  3. 在目标开发主题验证字段、文件类别、可见性与商品引用。开发主题并不隔离店铺共享的元对象或文件;直接修改已被线上引用的 Active 条目或替换文件,可能同步影响现店。分阶段发布宜准备新条目和新文件,审核后再切换引用。启用发布状态时可先准备 Draft,发布时核 Active;未启用该能力时不要假定有草稿保护。
  4. 从商品页和型号索引分别进入,下载并打开实体,确认型号、修订、版本、语言和内容。记录浏览器最终地址与文件哈希,检查页面标签是否一致。
  5. 回归旧商品入口、收藏链接、帮助中心文章和历史邮件链接。Shopify 网页重定向通常要求源页面已失效,不能用它覆盖仍有效页面,也不能据此保证 Shopify CDN 文件 URL 可重定向。商品页、市场或语言子目录和 CDN 文件地址应分别核对支持范围;逐条记录旧入口的最终地址,不假定一个重定向覆盖所有语言。URL redirects
  6. 用未登录窗口在手机、平板、桌面复查,关闭 JavaScript 再走一次普通链接路径。测试缺文件、草稿记录和不匹配语言。通过后才切换入口并记录发布结果。
  7. 若发现错配,先停止错误入口,恢复已备份且确认适用的记录、引用与网页正文,再下载验证。恢复字段不等于恢复文件内容;旧文件已被替换或删除时须从备份重新准备并核新实际 URL。回滚也保留版本说明与审核记录。

缺文件和语言边界怎么呈现

当文件引用为空或记录不可见时,不输出空 href、无效按钮或“下载成功”。仅保留仍可取得且已核准的型号适用说明和 HTML 步骤,并提供联系入口。核实为资料暂不可用时说明这一状态;只有确认是缺少所选语言文件时,才显示“此语言的 PDF 暂未提供”。若提供其他语言资料,明确写出该语言,并由用户选择;不要自动跨型号或跨修订降级。

简体中文、繁体中文和英文分别验收。网页界面翻译、手册正文翻译、PDF 语言和语言路由是不同工作项。切换语言后仍应保持型号与修订上下文;没有对应语言文件时显示真实缺口,不把同一个英文 PDF 伪装成三个翻译版本。

型号索引可列型号别名和问题词,筛选后仍提供普通页面入口。不要把局部目录筛选写成 Shopify 全站原生搜索能力:官方主题搜索文档列出的内容类型包括商品、页面与文章,不能据此承诺所有 PDF 正文或元对象条目自动入索引。Storefront search

相关实施资料

FAQ

一个商品只能有一本手册吗?

不必如此。可使用元对象引用列表表达多个适用文件,但每项都应写明修订、版本和语言。列表数量不证明这些文件适用于所有变体,仍需明确映射。

最新手册应该自动替代全部旧版吗?

先确认硬件适用范围。仅修正文案与改变安装步骤是不同变更。仍有旧硬件在使用时,保留适用旧版和清楚的选择说明通常比只留最新文件更可靠。

把条目改为 Draft,PDF 就私有了吗?

不能这样理解。条目的店面呈现与已公开文件的直链是不同边界。本文讨论公开支持资料,账号私有文件需要另行设计与验证。

替换文件名没变,还要检查地址吗?

要。官方说明替换时链接变化,改 URL handle 又会使旧地址失效。重新复制实际链接、下载内容并回归旧入口。

完成建模就算上线了吗?

不是。定义、条目、引用、主题呈现、真实文件和未登录访问都需要目标店铺实测。本文是实施设计,不声称已在任何商家店铺完成安装。

Sources

以上官方资料实际读取于 2026-11-17。字段、发布台账、无 JavaScript 回归和回滚步骤为本文提出的实施方法,不是 Shopify 原生手册版本管理或自动回滚承诺。

浏览 WESWOO 案例作品集