MuiseDestiny/zotero-gpt · 上手攻略
- 仓库：MuiseDestiny/zotero-gpt
- 链接：https://github.com/MuiseDestiny/zotero-gpt
- 分类：academic-writing
- 作者：Jay
- 更新：2026-07-14
这是什么
zotero-gpt 是一个 Zotero 文献管理器的 AI 助手插件，让研究者在阅读 PDF 文献时直接用 GPT（gpt-3.5-turbo / gpt-4）提问、摘要、搜索相关文献，所有交互都以内嵌弹窗形式在 Zotero 内完成，无需切换到 ChatGPT 或其他工具。
核心作者是 MuiseDestiny，基于 zotero-plugin-template 开发，兼容 Zotero 6 和 Zotero 7。
解决什么问题
学术研究者阅读文献时常面临：
- PDF 太长，没时间细读：想知道一篇论文的核心贡献，要通读全文才能提取摘要。
- 文献孤立，缺乏关联：看完一篇不知道库里还有哪些相关文献可以对比。
- 跨工具切换打断心流：读 PDF 时想提问，要切到 ChatGPT / Claude，复制粘贴，再切回来。
- 笔记与文献割裂：Zotero 的笔记功能是纯文本的，GPT 生成的摘要散落在别处。
zotero-gpt 把 GPT 直接嵌入 Zotero，实现「读 PDF → 问 GPT → 结果存在文献条目下」的无缝闭环。
快速安装
方式一：直接下载 xpi（推荐小白）
- 访问 GitHub Releases 下载
zotero-gpt.xpi - 打开 Zotero →
Tools → Add-ons - 点击齿轮图标 →
Install Add-on From File→ 选择下载的.xpi文件 - 重启 Zotero
方式二：从 Gitee 下载（国内加速）
https://gitee.com/MuiseDestiny/plugins/raw/master/zotero-gpt.xpi
⚠️ 前提：必须先安装 Zotero（支持 Zotero 6 和 Zotero 7）。Zotero 是免费开源的文献管理器，官网：https://www.zotero.org
方式三：源码构建
git clone https://github.com/MuiseDestiny/zotero-gpt.git
cd zotero-gpt
npm install
npm run build
# 生成的 .xpi 文件在 build/ 目录
核心用法
基础配置：填入 API Key
- 打开 Zotero GPT 插件窗口（快捷键或点击工具栏按钮）
- 在设置中填入 OpenAI API Key（需自行到 https://platform.openai.com/account/api-keys 申请）
- 选择模型：
gpt-3.5-turbo（便宜快速）或gpt-4（质量更高） - 可选填入自定义 API 域名（如使用第三方代理）
核心功能一览
| 功能 | 操作方式 |
|---|---|
| 对当前 PDF 提问 | 选中文字 → 打开 GPT → 输入问题 |
| 摘要整篇 PDF | 选中文字或直接点击摘要命令 |
| 基于文字搜索库内文献 | 选中文字 → 用 #search 命令 |
| 一键复制回复 | 点击复制按钮 |
| 查看历史对话 | 用键盘 ↑↓ 上下翻页 |
命令标签（Command Tags）：一键加速
zotero-gpt 支持命令标签——预设的快捷指令。输入 #标签名 再按 Enter，会自动触发对应模板。
内置示例：
# Summarize
Summarize the following paragraph briefly:
${Meet.Zotero.getPDFSelection()}
运行：输入 #Summarize → GPT 对选中文本生成摘要
自定义命令标签
- 在插件窗口输入
#标签名按Enter激活 - 在模板里用
${}嵌入动态代码（如${Meet.Zotero.getPDFSelection()}） - 按
Ctrl+S保存 - 长按标签可编辑颜色、触发词、位置
内置 API 示例（可组合使用）：
Meet.Zotero.getPDFSelection() // 获取当前 PDF 选中文本
Meet.Zotero.getAbstract() // 获取当前条目摘要
Meet.Zotero.getNote() // 获取当前笔记
Meet.Zotero.getItems() // 获取库中所有条目
Meet.Zotero.getPDFItems() // 获取库中所有 PDF 条目
典型适用场景
| 场景 | 使用方式 |
|---|---|
| 快速了解一篇新论文 | 用 #Summarize 摘要全文，5 分钟摸清贡献 |
| 对比阅读多篇文献 | 依次对每篇摘要，再人工横向比较 |
| 追踪某概念的引用 | 选中术语，用 #search 搜库内相关文献 |
| 写文献综述 | 用 GPT 生成各篇的「一句话贡献」，整理成表格 |
| 检查 PDF 翻译质量 | 选中译文段落，要求 GPT 对照英文原文点评 |
| 辅助理解复杂公式 | 选中公式附近文字，要求 GPT 解释 |
坑与注意
⚠️ API 费用：按 token 计费
GPT 调用是按量收费的：
- gpt-3.5-turbo：约 \$0.002 / 1K tokens（便宜，适合大量调用）
- gpt-4：约 \$0.03 / 1K tokens（贵，但质量高）
💡 建议：日常摘要、搜索用
gpt-3.5-turbo；复杂概念解释、英文润色切换gpt-4。
⚠️ 长 PDF 可能超出上下文窗口
GPT 有上下文 token 上限（gpt-3.5-turbo 支持 16K，gpt-4-turbo 支持 128K），超长 PDF 全篇喂入会失败。推荐做法：先用 #search 或 #abstract 提取关键内容，再针对具体段落提问。
⚠️ Zotero 7 兼容性问题
⚠️ 注意（截至本攻略写作时）：部分用户报告 zotero-gpt 在 Zotero 7 上的插件安装存在兼容性问题。建议： - 优先使用 Zotero 6（生态插件更丰富） - 如果用 Zotero 7，安装后测试核心功能（提问、摘要）是否正常 - 关注 GitHub Issues 了解最新兼容性状态
⚠️ GPT 对学术内容的局限性
GPT 偶尔会捏造文献引用或数据（「幻觉问题」）。对于事实性要求高的学术内容： - 关键引用务必回原文核实 - 不要直接用 GPT 生成的内容作为文献来源 - GPT 适合辅助理解，不适合替代批判性阅读
⚠️ 插件安全性
插件需要你的 OpenAI API Key 才能工作，该 Key 会存储在本地。务必： - 不要将 API Key 上传到 GitHub 或公开场合 - 定期检查 OpenAI 平台的 API 使用量，发现异常立即重置 Key
⚠️ 与 Zotero Better Notes 联动
zotero-gpt 可与 zotero-better-notes 联动，在 Better Notes 的笔记环境中直接调用 GPT。但 Better Notes 本身配置较复杂，新手建议先用纯 zotero-gpt 功能。
与同类对比
| 工具 | 特点 | 与 zotero-gpt 的区别 |
|---|---|---|
| ChatPDF | 在线服务，上传 PDF 对话 | 不用安装，但数据不在本地，不与 Zotero 整合 |
| PDF-GPT | 本地部署，开源 | 完全离线，但需要自己搭 LLM 服务 |
| ScholarCopilot | 学术专用，部分付费 | 生态封闭，与 Zotero 集成浅 |
| Zotero Better Notes | Zotero 原生笔记增强 | 无 AI 功能，但笔记管理更强大 |
| zotero-gpt | Zotero 插件 + OpenAI | 即装即用，与 Zotero 无缝，但依赖 OpenAI API |
| Paper QA | 命令行/代码接口 | 适合批量分析，不适合随手提问 |
zotero-gpt 的核心优势是即装即用 + Zotero 原生体验，最适合已经在用 Zotero 管理文献的研究者。
一句话推荐
如果你用 Zotero 管理文献，又不想在浏览器和 PDF 阅读器之间来回切换——zotero-gpt 就是你的一站式 GPT 学术阅读伴侣，装上它，读文献的效率至少提升一倍。
本攻略基于 2026-07-14 读取的 GitHub README 编写。插件版本、API 定价和 Zotero 兼容性可能随时间变化，请以官方 GitHub 最新说明为准。