Zotero 文献研究助手
在 Zotero 中对论文提问、溯源引用、整理文献与生成研究笔记。
按维度查看评分与理由
证据显示：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 可读写本地文件并执行命令，虽需确认，但用户应理解风险。
- 发布者身份未验证，建议用户自行评估信任度。
这个 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 有哪些优点和局限？
- 直接嵌入 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？
从 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 内部笔记中的流程相比，File-Based Notes 可将带 YAML frontmatter 和 Pandoc 引文语法的 Markdown 写入 Obsidian、Logseq 或任意本地目录。与云端 MinerU 相比，本地 mineru-api 模式可在默认 127.0.0.1 地址下让 PDF 留在本机，但需要自行部署并准备模型。