PaperQuay

中文 | English

开源 AI 论文工作台，覆盖 PDF 阅读、全文翻译、结构化概览、内联笔记、Zotero 导入、Agent 工作流和本地 RAG。

快速导航 | 为什么选择 PaperQuay | 当前功能 | 快速开始 | 本地开发

---

快速导航

问题与定位 | 近期更新 | 差异点 | 核心工作流 | 已完成功能 | 技术架构 | Zotero 兼容 | 待做计划

---

近期更新

v0.1.23 主要优化阅读器稳定性和日常使用体验：

• macOS 下改用系统左上角三色窗口按钮，并隐藏重复的自定义窗口控制按钮。
• 优化 PDF.js 文档清理流程，减少打开、切换和关闭论文时的旧 worker / 渲染任务报错。
• Agent RAG 回答支持可点击引用标签，可跳转到对应论文结构块或页面。
• 明确 RAG Top-K 设置含义，并为划词翻译和 PDF 段落翻译浮层提供独立开关。
• 优化侧边栏问答输入、多会话问答和 Agent 交互细节。

---

PaperQuay - 保持阅读心流的开源 AI 论文工作台

PaperQuay 不只是 PDF 阅读器、AI 总结工具，也不是 Zotero 的附属工具。 它是一款本地优先、开源免费的桌面端 AI 论文工作台，面向研究生、科研工作者和论文阅读重度用户，目标是在同一个应用中完成论文导入、PDF 阅读、AI 翻译、论文概览、内联阅读笔记、标签管理、Zotero 文献库导入、Agent 文献整理和本地 RAG 知识库构建。

传统论文阅读往往需要在 Zotero、PDF 阅读器、翻译工具、ChatGPT 和笔记软件之间频繁切换。PaperQuay 希望把导入、阅读、理解、翻译、批注、笔记、整理和知识库构建合并到一个连续的桌面端流程中，同时保留 Zotero 兼容能力，但不把 Zotero 作为必要依赖。

技术上，PaperQuay 主要基于 Electron + React + TypeScript/Vite 构建跨平台桌面端应用。React 渲染层负责文献库、PDF 阅读器、富文本笔记、Agent 工作区和设置界面；Electron 主进程与本地 Node.js 后端模块负责文件系统访问、IPC 通信、Zotero 导入、SQLite 持久化、应用更新和跨平台打包。PDF 阅读与渲染主要基于 PDF.js，富文本笔记基于 Tiptap/ProseMirror，本地数据使用 SQLite/sql.js 及 sqlite-vec 存储文献、笔记、阅读记录和 RAG 索引；AI 能力通过 OpenAI-compatible API 接入，用于论文概览、全文/划词翻译、Agent 工具调用和 RAG 检索增强问答。

科研工作流痛点	传统工具	PaperQuay
翻译延迟打断阅读	通常需要划词后等待 API 返回	可提前翻译 MinerU 结构块，阅读时瞬间跳转到缓存译文
左右对照影响专注	两栏来回扫视，格式也难以完全保持	保留原始 PDF，需要时跳转到精确对应译文
纯中文文件丢失原文语境	原文用词、术语和学术表达被隐藏	原文、结构块、译文、笔记和概览保持关联
论文笔记容易脱离上下文	笔记放在独立应用里，PDF 位置和文献关系丢失	富文本笔记、标签、双向链接、文献引用和反向链接写入本地文献库
大量论文速读繁琐	反复上传 PDF 给大模型，再手动整理结果	在本地文献库中生成并保存结构化论文概览
AI 模型选择受限	只能用内置模型或平台计费规则	支持自定义 OpenAI 兼容接口、模型和运行参数
大型文献库难维护	重命名、打标签、元数据和分类主要靠手动	Agent 可辅助批量重命名、元数据补全、打标签和分类
Zotero 迁移不方便	要么继续依赖 Zotero，要么手动重建	可选导入 Zotero 分类、标签和 PDF 附件

---

PaperQuay 有什么不同

