智能学术推送新体验：Zotero-arXiv-Daily全攻略

Zotero-arXiv-Daily是一款将arXiv论文推荐与Zotero集成的智能学术工具，它能根据你的Zotero图书馆内容，每天自动推送相关的最新研究论文到邮箱。无需本地安装，通过GitHub Actions工作流（一种自动化任务执行工具）即可实现零成本的学术追踪解决方案。

一、核心价值：三大场景化应用

1. 跨学科研究跟踪方案

对于从事交叉学科研究的学者，该工具能自动聚合不同领域的相关论文。系统通过分析Zotero图书馆中的文献关键词，从arXiv的计算机科学、物理学、数学等多个分类中精准筛选跨领域研究，帮助研究者把握学科交叉点的最新动态。

2. 文献综述加速工具

撰写综述论文时，工具可按时间线整理特定主题的最新研究。通过设置ARXIV_QUERY参数指定核心关键词，系统将每日推送相关新文献，配合Zotero的标签功能，可快速构建结构化的文献库，将综述写作的文献收集阶段缩短50%以上。

3. 团队知识共享机制

研究团队可通过共享Zotero群组图书馆，配置统一的推送参数，实现团队成员间的研究进展同步。系统支持多人邮箱接收，确保每位成员都能及时获取领域前沿，特别适合实验室或研究小组使用。

💡 专家提示：定期在Zotero中添加高质量文献能显著提升推荐精准度，建议每月至少更新10篇核心文献到图书馆。

二、场景化配置：三步完成系统部署

准备工作：环境搭建指南

📌 第一步：获取项目代码

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

📌 第二步：准备必要账号

• Zotero账户（需创建个人图书馆）
• 支持SMTP的邮箱账户（如QQ邮箱、Gmail）
• GitHub账户（用于运行自动化工作流）

⚠️ 重要提示：确保Zotero账户已开启API访问权限，在设置→Feeds/API中生成API密钥。

核心参数：安全配置详解

进入项目仓库的Settings→Secrets页面，添加以下关键参数：

基础认证参数

• ZOTERO_ID：Zotero用户ID（在账户设置→Feeds/API中查看）
• ZOTERO_KEY：Zotero API密钥（具有读取权限）
• SENDER：发送邮件的邮箱地址
• SENDER_PASSWORD：邮箱SMTP授权码（非登录密码）

内容控制参数

• ARXIV_QUERY：arXiv分类关键词，如"cs.AI+stat.ML"表示人工智能和机器学习领域
• MAX_PAPER_NUM：每日推送的最大论文数量（建议设为5-10篇）
• RECEIVER：接收邮件的地址，多个地址用逗号分隔

扩展功能：高级选项配置

在项目的Actions variables页面配置非敏感参数：

邮件设置

• SMTP_SERVER：邮箱SMTP服务器地址（如QQ邮箱为smtp.qq.com）
• SMTP_PORT：SMTP服务端口（通常为465）
• SEND_EMPTY：是否发送空邮件（设置为"false"可避免无新论文时的打扰）

AI增强功能

• USE_LLM_API：是否启用AI摘要功能（设置为"true"开启）
• MODEL_NAME：指定AI模型（如"gpt-3.5-turbo"）
• OPENAI_API_BASE：API访问地址（国内用户可配置代理地址）

💡 专家提示：初次配置后建议立即手动触发工作流测试，路径：Actions→daily→Run workflow，检查邮件接收情况。

三、实践指南：从入门到精通

日常使用技巧

论文筛选优化

通过修改ARXIV_QUERY参数可精确控制推荐范围，格式说明：

• 用"+"连接多个分类（如"cs.CV+cs.LG"）
• 用"-"排除特定关键词（如"cs.AI -robot"）
• 支持作者筛选（如"au:Zhang+Li"）

推送频率调整

修改工作流配置文件[.github/workflows/daily.yml]中的schedule字段，可自定义推送时间：

schedule:
  - cron: '0 8 * * *'  # 每天早上8点执行

常见问题诊断

邮件接收失败

1. 检查SMTP参数是否正确，端口是否开放
2. 确认邮箱是否开启SMTP服务（如QQ邮箱需在设置中开启）
3. 查看GitHub Actions日志：Actions→daily→最新运行→Re-run jobs

推荐相关性低

1. 增加Zotero图书馆中的相关文献数量
2. 优化ARXIV_QUERY关键词，使用更具体的分类
3. 启用LLM增强功能，配置USE_LLM_API=true

个性化配置

自定义邮件模板

编辑[src/zotero_arxiv_daily/construct_email.py]文件，修改邮件HTML模板，可添加个人签名或机构标识。

多库管理方案

通过配置CUSTOM_CONFIG变量实现多Zotero库管理：

zotero:
  user_id: ${{env.ZOTERO_ID}}
  api_key: ${{env.ZOTERO_KEY}}
  include_path: /path/to/specific/collection

💡 专家提示：使用Git分支管理不同的配置方案，通过分支切换实现研究主题的快速切换。

四、生态延伸：功能拓展与集成

第三方工具集成

Zotero插件联动

配合Zotero的"Better BibTeX"插件，可实现推荐论文的自动引用格式生成。在配置文件[config/custom.yaml]中设置：

export:
  format: bibtex
  path: ./references.bib

笔记系统对接

通过修改[src/zotero_arxiv_daily/executor.py]中的回调函数，可将推荐论文自动同步到Notion或Obsidian：

def post_process(papers):
    for paper in papers:
        notion_client.create_page(
            title=paper.title,
            content=paper.summary
        )

二次开发建议

功能扩展方向

1. 增加论文影响力分析模块，集成Altmetric数据
2. 开发Web界面，提供可视化配置和历史推荐查看
3. 添加多语言支持，适配非英语论文推荐

技术实现路径

• 推荐算法优化：修改[src/zotero_arxiv_daily/reranker/local.py]
• 新数据源集成：参考[src/zotero_arxiv_daily/retriever/arxiv_retriever.py]实现新接口
• 前端开发：可基于FastAPI构建管理界面，代码存放于新的[web/frontend]目录

💡 专家提示：参与项目贡献前，建议先阅读[CONTRIBUTING.md]文档，遵循代码规范和提交指南。

通过Zotero-arXiv-Daily，研究者可以将宝贵的时间从文献筛选中解放出来，专注于真正的学术创新。这款工具不仅是一个论文推荐系统，更是连接个人知识库与学术前沿的智能桥梁，为现代科研工作提供了高效的信息获取解决方案。