Zotero-arXiv-Daily 完整指南:3 步快速配置免费的 arXiv 论文日报邮件推送
【免费下载链接】zotero-arxiv-dailyRecommend new arxiv papers of your interest daily according to your Zotero libarary.项目地址: https://gitcode.com/GitHub_Trending/zo/zotero-arxiv-daily
每天,arXiv 上新几千篇论文,你连自己研究方向的都读不过来——有没有办法让系统替你挑好最相关的几篇,直接"寄"进你的邮箱?Zotero-arXiv-Daily 就是干这件事的:它读取你 Zotero 文献库里的论文,每天生成一份个性化的 arXiv 论文推荐清单,并自动推送成邮件。
先看效果:一封自动送达的 arXiv 论文推荐邮件
装好之后,你每天会收到这样一封邮件 📮
- 按相关度排序的推荐列表:自动抓取前一天的新论文,和你 Zotero 库里文献(尤其是近期添加的)算相似度打分,星标越多越值得看
- 每篇自带 AI TL;DR:LLM 生成的一句话摘要,配 PDF、代码仓库直链和作者单位,10 秒判断值不值得精读
- 零成本、零维护:整个流程跑在 GitHub Actions 免费 runner 配额里,不用买服务器,不用自己写定时任务
- 多源可扩展:除 arXiv 外还能接入 bioRxiv、medRxiv,适合生物医学方向的跨源追踪
三步快速配置:从 Fork 到收到第一封邮件
全程约 5 分钟,配置一次,之后每天自动运行。
第 1 步:Fork 这个仓库
进入项目页面,点右上角 Fork 把它复制到自己名下(顺手点个 Star),后续所有配置都在你的副本里进行。
第 2 步:填 7 个 Secrets
在你的 fork 中进入 Settings → Secrets and variables → Actions,点"New repository secret"依次添加:
ZOTERO_ID/ZOTERO_KEY:Zotero 账号的 User ID(一串数字,不是用户名)和只读 API keySENDER/SENDER_PASSWORD:发件邮箱 + SMTP 授权码(注意是授权码,不是登录密码)RECEIVER:接收日报的邮箱OPENAI_API_KEY/OPENAI_API_BASE:生成 TL;DR 用的 LLM API 凭证
第 3 步:添加公开变量 CUSTOM_CONFIG
切到 Variables 选项卡,新建一个叫CUSTOM_CONFIG的变量,粘贴下面的最小配置即可:
zotero: user_id: ${oc.env:ZOTERO_ID} api_key: ${oc.env:ZOTERO_KEY} include_path: null 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"] executor: source: ['arxiv'] reranker: local${oc.env:XXX}表示"取 secrets 里 XXX 的值",敏感信息不会被明文写进配置里。
全部填完后,去 Actions 页面手动运行一次 "Test workflow"(调试版,固定抓 5 篇论文),跑完看一眼日志和收件箱,你的第一份个性化论文日报就到账了。
按你的习惯微调:3 组最常改的配置项
所有微调都发生在CUSTOM_CONFIG里,完整字段说明见 README.md,默认值参考 config/default.yaml。
- 换你的研究领域:把
source.arxiv.category改成你的方向(如["cs.CL","cs.IR"]);想看交叉分类论文就加include_cross_list: true。做生物/医学,则启用source.biorxiv/source.medrxiv - 收窄兴趣来源:
zotero.include_path指定只读 Zotero 的某些集合(如["2026/survey/**"]),推荐会立刻更聚焦 - 控制量与语言:
executor.max_paper_num限制每封邮件的论文数;send_empty: true让没有新论文的周末也发一封"今日无新论文";llm.language决定 TL;DR 用中文还是英文
排序模型也可切换:executor.reranker设为local(本地 embedding,免费)或api(调用付费 embedding API,更精准)。
还能怎么搭:4 种进阶玩法
- 改推送时间:主流程默认每天 22:00 UTC 触发,编辑 workflow 文件里的 schedule 即可改成你习惯的时间点
- 随时手动补跑:在 Actions 面板对 "Send emails daily" 点 Run workflow,当天没跑成功也能手动补一次
- 本地跑一份:习惯命令行的话,克隆仓库(
git clone https://gitcode.com/GitHub_Trending/zo/zotero-arxiv-daily),设好同样的环境变量后执行uv run main.py,方便调试 src/zotero_arxiv_daily/ 里的逻辑 - 盯住新版本:把仓库 Watch 设为 Releases,作者发布新版本时会直接通知你,方便及时把上游改动合进自己的 fork
谁适合用,以及 3 个高频疑问
适合谁:用 Zotero 管理文献的博士/硕士生;需要跟踪领域前沿但没有时间天天刷 arXiv 的研究者;想给读组发"每日精选"的导师和实验室群。
Q1:真的完全免费吗?计算跑在公开仓库的 GitHub Actions 免费配额内,个人使用绰绰有余;LLM 部分可以选有免费额度的服务商,不花钱也能跑通。
Q2:Zotero User ID 在哪里找?它是 Zotero 账号设置 Security 页面里的一串数字,不是你的用户名:
Q3:为什么某天没收到邮件?周末和节假日 arXiv 不更新,日志里会显示 "No new papers found",属于正常;真有异常时先跑一遍 Test workflow 看日志,或把executor.debug设为true打开调试模式。
现在动手:5 分钟拥有你的专属论文日报
Zotero-arXiv-Daily 把"每天手动翻论文"变成"每天开收件箱",一份完全贴合你研究方向的 arXiv 论文日报,从此自动送达。
去 Fork 仓库、填好 3 处配置、手动触发一次测试工作流吧——几分钟后,第一封为你定制的论文日报就会出现在邮箱里 ✅
【免费下载链接】zotero-arxiv-dailyRecommend new arxiv papers of your interest daily according to your Zotero libarary.项目地址: https://gitcode.com/GitHub_Trending/zo/zotero-arxiv-daily
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考