动态流程演示：从文库浏览、打开论文、查看结构化阅读，到进入 Agent 工作区，整个过程都在同一个桌面工作流内完成。

块级瞬间跳转翻译

PaperQuay 使用更适合长时间论文阅读的翻译范式。它可以提前翻译并缓存 MinerU 解析出的结构块。之后阅读时，点击原文块即可快速跳转到对应译文，翻译不再必须发生在每次点击或划词之后。

基于 Tiptap 的笔记工作区

PaperQuay 内置独立的 Notes 工作区，编辑器基于 Tiptap。每篇笔记都会在本地保存 Tiptap JSON、渲染 HTML 和用于搜索的纯文本。编辑器支持标题、列表、任务列表、代码块、表格、图片、数学公式、高亮、链接、斜杠菜单式插入、文件夹、置顶、收藏、大纲、反向链接和本地自动保存。

笔记不是独立在文献库之外的孤岛。你可以用 [[笔记]] 连接想法，用 #标签 组织主题，用 @paper 引用文献，并通过这些内联引用在笔记和论文之间跳转，让阅读、摘录和后续整理保持在同一个研究工作流里。

论文速读概览页

PaperQuay 不只适合精读，也适合大批量速读筛选论文。在概览页中，每篇论文都可以直接展示由大模型生成的背景、研究问题、方法、实验设置、主要发现、结论和局限等信息。

阅读时间可视化

PaperQuay 会记录 PDF 不同位置的停留阅读时间，并在文献列表显示阅读热力预览，在文献详情面板显示独立的阅读时间图。你可以更直观地看到一篇论文哪些部分真正被读过、哪些部分还没有投入时间。

独立文献库，而不是只做导入

PaperQuay 可以独立建立本地文献库，支持 PDF 导入、默认文献存储文件夹、分类、标签、元数据编辑、搜索筛选、笔记和本地 SQLite 持久化。Zotero 仍然兼容，但只是可选导入来源。

面向文献管理的 Agent 操作

Agent 工作区不是普通聊天框，而是面向文献库操作设计。它可以辅助批量重命名、元数据补全、智能标签、标签清洗、自动分类和论文总结，并展示工具调用过程和执行结果，方便用户确认。

---

核心工作流

步骤	发生什么
1. 导入 PDF	将 PDF 拖入软件，或从导入窗口选择文件。
2. 确认元数据	检查标题、作者、年份、期刊/会议、DOI、摘要、关键词和重复提示。
3. 整理文献库	创建分类，将论文拖入分类，添加标签并标记收藏。
4. MinerU 解析	将 PDF 转成结构化块，并建立页面区域关联。
5. 生成论文概览	保存可复用的论文速读结果，便于后续筛选和回顾。
6. 全文翻译	缓存翻译后的结构块，让阅读时可以瞬间切换原文与译文。
7. 阅读与批注	高亮、写字、添加笔记、跳转批注，并导出批注后的 PDF。
8. 查看阅读时间	通过阅读时间图和热力预览查看 PDF 不同位置的累计阅读投入。
9. 写笔记	创建 Tiptap 富文本笔记，用文件夹整理，用 [[标题]] 连接笔记，用 #标签 组织主题，并通过 @paper 跳转文献。
10. 使用 Agent	让 Agent 对选中文献执行重命名、分类、打标签、补全元数据或总结。

---

PaperQuay 截图

主文库界面：在同一个桌面视图中管理论文、分类、元数据、阅读进度、笔记和 AI 生成的概览。

Agent 工作区：与论文助手对话、查看执行轨迹、审查工具调用，并在确认后执行批量文库操作。

---

已完成功能

下面是当前桌面端已经落地的能力。

