PDF 查看器故障排除
修复扩展 PDF 查看器中的「Viewer refreshed」错误、PDF 加载失败和同步阻塞。
多数 PDF 查看器问题源于查看器会话丢失、PDF 字节过期或同步冲突。本指南涵盖恢复步骤。
Viewer refreshed
消息： 查看器已刷新。请返回原 PDF 标签页并重新启用。
原因： PDF 字节临时存储在扩展后台进程中。重新加载查看器标签页或更新扩展会清除该内存。
修复：
- 关闭或忽略损坏的查看器标签页。
- 返回浏览器中的原始 PDF 标签页。
- 重新激活 ZetaMarker（
Ctrl+Shift+K/Cmd+Shift+K）或点击扩展图标。 - 若错误持续，将 PDF 上传到控制台并从资料库打开。
其他加载错误
| 消息 | 处理方式 |
|---|---|
| 缺少 rid。请返回 PDF 标签页并重新启用。 | 从源 PDF 标签页重新激活 — 勿将查看器 URL 加入书签。 |
| 无法加载 PDF。请上传到 ZetaMarker。 | 通过 /app?upload=pdf 上传并在控制台高亮。 |
| 无法加载 PDF 数据。请返回并重新启用。 | 与 Viewer refreshed 相同 — 从 PDF 标签页重新激活。 |
| 缺少查看器容器。 | 重新加载扩展查看器标签页或从 PDF 标签页重新激活。 |
| 查看器错误 | 重新加载页面；若重复出现则将 PDF 上传到云。 |
加载时查看器显示 加载中…
同步与回收站问题
| 消息 | 处理方式 |
|---|---|
| 同步已阻止。请刷新高亮或重新加载查看器。 | 在 选项 菜单使用 刷新高亮 或重新加载查看器。 |
| 高亮已在本地升级，但云端同步失败。请尝试刷新高亮。 | 检查连接后运行 刷新高亮。 |
| 页面在回收站中 — 请在 Web 应用中恢复后再编辑。 | 在控制台从回收站恢复。 |
| 页面在回收站 — 在应用中恢复以同步 | 同上 — 参见回收站中的页面。 |
同步冲突（409）参见同步冲突。
查看时扩展已更新
若标签页保持打开时 ZetaMarker 已更新，可能看到 ZetaMarker 已更新。请刷新此页面并重新启用扩展程序以继续使用高亮。 — 参见扩展已更新 — 刷新页面。