Resophy：AI加持的开源论文阅读器，让文献阅读效率翻倍

Resophy是一款基于HTML开发的开源AI论文阅读器，依托HTML+JavaScript+Python Flask轻量技术栈打造，主打AI翻译、论文分析、arXiv每日推荐等功能，采用Vibe Coding开发理念，能让用户自定义功能。Resophy能解决科研人员海量论文阅读效率低的痛点，支持论文解析、智能翻译和个性化推荐，支持MinerU官方云API，无需部署本地服务器，无GPU也能使用AI解析功能。

Resophy采用前后端分离的架构设计，核心服务与AI服务可分开部署，能将主服务和AI服务器部署在不同设备上，适配不同使用场景，依赖管理则通过uv实现。

1、主服务（Resophy Core）：由HTML+JavaScript做前端、Python Flask做后端，负责论文管理、分类、检索等核心基础功能。

2、AI服务（可选部署）

• LLM Server：提供大模型推理能力，支撑AI翻译、论文解析、arXiv论文分析等功能，支持本地部署或调用远程API。

• MinerU Server：实现PDF转Markdown的文档解析服务，是AI功能的基础支撑，可本地部署也可调用云API。

Resophy 能在 Windows、Mac、Linux 系统部署使用，具体安装配置请参考对应的安装指南。

使用Resophy的核心步骤分为初始配置和功能使用两部分，完成简单配置后，就能使用论文管理、AI翻译等全部功能。

首次使用需进入设置界面完成基础配置，涵盖用户个性化、AI功能、arXiv推荐、Zotero导入四大模块，所有配置项操作简单，支持即时保存和连接测试。

Resophy 配置

• LLM API配置：需输入模型名、基础URL、API密钥，支持所有OpenAI兼容接口，配置后可测试连接有效性。

• MinerU配置：分「本地部署」和「云API」两种模式，本地部署需输入服务器地址，云API仅需输入MinerU官网令牌。

• Zotero导入：支持自定义导入目录，会自动统计导入成功、失败、重复数量，可实时查看导入进度。

Resophy 基础操作

完成配置后，就能进行论文上传、管理、查看等基础操作，支持多种上传方式和精细化的论文信息管理。

1、论文上传：可直接拖拽PDF文件至上传区，也可输入arXiv论文URL，系统会自动从文件名或PDF元数据中提取arXiv ID，完成信息匹配。

2、分类管理：左侧分类树可创建、重命名、删除分类，能自由移动论文至不同分类，方便按研究方向整理。

3、全文检索：顶部搜索框支持按标题、作者、摘要检索论文，快速定位目标文献。

4、论文查看：点击论文卡片进入详情页，可查看元数据、摘要，点击「View PDF」打开专属PDF阅读器，自动记录阅读时间。

5、元数据管理：可编辑论文标题、作者、摘要等信息，添加笔记和标签，管理BibTeX引用格式，还能添加GitHub、项目主页等关联链接。

6、数据导出：支持将论文库以JSON格式导出，包含元数据和分类结构，方便数据备份和迁移。

自动元数据检索

上传论文时，系统会自动调用接口获取精准元数据：通过arXiv API获取标题、作者、摘要等基础信息，通过DBLP API获取BibTeX引用格式。若DBLP检索成功则使用其格式，否则使用arXiv默认格式，无需手动编辑论文基础信息。

Resophy的核心价值在于AI加持的功能，从双语翻译到深度解析，再到arXiv论文的智能筛选，全方位解决论文阅读的痛点。

AI翻译功能

基于Babeldoc工具实现PDF双语翻译，支持所有OpenAI兼容大模型，翻译后生成专属双语PDF文件（.zh.dual.pdf），原版内容与中文译文左右对照展示，无需切换文件。

使用步骤：主界面选中论文，点击「AI Translation」按钮，系统在后台执行翻译任务，完成后可在论文详情页查看双语PDF。

AI解析功能

采用「PDF转Markdown+大模型深度分析」两步法，精准解析论文结构和核心观点，支持自定义提示词控制解析风格。

1、PDF转Markdown：通过MinerU工具将PDF解析为结构化Markdown，保留图片、表格等元素，支持本地部署和云API两种模式。

2、大模型解析：将Markdown内容输入大模型，结合自定义System Prompt，生成包含摘要、研究方法、实验结果、结论的结构化解析报告。

使用步骤：选中论文点击「AI Interpretation」，在「解析任务」页面查看进度，完成后进入解析视图查看详细分析内容。

每日arXiv功能

自动爬取指定分类的arXiv最新论文，通过AI完成机构提取、摘要总结、关键词筛选，过滤无关信息，只推送相关研究内容。

1、智能爬取：通过Python的arxiv库爬取指定分类论文，支持定时自动检查（间隔5-60分钟可配置），自动清理过期论文（保留1-30天可配置）。

2、AI分析：提取论文作者机构及所属国家、项目主页/GitHub地址。将英文摘要生成长度100-200字的中文摘要。从预设列表中提取1-3个核心关键词。

3、智能筛选：根据配置的关键词列表和机构信息过滤论文，支持机构名称标准化和缩写识别，精准匹配研究方向。

使用步骤：配置好分类和筛选规则后，点击「Daily arXiv」按钮，系统自动爬取、分析论文，可直接批量导入至阅读列表。

五、Vibe Coding：零门槛自定义功能

Resophy独创Vibe Coding开发理念，无需深入理解复杂的代码结构，只需通过自然语言向AI Coding Agent描述需求，就能轻松定制、扩展功能，打造专属论文阅读器。

功能定制

1、让AI理解代码库：向Coding Agent发送提示词Please understand the functionality of this paper reading platform，AI会自动分析整个项目的架构、核心功能、代码组织和设计风格，建立全面的认知。

2、描述需求：直接用自然语言说明想要实现的功能，AI会按照项目现有代码风格完成开发，无需编写代码。

提示词编写技巧

向AI描述需求时，建议包含功能描述、操作方式、界面位置、数据存储、特殊要求，让AI更精准理解需求，示例优质提示词：

为我添加深色模式功能：

1、右上角导航栏（头像按钮旁）添加月亮图标按钮

2、点击切换为深色主题，图标变为太阳。再次点击切回浅色

3、保存用户偏好，页面刷新后自动恢复

4、深色主题适配所有界面元素（导航栏、侧边栏、论文卡片、设置页）

常见定制示例

可根据自身需求定制各类功能，以下是常用的定制方向和对应的提示词示例：

定制注意事项

1、AI会自动遵循项目现有代码风格，保证代码一致性。

2、新增功能后建议手动测试，确保功能正常运行。

3、修改核心功能时，检查是否影响现有功能的使用。

4、对可能影响数据的功能定制，提前备份papers/目录。