lifan0127/ai-research-assistant · 上手攻略

  • 仓库：lifan0127/ai-research-assistant
  • 链接：https://github.com/lifan0127/ai-research-assistant
  • 分类：学术工具 · Zotero 插件
  • 作者：Tom
  • 更新：2026-08-21

这是什么

Aria（AI Research Assistant，A-R-I-A = "AI Research Assistant" 倒写）是 Zotero 的一个本地插件，用 GPT-4 系列模型为你的文献库添加对话式 AI 助手功能。装好后 Zotero 工具栏出现一个按钮，点开就能和当前选中的文献"对话"——问它摘要、方法论、找相关研究、写笔记。

最新版本： - Zotero 7 → v0.7.4（GitHub Release） - Zotero 6 → v0.8.0（GitHub Release）

⚠️ 注意：Aria 尚未支持 Zotero 8（Citation Styler 2026 年评测已标注此限制）。

解决什么问题

Zotero 是学术文献管理的事实标准，但用 GPT-4 类模型辅助文献阅读一直是"复制 PDF → 粘贴到 ChatGPT → 再把结果手动搬回 Zotero"的割裂流程。

Aria 把这个流程直接嵌入了 Zotero：在你的文献库旁边开一个对话窗口，选中文献，直接问问题。典型用法：

  • "这篇论文的主要贡献是什么？"
  • "找出和我的研究问题最相关的段落"
  • "帮我写一段 note 总结"
  • "这张图描述了什么？"（需要 GPT-4 Vision preview）

快速安装

方法一：从 GitHub 下载 xpi（推荐）

  1. 打开 https://github.com/lifan0127/ai-research-assistant/releases/latest
  2. 根据你的 Zotero 版本下载对应 .xpi 文件（Zotero 6 / Zotero 7 版本不同，请勿混用）
  3. Zotero 主界面 → Tools → Addons（或 ⌘+Shift+A / Ctrl+Shift+A）
  4. 点击右上角齿轮图标 → Install Add-on From File
  5. 选择下载的 .xpi 文件 → Open → 确认安装
  6. 重启 Zotero

方法二：视频教程

Mushtaq Bilal 博士（Twitter/X @MushtaqBilalPhD）提供了详细图文安装教程：

https://twitter.com/MushtaqBilalPhD/status/1735221900584865904

首次配置 API Key

  1. 重启 Zotero 后，点击工具栏的 Aria 图标（或按 Shift + R）
  2. 按应用内提示粘贴你的 OpenAI API Key
  3. 保存后重启 Zotero

如果设置里看不到 Aria Tab，在 Edit → Preferences → Advanced → Configuration Editor 里搜索 aria，找到 extensions.zotero.aria.OPENAI_API_KEY，双击添加 key。

核心用法

激活方式

  • 快捷键：Shift + R
  • 工具栏按钮：点击 Aria 图标
  • 拖拽 PDF：选中 PDF 文件直接拖入 Aria 对话窗口

对话交互

在 Aria 窗口输入问题，AI 会结合当前 Zotero 选中的文献给出回答。支持：

  • 自动补全（Autocompletion）：输入问题前缀，AI 补全完整问题
  • 拖放 PDF：把 PDF 拖进对话，AI 自动解析内容
  • 笔记标注（Note Annotation）：生成 Zotero Note 并自动关联到对应文献

模型选择

在 Edit → Preferences → Aria 中可配置：

  • Base 模型：GPT-4 / GPT-4 Turbo（Preview）
  • Zoom Level：适配屏幕分辨率
  • 快捷键：可自定义激活热键组合

⚠️ 版本说明： - v0.7.1 添加了 GPT-4o 和 GPT-4o mini 支持（2024 年 7-8 月） - v0.7.2 替换了已废弃的 GPT-4-Vision 模型调用 - v0.7.4 升级了 zotero-plugin-toolkit 以修复与其他插件的兼容性问题

Prompt Library（提示词库）

Aria 内置了交互式提示词库，对新手友好——不需要自己写 Prompt，直接从库里选现成的。

反馈与会话分享

  • Feedback：提交你对 AI 回复的反馈（帮助改进）
  • Share Chat Session：把对话分享给同事或协作伙伴

反馈问题

遇到错误时，在 GitHub 提 Issue，请附上 Aria 对话窗口的截图。

典型使用场景

场景 操作 效果
快速了解论文 选中 PDF → 问"主要贡献是什么" 不用打开 PDF 也能获取摘要
找相关文献 选中文献 → 问"哪些论文和这个研究问题相关" 扩展文献调研
写笔记 选中文献 → 拖入 Aria → 生成 Note 自动写好一段总结
图表解读 上传 PDF 截图 → GPT-4 Vision 分析 看图说话
批量筛选 对多篇文献依次提问 快速过滤不相关文献

坑与注意

  1. Zotero 8 不兼容：当前 Aria 最高支持 Zotero 7，Zotero 8 用户需要等更新（或降级到 Zotero 7）。

  2. API 费用：Aria 本身免费，但 GPT-4 API 按 token 计费。大文献库频繁使用会产生费用，建议在 OpenAI 平台设置用量提醒。

  3. 无法查询 SQLite 数据库：目前只能通过 Zotero 搜索 API 查询文献库，无法直接读 SQLite 获取文档数量等指标（作者已知，会在 future release 解决）。

  4. 上下文感知有限：Aria 对 Zotero 应用状态（当前选中项、当前 Tab、高亮文本）的感知有限，需要通过拖拽和自动补全功能手动提供上下文。

  5. Max Iterations 错误：某些复杂问题 AI 会进行多轮 API 调用，可能在中途达到最大迭代次数而停止。遇到此错误可拆分问题为更小的子问题重试。

  6. 迭代速度放缓：相比 PapersGPT 等同类插件（有 MCP 支持、本地模型、多 Provider），Aria 更新节奏较慢（最后一次 release 约 2025 年），生态扩张动能不足。

  7. 中文文献支持：Aria 主要针对英文 GPT-4 模型优化，中文文献的处理效果取决于模型本身的能力，非插件层面的特殊处理。

与同类对比

插件 Zotero 版本 支持模型 MCP 支持 本地模型 最新支持
Aria（本案） 6 / 7 GPT-4 系列 ❌ ❌ Zotero 7
PapersGPT 7+ GPT-4、Claude、Gemini、DeepSeek 等 ✅ ✅ 活跃
Beaver 7+ OpenAI、Claude、Gemini 等 部分 ✅ 活跃（Plus 计划）
ZoteroGPT 6+ GPT-4 ❌ ❌ 较旧

Aria 的定位是最简单的 Zotero+GPT 入门组合——开箱即用、不需要折腾配置，适合只需要 GPT-4 能力的轻度用户。如果需要多模型支持、MCP 或本地模型，PapersGPT 是更现代的选择。

一句话推荐结论

研究人员在 Zotero 里装 Aria 是最轻量的 GPT-4 文献助手入门方案，5 分钟装好、直接在文献库旁边对话；但如果你需要多模型支持或 MCP 集成，这个插件的迭代速度已经落后于 PapersGPT 等更新的竞品，Zotero 8 用户暂时也无法使用。