智能推送arXiv论文：Zotero-arxiv-daily高效获取方案

一、项目核心价值：终结学术追踪痛点

在信息爆炸的时代，研究人员每天需要处理成百上千篇新发表的学术论文，如何精准筛选出与自己研究方向高度相关的文献成为一大挑战。Zotero-arxiv-daily作为一款开源工具，通过深度整合Zotero图书馆与arXiv论文数据库，解决了三个核心痛点：

• 信息过载筛选难：传统学术追踪方式需要手动浏览大量论文标题和摘要，效率低下
• 研究方向匹配不准：通用搜索引擎难以理解个人研究兴趣的细微差别
• 时间成本高昂：研究者平均每天花费2-3小时筛选相关文献

本项目的独特优势在于：基于你的Zotero图书馆内容进行智能推荐，利用GitHub Actions（自动化工作流工具）实现每日自动推送，全程无需本地部署，零成本即可搭建个性化学术追踪系统。

二、模块化实施指南：四步构建智能推送系统

1. 获取项目代码库

🔧 操作步骤：

git clone https://gitcode.com/GitHub_Trending/zo/zotero-arxiv-daily
cd zotero-arxiv-daily

📌 关键说明：此操作会在本地创建项目副本，包含所有必要的配置文件和源代码。建议使用Git 2.20.0及以上版本以确保兼容性。

图1：项目复刻界面，红色箭头指示"Fork"按钮位置

2. 配置Zotero访问凭证

📌 核心概念：Zotero是一款开源文献管理软件，通过API可以安全访问你的个人图书馆数据。我们需要获取两个关键凭证：

参数名称	数据类型	安全级别	获取途径
ZOTERO_ID	数字	公开信息	Zotero设置→Feeds/API
ZOTERO_KEY	字符串	敏感信息	Zotero设置→Feeds/API→创建新密钥

🔧 操作验证：获取凭证后，可通过以下命令测试连接（替换为你的实际ID和密钥）：

curl "https://api.zotero.org/users/[ZOTERO_ID]/items?key=[ZOTERO_KEY]"

检查点：如返回JSON格式的图书馆数据，说明Zotero配置正确。

3. 设置环境变量与密钥

📌 配置决策指南：在项目仓库的"Settings→Secrets"页面添加以下配置项，区分敏感信息（Secrets）和普通变量（Variables）：

图2：环境变量配置界面，红色箭头指示添加新密钥的位置

核心配置项选择建议：

• ARXIV_QUERY：使用arXiv分类代码，如"cs.AI+stat.ML"表示人工智能和机器学习领域
• MAX_PAPER_NUM：推荐设置10-15篇，平衡信息价值与阅读时间
• USE_LLM_API：学术研究者建议设为"true"，利用AI生成论文摘要

图3：变量配置示例，展示了Zotero和邮件参数的设置格式

检查点：添加完成后应看到至少8个配置项，包括Zotero凭证、邮件参数和查询条件。

4. 启动自动化工作流

🔧 操作步骤：

1. 进入项目仓库的"Actions"页面
2. 选择"Send emails daily"工作流
3. 点击"Run workflow"按钮手动触发首次执行

图4：工作流触发界面，红色箭头指示手动运行按钮

📌 调度说明：默认配置为每天自动运行，如需调整频率，可修改.github/workflows/main.yml中的schedule字段。

检查点：工作流执行成功后，接收邮箱应收到测试邮件，包含格式正确的论文推荐列表。

三、场景化应用方案：不同角色的最优使用策略

1. 科研人员：深度学术追踪

核心需求：全面掌握细分领域最新进展，保持研究前沿性

优化配置：

• ARXIV_QUERY：设置2-3个紧密相关的分类（如"cs.CV+cs.LG"）
• MAX_PAPER_NUM：15篇，确保覆盖重要研究
• USE_LLM_API：true，启用AI生成技术摘要
• 每周更新Zotero图书馆，保持推荐模型时效性

使用技巧：将重要论文直接从邮件添加到Zotero，形成研究脉络图谱

2. 研究生：高效文献管理

核心需求：快速筛选高质量文献，支持学位论文写作

优化配置：

• ARXIV_QUERY：精确到细分方向（如"cs.NE+q-bio.NC"）
• MAX_PAPER_NUM：10篇，聚焦高影响力论文
• SEND_EMPTY：false，无新论文时不发送邮件
• 建立Zotero分类文件夹，与arXiv分类对应

使用技巧：设置论文阅读优先级标记，优先处理五星推荐论文

3. 产业研发人员：技术趋势监测

核心需求：跟踪技术应用可能性，关注产学研结合点

优化配置：

• ARXIV_QUERY：跨学科组合（如"cs.AI+eess.IV"）
• MAX_PAPER_NUM：20篇，扩大监测范围
• USE_LLM_API：true，重点关注"应用价值"字段
• 建立技术标签体系，分类管理推荐论文

使用技巧：定期导出推荐历史，分析技术发展趋势

四、常见配置陷阱与解决方案

1. Zotero API访问失败

症状：工作流日志显示403错误 原因：API密钥权限不足或用户ID错误 解决方案：在Zotero密钥管理页面确保勾选"read access"权限，重新核对用户ID

2. 邮件发送超时

症状：工作流执行超时，无邮件接收 原因：SMTP服务器配置错误或端口被防火墙阻止 解决方案：使用常见邮件服务商的标准配置（如QQ邮箱SMTP端口465，SSL加密）

3. 推荐相关性低

症状：收到的论文与研究方向不符 原因：ARXIV_QUERY分类过宽或Zotero图书馆样本不足 解决方案：细化分类代码，添加至少10篇相关论文到Zotero图书馆

五、进阶功能矩阵

功能特性	基础版（默认配置）	高级版（需额外配置）
论文推荐	基于关键词匹配	基于语义相似度（需USE_LLM_API=true）
推送频率	每日一次	自定义时间间隔（修改workflow调度）
内容处理	标题+摘要	自动生成技术亮点与应用价值
多源支持	arXiv	arXiv+bioRxiv+medRxiv（需修改配置文件）
存储集成	仅邮件推送	自动保存到Zotero（需额外权限配置）

六、实施效果验证

成功配置后，你将收到类似以下内容的每日邮件：

图5：邮件推送效果示例，展示了论文标题、作者、相关度评分和摘要

检查点：邮件应包含：

• 3-5篇相关论文（数量由MAX_PAPER_NUM决定）
• 每篇论文的相关度评分（★★★☆☆格式）
• 简明技术摘要（TLDR）
• 直达PDF和代码的链接

通过这套系统，研究者可将文献筛选时间从每天2小时减少到15分钟，同时显著提高发现重要研究的概率。随着使用时间增加，系统会逐渐学习你的研究兴趣，推荐精准度不断提升。