Zotero-arXiv智能推送：零成本构建你的学术灵感引擎

如何让Zotero主动推送研究灵感？这款开源工具将彻底改变你的文献追踪方式。通过Zotero-arXiv-Daily，你可以实现arXiv论文的自动化跟踪与智能推送，每天早晨醒来即可收到与你研究方向高度匹配的最新论文摘要，全程零成本、无需本地部署，让学术追踪变得高效而轻松。

一、核心价值：为什么选择智能推送系统

Zotero-arXiv-Daily的核心在于将你的Zotero图书馆（文献管理工具）与arXiv（预印本数据库）无缝连接。系统会分析你现有文献的研究主题，每天自动检索arXiv最新论文，并通过邮件将高相关度的成果推送到你的收件箱。相比传统的关键词订阅，这种基于文献内容的智能匹配能更精准地捕捉你的研究兴趣，平均节省研究者40%的文献筛选时间。

二、场景化配置：三步完成自动化部署

2.1 5分钟完成环境变量配置

立即配置基础必配项，这是系统运行的核心引擎：

• ZOTERO_ID：你的Zotero账户ID（在Zotero设置→Feeds/API中获取）
• ZOTERO_KEY：具有读取权限的Zotero API密钥（需在Zotero网站生成）
• ARXIV_QUERY：目标arXiv分类（如cs.AI+cs.CV表示人工智能与计算机视觉）
• SMTP_SERVER：邮件发送服务器地址（如Gmail为smtp.gmail.com）
• SMTP_PORT：邮件服务器端口（通常为587）
• SENDER与RECEIVER：发件人与收件人邮箱地址

图1：在项目设置中添加环境变量的操作界面，红色箭头指示"New repository secret"按钮位置

💡 操作提示：Zotero API密钥需勾选"允许读取库"权限，无需勾选写入权限以确保安全。

2.2 启用进阶功能（可选）

根据研究需求开启智能增强功能：

• MAX_PAPER_NUM：设置每日推送的最大论文数量（建议10-20篇）
• USE_LLM_API：设为true启用AI摘要功能（需额外配置OPENAI_API_KEY）
• SEND_EMPTY：设为true即使无新论文也发送通知邮件

2.3 安全注意事项

• 所有密钥信息必须通过项目 Secrets 功能存储，禁止直接写入代码
• SMTP密码建议使用邮箱应用专用密码（如Gmail的App Password）
• 定期轮换API密钥（建议每90天更新一次）

配置流程图 图2：Zotero arXiv 自动化配置流程图，展示从环境变量设置到邮件推送的完整流程

三、实践拓展：从部署到优化的全流程指南

3.1 30秒触发首次运行

在项目的Actions页面中，找到"Send emails daily"工作流，点击"Run workflow"按钮即可立即启动首次论文检索。工作流文件路径为.github/workflows/daily.yml，你可以通过修改该文件自定义推送时间（默认每天UTC 0点执行）。

图3：GitHub Actions工作流手动触发界面，红色箭头指示"Run workflow"按钮

💡 操作提示：首次运行建议选择"Run workflow"手动触发，确认配置正确后再依赖定时任务。

3.2 故障诊断速查表

常见错误	可能原因	解决方案
邮件发送失败	SMTP服务器配置错误	检查SMTP_SERVER和SMTP_PORT，Gmail用户需开启"Less secure app access"
论文推荐为空	Zotero库内容不足	至少添加5篇相关文献以提供足够的主题训练数据
API调用超限	请求频率过高	参考下方API调用频率优化建议调整参数
摘要生成失败	LLM配置错误	确认USE_LLM_API设为true且OPENAI_API_BASE正确

3.3 API调用频率优化

为避免触发服务提供商的请求限制，建议：

• 将Zotero API请求间隔设置为≥3秒（系统默认配置）
• arXiv检索时间窗口设为最近7天（通过修改config/base.yaml实现）
• 启用本地缓存（设置CACHE_ENABLE=true）减少重复请求

四、效果展示：智能推送邮件样例

成功配置后，你将收到类似以下格式的每日论文推送邮件，包含论文标题、作者、相关度评分和AI生成的TLDR（精简摘要）：

图4：论文推送邮件截图，展示包含相关度评分和摘要的论文列表

通过这套自动化系统，你可以将宝贵的研究时间从文献筛选中解放出来，专注于真正重要的创新工作。立即部署Zotero-arXiv-Daily，让前沿研究主动找到你！