Skip to content
 
 

Repository files navigation

Paper Tracker

Python Version License Version Last Commit Code Size Maintenance

English | 中文

Paper Tracker 是一个最小化的论文追踪工具,核心目标是基于关键词查询多个论文数据库(arXiv、OpenAlex、PubMed),并按配置输出结构化结果,便于持续跟踪新论文。

如果该项目对你有帮助, 请麻烦点一个 Star ⭐, 谢谢!

效果展示

查看实际运行效果:📄 部署发布页

HTML 输出结果演示

已实现功能

  • 🔍 查询与筛选:

    • 支持多数据源:arxiv(预印本)、openalex(期刊/会议/预印本)、pubmed(生物医学期刊),可同时启用
    • 支持字段化检索:TITLEABSTRACTAUTHORJOURNALCATEGORY
    • 支持逻辑操作:ANDORNOT
    • 支持全局 scope(对所有 queries 生效)
    • 多源结果聚合后执行跨源去重
    数据源 数据类型 query 字段支持 本地精筛 跨源去重
    arxiv 预印本 完整
    openalex 期刊 / 会议 / 预印本 部分
    pubmed 生物医学期刊 部分

    注意openalex 来源数据目前尚不稳定,可能返回与查询主题不相关的论文,该功能仍处于开发阶段。如果发现结果中出现大量无关文章,建议在配置中关闭 openalex 来源。

    PubMed 使用提示:PubMed 偏向生物医学/生命科学领域;若检索主题与生命科学无关,启用 PubMed 大概率召回较少。建议设置 NCBI_API_KEY 环境变量以提升速率上限。

  • 🧲 拉取策略: 支持拉取更早的论文以补全预定论文数量

  • 🗃️ 去重与存储: SQLite 去重功能, 并存储论文内容供日后查询

  • 📤 输出能力: 支持jsonmarkdownhtml 等格式输出, 支持替换模板

  • 🤖 LLM 增强: 支持 OpenAI-compatible 接口调用, 包括摘要翻译与结构化总结支持

  • 🌐 输出语言可配置: 可通过 llm.target_lang 自定义翻译与总结输出语言(如 Simplified ChineseEnglishJapanese

快速开始

建议使用虚拟环境(如 .venv/):

python3 -m venv .venv
source .venv/bin/activate      # macOS / Linux
# .venv\Scripts\activate       # Windows
python -m pip install -e .     # Install

用内置示例配置直接运行:

paper-tracker search --config config/example.yml

自定义配置

复制示例配置,按需修改后运行:

cp config/example.yml config/custom.yml
# 修改 config/custom.yml 字段
paper-tracker search --config config/custom.yml

以下为必填字段:

  • queries:至少设置一条查询
  • llm.base_url / llm.model:当 llm.enabled: true 时必须指定

(可选) 配置 LLM 环境变量

启用 LLM 摘要翻译时需要配置 API Key:

cp .env.example .env
# 编辑 .env,填入你的 LLM_API_KEY

📚 详细指引可以查看文档:

更新

如需更新到最新版本:

cd paper-tracker
git pull
python -m pip install -e . --upgrade

反馈

如遇到问题或有功能建议,欢迎在 GitHub Issues 提交。

请提供运行时的日志信息 (默认在 log/ 下)

许可证

本项目使用 MIT License

致谢

本仓库为独立实现,参考了以下项目的功能思路:

About

Keyword-based academic paper tracker supporting arXiv & OpenAlex, with LLM-powered translation and multi-format output (JSON/Markdown/HTML).

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages