windingwind/zotero-pdf-preview · 上手攻略

  • 仓库：windingwind/zotero-pdf-preview
  • 链接：https://github.com/windingwind/zotero-pdf-preview
  • 分类：academic-writing
  • 作者：Tom
  • 更新：2026-08-22

这是什么

zotero-pdf-preview 是 Zotero 的一个插件，在 Zotero 文献库界面中直接预览 PDF 附件，无需打开外部 PDF 阅读器即可查看文档内容。支持预览区域可调整、注释显示、缩放控制、暗模式和多页切片显示。该插件由 Zotero 插件开发者 windingwind（也是 zotero-pdf-translate、zotero-better-notes 等热门插件的作者）维护。

⚠️ 重要声明：项目已归档

本插件已停止维护。 自 Zotero 7.0.0-beta.55 起，Zotero 原生支持附件预览功能。如果你正在使用 Zotero 7.x，请直接使用内置预览而非此插件。

本攻略保留用于： - 仍在使用 Zotero 6 的用户 - 研究 Zotero 插件开发的学习参考 - 历史存档目的

解决什么问题

在安装此插件前，查看 PDF 附件需要： 1. 在文献库中双击 PDF → Zotero 打开外部 PDF 阅读器 2. 切换回 Zotero 继续浏览文献 3. 反复在两个窗口间切换，打断阅读节奏

zotero-pdf-preview 将 PDF 预览嵌入 Zotero 右侧边栏，实现"边翻文献库、边扫 PDF 内容"的工作流，适合快速筛选文献和浏览 PDF 图表。

快速安装

Zotero 6（稳定版）

  1. 从 Releases 页面 下载最新的 .xpi 文件
  2. Zotero → Tools → Addons
  3. 点击右上角齿轮图标 → Install Add-on from File
  4. 选择下载的 .xpi 文件 → Install

⚠️ Firefox 浏览器：右键点击 .xpi → "另存为"后再安装

Zotero 7（预发布版）

从 Releases 页面 下载最新预发布版 .xpi，安装步骤同上。

从源码构建（开发目的）

git clone https://github.com/windingwind/zotero-better-notes.git
cd zotero-better-notes
npm install
npm run build

构建产物为 ./builds/*.xpi，可用上述方法安装。⚠️ README 示例命令中误写为 zotero-better-notes，实际应为 zotero-pdf-preview。

核心用法

打开预览

插件安装后，预览显示在 Zotero 主窗口右侧边栏。显示位置有两种：

  1. Info 标签页下方（默认）：选中文献后，Info 分栏底部出现预览区
  2. Preview 标签页：右侧边栏独立 Preview 标签页

切换显示/隐藏：按 P 键，或点击拖动条。

缩放操作

操作 按键/方式
放大 Ctrl/Cmd + + 或 Ctrl/Cmd + 滚轮上
缩小 Ctrl/Cmd + - 或 Ctrl/Cmd + 滚轮下
重置缩放 Ctrl/Cmd + 0
手动缩放 鼠标滚轮（需按住 Ctrl/Cmd）

双击跳转

启用"双击预览页跳转"后，双击预览中的任意页面，Zotero 会打开 PDF 并跳转到对应页面。

预览页面范围控制

设置路径：Menu bar → Edit → Preferences → Preview

默认预览前 10 页。高级用法支持 Python 风格的切片命令，可自定义预览页码范围：

# 语法：command1,command2,...
# 支持命令：

# 单页
1        # 预览第1页
10       # 预览第10页

# 切片 [start:stop)，支持负数（从末尾倒计数）
1:11     # 预览第1-10页
:11      # 预览第1-10页（同上）
10:      # 预览第10页至最后一页
-3:      # 预览倒数第3页至最后一页
:-3      # 预览第1页至倒数第3页（不含）
:        # 预览所有页面

配置项详解

配置项 说明 默认值
Enable Preview 启用预览功能 true
Preview in Info Tab 在 Info 分栏显示预览 true
Preview Position Info 分栏中预览位置 bottom
Preview in Preview Tab 在独立 Preview 标签页显示 true
Show Toolbar 显示工具栏 true
Show Annotations 显示 PDF 批注（可能降低速度） false
Show Hovered Page Style 悬停页加阴影和手型光标 true
Double-click to Open/Jump PDF 双击跳转 PDF true
Dark Mode 暗模式预览（原生日语，不保证色彩正确） false
Preview First N Pages 预览前 N 页 10
Preview Tab Name Preview 标签页标题 preview

典型适用场景

  • 文献筛选：在库中快速浏览 PDF 图表、摘要图，不用逐个打开
  • 阅读中途切换：阅读长 PDF 时想快速切回文献库确认上下文
  • 笔记整理：配合 zotero-better-notes 等插件做笔记时同步查看 PDF 内容
  • Zotero 6 用户：Zotero 7 以前没有内置预览功能的用户刚需

坑与注意

  1. ⚠️ Zotero 7 用户请勿安装：Zotero 7.0.0-beta.55+ 已内置附件预览，此插件与原生功能重复，且作者已停止更新。
  2. 注释显示影响性能：开启"Show Annotations"后，复杂 PDF 预览会明显变慢，建议保持关闭。
  3. 暗模式色彩问题：作者注明暗模式为"朴素实现"，PDF 内图片色彩可能显示不正确。
  4. .xpi 下载注意：Firefox 浏览器会直接安装 .xpi 而不保存，需右键"另存为"。
  5. 切片语法细节：start:stop 中 stop 为排除边界（Python 惯例），例如 1:11 预览 1-10 页而非 1-11 页。
  6. 构建命令示例有误：README 中 git clone 示例写的是 zotero-better-notes，实际目标仓库是 zotero-pdf-preview。

与同类对比

插件 功能 Zotero 7 兼容
zotero-pdf-preview 库内 PDF 预览 ❌（已停止维护）
Zotero 7 原生预览 库内 PDF 预览 ✅（内置）
zotero-better-notes PDF 批注与笔记 ✅（活跃维护）
zotero-pdf-translate PDF 内翻译 ✅（活跃维护）

如果你需要的是 Zotero 内的 PDF 快速查看，Zotero 7 用户直接用原生功能即可；Zotero 6 用户在安装此插件前请确认 Zotero 6 的 beta 版是否也已内置预览（Zotero 6.0-beta.3+ 可能已含相关功能）。

一句话推荐结论

zotero-pdf-preview 曾是 Zotero 6 用户提升文献浏览效率的必备插件，但在 Zotero 7 原生支持附件预览后已归档退役。当前 Zotero 7 用户请直接使用内置预览功能，勿再安装此插件。

⚠️ 数字核验：本仓库 Stars ~1253（2026-08）；项目状态：归档/停止维护；最后更新日期请以 GitHub Release 页为准，本攻略无法独立核验具体版本号。