llm-for-zotero

在 Zotero 里直接对话你的文献库，自动提炼观点、生成综述

llm-for-zotero 是一个深度集成 Zotero 文献库的开源研究智能体系统。它解决了科研人员在文献阅读、信息提取和知识管理中的痛点，将大语言模型的能力直接嵌入 Zotero 工作流。核心能力包括：基于自然语言对文献库进行智能检索与问答，自动提取文献元数据、关键观点和实验数据，生成文献综述和摘要，以及辅助论文写作。系统采用 TypeScript 开发，支持本地或云端 LLM 接入，注重隐私保护。通过插件形式与 Zotero 桌面端和 Web 端协同工作，让研究者无需切换工具即可完成从文献管理到知识产出的全流程。

开源 free 搜索知识

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 3132

维护状态活跃

是否开源是

定价模式 free

项目数据

分类搜索知识

开发团队yilewang

所属国家

官网地址https://yilewang.github.io/llm-for-zotero

GitHubhttps://github.com/yilewang/llm-for-zotero

定价模式free

价格说明开源项目，基于AGPL-3.0许可证，可自行部署使用，无付费版本。

访问状态

是否开源是

开源协议AGPL-3.0

主要语言TypeScript

技术栈/模型academic-paper,codex,literature-analysis,llm-agent,mcp,rag,research-tool,zotero,zotero-plugin

GitHub 星标★ 3132

30天Star增速

HF 下载量

上线时间2026-01-29 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数2

使用教程

难度：入门约 10 分钟部署方式：本地安装 7 步

环境要求

已安装 Zotero 桌面端（支持 Tools -> Add-ons 安装 .xpi 插件）
可用的 LLM 接入方式：标准 API 提供商、本地 OpenAI 兼容模型，或 WebChat / Codex App Server / Claude Cod
WebChat 模式需要 Chrome 等 Chromium 内核浏览器
Codex 模式需要 Node.js 与 npm（用于安装 Codex CLI）

安装与启动步骤

1下载插件包

打开项目的 Releases 页面，下载最新版本的 .xpi 插件文件到本地，先不要解压。
2安装插件到 Zotero

在 Zotero 中依次打开 Tools -> Add-ons -> 齿轮图标 -> Install Add-on From File，选择刚下载的 .xpi。
3重启 Zotero

安装完成后重启 Zotero，让插件加载生效，之后才能看到 llm-for-zotero 设置项。
4配置模型连接

打开 Preferences -> llm-for-zotero，选择 Provider，填入 API Base URL、密钥和模型名，点击 Test Connection 验证。
5在 PDF 中调用助手

在 Zotero 中打开一篇 PDF，点击右侧工具栏的 LLM Assistant 图标，即可开始提问与总结。
6可选：配置 Codex

无需 API key 的替代方案。全局安装 Codex CLI 并登录，凭证保存在 ~/.codex/auth.json，随后在 Agent 标签开启集成。
```
npm install -g @openai/codex
codex login
```
7可选：配置 WebChat

下载 sync-for-zotero 的 extension.zip 并解压，在 chrome://extensions 开启开发者模式后 Load unpacked，再把 Auth Mode 设为 WebChat。

关键配置

配置项	必填	说明	示例
`Provider`	是	选择模型服务提供方协议	`openai_chat_compat`
`API Base URL`	是	模型服务的接口地址	`https://api.openai.com/v1`
`secret key`	是	访问模型服务的密钥（WebChat/Codex 模式可免）	`sk-xxxxxxxx`
`model name`	是	使用的模型名称，可按任务配多个模型	`gpt-4o`
`temperature`	否	生成随机性超参数	`0.7`
`max_tokens_output`	否	单次输出最大 token 数	`4096`

如何确认成功

在 Preferences 中点击 Test Connection 显示连接成功；打开 PDF 点击 LLM Assistant 能正常问答。WebChat 模式下浏览器显示绿点表示已连接。

常见问题

Q：不想用 API key 可以吗？

A：可以。README 提供 WebChat（ChatGPT/DeepSeek/Gemini 网页同步）和 Codex App Server（ChatGPT Plus 订阅）两种免 API key 方案，直接在设置中切换 Auth Mode 或 Agent 标签开启即可。

Q：Codex 和 Claude Code 能同时启用吗？

A：不能。两者在 Agent 标签中是互斥的运行模式，启用其中一个前必须先关闭另一个。

Q：WebChat 模式连接总掉线怎么办？

A：需保持所选提供方的浏览器标签页处于打开状态，不要最小化或切到后台，并让标签页与 Zotero 处于同一显示器，否则连接可能中断。

Q：Claude Code 模式能操作 Zotero 文献库吗？

A：不能。Claude Code 模式不支持原生 Zotero API 操作，读取条目状态、编辑笔记、打标签、改元数据等请使用内置的 Agent Mode。

注意事项

Codex App Server 与 Claude Code 是互斥的运行模式，需先禁用一个再启用另一个。
Claude Code 模式为实验性功能，需要 PATH 中存在已认证的 claude 命令，并依赖 Node.js/npm 桥接。
Windows 上安装 Codex 请使用 PowerShell 或 CMD，而不是 WSL，否则 Zotero MCP 无法使用本地回环连接。
WebChat 下 Gemini 需要配套扩展版本显式声明 gemini 目标，旧版本扩展会被 Zotero 拒绝。

核心亮点

深度集成 Zotero，无需迁移文献，直接在原库上实现智能问答和摘要
支持多种 LLM 后端（OpenAI、本地模型等），兼顾效果与隐私
自动提取文献关键信息，生成结构化笔记，显著提升文献调研效率

不足之处

依赖 Zotero 插件生态，安装配置有一定门槛
对大型文献库的检索性能可能受限于本地资源
文档/社区待观察

适用场景

科研人员快速梳理某领域文献，自动生成综述初稿
研究生在写论文时，从个人文献库中检索特定观点和证据
团队共享文献库，用自然语言查询跨文献的关联信息

替代项目

Zotero GPT、SciSpace、Elicit

项目介绍

llm-for-zotero 是智能体领域的开源项目，由 yilewang 开发，是 2026 年新上线的项目。

在全站 13,014 个收录项目中，它的 GitHub 星标数（3,132）位列前 30%，在智能体分类的 2,499 个项目里位列前 13%。

近 42 天，它的 GitHub 星标从 2,619 增加到 3,132，净增 513。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。基于AGPL-3.0许可证，可自行部署使用，无付费版本。

它主要面向的使用场景是：科研人员快速梳理某领域文献，自动生成综述初稿。同类可对比的替代方案包括 Zotero GPT、SciSpace、Elicit。

上一篇：Memary

下一篇：agentfield