模块	已完成能力
本地文献库	使用本地 SQLite 保存论文、作者、分类、标签、附件、笔记、批注、导入记录、设置和 RAG 索引
PDF 导入	支持文件选择器和拖拽导入，入库前进入导入确认窗口
文件管理	支持文献存储文件夹、复制/移动/保留原路径、命名规则、原始路径记录和本地私有文件管理
元数据	支持通过 DOI 或标题优先调用 OpenAlex 补全，可配置 OpenAlex API Key / mailto，Crossref 兜底，导入前可手动编辑
分类树	支持系统分类、自定义分类、子分类、折叠、右键菜单、拖拽排序、层级调整和收藏
文献详情	支持标题、作者、年份、期刊/会议、DOI、URL、摘要、关键词、标签、笔记、引用、收藏和阅读时间图
笔记工作区	支持独立 Tiptap 笔记工作区、文件夹、搜索、标签、置顶、收藏、大纲、反向链接和本地自动保存
笔记编辑器	支持富文本、标题、列表、任务列表、代码块、表格、图片、数学公式、高亮、链接、组件块和斜杠菜单式插入
内联笔记链接	支持 [[笔记]] 双向链接、#标签、@paper 文献引用、补全菜单，以及笔记和文献之间的内联跳转
阅读器	支持 PDF 阅读、MinerU 结构块视图、PDF 区域联动、阅读热力进度、阅读时间记录和批注工具
翻译	支持全文翻译、块级翻译缓存和划词翻译，模型使用 OpenAI 兼容接口
论文概览	支持背景、研究问题、方法、实验设置、主要发现、结论和局限等速读概览字段
Agent 工作区	支持对话、执行轨迹、工具调用卡片、文献选择、元数据工具、重命名、打标签、分类和总结
Zotero 导入	支持从 zotero.sqlite 导入 Zotero 分类、标签和可用 PDF 附件
备份	支持通过 WebDAV 备份和恢复文献库数据库、笔记数据库和本地 RAG SQLite 数据库
软件更新	支持应用内检查更新、Windows 和 Linux 自动更新流程，以及 macOS 打开发布页手动下载
主题	支持浅色和深色主题，面向桌面端长时间阅读优化

---

第一次使用流程

1. 打开设置，选择默认文献存储文件夹。
2. 通过拖拽或导入按钮添加 PDF。
3. 在导入确认窗口中检查或修改元数据。
4. PaperQuay 会复制 PDF 到文献库存储文件夹，并写入本地文献库。
5. 在左侧创建分类和子分类。
6. 将文献拖入分类，添加标签，标记收藏，然后打开阅读。
7. 打开 Notes 工作区，创建富文本笔记、连接相关想法，并把笔记和文献关联起来。
8. 如需 AI 功能，在设置中配置 OpenAI 兼容接口和模型。
9. 如需 MinerU 解析，在设置中配置 MinerU API key。
10. 如果已有 Zotero 文库，可以在设置中选择 Zotero 数据目录并导入分类和 PDF。

---

技术架构

PaperQuay 使用 Electron 作为桌面宿主。React 渲染进程通过 IPC 调用本地 Electron 后端，用于文件系统访问、本地持久化、Zotero 导入、PDF 处理和打包。

路径	职责
src/	React + TypeScript 前端界面、功能模块、状态和服务层
src/features/literature/	本地文献库、导入流程、分类树和文献详情
src/features/reader/	阅读器外壳、联动阅读工作区、设置和 AI 阅读动作
src/features/pdf/	PDF 渲染、覆盖层、批注表面和 PDF 交互
src/features/blocks/	MinerU 块渲染和结构化内容视图
src/features/agent/	Agent 对话界面、执行轨迹、工具卡片和文献库操作入口
src/features/notes/	基于 Tiptap 的笔记工作区、编辑器工具栏、自定义补全扩展、大纲和反向链接
src/stores/useNotesStore.ts	笔记、标签、当前笔记、自动保存和工作区错误状态管理
src/services/	前端到 Electron IPC commands 的调用封装
src/platform/electron/	渲染进程侧的命令、事件、窗口控制和文件拖放桥接封装
electron/	Electron 主进程、preload 桥接、命令后端、打包辅助和本地持久化

