# Zotero PDF2zh 教程：原 PDF、双语译文与附件关系

在独立 Zotero 测试库导入原创条目，配对安装插件与 Server，核对翻译进度、原文保留和译文附件挂载。

运行范围：原创 PDF/CSV/EPUB/HTML 材料与本地验收已实际执行。没有调用翻译模型、没有连接 Zotero 库、没有填写凭证。官方截图为官方项目示例，不是本练习运行输出。

依赖：Python 3.11+；PDF 验收需 Poppler 的 pdfinfo/pdftotext；OCR 复现需 tesseract 英文语言数据。安装翻译工具时遵循各自官方 Python 要求。

## 1. 准备独立测试库

下载 item.json 与 source.pdf，在 Zotero 新建“QR PDF2zh 练习”分类。item.json 为原创 CSL JSON 条目，不含真实 DOI；先在独立测试库导入，避免动到自己的正式资料库。

```sh
python3 verify.py
```

## 2. 导入条目并挂原文

在 Zotero 文件菜单导入 item.json，把 source.pdf 拖到刚导入条目下。展开条目检查附件层级，双击打开原文。下载包 attachments.tsv 是预期清单，不是假冒 Zotero 数据库导出。

## 3. 配对安装插件与 Server

从官方最新 release 同时取得 XPI 与 Server，记录两个版本。官方 v4.1.7 强调二者同时更新；具体支持的 Zotero 版本以当前 release 为准。不要用截图版本猜本机版本。

## 4. 启动后端并设置连接

按官方 Server 说明启动服务，在 Zotero 插件设置里填实际 Server 地址，选择 pdf2zh 或 pdf2zh_next 对应引擎，再配置本机可用的服务。官方截图用于定位设置与入口。

## 5. 先翻译单个测试附件

右键选中 source.pdf，使用插件对应翻译菜单。保留进度和错误信息，等待后台任务完成；本教材没有运行 Zotero 插件或翻译模型，截图来自项目官方示例。

## 6. 核对译文附件挂载

展开原条目，确认原 PDF 仍在，译文/双语附件在同一条目下可打开。远程/Docker 模式可能通过 HTTP 挂载附件，检查实际文件可访问性；不能只看进度到 100%。

## 7. 核对文件与库关系两层证据

运行包内离线脚本检查原文哈希与清单，再在 Zotero 界面人工核对条目和附件关系。文件存在检查没有访问 Zotero 数据库，也不能证明插件已完成。

```sh
python3 verify.py
```

## 来源

- https://github.com/guaguastandup/zotero-pdf2zh
- https://zotero-pdf2zh.github.io/

## 教材

原创输入材料可用于学习练习。官方图片版权归原作者，网页中保留来源。ZIP 包含供缩略图使用的官方菜单示例，明确标注非本机结果；来源记录在 thumbnail-sources.json。