steven-jianhao-li/zotero-AI-Butler

AI 总结

• 自动扫描新加入PDF并生成结构化Markdown笔记，直接保存到对应Zotero条目便于回顾
• 支持多模态Base64上传，能较好处理公式、图表、复杂排版及纯图片PDF，中英文均可
• 提供“一图总结”（用Nano Banana Pro生成学术海报式图片）与思维导图（可导出PNG/OPML）
• 支持对分类下多篇论文生成综合文献综述报告，并创建独立报告条目关联原始PDF
• 内置侧边栏沉浸阅读与追问功能，支持KaTeX渲染LaTeX公式、固定侧边栏不中断心流
• 兼容多平台模型API（Gemini/OpenAI/Anthropic/OpenAI兼容/火山方舟等），提示词模板可自定义

内容摘录

Zotero插件：**zotero-AI-Butler【AI 管家】**

<!-- Badges -->
<p>
 <a href="https://github.com/steven-jianhao-li/zotero-AI-Butler/releases/latest"><img src="https://img.shields.io/github/v/release/steven-jianhao-li/zotero-AI-Butler" alt="Latest Release"></a>
 <a href="https://github.com/steven-jianhao-li/zotero-AI-Butler/releases"><img src="https://img.shields.io/github/downloads/steven-jianhao-li/zotero-AI-Butler/total.svg" alt="Downloads"></a>
 <a href="https://img.shields.io/badge/Using-Zotero%20Plugin%20Template-blue?style=flat-square&logo=github"><img src="https://img.shields.io/badge/Using-Zotero%20Plugin%20Template-blue?style=flat-square&logo=github" alt="Using Zotero Plugin Template"></a>
 <a href="https://github.com/steven-jianhao-li/zotero-AI-Butler/stargazers"><img src="https://img.shields.io/github/stars/steven-jianhao-li/zotero-AI-Butler?style=social" alt="Stars"></a>
 <a href="https://github.com/steven-jianhao-li/zotero-AI-Butler/network/members"><img src="https://img.shields.io/github/forks/steven-jianhao-li/zotero-AI-Butler?style=social" alt="Forks"></a>
</p>
</div>
点我查看 **AI Butler Wiki**——配置与使用文档
**文献下载一时爽，打开阅读火葬场。**
**天书难啃骨头硬，管家嚼碎再喂粮。**

想着稍后阅读的论文，最后却变成了永不阅读？
长篇大论的学术论文，有翻译却也抓不住重点？

文献阅读被以下问题困扰？
痛点一：文章太多，读不过来。即便让AI辅助阅读，却还要一篇一篇的发给AI，效率低下。
痛点二：读完就忘，需要反复重新阅读。 辛辛苦苦读完一篇，两天后就忘了，想回忆又得从头看起，浪费时间。
痛点三：文章太长，即使有翻译插件，也难以抓住重点，读下一页忘上一页。

别慌！您的专属AI管家 Zotero-AI-Butler 已闪亮登场！

TA 是您7x24小时待命、不知疲倦且绝对忠诚的私人管家。
您只管像往常一样把文献丢进 Zotero，剩下的体力活全交给TA！
管家会自动帮您精读论文，将文章揉碎了总结为笔记，让您“十分钟完全了解”这篇论文！
3.0版本震撼首发“一图总结”功能，用Nano Banana Pro生成学术海报，一图胜千言！
🎖️ 核心功能
**自动化处理**：管家自动扫描新添加的PDF文献，利用大模型生成条理清晰的Markdown笔记，和论文条目一同保存，随时都能回顾。
**多模态支持**：支持Base64上传PDF，数学公式、图表和复杂排版无损提取，中英文论文全部支持，甚至纯图PDF也能阅读总结。
**一图总结**：全网首发——用一张图总结一篇论文，利用 Nano Banana Pro 为每篇论文生成学术海报式图片，帮助快速在脑海中建立论文知识体系。“一图胜千言”，快速把握论文核心，建立文章内容记忆点。
**思维导图**：自动生成论文思维导图，将长篇论文层次结构可视化呈现。支持放大缩小、导出PNG图片和OPML大纲格式，轻松复用到其他工具中。
**多文献综述**：右键分类即可对多篇论文进行综合分析，自动生成文献综述报告，创建独立的报告条目并关联所有原始PDF。
**沉浸阅读**：内置AI管家侧边栏，支持LaTeX公式渲染和大模型追问功能，一边读论文原文，一边看论文讲解，同时随时向大模型提问。还可以固定侧边栏为AI管家，切换文献再也不会打断心流！
**开源平台**：AI管家旨在提供一个自由、定制化的智能论文管理平台。所有模型提示词均可自定义——如何读文献，由您说了算；支持多个大模型的API——选择哪个大模型，也由您说了算。AI管家本身无任何收费渠道。

