steven-jianhao-li/zotero-AI-Butler

【Zotero AI 管家】调用大模型，自动精读论文库里的论文，总结为Zotero笔记。支持主流大模型平台！您只需像往常一样把文献丢进 Zotero，管家会自动帮您精读论文，将文章揉碎了总结为笔记，让您“十分钟完全了解”这篇论文！

📚 什么是 Zotero‑AI‑Butler？

一个免费、开源的 Zotero 插件，可让您在参考文献管理器中调用大型语言模型（LLM）。它会自动读取您添加到 Zotero 的 PDF，将其发送到您配置的模型（Gemini、OpenAI、Claude 等），并写回结构化的 Markdown 笔记、思维导图、单页“海报”图像，甚至文献综述草稿。简而言之，它将 Zotero 变成了一个 AI 研究助手。

🎯 核心功能（根据 README 描述）

功能	作用	触发方式
AI Butler Agent (v5.0)	通过搜索您的文献库、提取证据并回复模型生成的答案来回答研究问题。	打开 Butler 仪表板中的 Agent 选项卡并输入查询。
自动笔记生成	当添加新 PDF 时，插件提取完整文档（用于多模态模型的 Base64）并要求 LLM 生成清晰的 Markdown 摘要，保存为 Zotero 笔记。	在设置中启用自动扫描新条目或手动运行扫描。
深度阅读 / 多轮摘要	将论文分成多个部分（背景、方法、实验、结论）并运行多次模型调用，然后将结果合并为详细笔记。	右键单击 → AI Butler 多轮重读 → 选择多轮拼接或多轮摘要。
单图摘要	生成单个学术海报风格的图像（通过“Nano Banana Pro”服务），可视化论文的关键点。	右键单击 → 单图摘要（需要 API 密钥）。
思维导图导出	生成论文结构的交互式层次图；可导出为 PNG 或 OPML 以供其他工具使用。	右键单击 → 生成思维导图。
批量文献综述	选择一个集合/文件夹，插件将编写一个链接所有源 PDF 的合并综述文档。	右键单击集合 → AI Butler 文献综述。
侧边栏预览	在 PDF 旁边显示 AI 生成的笔记，支持 KaTeX 渲染 LaTeX、可折叠部分、字体缩放以及用于后续问题的快速提问框。	打开侧边栏或单击 AI‑Butler 图标。
提示模板管理器	内置和用户定义的提示集，用于单次、多轮或最终摘要调用；变量替换的实时预览。	设置 → 提示模板。
多模型支持	支持 Google Gemini、OpenAI（包括 gpt‑5）、Anthropic Claude、SiliconFlow 兼容 API、Volcano‑Argo、Ollama 等。	设置 → API 配置。
主题和界面适配	匹配 Zotero 的浅色/深色模式；可选择的笔记渲染主题（GitHub、Redstriking）和自定义 CSS。	设置 → 界面主题。

🛠️ 底层工作原理（高级，来自 README）

PDF 处理 – 插件可以提取纯文本或将整个文件作为 Base64 编码的 blob 发送，允许多模态模型（例如 Gemini 2.5 Pro）查看图形、表格和方程。
任务队列 – 论文被放入生产者‑消费者队列；您可以在 任务队列 页面查看状态（待处理、运行中、已完成、失败）。
提示驱动的 LLM 调用 – 每个功能对应一个提示模板。插件替换 {{title}}、{{authors}} 等变量，然后调用配置的 API。
结果存储 – LLM 的响应保存为附加到同一条目的 Zotero 笔记，并可选择在侧边栏中显示或导出为图像/OPML。
配置 – API 密钥存储在本地；插件绝不会将您的参考文献或密钥转发给任何第三方服务器。

🚀 快速开始

安装 – 从 Releases 页面下载最新的 .xpi 文件，将其拖入 Zotero 的 工具 → 附加组件 窗口。
配置 LLM – 打开 AI Butler → 设置 → API 并粘贴 Gemini、OpenAI、Claude 等密钥。单击 测试连接。
启用自动扫描（可选）– 设置 → 界面 → 勾选 自动扫描新文献。
运行任务 – 右键单击 PDF → 使用 AI Butler 摘要（或使用仪表板的批量扫描器）。

🎓 谁受益？

研究人员和学生，需要快速、一致的论文摘要，而无需手动将文本复制到聊天窗口。
文献综述撰写者，希望获得已链接到源 PDF 的初始草稿。
任何使用 Zotero 的人，希望获得 AI 增强的笔记、思维导图或可视化摘要。

⚠️ 限制和注意事项（根据 README）

您必须提供自己的 API 密钥 – 插件不托管任何模型。
令牌成本 – 多轮或图像生成模式可能消耗大量令牌；README 警告高 API 费用。
性能 – 自动扫描默认禁用，以避免减慢 Zotero；您必须启用它。
模型兼容性 – Base64 模式仅适用于多模态模型；纯文本模型需要纯文本提取路径。
隐私 – 所有请求直接从您的机器发送到模型端点；插件声称不收集数据。

📚 进一步阅读

完整用户指南：https://steven-jianhao-li.github.io/zotero-AI-Butler/
Agent 使用详情：docs/agent.md
使用提供的 BibTeX 条目引用软件（DOI 10.5281/zenodo.20457937）。

Zotero‑AI‑Butler 是一个真正的、功能丰富的 AI 增强研究工具，存在于 Zotero 生态系统中，将您的参考文献变成一个交互式、模型驱动的学习伙伴。