papersgpt/papersgpt-for-zotero · 上手攻略

  • 仓库：papersgpt/papersgpt-for-zotero
  • 链接：https://github.com/papersgpt/papersgpt-for-zotero
  • 分类：Zotero 插件 / AI 知识管理 / MCP
  • 作者：Tom
  • 更新：2026-08-27

是什么

PapersGPT 是一个 Zotero 原生插件，用 C++ 编写核心索引引擎，把 Zotero 里的 PDF 文献库升级为可对话的 AI 知识库。支持单 PDF 问答、多 PDF 交叉分析、全库语义搜索，还能作为 MCP Server 把 Zotero 接入 Claude Code、Cursor 等 AI 编程工具。数据完全本地处理，号称"零云依赖"。

⚠️ 注意：GitHub README 描述较为夸张（"industrial-scale intelligence""10,000+ documents in minutes"），实际性能受本地硬件影响较大，建议先装免费版试用。

解决什么问题

  • 单 PDF 快速问答：打开任意 PDF，按 Cmd+Enter（macOS）或 Ctrl+Enter（Windows）直接向 AI 提问该文档，无需复制粘贴。
  • 多 PDF 交叉分析：选中多个 PDF 或一个收藏夹，AI 综合多篇文献给出对比分析（如"比较这 20 篇的样本量和 p 值"）。
  • 全库语义搜索：用自然语言搜索整个 Zotero 文献库，无需记住关键词。
  • Zotero MCP Server：把本地文献库作为 MCP 工具接入 AI 编程环境，在 Cursor/Claude Code 里直接调取文献。
  • AutoPilot 批量处理：设定研究目标，AI 批量处理 1000+ 篇论文，把洞察写入 Zotero Notes。

快速安装

第一步：下载 XPI 安装包

最新版本（v1.1.0）下载链接（GitHub Release）：

https://github.com/papersgpt/papersgpt-for-zotero/releases/download/papersgpt-v1.1.0/papersgpt-v1.1.0.xpi

⚠️ 下载地址直接从 GitHub Releases 页面获取，不要点击 README 里拼接的 JWT token 图片链接（那是内网图片，不可访问）。

第二步：安装 Zotero 插件

  1. 打开 Zotero → 菜单栏 工具 → 附加组件
  2. 点击右上角齿轮图标 → Install Add-on From File
  3. 选择下载的 .xpi 文件
  4. 重启 Zotero

⚠️ 需要 Zotero 10+。Windows 用户若安装后"Local LLM"选项不显示，重启 Zotero 通常可解决。

核心用法

单 PDF 对话

  1. 在 Zotero 中打开任意 PDF
  2. 点击 PDF 顶部菜单的 PapersGPT 按钮，或按快捷键： - macOS：Command + Enter - Windows / Linux：Ctrl + Enter
  3. 在弹出窗口输入问题，AI 基于当前 PDF 回答
  4. 每条回答附带可点击的引用，直接跳转到 PDF 原文位置

多 PDF 对话

  1. 在 Zotero 主窗口，按住 Ctrl（Windows）或 Command（macOS）点击选中多个 PDF（或选中一个收藏夹）
  2. 同上快捷键呼出 PapersGPT，AI 在多篇文档范围内综合回答

⚠️ 多 PDF 对话有篇数限制：Basic Plan 20 篇、Premium 100 篇、Business 300 篇。超出限额会提示升级。

全库搜索

在 PapersGPT 设置中勾选 "Search entire library"，AI 在整个 Zotero 库范围内检索并综合回答。

⚠️ 全库模式 PDF 数量限制：Premium ≤ 1000 篇、Business ≤ 2000 篇。免费用户无全库权限。

AutoPilot 批量处理

  1. 定义研究目标（如："总结我所有关于心血管的论文的方法论"）
  2. PapersGPT 批量阅读库内相关 PDF，将洞察写入 Zotero Notes
  3. 次日查看 Notes 获取结构化报告

⚠️ AutoPilot 批量处理适合离线运行（过夜），大规模库（>500 篇）首次运行可能耗时较长。

MCP Server（接入 AI 编程工具）

PapersGPT 可作为 MCP Server 供 Claude Code、Cursor、Windsurf 等工具调用 Zotero 文献库：

# 详见 GitHub 文档：
# https://github.com/docsagent/docsagent

⚠️ MCP Server 配置需要参考 GitHub 上 docsagent 子项目的说明，配置过程有一定复杂度，非开发者用户可跳过此功能。

支持的模型

在线 SOTA 模型（需 API Key）：DeepSeek V4 Pro、Claude Fable 5、Claude Sonnet 5、GPT-5.6、Gemini 3.6、GLM 5.2、Kimi k3 等。

本地免费模型（无 API 费用）： - 内置一键下载：Gemma 4 12B（QAT）、Qwen3.5 4B - 自定义 OpenAI 兼容端点 - Ollama 集成（任何本地 Ollama 模型）

⚠️ README 提到 Gemma 4 12B "单点即下载"，但实测 Windows 用户在 M 系列 Mac 曾遇路径含中文导致下载失败（v1.1.0 已修复此 bug）。

典型适用场景

场景 说明
文献综述加速 全库提问，AI 综合 N 篇论文的研究方法/结论，输出对比表
深度单篇精读 边读 PDF 边问 AI，帮助理解方法学和结果
跨学科发现 同一问题在不同领域论文里的不同结论，AI 帮你找出来
博士/研究员日常 过夜 AutoPilot 处理 1000+ 篇新论文的摘要洞察
AI 编程工具增强 MCP 接入 Cursor/Claude Code，编程时直接引用文献

坑与注意

  1. 本地 LLM 下载依赖 HuggingFace：若 HuggingFace 访问不稳定（国内常见），插件会自动切换到镜像源，但首次配置建议确保网络通畅。
  2. 免费额度有限：每天 10 次在线 SOTA 模型对话 + 20 次本地模型对话，超出需购买 Pro 计划。
  3. Zotero 10 兼容性：旧版 Zotero（< v6）不支持；升级 Zotero 再装插件。
  4. 中文路径 bug 已修复：v1.1.0 修复了 Windows 本地模型路径含中文时启动崩溃的问题，确保使用最新版本。
  5. 引用准确性：README 声称"每条回答带可跳转引用"，实际引用准确性受 PDF 解析质量影响，对扫描版 PDF（OCR 未处理）支持较差。
  6. Pro 计划限制：插件内购买后会开通 Pro，功能包括更多对话次数和全库搜索，隐私敏感用户需自行评估（数据处理在本地，但 API 调用走网络）。

与同类对比

工具 类型 核心优势 缺点
PapersGPT Zotero 插件 C++ 核心速度快、MCP 集成、本地模型支持、全库搜索 Pro 付费、Zotero 独占
Zotero GPT Zotero 插件 轻量、免费方案可用 无 MCP、无多 PDF 交叉分析
DocGPT 浏览器插件 跨 PDF 库搜索 非 Zotero 原生、同步麻烦
ChatPaper Web / API 专注 arXiv 批量处理 非 Zotero 原生

PapersGPT 适合已有成熟 Zotero 文献库、且需要 MCP 集成或本地模型 air-gapped 使用的用户。

一句话推荐结论

如果你已经在用 Zotero 管理文献库、同时需要 AI 辅助阅读和跨文档分析，PapersGPT 是目前 Zotero 生态里功能最完整的 AI 插件——尤其是 MCP 接入和本地模型支持是独特护城河；但 Pro 计划付费墙和"夸张营销"需要理性看待，先用免费额度试用再决定。