!AI管家直观效果

推荐使用 Google Gemini 3 pro 模型总结论文，用 Gemini 讲解论文很容易理解。
没有免费的 Google Gemini 3 pro API？参考我的自用gcli2api配置教程部署gcli2api获得个人几乎用不完的免费Gemini 3 pro访问额度！
**您只负责思考，Zotero-AI-Butler 将为您的阅读扫清障碍！**
✨ 功能介绍
智能笔记生成与查阅

AI管家的核心使命是利用大模型（如 Gemini 或 OpenAI）深度阅读论文，并将总结内容自动整理为条理清晰的 Markdown 笔记，保存至 Zotero 条目下。
笔记自动保存： 生成的笔记会自动保存到 Zotero 对应的条目下，笔记交互逻辑与 Zotero 原生笔记一致。
笔记查阅： 点击笔记条目进行查看。
 !Zotero中由AI管家生成的笔记
对照阅读： 在阅读论文原文时，可以同时打开笔记，与原文一同阅读。
 !生成的笔记在阅读论文时可并排查看
灵活的三种任务触发方式

AI管家提供三种方式来获取和分析您的论文。
方式一：右键唤醒 (即时处理)
 这是最直接的交互方式。当您需要立即分析某篇特定论文时：
在论文条目上右键，选择 “召唤AI管家进行分析”。
任务将立即进入队列。您可以点击**“详情”**，实时查看大模型的分析响应过程。

!右键菜单中唤醒AI管家进行分析
**多轮对话重新精读**：如果想用更详细的模式重新分析一篇已经总结过的论文（或者想换一种模式），可以在右键菜单中选择 **“AI管家多轮对话重新精读”**，然后选择 **“多轮拼接”** 或 **“多轮总结”**。这会强制覆盖已有的AI笔记。
方式二：自动巡航 (新文献自动处理)
 实现“一劳永逸”的自动化工作流。
默认关闭： 为最小化对 Zotero 性能的影响，此功能默认关闭。
一键开启： 您可以在 “仪表盘” -> “界面设置” 中开启 “自动扫描新文献” 功能。
自动运行： 开启后，当您将新论文（如PDF）拖入 Zotero，管家会等待 Zotero 完成元数据检索，然后自动开始分析。
持久化设置： 该设置会自动保存，Zotero 重启后依然生效。

!在仪表盘中开启自动扫描新文献功能后，AI管家会自动处理新添加的论文
方式三：批量处理 (旧文献回溯补充)
 适用于补充总结您文献库中积压已久的旧论文。
未总结论文扫描： 在 “仪表盘” 中，点击 “扫描未分析论文”。AI管家会自动找出所有没有AI管家笔记的论文，并按您的 Zotero 目录结构清晰排列。
批量选择添加：您可以自由勾选需要补充笔记的论文（可按目录全选），点击 “添加到队列”。
后台处理：AI管家会在后台按照您设置的速度，慢慢处理这些积压的论文。

!批量扫描未分析论文并添加到任务队列
AI管家主界面

AI管家拥有主页面，是管理所有任务和配置的核心界面。可以通过以下两种方式打开：
a. Zotero 顶部菜单：“编辑” -> “设置” -> “AI管家” 选项卡。
b. 任意条目上右键 -> “AI管家仪表盘”。

仪表盘主要包含四大页面：- 仪表盘：提供统计信息和快捷操作。
仪表盘：提供统计信息和快捷操作。

!仪表盘页面
任务队列：管理和监控所有论文分析任务。所有论文分析都基于“生产者-消费者”模式进行。可以在此页面查看所有待处理、进行中、已完成或失败的论文任务状态。

!任务队列页面
快捷设置：这是插件的配置中心，支持配置：
API配置： 目前支持 OpenAI、Gemini、Anthropic 以及 OpenAI兼容（支持第三方如硅基流动等）四大平台。配置密钥后可点击 “测试连接” 验证可用性。
 !API配置与连接测试
任务处理速度： 控制每分钟处理论文的数量，避免API调用超限。
PDF处理方式： 可选择多模态处理（Base64编码）或文字提取模式。Base64编码适用于多模态大模型（如Gemini 2.5 Pro），此方式能让模型直接“看到”PDF原文，对图片、公式、表格的理解能力更强；文字提取模式适用于不支持多模态的模型。
 !设置任务处理速度与PDF处理方式
提示词模板： 内置多种提示词模板，并支持用户自定义。
 !提示词模板设置