笔记编辑器使用官方 Tiptap 包实现，并参考了上游仓库 ueberdosis/tiptap 的源码。本地的 WikiLink、HashTag 和 PaperReference 扩展沿用了官方 Mention 节点和 @tiptap/suggestion 插件的架构：由 Tiptap inline node 保存结构化属性，由 Suggestion 插件负责匹配、渲染、键盘导航和插入。编辑器的组件块也参考了 Tiptap 官方 React NodeView 示例：自定义块是通过 ReactNodeViewRenderer 渲染的真实 Tiptap 节点，并用 NodeViewWrapper 和 NodeViewContent 分离不可编辑控件和可编辑内容。

---

环境要求

• Node.js 18 或更高版本
• Windows、macOS 或 Linux

可选外部服务：

• MinerU API key：用于云端 PDF 结构解析。
• OpenAI 兼容 API key：用于论文概览、翻译、问答和 Agent。
• 网络连接：用于 OpenAlex 和 Crossref 元数据补全。
• 可选 OpenAlex Premium API key 和 mailto polite-pool 邮箱：用于更稳定的批量元数据查询。

---

本地开发

安装依赖：

npm install

启动桌面开发模式：

npm run dev

只构建前端：

npm run build

预览构建后的 Web 资源：

npm run preview

构建桌面安装包：

npm run electron:build

---

Zotero 兼容

PaperQuay 可以读取包含 zotero.sqlite 的 Zotero 本地数据目录。导入时会将 Zotero 数据库复制到临时只读工作文件中读取，不会修改 Zotero 原始数据库。

导入结果会进入 PaperQuay 自己的本地文献库。Zotero collections 会变成本地分类，分类下可访问的本地 PDF 会复制到 PaperQuay 的文献存储文件夹中。

Zotero 是 PaperQuay 的兼容来源之一，不是必要依赖。你可以完全不使用 Zotero，直接在 PaperQuay 中建立自己的文献库。

---

数据与隐私

PaperQuay 是本地优先。文献库、笔记和本地 RAG 索引保存在 SQLite 数据库，导入的 PDF 保存到你配置的文献存储文件夹中。

可选 WebDAV 备份会把本地文献库、笔记和 RAG 数据库上传到你配置的远端服务。API key、本地 PDF、解析产物和备份文件都不应该进入源码仓库。

不要提交本地数据、API key、PDF、解析结果、笔记数据库或备份文件。当前 .gitignore 已默认排除运行时目录、SQLite 数据库、旧版 JSON 文献库数据、API key 文件、构建产物、备份包和私人 PDF。

---

待做计划

下面这些是还没完全落地、或需要继续深化的方向；已经实现的笔记、阅读时间图、WebDAV 备份和软件更新能力已放在“当前功能”中。

• 从 PDF 首页提取更稳定的元数据。
• 增加 DOI / arXiv / Semantic Scholar 补全来源。
• 深化 PDF 区域、批注和独立笔记之间的双向绑定。
• 增加引用格式生成和导出。
• 增加文件夹监听和自动导入队列。
• 增加跨论文和笔记的 RAG 知识库问答。
• 支持一键生成综述、Word / LaTeX 草稿等研究写作能力。
• 完善签名后的 macOS 发布流程，让安装和更新检查更顺畅。
• 本地优先模型稳定后，再考虑可选云同步。

---

致谢

PaperQuay 的不少设计与打磨，也受到 LinuxDo 社区 讨论、反馈和想法的启发。

PaperQuay 的笔记工作区构建在 Tiptap 之上。感谢 Tiptap 维护者提供可扩展的编辑器框架与示例，支撑 PaperQuay 的笔记体验。

---

许可证

PaperQuay Community Edition 使用 AGPL-3.0-only 许可证。

如果你分发修改后的版本，或把修改后的版本作为网络服务提供给用户，需要保留许可证和版权声明，说明修改内容，并按 AGPL 要求提供对应源代码。闭源商业授权、商业支持或品牌名称使用许可需要与维护者另行协商。品牌使用说明见 TRADEMARKS.md。