ovohao/auto-paper-collecter

---

🆕 最新更新 · What’s New

✨ v1.1 — 体验与智能双升级 · 2026-06-27

2026-06-27 · 已上架 SkillHub 🎉

本 skill 现已登陆 SkillHub，可在平台上直接浏览 / 获取与安装。

2026-06-26 · Agent Skill 现可一键安装为 Claude Code 插件，并支持 Codex 🤖🔌

除了网页版，本仓库内置一个 Claude Code / Codex 通用的 Agent Skill —— 一句话 「运行我的文献雷达」 就能跑完整条流水线、产出当日文献摘要，纯 Python 标准库、零依赖、免 AI API key。 一行命令安装：/plugin marketplace add OvOhao/auto-paper-collecter → /plugin install auto-paper-collecter@auto-paper-collecter。 同时新增 AGENTS.md，让 Codex / OpenAI 等 agent 也能开箱即用。👉 详见下方 「🤖 Skill 版」。

---

🌟 这是什么 · What is this

auto-paper-collecter 是一个轻量、自托管的学术文献自动聚合工具。

你只要告诉它你关心的几个关键词，它就会每天自动：

🛰️ 跨 arXiv / Crossref(含 IEEE·ACM)/ Semantic Scholar / GitHub / RSS 多源检索 🧠 用 LLM 做"联想式"扩展检索，不再只匹配字面关键词 🎯 用 LLM 把跨领域、不相关的论文过滤掉，只留计算机领域、真正切题的 ✍️ 为每篇生成中文摘要(一句话 TL;DR / 方法 / 核心贡献) 📊 分析领域热点、生成每周报告，还能邮件 / 浏览器推送

一个零构建的单页仪表盘，前后端同源，开箱即用。

---

🎯 为什么做它 · Motivation

[!NOTE] 做科研最累的事情之一，是跟踪文献。 arXiv 每天上新成百上千篇，关键词搜索要么漏掉同义写法、要么被一堆跨领域结果淹没， 手动刷既费时又容易错过。

于是有了这个小工具 —— 把"每天读一遍最新文献"这件事自动化，并交给 LLM 做最脏最累的两件事：

1. 想得更全：C2Rust 也该搜到 C-to-Rust translation、migrating legacy C to Rust……
2. 筛得更准：把"医学里的 translation""金融里的 AI"这种同名跨领域噪声挡在门外。

让你打开页面，看到的就是一份干净、按时间排好、带摘要的当日文献流。🫧

---

✨ 功能特性 · Features

---

🧩 工作原理 · How it works

flowchart LR
    A([🔑 你的关键词]) --> B{{🧠 LLM 联想扩展}}
    B --> S1[arXiv]
    B --> S2[Crossref]
    B --> S3[Semantic Scholar]
    B --> S4[GitHub]
    B --> S5[RSS]
    S1 --> M[🧹 跨源去重]
    S2 --> M
    S3 --> M
    S4 --> M
    S5 --> M
    M --> F{{🎯 LLM 相关性过滤}}
    F --> Z{{✍️ LLM 中文摘要}}
    Z --> DB[(🗄️ SQLite)]
    DB --> UI([📊 仪表盘 / 邮件 / 周报])

---

🚀 快速开始 · Quick Start

# 1) 克隆并进入
git clone https://github.com/OvOhao/auto-paper-collecter.git
cd auto-paper-collecter

# 2) 建虚拟环境 & 装依赖
python -m venv .venv
source .venv/bin/activate            # Windows: .venv\Scripts\activate
pip install -r requirements.txt

# 3) 配置（复制模板后编辑 .env，填入你的 AI 网关等）
cp .env.example .env

# 4) 起飞 🛫
python run.py

打开 http://localhost:8000 → 进入「订阅设置」填关键词 → 点「保存并拓取」即可。

🐳 或用 Docker 一键起飞：cp .env.example .env（可选）→ docker compose up -d，数据库会持久化到 ./data。

[!TIP] 关键词建议用英文（各源召回率更高）；界面与摘要是中文。首次抓取 + 摘要约需 1–3 分钟，后台进行，完成后页面自动出结果。

---

🤖 Skill 版 · Use as an Agent Skill

除了网页版，本仓库还内置一个 Claude Code / Codex 通用的 Agent Skill（skills/auto-paper-collecter/ 目录）—— 直接对 AI 助手说一句"运行我的文献雷达"，它就会跑完整条流水线并产出当日文献摘要， 而且不需要任何 AI API key（跑这个 skill 的模型本身就是那个 LLM）。

方式一 · 作为 Claude Code 插件安装（推荐，一行命令搞定）

/plugin marketplace add OvOhao/auto-paper-collecter
/plugin install auto-paper-collecter@auto-paper-collecter

方式二 · 直接复制 skill 目录

cp -r skills/auto-paper-collecter ~/.claude/skills/auto-paper-collecter
$EDITOR ~/.claude/skills/auto-paper-collecter/state/config.json   # 编辑你的关键词

然后对 Claude Code 说 「运行我的文献雷达 / 今天有什么新论文」 即可。脚本是纯 Python 标准库、零依赖； 确定性的抓取交给脚本，LLM 的判断（联想扩展 / 相关性过滤 / 中文摘要 / 热点）由运行 skill 的模型完成 （Claude Code → Claude；Codex → GPT）。细节见 skills/auto-paper-collecter/SKILL.md。

📦 本 skill 也已上架 SkillHub，可在平台上直接浏览 / 获取。

---

⚙️ 配置 · Configuration

所有配置都在 .env（参见 .env.example）：

[!IMPORTANT] .env 已被 .gitignore 忽略，密钥永远不会被提交。请妥善保管自己的 key 🔐

---

🛰️ 数据源 · Data Sources

---

📡 API

---

🗺️ 路线图 · Roadmap

• [x] 多源聚合 + LLM 联想扩展 + 相关性过滤
• [x] 领域热点（细分方向 + 详细总结 + 论文清单）
• [x] 收藏 / 笔记 / BibTeX / 每周报告
• [x] 浏览器 + 邮件推送、定时任务
• [x] 更多数据源（HuggingFace · Papers with Code）
• [x] 一键 Docker 部署
• [x] 移动端适配 + 深色模式 + 👍/👎 反馈学习 + 多渠道推送
• [ ] 多用户 + 鉴权（PostgreSQL）
• [ ] 移动端适配

欢迎在 Issues 里提你想要的功能！🙌

---

🤝 一起建设 · Contributing

这是一个业余时间打磨的开源小项目，它的成长离不开你 —— 非常欢迎大家一起把它做得更好！ 🌱✨

• 🐛 发现 Bug → 提个 Issue
• 💡 有想法 / 想讨论 → 来 Discussions 一起头脑风暴 🧠
• ✨ 想要新功能 → 在 Issues 许个愿
• 🔧 想动手 → Fork → 改 → 提一个 Pull Request

无论是改一个错别字、补一句文档，还是接一个新数据源，每一份贡献都同样珍贵 💗 也欢迎你只是来 Discussions 聊聊你的科研工作流、分享你的关键词配置 —— 让我们把这个小雷达一起养大 🚀

---