llm-for-zotero

环境要求

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

安装与启动步骤

1. 1下载插件包

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

2. 2安装插件到 Zotero

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

3. 3重启 Zotero

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

4. 4配置模型连接

   打开 Preferences -> llm-for-zotero，选择 Provider，填入 API Base URL、密钥和模型名，点击 Test Connection 验证。

5. 5在 PDF 中调用助手

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

6. 6可选：配置 Codex

   无需 API key 的替代方案。全局安装 Codex CLI 并登录，凭证保存在 ~/.codex/auth.json，随后在 Agent 标签开启集成。

   npm install -g @openai/codex
   codex login

   复制

7. 7可选：配置 WebChat

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

关键配置

如何确认成功

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

常见问题

注意事项

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