企业官网建设流程全解析

• 人工智能
• 大模型
• AI 应用
• 科研

Zotero AI Butler（AI 管家）是一款开源的 Zotero AI 插件，调用大模型自动精读论文库里的文献，把长文"揉碎"成条理清晰的 Markdown 笔记，让您十分钟完全了解一篇论文。它支持 Google Gemini、OpenAI、Claude、火山方舟、Ollama 等主流大模型平台。

刚装好插件时，很多新手会问：到底怎么"唤醒"AI 管家去分析论文？其实它提供了 3 种互补的触发方式——

三者可任意组合，任务都统一进入任务队列按您设置的速度后台处理。下面逐一讲清操作步骤。

方式一：右键唤醒，即时分析单篇论文

这是最直接的交互方式，适合"我现在就要看这篇"的场景。

1. 在 Zotero 文献列表中，选中一篇论文条目；
2. 右键，选择"AI 管家生成 AI 总结"（想要更深度的逐章分析，则选"AI 管家生成 AI 精读"）；
3. 任务立即进入队列，点击"详情"可实时查看大模型的分析响应过程；
4. 完成后，笔记会自动挂在该论文条目下，随时点开回顾。

💡 如果一篇论文已有总结，想用更详细的模式重新分析，可右键选择"AI 管家多轮对话重新精读"，在"多轮拼接"或"多轮总结"之间挑选，它会强制覆盖已有 AI 笔记。右键菜单的注册逻辑见 hooks.ts。

方式二：自动巡航，新文献全自动处理

想让工作流"一劳永逸"？开启自动巡航后，您只管把 PDF 拖进 Zotero，剩下的交给管家。

开启步骤（一键完成）：

1. 在任意条目上右键 →"AI 管家仪表盘"（或顶部菜单"编辑 → 设置 → AI 管家"）；
2. 在仪表盘首页点击"🚀 开始自动扫描"，即刻生效。

它是怎么工作的？

• 插件在后台监听文献库的item-add事件，发现新条目后先等待 Zotero 完成元数据检索、确认 PDF 附件就绪，再自动加入队列（等待期间会指数退避重试，最多 5 次）；
• 自动总结默认开启，自动精读默认关闭，可在"快捷设置 → 界面设置"中分别勾选，避免不必要的 API 消耗；
• 设置会自动持久化，Zotero 重启后依然生效。

实现源码在 autoScanManager.ts 与 DashboardView.ts。

方式三：批量扫描，补齐旧文献的笔记

文献库里堆着大量"下载一时爽、打开阅读火葬场"的旧论文？批量扫描可以一次性找出所有缺少 AI 笔记的文献。

使用步骤：

1. 打开AI 管家仪表盘；
2. 点击"🔍 扫描未总结论文"或"📚 扫描未精读论文"（分别补齐总结类或精读类笔记）；
3. 扫描结果按您的 Zotero 目录结构以树形展示，勾选需要的论文（支持按目录全选、父子联动勾选）；
4. 点击"添加到队列"，管家会在后台按设定速度慢慢消化这批积压任务。

扫描对话框的树形选择逻辑在 libraryScannerDialog.ts 中实现。

任务队列：三种方式的共同"出口"

无论哪种方式唤醒，任务都会汇入同一个任务队列（生产者-消费者模式）。在"任务队列"页面可以查看每篇论文的待处理、进行中、已完成或失败状态：

📌新手小贴士

• 批量补齐前，建议在"快捷设置"里调低任务处理速度（每分钟处理论文数），避免 API 调用超限；
• 使用多模态模型（如 Gemini 3 Pro）时，把PDF 处理方式设为 Base64 编码，公式、图表、表格理解更准确；
• 还没配置 API？先按 快速开始文档 花 5 分钟完成安装与 API 连接测试；
• 想看完整的安装、API 配置与 FAQ，可参考官方文档 docs/index.md 与 docs/quick-start.md。

总结

三种方式各管一段：右键管"急事"，巡航管"新事"，批量管"旧事"。配置好大模型 API 后，您只需像往常一样把文献丢进 Zotero，AI 管家会自动把它们嚼碎，变成随时可查的论文笔记。

• 人工智能
• 大模型
• AI 应用
• 科研