这个项目是基于 Resophy 开源项目二次开发而来，非常感谢原作者有趣的创造。
PaperPilot 是您的下一代科研助手，旨在优化您的学术工作流。通过将先进的 AI 能力与强大的文档管理系统深度融合，PaperPilot 帮助您以前所未有的效率发现、阅读、理解和管理研究论文。
无论您是追踪最新的 ArXiv 预印本，还是深度研读复杂的 PDF 文献，PaperPilot 都是您的智能副驾驶。
Note: 本项目基于 Trae Coding Agent，使用了 2 种模型（Gemini-3-Pro-Preview 和 GPT-5.2，其中 Gemini-3-Pro-Preview 主要用于代码功能开发，GPT-5.2 主要用于 Bugfix 和性能优化）Vibe Coding 实现，这真的对于我一个没有写过现代意义上 Web 前端代码的我简直不可思议 🤯（上一次写 Web 代码还是读本科时用 HTML 和 CSS 手写网页）。
- 无缝上传：支持拖拽上传 PDF，自动提取元数据。
- 高效整理：自定义分类、文件夹管理及全文检索。
- Zotero 集成：支持从 Zotero RDF 库一键导入文献。
- 阅读热力图：内置 GitHub 风格的贡献图，可视化您的阅读习惯。
- AI 翻译：基于 BabelDOC 实现像素级英汉（及多语种）翻译，完美保留原始排版和图表。
- AI 深度解读：利用 MinerU (PDF转Markdown) 和 LLM 对论文进行深度分析，生成结构化摘要（摘要、方法、实验、结论）。
- 论文对话：与文档进行交互式问答，快速厘清概念与细节。
- 自动追踪：定时抓取指定 ArXiv 领域（如
cs.CV,cs.AI）的最新论文。 - 智能筛选：支持按关键词、机构权重进行过滤和高亮。
- AI 摘要：自动为新论文生成简明扼要的中文摘要。
- 离线可用：即使没有 LLM 连接也能正常抓取（仅跳过摘要/机构信息）。
自动抓取最新论文，生成 AI 摘要，助您紧跟前沿。
基于全文的深度分析与交互式问答，打破语言与理解障碍。
高效的阅读列表管理与灵活的系统配置。
支持用户登录鉴权，保障私密访问，方便公网部署。
- 后端：Python 3.10+, Flask
- 前端：HTML5, CSS3, 原生 JS (响应式设计)
- 数据库：SQLite (元数据), Supabase (可选鉴权)
- AI 核心：
推荐使用 uv 进行快速可靠的依赖管理。
- Python 3.10 或更高版本
uv包管理器
-
克隆仓库
git clone https://github.com/flyflypeng/PaperPilot cd PaperPilot -
初始化环境
uv venv source .venv/bin/activate # Linux/macOS # .\.venv\Scripts\activate # Windows
-
安装依赖
选项 A: 标准版 (仅客户端) 如果您主要使用外部 API 进行 AI 任务，推荐此选项。
uv pip install -e ".[local]"选项 B: 完整版 (本地 AI) 包含本地运行 MinerU 和 VLM 推理所需的依赖。
uv pip install -e ".[server]" -
Supabase Auth 鉴权（可选） PaperPilot 的登录/注册基于 Supabase Auth（邮箱+密码）。启用后，前端会在浏览器中通过
supabase-js获取会话令牌，并在请求/api/*时携带Authorization: Bearer <access_token>；后端会用 Supabase 的/auth/v1/user接口校验令牌有效性。 若未配置SUPABASE_URL与SUPABASE_ANON_KEY，系统将默认关闭鉴权：前端不会显示登录界面，后端/api/*接口不要求Authorization头，直接进入管理界面。1）创建 Supabase 项目并获取密钥
- 进入 https://supabase.com/ 创建 Project
- 在 Supabase 控制台进入 Project Settings → API
- 复制 Project URL 作为
SUPABASE_URL - 复制 Project API keys → anon public 作为
SUPABASE_ANON_KEY
2）在 Supabase 控制台启用 Email 登录
- 进入 Authentication → Providers
- 启用 Email（Email/Password）
- 如仅用于本地/内网试用，可在 Authentication → Settings 中关闭邮箱确认（Email confirmations），避免注册后必须点邮件验证
3）配置回调地址（非常重要）
- 进入 Authentication → URL Configuration
- 将 Site URL 设置为你的站点根地址，例如：
- 本地：
http://localhost:7191 - 线上：
https://your-domain.com - 在 Redirect URLs 中添加允许的回调地址（至少包含站点根地址），例如：
http://localhost:7191/https://your-domain.com/
4）在 PaperPilot 中启用鉴权 在项目根目录复制并编辑环境变量：
cp .env.example .env # 编辑 .env 文件填入 SUPABASE_URL 和 SUPABASE_ANON_KEY重启服务后访问页面，若 Supabase 配置正确会出现登录/注册入口。
安全提示
- 仅使用
anon publickey；不要把service_rolekey 放进.env或发到前端 - 本项目会把
SUPABASE_URL与SUPABASE_ANON_KEY注入到页面中（用于浏览器侧登录），这是预期行为
-
启动应用
python app.py
访问 Web 界面：
http://localhost:7191（默认端口）自定义启动参数：
app.py支持以下命令行参数，方便用户自定义运行配置：参数 默认值 说明 --papers-dir./papers指定论文存储目录路径（绝对路径或相对路径） --host0.0.0.0服务器监听地址 --port7191服务器监听端口 --debugFalse启用调试模式（开发用） 典型配置方案：
-
指定数据存储位置（适合数据盘挂载场景）：
python app.py --papers-dir /mnt/data/my_papers
-
修改服务端口（当默认端口被占用时）：
python app.py --port 8080
-
仅允许本地访问（增强安全性）：
python app.py --host 127.0.0.1
-
PaperPilot 支持通过 Web UI 直接进行配置。
在 Settings 标签页中配置：
- LLM 提供商：设置 API Key、Base URL 和模型名称（如 GPT-4, Qwen, DeepSeek）。
- MinerU：选择本地实例或云端 API。
配置您的研究关注点：
- 领域 (Categories)：选择需要监控的 ArXiv 分类。
- 关键词 (Keywords)：定义筛选和高亮的关键词。
- 计划任务：设置自动抓取的时间间隔。
- 多用户支持：当前版本 PaperPilot 专为个人或小团队设计，尚未完全支持多用户隔离（Multi-tenancy）。虽然支持通过 Supabase 进行鉴权，但所有用户共享同一套后台配置和论文库。建议在私有网络或受信任的环境中部署。
- BabelDOC 翻译：基于 BabelDOC 功能的中英文对照翻译功能内存开销较大，并且整个 AI 翻译过程较长，建议需要特别精读论文时使用。
欢迎提 Issue/PR 参与共建。Roadmap 会根据需求与资源动态调整。
- 阅读标注：高亮、批注、书签与引用片段一键复制
- 论文对话增强：回答可溯源到页码/段落/引用片段
- Daily ArXiv 规则升级：关键词组合、排除词、正则
- 部署与运维：Docker Compose、自动备份/恢复、健康检查
- 语义检索：本地 embedding 索引（可选向量库），支持跨库搜索
- 个人知识库：研究笔记/摘要沉淀成可查询的研究日志（主题/时间线）
- 任务队列与进度中心：翻译/解读/索引统一队列、重试与优先级
- 多用户隔离：按用户/团队隔离论文库与设置
- 论文推荐与关系图谱：基于引用网络与阅读行为的个性化推荐
- 协作工作区：共享文件夹、团队注释与权限控制
- 多模态理解：图表/公式/表格结构化提取与可检索
- 移动端/PWA：离线阅读、跨设备同步
- 更快的 PDF 渲染、分页缓存与长文档按需加载
- 全局搜索与索引增量更新（避免全量重扫）
- 配置校验与一键诊断（LLM/MinerU/BabelDOC 依赖检查）
- 统一日志与可观测性（任务耗时、失败原因统计）
本项目采用 CC BY-NC 4.0 许可证。详情请参阅 LICENSE 文件。