Zotero AI 管家
Zotero AI 管家 是 AI Skill Hub 本期精选Agent工作流之一。已获得 1.4k 颗 GitHub Star，综合评分 7.5 分，整体质量较高。我们推荐使用将其纳入你的 AI 工具库，帮助提升工作效率。
📚 深度解析
Zotero AI 管家 工作流的设计遵循"最小配置，最大复用"原则：核心逻辑已经封装好，用户只需配置自己的 API Key 和业务参数即可快速上手。工作流内置错误处理和重试机制，在网络波动或 API 限速等情况下仍能稳定运行，适合作为生产环境的自动化基础设施。
在实际部署时，建议先在测试环境中运行 3-5 次，验证各个环节的输出结果符合预期，再部署到生产环境。AI Skill Hub 评分 7.5 分，是同类 Agent 工作流中的精选推荐。
📋 工具概览
Zotero AI 管家 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
📖 中文文档
Zotero AI 管家 是一套完整的 AI Agent 自动化工作流方案。通过可视化的节点编排，将复杂的多步骤任务拆解为清晰的自动化流程，实现全程无人值守的智能处理。支持与数百种外部服务和 API 无缝集成，适合构建数据处理管线、业务自动化和 AI 辅助决策系统。
- 可视化 Agent 工作流编排，无需编写复杂代码
- 支持多步骤自动化任务链，实现全流程无人值守
- 与外部 API、数据库和第三方服务无缝集成
- 内置错误处理与自动重试机制，保障稳定运行
- 提供可复用的自动化模板，快速在同类场景部署
- 自动化日常重复性工作，将精力集中于创造性任务
- 构建数据采集 → 处理 → 输出的完整自动化管线
- 实现跨平台、跨系统的数据流转和业务协同
# 方式一：npm 全局安装 npm install -g zotero-ai-butler # 方式二：npx 直接运行（无需安装） npx zotero-ai-butler --help # 方式三：项目依赖安装 npm install zotero-ai-butler # 方式四：从源码运行 git clone https://github.com/steven-jianhao-li/zotero-AI-Butler cd zotero-AI-Butler npm install npm start
- 访问 GitHub 仓库获取工作流文件
- 在对应平台（Dify / Flowise / Make 等）中找到「导入工作流」功能
- 上传工作流文件
- 按照提示配置必要的环境变量和 API Key
- 运行测试确认流程正常后投入使用
# 命令行使用
zotero-ai-butler --help
# 基本用法
zotero-ai-butler [options] <input>
# Node.js 代码中使用
const zotero_ai_butler = require('zotero-ai-butler');
const result = await zotero_ai_butler.run(options);
console.log(result);
# zotero-ai-butler 配置说明 # 查看配置选项 zotero-ai-butler --config-example > config.yml # 常见配置项 # output_dir: ./output # log_level: info # workers: 4 # 环境变量（覆盖配置文件） export ZOTERO_AI_BUTLER_CONFIG="/path/to/config.yml"
🎖️ 核心功能
- 自动化处理：管家自动扫描新添加的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 将为您的阅读扫清障碍！
✨ 功能介绍
4. 对话与追问(Pre-release功能)
AI管家支持多轮对话功能，允许用户在生成的AI总结基础上进行后续追问。 
🚀 安装与快速上手
安装插件
- 访问本项目的 GitHub Releases 页面。
- 下载最新的Release版本的
.xpi文件。 - 打开 Zotero 桌面端，点击顶部菜单的 “工具” -> “插件”。
- 将下载好的 .xpi 文件拖拽到插件窗口中，完成安装。
[点我查看 **AI Butler Wiki**——配置与使用文档](https://steven-jianhao-li.github.io/zotero-AI-Butler/)
文献下载一时爽，打开阅读火葬场。 天书难啃骨头硬，管家嚼碎再喂粮。
想着稍后阅读的论文，最后却变成了永不阅读？ 长篇大论的学术论文，有翻译却也抓不住重点？
文献阅读被以下问题困扰？
- 痛点一：文章太多，读不过来。即便让AI辅助阅读，却还要一篇一篇的发给AI，效率低下。
- 痛点二：读完就忘，需要反复重新阅读。 辛辛苦苦读完一篇，两天后就忘了，想回忆又得从头看起，浪费时间。
- 痛点三：文章太长，即使有翻译插件，也难以抓住重点，读下一页忘上一页。
别慌！您的专属AI管家 Zotero-AI-Butler 已闪亮登场！
TA 是您7x24小时待命、不知疲倦且绝对忠诚的私人管家。 您只管像往常一样把文献丢进 Zotero，剩下的体力活全交给TA！ 管家会自动帮您精读论文，将文章揉碎了总结为笔记，让您“十分钟完全了解”这篇论文！ 3.0版本震撼首发“一图总结”功能，用Nano Banana Pro生成学术海报，一图胜千言！
快速配置与使用
- 在任意论文上右键 -> “AI管家仪表盘” -> 打开 “设置” 选项卡。
- 配置API： 填入您的 API 密钥（推荐Gemini），点击 “测试连接” 确保网络通畅。
- 开启自动扫描： 转到 “界面设置” 选项卡，勾选 “自动扫描新文献”。
现在，当您拖入新的PDF论文时，AI管家将在1分钟左右（取决于模型速度）自动为您生成精读笔记。
8. 侧边栏 AI 笔记预览
在 Zotero 右侧的条目信息面板中，AI 管家会自动展示该文献的 AI 笔记内容，方便您快速浏览。
- 自动检测：自动查找并显示 AI 管家生成的笔记
- 样式渲染：使用精美的 CSS 样式渲染笔记内容，支持多种主题切换
- 折叠/展开：点击标题栏可折叠或展开笔记区域
- 高度可调：拖拽底部手柄调整笔记区域高度，设置自动保存
- 字体缩放：点击标题栏的 +/− 按钮调整字体大小
- 快速生成：如果没有 AI 笔记，可一键召唤 AI 管家生成
- 侧边栏追问：
- 完整追问 (保存记录)：打开对话窗口进行深度追问，对话记录自动保存到笔记
- 快速提问 (不保存记录)：临时提问，不保存对话历史
- LaTeX 公式渲染：侧边栏支持 KaTeX 渲染 LaTeX 数学公式，让论文中的数学内容清晰可见。
- 自动渲染：自动识别并渲染
$...$（行内公式）和$$...$$（块级公式） - 横向滚动：长公式自动显示横向滚动条，避免内容溢出
- 暗色模式适配：公式渲染完美适配 Zotero 的明暗主题
- 固定侧边栏：可以使用Zotero自带的固定侧边栏功能，将AI管家侧边栏窗口固定，方便翻阅论文。
- 使用方法：右键侧边栏最右侧的 AI 管家 图标，点击“固定此栏”即可固定侧边栏窗口。再次右键，点击“取消固定此栏”即可取消固定。
5. 多平台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免费额度，支持豆包大模型系列 |
| **Ollama** | llama3.2 | 本地/局域网模型服务，使用文本提取或 MinerU 处理 PDF |
Zotero插件：**zotero-AI-Butler【AI 管家】**
<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> <a href="https://doi.org/10.5281/zenodo.20457937"><img src="https://img.shields.io/badge/DOI-10.5281%2Fzenodo.20457937-blue" alt="DOI"></a> </p> </div>
隐私声明：本项目为第三方开源Zotero插件，不提供任何的大模型代理服务。用户需自行申请并配置大模型API Key方可使用。本插件绝不收集、存储或上传您的任何个人数据、文献或API Key，所有的交互请求均直接从您的本地设备发送至您配置的大模型服务商处。
如果本插件对您的研究有帮助，欢迎在论文中引用或致谢！
该项目提供了一个开源的AI工作流，支持主流大模型平台，自动精读论文库里的论文，总结为Zotero笔记，具有很好的实用价值
⚡ 核心功能
- 可视化 Agent 工作流编排，无需编写复杂代码
- 支持多步骤自动化任务链，实现全流程无人值守
- 与外部 API、数据库和第三方服务无缝集成
- 内置错误处理与自动重试机制，保障稳定运行
- 提供可复用的自动化模板，快速在同类场景部署
👥 适合人群
🎯 使用场景
- 自动化日常重复性工作，将精力集中于创造性任务
- 构建数据采集 → 处理 → 输出的完整自动化管线
- 实现跨平台、跨系统的数据流转和业务协同
⚖️ 优点与不足
- +大幅减少重复性人工操作
- +可视化流程，清晰直观
- +可扩展性强，支持复杂场景
- −初始配置和调试需投入一定时间
- −强依赖外部服务的稳定性
- −复杂场景需具备一定技术基础
该工具使用 AGPL-3.0 协议，商用场景请仔细阅读协议条款，必要时咨询法律意见。
AI Skill Hub 为第三方内容聚合平台，本页面信息基于公开数据整理，不对工具功能和质量作任何法律背书。
建议在沙箱或测试环境中充分验证后，再部署至生产环境，并做好必要的安全评估。
⚠️ AGPL 3.0 — 最严格的 Copyleft，网络服务端使用也需开源，SaaS 使用受限。
🔗 相关工具推荐
❓ 常见问题 FAQ
经综合评估，Zotero AI 管家 在Agent工作流赛道中表现稳健，质量良好。如果你已有明确的使用需求，可以直接上手体验；如果还在评估阶段，建议对比同类工具后再做决策。
| 原始名称 | zotero-AI-Butler |
| Topics | workflowacademic-toolsaiai-butlerartificial-intelligencebutlertypescript |
| GitHub | https://github.com/steven-jianhao-li/zotero-AI-Butler |
| License | AGPL-3.0 |
| 语言 | TypeScript |
收录时间：2026-06-05 · 更新时间：2026-06-05 · License：AGPL-3.0 · AI Skill Hub 不对第三方内容的准确性作法律背书。