文献下载一时爽，打开阅读火葬场。 天书难啃骨头硬，管家嚼碎再喂粮。
想着稍后阅读的论文，最后却变成了永不阅读？ 长篇大论的学术论文，有翻译却也抓不住重点？
文献阅读被以下问题困扰？
- 痛点一：文章太多，读不过来。即便让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管家本身无任何收费渠道。
推荐使用 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 原生笔记一致。
- 笔记查阅： 点击笔记条目进行查看。
- 对照阅读： 在阅读论文原文时，可以同时打开笔记，与原文一同阅读。
- 笔记查阅： 点击笔记条目进行查看。
AI管家提供三种方式来获取和分析您的论文。
- 方式一：右键唤醒 (即时处理)
这是最直接的交互方式。当您需要立即分析某篇特定论文时：
- 在论文条目上右键，选择 “召唤AI管家进行分析”。
- 任务将立即进入队列。您可以点击**“详情”**，实时查看大模型的分析响应过程。
-
多轮对话重新精读：如果想用更详细的模式重新分析一篇已经总结过的论文（或者想换一种模式），可以在右键菜单中选择 “AI管家多轮对话重新精读”，然后选择 “多轮拼接” 或 “多轮总结”。这会强制覆盖已有的AI笔记。
-
方式二：自动巡航 (新文献自动处理) 实现“一劳永逸”的自动化工作流。
- 默认关闭： 为最小化对 Zotero 性能的影响，此功能默认关闭。
- 一键开启： 您可以在 “仪表盘” -> “界面设置” 中开启 “自动扫描新文献” 功能。
- 自动运行： 开启后，当您将新论文（如PDF）拖入 Zotero，管家会等待 Zotero 完成元数据检索，然后自动开始分析。
- 持久化设置： 该设置会自动保存，Zotero 重启后依然生效。
- 方式三：批量处理 (旧文献回溯补充)
适用于补充总结您文献库中积压已久的旧论文。
- 未总结论文扫描： 在 “仪表盘” 中，点击 “扫描未分析论文”。AI管家会自动找出所有没有AI管家笔记的论文，并按您的 Zotero 目录结构清晰排列。
- 批量选择添加：您可以自由勾选需要补充笔记的论文（可按目录全选），点击 “添加到队列”。
- 后台处理：AI管家会在后台按照您设置的速度，慢慢处理这些积压的论文。
AI管家拥有主页面，是管理所有任务和配置的核心界面。可以通过以下两种方式打开： a. Zotero 顶部菜单：“编辑” -> “设置” -> “AI管家” 选项卡。 b. 任意条目上右键 -> “AI管家仪表盘”。
仪表盘主要包含四大页面：- 仪表盘：提供统计信息和快捷操作。
- 仪表盘：提供统计信息和快捷操作。
- 任务队列：管理和监控所有论文分析任务。所有论文分析都基于“生产者-消费者”模式进行。可以在此页面查看所有待处理、进行中、已完成或失败的论文任务状态。
- 快捷设置：这是插件的配置中心，支持配置：
-
API配置： 目前支持 OpenAI、Gemini、Anthropic 以及 OpenAI兼容（支持第三方如硅基流动等）四大平台。配置密钥后可点击 “测试连接” 验证可用性。
-
任务处理速度： 控制每分钟处理论文的数量，避免API调用超限。
-
PDF处理方式： 可选择多模态处理（Base64编码）或文字提取模式。Base64编码适用于多模态大模型（如Gemini 2.5 Pro），此方式能让模型直接“看到”PDF原文，对图片、公式、表格的理解能力更强；文字提取模式适用于不支持多模态的模型。
-
提示词模板： 内置多种提示词模板，并支持用户自定义。
-
AI管家支持多轮对话功能，允许用户在生成的AI总结基础上进行后续追问。
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免费额度，支持豆包大模型系列 |
AI管家提供强大的提示词管理功能：
- 内置预设：提供多种常用提示词模板，一键切换。
- 自定义预设：支持保存和管理用户自定义的提示词模板。
- 实时预览：编辑提示词时可实时预览变量替换效果（如
{{title}}、{{authors}}等）。 - 一键恢复：可随时恢复为系统默认提示词。
AI管家新功能——支持多轮提示词配置，用户可以自定义每轮对话的提示词，包括：研究背景与问题、研究方法与技术、实验设计与结果、结论与展望等，最终汇总多轮对话至一篇完整总结。
| 模式 | 说明 | Token消耗 | 适用场景 |
|---|---|---|---|
| 单次对话 | 一次性生成完整总结 | 最少 | 快速阅读、时间紧迫 |
| 多轮拼接 | 分轮深入提问，拼接所有回答 | 较多 | 深度研读、需要详细分析 |
| 多轮总结 | 多轮对话后AI汇总精炼 | 中等 | 平衡深度与简洁 |
- 多轮提示词配置：用户可以自定义每轮对话的提示词，包括：研究背景与问题、研究方法与技术、实验设计与结果、结论与展望等。
- 最终总结提示词：在多轮总结模式下，可配置AI最终汇总时使用的提示词。
AI管家完美适配 Zotero 的明暗主题切换，无论您使用亮色还是暗色模式，界面都能自动适配，保护您的眼睛。
在 Zotero 右侧的条目信息面板中，AI 管家会自动展示该文献的 AI 笔记内容，方便您快速浏览。
- 自动检测：自动查找并显示 AI 管家生成的笔记
- 样式渲染：使用精美的 CSS 样式渲染笔记内容，支持多种主题切换
- 折叠/展开：点击标题栏可折叠或展开笔记区域
- 高度可调：拖拽底部手柄调整笔记区域高度，设置自动保存
- 字体缩放：点击标题栏的 +/− 按钮调整字体大小
- 快速生成：如果没有 AI 笔记，可一键召唤 AI 管家生成
- 侧边栏追问：
- 完整追问 (保存记录)：打开对话窗口进行深度追问，对话记录自动保存到笔记
- 快速提问 (不保存记录)：临时提问，不保存对话历史
- LaTeX 公式渲染：侧边栏支持 KaTeX 渲染 LaTeX 数学公式，让论文中的数学内容清晰可见。
- 自动渲染：自动识别并渲染
$...$（行内公式）和$$...$$（块级公式） - 横向滚动：长公式自动显示横向滚动条，避免内容溢出
- 暗色模式适配：公式渲染完美适配 Zotero 的明暗主题
- 自动渲染：自动识别并渲染
- 固定侧边栏：可以使用Zotero自带的固定侧边栏功能，将AI管家侧边栏窗口固定，方便翻阅论文。
-
使用方法：右键侧边栏最右侧的 AI 管家 图标，点击“固定此栏”即可固定侧边栏窗口。再次右键，点击“取消固定此栏”即可取消固定。
-
AI 管家支持自定义侧边栏笔记的渲染样式。
- 内置主题：
- GitHub (默认) - 简洁清爽的 GitHub 风格
- 红印 (Redstriking) - 红色主题，适合强调重点内容
- 主题切换：在 "界面设置" 中可选择笔记样式
💡 红印主题来源：Theigrams/My-Typora-Themes
欢迎为 AI 管家贡献更多漂亮的主题！
- 在
addon/content/markdown_themes/目录下创建新的 CSS 文件（如your-theme-name.css） - CSS 中可使用
#write或.markdown-body作为选择器前缀（会自动适配） - 在
src/modules/themeManager.ts的BUILTIN_THEMES数组中添加新主题：{ id: "your-theme", name: "您的主题名称", file: "your-theme-name.css" }
- 在
src/modules/views/settings/UiSettingsPage.ts的主题下拉列表中添加选项 - 在
src/hooks.ts的const themes = [中添加新主题 - 提交 Pull Request！
提示：Typora 主题可以直接使用！插件会自动适配
#write选择器。
- 右键论文父条目，选择 "召唤AI管家一图总结" 即可体验（需要提前在快捷设置中配置“一图总结”密钥哦）
- 🎨 欢迎优化提示词：相信您的结果一定比示例更好看！欢迎在 Discussion 中分享您的提示词和效果，优秀的提示词有机会被选为默认模板！
- 自动一图总结：在"一图总结"设置页面中，可开启"自动添加一图总结"功能。开启后，每当论文AI总结完成时，系统会自动生成一图总结。
⚠️ 注意：此功能默认关闭，开启时需二次确认，因为会消耗大量API费用。
AI管家支持对分类下的多篇论文进行综合分析，自动生成文献综述报告。
使用方法：
- 右键点击任意分类，选择 "AI管家文献综述"
- 在配置页面中设置综述名称、自定义提示词
- 勾选需要纳入综述的论文（支持多 PDF 选择）
- 点击"生成综述"
生成内容：
- 创建新的"报告"类型条目
- 将所有选中 PDF 作为链接附件添加到报告
- 附件命名格式：
[论文标题前30字] 原附件名 - 自动生成综合文献综述笔记
📖 详细使用说明请参阅 文献综述文档
AI管家支持自动生成论文思维导图，将长篇论文的层次结构可视化呈现，帮助您快速掌握论文脉络。
功能特性：
- 自动生成：基于AI分析自动生成结构化思维导图，包含研究背景、研究方法、关键结果、结论等核心章节
- 交互操作：支持放大、缩小、适应画布等操作，自由探索论文结构
- 可调高度：拖拽底部手柄调整思维导图区域高度，设置自动保存
- 导出功能：
- PNG导出：高清2倍分辨率图片，适合分享和存档
- OPML导出：标准大纲格式，可导入到其他思维导图工具（如XMind、幕布等）
使用方法：
- 右键论文条目，选择 "召唤AI管家生成思维导图"
- 等待AI分析完成，思维导图自动显示在侧边栏
- 使用工具栏按钮进行缩放、导出等操作
自定义设置：
在 "快捷设置" -> "思维导图" 中可配置：
- 提示词模板：自定义思维导图结构，不限于默认的四大类
- 导出路径：设置默认导出目录（默认为桌面）
- 访问本项目的 GitHub Releases 页面。
- 下载最新的Release版本的
.xpi文件。 - 打开 Zotero 桌面端，点击顶部菜单的 “工具” -> “插件”。
- 将下载好的 .xpi 文件拖拽到插件窗口中，完成安装。
- 在任意论文上右键 -> “AI管家仪表盘” -> 打开 “设置” 选项卡。
- 配置API： 填入您的 API 密钥（推荐Gemini），点击 “测试连接” 确保网络通畅。
- 开启自动扫描： 转到 “界面设置” 选项卡，勾选 “自动扫描新文献”。
现在，当您拖入新的PDF论文时，AI管家将在1分钟左右（取决于模型速度）自动为您生成精读笔记。
感谢以下贡献者对本项目的支持与帮助：
感谢下面的开源项目：
尤其感谢 zotero-ainote 项目的作者 BlueBlueKitty，其项目为本插件提供了宝贵的代码参考。由于本项目在实现上与 zotero-ainote 存在较大差异，因此未直接fork该项目，而是基于 Zotero Plugin Template 重新开发。大家有兴趣可以给 zotero-ainote 点个star以示支持！
如果你觉得这个项目对你有帮助，请不要吝啬你的 ⭐️！