TideDra/zotero-arxiv-daily · 上手攻略

仓库：TideDra/zotero-arxiv-daily
链接：https://github.com/TideDra/zotero-arxiv-daily
分类：academic-writing · Zotero 插件
作者：Tom
更新：2026-07-14

一、是什么

zotero-arxiv-daily 是一个零成本、零安装的 arXiv 论文每日推荐工具，通过 fork 该 GitHub 仓库并配置 GitHub Actions，即可每天自动根据你 Zotero 书架中的论文主题，推荐当日新提交的 arXiv（及 bioRxiv、medRxiv）论文，生成带有 AI TL;DR 的邮件发送到你的邮箱。

整个流程跑在 GitHub Action 的免费配额内，不需要自建服务器，不需要额外部署，适合个人研究者或小型 lab。

二、解决什么问题

信息过载：arXiv 每日新论文上千篇，扫标题无从下手。
研究方向漂移：只靠关键词订阅不够精准，zotero-arxiv-daily 基于你整个 Zotero 书架的语义上下文做推荐，比单一关键词匹配更贴合你的研究兴趣。
手动检索成本高：不再需要每天打开 arXiv 手动翻目录，系统自动推送。
发现相关代码实现：邮件中附有论文的 PDF 链接和代码仓库链接（若有）。

三、快速安装

3.1 Fork 仓库

在 GitHub 上 fork TideDra/zotero-arxiv-daily。

3.2 配置 GitHub Secrets（6 个必需）

进入 fork 仓库的 Settings → Secrets and variables → Actions，添加以下 Secret：

Secret 名	说明	获取方式
`ZOTERO_ID`	Zotero 用户数字 ID	zotero.org/settings/security，显示为一串数字
`ZOTERO_KEY`	Zotero API 密钥（读权限）	同上页面，点击 "Create new key"
`SENDER`	发件邮箱地址	如 `abc@qq.com`
`SENDER_PASSWORD`	SMTP 认证码	不是邮箱密码，是 SMTP 服务授权码（QQ 邮箱在设置→账户中生成）
`RECEIVER`	收件邮箱地址	如 `abc@outlook.com`
`OPENAI_API_KEY`	LLM API 密钥（可选）	支持 OpenAI 或 SiliconFlow 等兼容 API
`OPENAI_API_BASE`	API 地址（可选）	如 `https://api.siliconflow.cn/v1`

⚠️ 安全注意：这些 Secret 对 fork 仓库所有者也不可见，设置后无法回读，请妥善记录。发件邮箱建议用专门的小号。

3.3 配置 CUSTOM_CONFIG（仓库变量）

在 Settings → Variables → Actions 中添加一个 CUSTOM_CONFIG 变量，粘贴以下内容并按注释修改：

zotero:
  user_id: ${oc.env:ZOTERO_ID}
  api_key: ${oc.env:ZOTERO_KEY}
  include_path: null  # 或 ["2026/survey/**", "2026/reading-group/**"]

email:
  sender: ${oc.env:SENDER}
  receiver: ${oc.env:RECEIVER}
  smtp_server: smtp.qq.com
  smtp_port: 465
  sender_password: ${oc.env:SENDER_PASSWORD}

llm:
  api:
    key: ${oc.env:OPENAI_API_KEY}
    base_url: ${oc.env:OPENAI_API_BASE}
  generation_kwargs:
    model: gpt-4o-mini

source:
  arxiv:
    category: ["cs.AI", "cs.CV", "cs.LG", "cs.CL"]
    include_cross_list: false

executor:
  debug: ${oc.env:DEBUG,null}
  source: ["arxiv"]

arXiv 分类参考（完整列表见 arXiv 分类体系）： - cs.AI 人工智能 - cs.CV 计算机视觉 - cs.LG 机器学习 - cs.CL 计算语言学 - cs.CL 之外还有 stat.ML、math.OC、econ.GN 等

3.4 启用 GitHub Actions

进入仓库 Actions → arxiv daily workflow，点击 Enable workflow。默认每日触发一次，可在 .github/workflows/ 目录下调整 cron 时间。

四、核心用法

4.1 本地调试（如需）

