排查链接问题
修复将 PDF 链接到资源时的常见问题。
链接时找不到资源
搜索无效：
- 只需输入名称的一部分（无需完整名称）
- 搜索不区分大小写（大小写无影响）
- 尝试使用资源名称中的其他 关键词
资源不存在：
- 确认产品/页面/系列在 Shopify 中存在
- 检查资源是否已发布（非草稿状态）
- 已归档的资源不会显示
选择了错误的资源类型：
- 确认您选择了正确的类型（产品、页面等）
- 在下拉菜单中切换资源类型
链接似乎成功但 PDF 未显示
检查三个必要条件：
- ✅ PDF 已链接（您已完成此步骤）
- ⚠️ PDF 状态为已激活（请检查此项）
- ⚠️ 主题应用扩展已添加到主题（请检查此项）
无法取消 PDF 链接
PDF 仍显示链接：
- 刷新页面
- 检查链接是否真的已删除
- 再次尝试取消链接
批量取消链接失败：
- 尝试逐个取消链接
- 检查权限设置
- 如问题持续，请联系支持
链接了错误的 PDF
修复链接：
- 取消不正确 PDF 的链接
- 链接正确的 PDF
- 检查状态是否为已激活
- 在店铺前台验证
链接了多个 PDF：
- 检查是否有多个 PDF 被链接
- 取消不需要的 PDF 的链接
- 只保留正确的 PDF
批量链接不起作用
资源数量过多：
- 尝试较小批次（每次 25-50 个）
- 大规模操作需要更长时间
- 等待后台处理完成
资源未被选中：
- 确认复选框已勾选
- 至少选择一个资源
- 确认前检查选择内容
操作超时：
- 非常大规模的批量操作可能超时
- 拆分为较小批次
- 在非高峰时段重试
链接数量显示有误
缓存延迟：
- 链接数量每隔几分钟更新一次
- 刷新页面并等待
- 数量会自动更新
包含所有资源类型：
- 数量显示跨所有资源的链接总数
- 同一 PDF 可能同时链接到产品和页面
- 这是正常现象
无法链接到首页或搜索页
链接流程不同：
- 首页和搜索页无需搜索操作
- 直接选择资源类型并点击"链接"
- 每个商店各只有一个首页和搜索页
已链接：
- 检查 PDF 是否已链接
- 如需重新链接，请先取消链接
- 每个 PDF 对每个资源只能链接一次
模板筛选导致 PDF 不显示
筛选条件可能过于严格：
- 检查模板名称是否正确
- 确认页面使用了该模板
- 暂时删除筛选条件以进行测试
模板不存在：
- 在主题代码中检查模板名称
- 模板名称区分大小写
- 先不使用筛选条件进行测试
更新后链接消失
PDF 已删除：
- 删除 PDF 后，所有链接均会移除
- 删除操作无法撤销
- 如果重新上传，必须重新建立链接
误操作取消了链接：
- 在 PDF 库中检查链接状态
- 如有需要，重新链接 PDF
- 对多个资源使用批量链接功能
无法链接到特定产品
产品可能处于以下状态：
- 已归档（请先重新激活）
- 草稿（请先发布）
- 已删除（无法链接到已删除的产品）
检查产品是否存在：
- 在 Shopify 管理后台搜索
- 如已知产品 ID，请核对
- 确认产品已发布
批量链接到了错误的资源
撤销批量操作：
- 选择同一个 PDF
- 使用批量取消链接功能
- 选择相同的资源
- 从所有资源中取消链接
预防误操作：
- 确认前检查选择内容
- 先用 2-3 个资源进行测试
- 使用筛选条件缩小选择范围
- 最终确认前检查预览
达到链接上限
链接没有数量限制：
- 可将一个 PDF 链接到无限个资源
- 可将无限个 PDF 链接到同一资源
- 不应出现此类错误
可能是套餐 PDF 数量限制：
- 检查您的 PDF 数量与套餐上限
- 可能需要升级套餐或删除 PDF
- 链接本身没有数量限制
成功链接的技巧
有效搜索：
- 使用部分名称
- 尝试不同关键词
- 如有筛选功能，按类型筛选
保存前确认：
- 检查资源名称
- 确认资源类型
- 如有使用，检查模板筛选条件
先行测试：
- 先链接到一个资源
- 在店铺前台确认效果
- 再进行批量操作
保持有序：
- 为 PDF 使用清晰的名称
- 采用一致的命名规范
- 记录各 PDF 对应的页面