Zotero 文献研究助手
在 Zotero 中对论文提问、溯源引用、整理文献与生成研究笔记。
- Star 数
- ★ 3.5k
- 最近更新
- 3 天前
- License
- AGPL-3.0
- 主语言
- TypeScript
- FA 评分
- 54/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · OpenAI API · Claude APIChatGPT · Claude Code（部分支持）
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 研究生正在阅读一篇 PDF，希望在 Zotero 阅读器中追问方法、结果或一段选中文本，并点击引用直接核对原文。
- 不适合
- 不使用 Zotero 7/8/9 的用户，插件无法独立运行
- 不愿为云端模型 API 或 MinerU 云解析付费的用户
- 源码审查
- 54/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
llm-for-zotero 是一个安装为 .xpi 的 Zotero 插件，将论文对话与研究工作流嵌入 Zotero 的 PDF 阅读器侧栏及独立窗口。它可围绕当前 PDF、选中文本、截图、多个已打开的论文和上传文件发起对话，并生成可跳回原文位置的引用。启用 beta Agent Mode 后，系统可搜索和读取 Zotero 文献库，执行可确认的标签、元数据、馆藏、附件与笔记操作，并支持同一会话中的最近写入撤销。它既可使用标准 API 提供商和本地 OpenAI 兼容端点，也提供 WebChat、Codex App Server 与实验性的 Claude Code 模式。输出可保存到 Zotero 内部笔记，或写入 Obsidian、Logseq 等本地 Markdown 目录。
在首次提问时，插件把当前论文载入上下文；后续问题对同一论文进行聚焦检索，并为生成的引用提供跳转到 Zotero 原文段落的入口。它可读取 PDF、选中文本、图像截图和最多 10 个外部文件，支持 PDF、DOCX、PPTX、TXT 与 Markdown 上传；也可通过 / 将其他打开的论文加入上下文。Agent Mode 提供文献库和 PDF 阅读、CrossRef 与 Semantic Scholar 检索、标签和元数据更新、馆藏与附件管理、笔记编辑、文件读写及分析命令等能力，写入操作通过确认卡处理，并保留每会话最近 10 条写入记录用于撤销。MinerU 启用后会解析新加入的 PDF，并缓存提取的 Markdown、表格、公式、图像和复杂版式结果；本地模式调用 mineru-api 的 POST /file_parse。插件可把回答、完整对话和带 YAML frontmatter 的 Markdown 研究笔记写入 Zotero 或配置的本地目录。
- 研究生正在阅读一篇 PDF，希望在 Zotero 阅读器中追问方法、结果或一段选中文本，并点击引用直接核对原文。
- 需要比较多篇已打开论文的研究者，可用 / 将其他论文加入上下文，要求系统归纳方法差异或证据。
- 维护大型 Zotero 文献库的用户，可在 Agent Mode 中搜索条目、发现相关文献，再确认应用标签或更新元数据。
- 使用 Obsidian 或 Logseq 的研究者，可要求系统总结当前论文并将带 YAML frontmatter 和 Pandoc 引文语法的 Markdown 笔记保存到指定目录。
- 需要处理表格、公式或复杂双栏版式的用户，可启用 MinerU，将新增 PDF 解析并缓存后用于后续对话。
- 拥有 ChatGPT Plus 的 Zotero 用户，可配置本地 codex app-server，在插件内切换到 Codex 对话系统而不单独配置 API 密钥。
如何安装或部署这个 Agent？
从 Releases 页面下载最新 .xpi 文件。在 Zotero 中依次打开“工具”→“插件”，点击齿轮图标并选择“从文件安装插件”，选中该 .xpi 后重启 Zotero。随后打开“偏好设置”→“llm-for-zotero”，选择 Provider，填写 API Base URL、secret key 和 model name，点击“Test Connection”。若使用 Codex App Server，先安装并登录 Codex CLI：npm install -g @openai/codex，然后运行 codex login；再在插件“Agent”标签页启用集成并测试连接。
如何使用这个 Agent？
在 Zotero 中打开一篇 PDF，点击右侧工具栏的 LLM Assistant 图标，然后直接提出问题、选中文本后提问、添加截图，或上传补充文件。可保存单条回答或完整对话到 Zotero 笔记；如需输出到本地 Markdown，先在“Notes Directory”配置目录昵称、绝对路径和默认文件夹，再要求系统保存到该昵称对应的位置。要使用库级检索、写笔记或整理任务，先在偏好设置启用 Agent Mode，再在上下文栏切换“Agent (beta)”。
这个 Agent 有哪些优点和局限？
- 直接嵌入 Zotero PDF 阅读器，并提供可跳回来源段落的引用，便于核查模型回答。
- 覆盖当前论文、多论文比较、截图和多种外部文档上下文，而不局限于单篇 PDF 问答。
- Agent Mode 将文献库检索、CrossRef 与 Semantic Scholar 学术发现、笔记和整理操作集中到同一工作流，并对写入提供确认与会话撤销。
- 支持 API 提供商、本地 OpenAI 兼容模型、WebChat、Codex App Server 和 Claude Code 等多条后端路径。
- 可选 MinerU 解析与本地 Markdown 笔记输出，适合重视 PDF 提取质量或使用 Obsidian、Logseq 的工作流。
- 核心交付形式是 Zotero 插件，采用前必须运行兼容的 Zotero 7、8 或 9，而非独立网页或桌面研究工具。
- 不同后端有不同运行和凭据要求；标准提供商通常需要 API key，Codex 需要已登录的 Codex CLI，Claude Code 需要 CLI 和本地 bridge。
- Claude Code 集成为实验性功能，且目前不支持原生 Zotero API 操作；需要库级读取、标签或导入时仍应使用内置 Agent Mode。
- WebChat 依赖 Chromium 浏览器扩展和保持打开的 ChatGPT 或 DeepSeek 标签页，标签页最小化、后台运行或跨显示器状态可能导致连接中断。
- 本地 MinerU 解析需要自行运行 mineru-api；暂停只会停止插件队列和 HTTP 等待，服务器上已开始的解析仍会继续执行。
这个 Agent 与同类方案有什么区别？
与仅保存在 Zotero 内部笔记中的流程相比，File-Based Notes 可将带 YAML frontmatter 和 Pandoc 引文语法的 Markdown 写入 Obsidian、Logseq 或任意本地目录。与云端 MinerU 相比，本地 mineru-api 模式可在默认 127.0.0.1 地址下让 PDF 留在本机，但需要自行部署并准备模型。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Zotero 文献研究助手 当前 | 54 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 3.5k | 3 天前 | TypeScript | Codex · OpenAI API · Claude API |
| LLM Wiki | 69 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 1.8k | 15 天前 | Python | Codex · Claude Code · Claude.ai |
| 材料学习工坊 | 92 · 表现优秀 | Agent 插件 / 技能免费 | ★ 1.3k | 17 天前 | Python | Codex · Claude Code |
| AI Research Skills 科研技能目录 | 77 · 存在缺口 | Agent 插件 / 技能免费 + 模型费 | ★ 604 | 1 天前 | Python | Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：Agent Mode 默认禁用，写操作需确认，提供会话内撤销（最近10条），读取工具不受限但写入工具可审查。数据流透明性：README 有隐私与数据流章节，但未提供详细日志或审计。敏感数据处理：API 密钥存储于本地配置，但未说明加密或保护措施。依赖安全：依赖版本未固定，无安全审计记录。外部影响：可读写本地文件、执行命令，但需确认。回滚：提供会话内撤销，但非持久化。来源归属：未验证发布者身份，无明确归属声明。扣分原因：敏感数据处理和依赖安全证据不足，来源归属不明确。
证据显示：代码结构一致，测试覆盖部分功能，但未提供完整测试结果。依赖可用性：依赖项未固定版本，可能影响可复现性。失败消息：代码中有错误处理，但未提供用户可见的失败消息示例。扣分原因：依赖版本未固定，失败消息证据不足。
证据显示：面向 Zotero 用户，支持多种场景（论文问答、总结、比较等）。能力边界：Agent Mode 明确区分读写工具，写操作需确认。触发精度：技能触发模式明确，但未提供详细规则。环境适配：支持多种后端（API、本地模型、WebChat、Codex、Claude Code），但依赖外部服务。扣分原因：触发精度和部分环境适配证据不足。
证据显示：README 结构清晰，有安装说明、示例、FAQ、已知限制。许可证为 AGPL-3.0，版本号存在但无变更日志。维护责任：有 issue 模板和 CI，但发布者未验证。扣分原因：无变更日志，维护责任不明确。
证据显示：输出可用性高，提供引用跳转、笔记保存等功能。边际价值：提供独特功能（如 MinerU 解析、多论文比较）。成本效益：需要配置 API 密钥或外部服务，成本未明确。扣分原因：成本效益证据不足。
证据显示：README 中的声明部分有演示，但未提供可验证的测试结果。交叉验证：未提供独立来源验证。事实与推断分离：未明确区分。扣分原因：缺乏可验证的测试结果和独立验证。
- 依赖版本未固定，可能引入安全漏洞或兼容性问题。
- API 密钥存储方式未说明加密措施，建议用户谨慎保管。
- Agent Mode 可读写本地文件并执行命令，虽需确认，但用户应理解风险。
- 发布者身份未验证，建议用户自行评估信任度。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v3.9.16 Release v3.9.16
发布说明摘录
What's new in LLM for Zotero *Changes since 3.9.15* The agent now reads the parts of a paper you name, in any language, and shows you which parts it read. It can do more in your library: attach files, find PDFs, change item types, annotate, and open a PDF at a page. Claude Code and Codex show their steps in Task progress, and Codex asks before it writes to Zotero. Reading papers Ask for the parts you want Name the parts of a paper you want, such as "the abstract and the results". The agent picks those sections from the paper's own outline, in any language. …在 GitHub 查看 ↗ -
v3.9.15 Release v3.9.15
发布说明摘录
What's new in LLM for Zotero *Changes since 3.9.14* You can now open any chat in its own small window and keep it beside your paper. Answers are easier to read, with type and spacing closer to Claude desktop. Zotero's Codex sessions can use their own Codex home folder, apart from the Codex app. Chat windows Open a chat in its own window In the separate chat window, drag a chat out of the chat list, or drag the chat title. You can also right-click a chat and choose Open in New Window. The new window holds that one chat. …在 GitHub 查看 ↗ -
v3.9.14 Release v3.9.14
发布说明摘录
What's new in LLM for Zotero *Changes since 3.9.13* The chat has a new layout: the composer floats over the bottom of the chat, and the window sidebar groups your chats by agent. Answers that use the web now credit their sources. Task progress shows which papers and pages each question used, and where the answer uses them. A local MinerU server can now start when you need it and stop when you don't. The chat window A floating composer The composer and the shortcut chips now float over the bottom of the chat. …在 GitHub 查看 ↗