对话与追问(Pre-release功能)

AI管家支持多轮对话功能，允许用户在生成的AI总结基础上进行后续追问。
!打开后续对话功能
!后续对话功能示例
多平台API支持

AI管家支持多种主流大模型平台，满足不同用户的需求：

| 平台 | 推荐模型 | 特点 |
| -------------------- | ------------------------ | ----------------------------------------------------------------------------------- |
| **Google Gemini** | gemini-3-pro-preview | 🌟 推荐！多模态能力强，PDF理解准确 |
| **OpenAI** | gpt-5 | 官方新接口 |
| **Anthropic Claude** | claude-opus-4-5-20251101 | 综合能力优秀 |
| **OpenAI 兼容** | 自定义 | OpenAI旧接口，使用标准的 Chat Completions 接口格式，支持 SiliconFlow 等第三方服务商 |
| **火山方舟** | doubao-seed-1-8-251228 | 🆕 每日200万tokens免费额度，支持豆包大模型系列 |

!多平台API配置
提示词预设管理

AI管家提供强大的提示词管理功能：
**内置预设**：提供多种常用提示词模板，一键切换。
**自定义预设**：支持保存和管理用户自定义的提示词模板。
**实时预览**：编辑提示词时可实时预览变量替换效果（如 {{title}}、{{authors}} 等）。
**一键恢复**：可随时恢复为系统默认提示词。

!提示词模板设置
多轮对话与总结模式

AI管家新功能——支持多轮提示词配置，用户可以自定义每轮对话的提示词，包括：研究背景与问题、研究方法与技术、实验设计与结果、结论与展望等，最终汇总多轮对话至一篇完整总结。

| 模式 | 说明 | Token消耗 | 适用场景 |
| ------------ | -------------------------- | --------- | ---------------------- |
| **单次对话** | 一次性生成完整总结 | 最少 | 快速阅读、时间紧迫 |
| **多轮拼接** | 分轮深入提问，拼接所有回答 | 较多 | 深度研读、需要详细分析 |
| **多轮总结** | 多轮对话后AI汇总精炼 | 中等 | 平衡深度与简洁 |
**多轮提示词配置**：用户可以自定义每轮对话的提示词，包括：研究背景与问题、研究方法与技术、实验设计与结果、结论与展望等。
**最终总结提示词**：在多轮总结模式下，可配置AI最终汇总时使用的提示词。

!多轮对话模式设置
主题适配

AI管家完美适配 Zotero 的明暗主题切换，无论您使用亮色还是暗色模式，界面都能自动适配，保护您的眼睛。

!明暗主题适配
侧边栏 AI 笔记预览

在 Zotero 右侧的条目信息面板中，AI 管家会自动展示该文献的 AI 笔记内容，方便您快速浏览。
**自动检测**：自动查找并显示 AI 管家生成的笔记
**样式渲染**：使用精美的 CSS 样式渲染笔记内容，支持多种主题切换
**折叠/展开**：点击标题栏可折叠或展开笔记区域
**高度可调**：拖拽底部手柄调整笔记区域高度，设置自动保存
**字体缩放**：点击标题栏的 +/− 按钮调整字体大小
**快速生成**：如果没有 AI 笔记，可一键召唤 AI 管家生成

!侧边栏AI笔记预览
**侧边栏追问**：
**完整追问 (保存记录)**：打开对话窗口进行深度追问，对话记录自动保存到笔记
**快速提问 (不保存记录)**：临时提问，不保存对话历史

!侧边栏追问
**LaTeX 公式渲染**：侧边栏支持 KaTeX 渲染 LaTeX 数学公式，让论文中的数学内容清晰可见。
**自动渲染**：自动识别并渲染 $...$（行内公式）和 $$...$$（块级公式）
**横向滚动**：长公式自动显示横向滚动条，避免内容溢出
**暗色模式适配**：公式渲染完美适配 Zotero 的明暗主题

!侧边栏LaTeX公式渲染
**固定侧边栏**：可以使用Zotero自带的固定侧边栏功能，将AI管家侧边栏窗口固定，方便翻阅论文。
**使用方法**：右键侧边栏最右侧的 AI 管家 图标，点击“固定此栏”即可固定侧边栏窗口。再次右键，点击“取消固定此栏”即可取消固定。

 !固定侧边栏
笔记样式主题

AI 管家支持自定义侧边栏笔记的渲染样式。
**内置主题**：
**GitHub** (默认) - 简洁清爽的 GitHub 风格
**红印 (Redstriking)** - 红色主题，适合强调重点内容
**主题切换**：在 "界面设置" 中可选择笔记…