# 克隆你的 fork
git clone https://github.com/YOUR_USERNAME/zotero-arxiv-daily.git
cd zotero-arxiv-daily

# 安装依赖
pip install -r requirements.txt

# 手动运行（设置环境变量后）
python -m src.arxiv_daily

4.2 调整订阅范围

在 CUSTOM_CONFIG 的 zotero.include_path 中指定 Zotero 集合路径（glob 模式），只从这些集合中提取研究兴趣：

zotero:
  include_path: ["2026/survey/**", "2026/reading-group/**"]

4.3 扩展数据源

支持同时订阅 bioRxiv 和 medRxiv：

source:
  arxiv:
    category: ["cs.AI", "cs.CG"]
    include_cross_list: true
  biorxiv:
    category: ["biochemistry", "animal behavior and cognition"]
  medrxiv:
    category: ["psychiatry and clinical psychology", "neurology"]

4.4 忽略不需要的 Zotero 文献

在 zotero.exclude_path（或在 CUSTOM_CONFIG 中对应字段）配置 glob 模式，排除某些方向的文献不被用于构建兴趣画像。

4.5 使用 SiliconFlow 等免费/低成本 API

README 特别提到可用 SiliconFlow（国内平台）获取免费 LLM API：

llm:
  api:
    key: ${oc.env:OPENAI_API_KEY}
    base_url: ${oc.env:OPENAI_API_BASE}  # https://api.siliconflow.cn/v1

⚠️ API 费用：使用 OpenAI 官方 API 会产生费用，建议使用 SiliconFlow 等平台或设置每日请求限制。

五、典型适用场景

场景	原因
研究生/研究员每日跟踪前沿	零成本、自动推送、不遗漏
跨学科研究者	可同时订阅 cs.AI + stat.ML + econ.GN 等多分类
论文阅读小组	配合 Zotero 收藏夹使用，定期推荐阅读清单
需要发现代码实现的工程师	自动附有 GitHub 链接的论文会被优先推荐

六、坑与注意

Zotero API 速率限制：Zotero API 有请求频率限制，Zotero ID 对应的用户库如果论文很多（>10000 篇），初次构建兴趣画像可能触发限流。建议分批次配置 include_path。
GitHub Actions 免费额度：Linux runner 每月 2000 分钟，arXiv 抓取 + LLM 生成通常 5-10 分钟/次，足够每日运行。
SMTP 端口 465：部分邮箱（如 QQ）支持 465 端口的 SSL SMTP，部分可能需要 587（STARTTLS），请按你的邮箱服务商调整 smtp_port。
OPENAI_API_KEY 可选但推荐：不使用 LLM API 时，系统会用论文原始摘要；但有了 AI TL;DR 才能真正快速筛选。不指定模型时，默认用 gpt-4o-mini。
fork 仓库更新：上游仓库有更新时，fork 需要手动同步（Merge upstream），建议定期检查并合并，否则可能错过新功能和安全修复。
中文 Zotero 用户：中文界面 Zotero 同样可用，配置方式完全一致。

七、与同类对比

工具	原理	优点	缺点
zotero-arxiv-daily	Zotero 书架语义 → arXiv 推荐	零成本、零部署、语义精准	需 fork + 配置 Actions、有 GitHub 依赖
arXiv 新 RSS + 关键词	关键词匹配	简单	噪音多、无法语义理解
Connected Papers	引文图谱发现	可视化好	面向回溯发现而非每日推送
Semantic Scholar API	学术图谱搜索	数据全、API 丰富	需要自己写爬虫/调度
Researchrabbit	可视化论文关系	交互好	不是每日推送模式

zotero-arxiv-daily 的核心优势是基于你已有知识库的语义推荐，相当于一个完全属于你自己的、知道你研究方向的论文发现引擎——而不是通用热门榜。

八、一句话推荐结论

如果你用 Zotero 管理文献，又不想花一分钱、不想装任何软件，只想每天早上收到一封「今天有哪些新论文跟你的研究相关」的邮件，fork + 配置 zotero-arxiv-daily 是最省事的方案——GitHub Action 跑一切，你只需要每早查邮箱。

来源：GitHub README · Zotero API 文档 · arXiv 分类体系 · SiliconFlow 官网