任务管理与补译
右键文库中的条目或 PDF，选择 zotero-pdf2zh-pro → 任务列表。
根据状态操作
| 状态或问题 | 操作 |
|---|---|
| 排队中、运行中 | 等待阶段更新，保持服务运行 |
| 待恢复 | 点击“继续任务”；恢复整个队列用“继续上次队列” |
| 失败 | 查看错误，修复连接或配置后“重试任务” |
| 未完成 | 点击“补译”，保留已验证译文，只请求剩余段落 |
| 已完成，导入失败 | 点击“重试导入”，只拉取已有结果，不重新翻译 |
| 怀疑漏译 | 点击“检查并补译” |
补译可能消耗 API 额度；新结果另存为附件，保留旧附件和批注。 “删除记录”会删除服务端任务数据和恢复检查点，操作前先保存所需结果。
查看详情
点击任务卡片的 详情，查看错误和请求指标。
如何看请求指标
- 耗时：排队与执行的累计时间，不包含停机或等待继续。
- QPS / 活跃请求：当前请求速率与并发情况。
- Token / 输出速度：服务商回报的用量和速度；
—表示缺失，不能当作零消耗。 - 缓存：本地翻译缓存与服务商缓存是两种统计。
重启、恢复与翻页
服务重启后，未开始或执行中断的任务等待手动继续，主动取消的任务不加入恢复队列。 继续、重试和补译沿用原任务配置；原 PDF 或任务目录已删除时无法恢复。
历史记录每页 30 条，活动任务和待导入结果始终显示。筛选作用于当前列表；“重试本页失败”只处理当前列表，“清理失败记录”会处理相应服务的全部失败记录。
提交时断线，可从同一原附件以相同配置再次提交找回已接收任务。不要反复更换配置重新提交。
数据保存、附件关联或记忆同步出错
- 任务记录无法安全读取：先停止服务并备份数据目录，再核对
tasks.json和tasks.json.bak。不要直接覆盖原文件；备份可能缺少最近任务。 - 任务变更未能保存：检查磁盘空间和目录权限，再重试。取消保存失败时，恢复写入后需再次取消。
- 本地附件关联损坏：退出 Zotero 并备份 Profile，核对
extensions.zotero.pdf2zhpro.taskBindings与taskBindingsBackup，不要直接清空。 - 已导入附件被删除或未同步：先恢复或下载附件，不必重译。
- 记忆同步失败：PDF 仍可导入。修复空间、权限或占用问题后点击“重试记忆同步”；同步完成前不能删除任务。
无法判断原因时，导出诊断包反馈。