开源、本地优先的电子书与论文阅读器。
藏书、论文、阅读进度和批注默认保存在自己的设备上；无需注册账号，本地阅读无需联网。
近期论文增强 · 安装教程 · 第一次使用 · 论文阅读 · 完整论文指南 · 问题反馈
如果 LightRead 对你有帮助，欢迎在 GitHub 点个 ⭐ Star，你的支持是项目持续更新的动力。
- 阅读常见电子书：EPUB、MOBI、AZW / AZW3、FB2 / FB2.zip、CBZ / CBR、DjVu、PDF、TXT、HTML、Markdown。
- 管理藏书与论文：本地导入、拖拽导入、分类标签、置顶、批量管理、阅读进度、书签与批注。
- 专业 PDF 阅读：MuPDF / PDFium 渲染可选（默认 MuPDF），支持清晰原版页面、连续滚动、单页 / 对页 / 书籍视图、自动阅读和听书。
- 论文精读：独立论文库、划词翻译、版式对照翻译、以 Pi Agent 为默认主路径的本机对话、带人工修订的论文十问和 BabelDOC 整本翻译；Codex 与 Claude Code 均为可选引擎。
- 找书和找论文：中文维基文库、Internet Archive 公开图书、古登堡计划、arXiv、GitHub、Open Library，以及 OPDS / Calibre。
- 听书：在线神经音色、本地离线模型和系统语音三种方式。
- 开放迁移：按 Google OKF v0.1 导入 / 导出
.okf.zip藏书包，可被其他 OKF 工具读取；另有 WebDAV 云备份和自定义书库存储位置。
本地阅读不需要账号或网络。书源下载、在线听书、AI、版本检查和 WebDAV 是可选联网功能；使用哪个服务由你自己决定。
最近几个版本持续强化 PDF 与论文精读，变化不只是增加按钮，而是把“清晰阅读 → 定位与批注 → 翻译 → Agent 深读 → 人工形成答案”串成了一条完整工作流。
| 版本 / 状态 | 增强 | 带来的实际变化 | 对应提交 |
|---|---|---|---|
| v1.1.10 | 本机论文 Agent 与人工修订论文十问 | 默认使用 Pi Agent；自动读取完整论文、笔记、当前页与选中文本。AI 初答、人工回答、AI 再答互不覆盖 | 22e5b6b |
| v1.1.9 | 连续页面无接缝 | 连续滚动时移除页面四周和页间的额外缝隙，横版与双栏论文阅读更连贯 | 404bc32 |
| v1.1.8 | PDF 适宽 / 适高贴合可视区域 | 缩放按 96 DPI 百分比语义与设备像素渲染，减少留白、模糊和彩色文字雾边 | 223691b |
| v1.1.7 | 论文翻译、BabelDOC 上下文与完整快捷键 | 强化版式对照翻译、术语上下文、PDF 搜索 / 保存 / 打开 / 缩放等键盘操作 | 867f93a |
v1.1.10 提供本机论文 Agent 与人工修订论文十问；v1.1.9 已包含无接缝连续阅读和此前的 PDF 渲染、翻译与快捷键增强。功能状态以本表为准。
不使用 Agent 时无需安装任何命令行工具。需要 Agent 时只安装并配置 Pi Agent 就可以完整使用对话与论文十问；Codex 和 Claude Code 是独立的可选增强，不会影响 Pi、论文翻译或普通阅读。详细能力、数据目录与排错方法见 论文阅读完整指南。
只从本项目的 GitHub Releases 下载。页面打开后，找到 Assets，按照自己的系统选择文件。
文件名中的 x.y.z 是版本号，例如 1.1.1。
| 你的设备 | 应下载的文件 | 说明 |
|---|---|---|
| Mac，Apple M 系列芯片 | LightRead_x.y.z_aarch64.dmg |
Apple Silicon 版 |
| Mac，Intel 处理器 | LightRead_x.y.z_x64.dmg |
Intel 版 |
| Windows 10 / 11，64 位 | LightRead_x.y.z_x64-setup.exe |
推荐的 Windows 安装程序 |
| Ubuntu / Debian，64 位 | LightRead_x.y.z_amd64.deb |
Debian 系安装包 |
| Fedora / RHEL，64 位 | LightRead-x.y.z-1.x86_64.rpm |
RPM 安装包 |
| 其他 64 位 Linux | LightRead_x.y.z_amd64.AppImage |
免安装便携版 |
| Android，arm64 | LightRead_vx.y.z_android_arm64.apk |
实验版本 |
不知道 Mac 是哪种处理器？点击左上角苹果菜单 → 关于本机：显示“芯片 Apple M…”就下载 aarch64.dmg，显示“处理器 Intel”就下载 x64.dmg。
- 下载对应的
.dmg文件并双击打开。 - 把 LightRead 拖到 Applications / 应用程序 文件夹。
- 到“应用程序”中打开 LightRead。
- 如果 macOS 提示无法验证开发者，先确认文件来自本仓库，然后右键 LightRead → 打开；仍被阻止时，进入“系统设置 → 隐私与安全性”，点击 仍要打开。
升级时再次打开新版 DMG，把 LightRead 拖进“应用程序”并选择替换即可，不需要先卸载旧版。
- 下载
LightRead_x.y.z_x64-setup.exe。 - 双击安装程序，按提示完成安装。
- 如果 SmartScreen 出现提示，先确认发布者文件来自本仓库，再点击“更多信息 → 仍要运行”。
- 从开始菜单打开 LightRead。
升级时直接运行新版安装程序覆盖安装，藏书和设置不会因为覆盖安装而删除。
Ubuntu / Debian 用户可以双击 .deb 安装，也可以在下载目录运行：
sudo apt install ./LightRead_x.y.z_amd64.debFedora / RHEL 用户：
sudo dnf install ./LightRead-x.y.z-1.x86_64.rpm使用 AppImage 时，先赋予执行权限再运行：
chmod +x LightRead_x.y.z_amd64.AppImage
./LightRead_x.y.z_amd64.AppImage请把命令里的 x.y.z 换成实际下载的版本号，也可以直接输入文件名前几个字母后按 Tab 自动补全。
- 下载
android_arm64.apk，在系统设置中允许浏览器或文件管理器“安装未知应用”。 - 打开 APK 完成安装。目前仅提供 arm64 架构，界面和交互仍在持续适配。
- 已安装旧版时先尝试覆盖安装。包名、签名必须与旧版匹配，且安装包版本不能更低；历史实验版签名不统一，不能保证所有旧版都能直接覆盖升级。
遇到“签名不一致”“应用冲突”时，先保留旧 App，不要卸载或清除数据。 确认备份可恢复后，再按下面的步骤迁移：
- 在旧版打开 设置 → 数据 → 藏书导入与导出 → 导出藏书包。
v1.1.18已有这个功能，导出的文件名类似lightread-library-日期.okf.zip。 - 用系统文件管理器找到这个 ZIP，确认文件非空且能正常打开，将它复制到公共“下载”目录、电脑或网盘等应用私有目录之外。仅看到“藏书包已导出”提示不代表文件一定保存成功：Android 的本地导出依赖 WebView 下载行为，部分设备可能不生成文件。最好先在另一台设备的 LightRead 中试导入，核对书籍、阅读进度和标注。
- 如果找不到 ZIP 或备份失败，继续保留旧 App。
v1.1.18也有 设置 → WebDAV 云备份 → 备份到云端，可配置已有的 WebDAV 网盘进行整库备份；在网盘中确认LightRead/lightread-backup.zip已更新，并下载一份到电脑核验。无法取得可恢复的备份时，不要卸载旧版。 - 确认应用外的备份完整后，才卸载发生签名冲突的旧版，安装新版。在新版 设置 → 数据 → 导入藏书包 选择已保存的 ZIP；使用 WebDAV 的用户也可重新填写原网盘地址与凭据，点击 从云端恢复。恢复前不要用新版空书库“备份到云端”覆盖旧备份。
- 检查藏书、论文、进度和标注是否恢复，保留备份文件。藏书包不是整台应用的快照：应用设置、登录信息、API 密钥、书源密码和论文 Agent 工作目录需要另行保留或重新配置。
- 导入书籍：进入左侧“藏书”，点击“导入书籍”，或者把文件直接拖进窗口。支持一次选择多个文件。
- 导入论文：进入左侧“论文”，点击“导入论文”；也可以在“书源 → arXiv”下载后直接阅读。
- 开始阅读：点击书籍或论文封面。阅读页顶部可以切换翻页 / 滚动、适高 / 适宽、双页、自动阅读和听书。
- 分类整理：在藏书或论文页点击“管理”，可批量设置标签、移动、置顶或删除。
- 设置存储与备份：进入“设置 → 数据”，可以更改书库位置、导入 / 导出开放的 OKF 藏书包，或配置 WebDAV。
桌面版安装后，还可以在系统文件管理器中右键 PDF、EPUB、MOBI、AZW、FB2、CBZ / CBR、DjVu、TXT、HTML、Markdown 等文件，选择 打开方式 → LightRead。如果希望以后都用 LightRead 打开，请勾选“始终使用”或在系统中设为默认应用。
导入的文件、封面、进度和批注默认进入 LightRead 的本地数据目录。需要自己管理文件位置时，可在“设置 → 数据 → 存储位置”选择一个专用文件夹。
“论文”是独立于普通藏书的工作区。把 PDF 导入“论文”后，会启用完整的论文精读功能；普通藏书中的 PDF 默认保持简洁阅读界面，也可以在管理模式中移入论文库。
- 连续阅读与清晰渲染：论文默认连续滚动和适宽显示，也可切换单页、对页或书籍视图。原版页面由 MuPDF 或 PDFium 按设备像素比绘制（默认 MuPDF），PDFium 提供文字选择、链接、目录、批注和文本分析。
- 划词工具：选择文字后可高亮、写想法、复制或 AI 翻译；标注可以集中查看并跳回原文。
- 引文与目录跳转：点击页内链接或目录后，可以一键回到刚才的阅读位置。
- AI 中文翻译：右侧支持“版式对照”和“段落列表”；滚动到哪一页就按需翻译哪一页，翻译结果会缓存。
- 本机论文 Agent（桌面端）：默认使用 Pi Agent；Codex、Claude Code 可按需选择但不要求安装。发送问题时，LightRead 自动准备完整 PDF 文本、笔记、当前页和选中文本；Agent 保留自身的工具、联网与审批能力，并可在共享工作区写文件。
- 论文十问：每一问分为不可覆盖的“AI 初答”、可人工编辑保存的“我的回答”和独立的“AI 再答”。点击“保存并让 AI 再答”时，人工版本会先持久化，再交给当前 Agent 重新阅读论文后完整回答。
- 整本重排版翻译：桌面端可选安装 BabelDOC，生成保持图表、公式和原版布局的中文版 / 双语版 PDF，并自动导入论文库。该功能需要额外安装约 700 MB 的模型和工具，并使用“设置 → AI 助手”中配置的个人模型服务；内置试用通道不支持 BabelDOC。
- arXiv：在“书源”里按分类浏览或搜索 arXiv，下载后直接进入本地阅读流程。
翻译不会在打开论文时自动消耗模型用量，只有点击翻译后才会请求已配置的 OpenAI 兼容服务。进入“设置 → AI 助手”可以选择内置限速试用通道，也可以配置硅基流动、智谱、千问、Kimi、豆包、本地 Ollama 或任意兼容接口。
- 按 Pi 官方说明 安装 Pi 0.78 或更高版本，并在 Pi 中配置自己使用的模型提供商。
- 打开 LightRead 的“设置 → 论文 Agent”，确认 Pi 显示为可用；桌面应用没有找到
pi时，可手动选择其可执行文件。 - 打开一篇论文，点击右上方 Agent。直接对话，或切到 论文十问 生成 AI 初答、编辑“我的回答”，再点击“保存并让 AI 再答”。
这条路径不需要安装 Codex 或 Claude Code。LightRead 不代为安装、登录或保存任何引擎凭据；Pi 使用自身的提供商与模型配置。Codex 使用自身登录；Claude Code 仅允许第三方 API 或企业认证，个人 claude.ai OAuth 不会被接入。不同引擎的会话独立，但共享同一论文工作区。
Agent 上下文保存在系统应用数据目录的 paper-agents/<论文 ID>/ 下，不随自定义书库位置迁移，也不包含在 OKF/WebDAV 备份中。current-paper 是由 LightRead 反复生成的只读副本（不是原论文的链接），用于防止误写；由于 Agent 仍以当前系统用户运行并保留完整能力，这不是防篡改沙箱。删除论文时，对话、论文十问人工回答和共享工作区会一起删除。
更完整的阅读模式、Agent 文件结构、引擎差异、隐私边界与排错说明见 论文阅读完整指南。
扫描版或纯图片 PDF 如果没有文本层，将无法进行文字选择、听书和 AI 文本分析；普通页面阅读不受影响。
-
翻页 / 滚动双模式，宽屏双栏，触屏点击和滑动翻页；翻页模式下上滑 / 下滑也可翻页，滚动模式则整本上下连续滑动。
-
白色、米黄、护眼绿、夜间四种主题；可调字号、行距、页边距和字体，并支持导入自定义字体。
-
全书检索支持多关键词、正则表达式、区分大小写和全词匹配。
-
四色划线、写想法、书签、目录定位和阅读时长统计。
-
普通阅读页也支持 AI 问答和划词解读，AI 服务为可选配置。
-
PDF 默认连续滚动并适宽显示，可切换适高、单页、对页和书籍视图。翻页模式下页面高于视口时先在页内上下滑动，滑到页尾再继续（滚轮、触屏或键盘）即翻到下一页，页首上翻则回到上一页页尾。
-
自动阅读会根据当前模式连续滚动或自动翻页，控制条可自动收起。
-
PDF 页面可在设置中选择 MuPDF 或 PDFium 渲染，默认使用 MuPDF；文字选择、目录、链接、搜索和标注由 PDFium 提供。页面始终保持原版 PDF 版式，不进行容易破坏公式与图表的正文重排。
-
桌面系统注册文件关联，可通过“打开方式”直接打开 PDF 和其他支持格式。
- 在线神经音色：微软 Edge 大声朗读音色，需要联网，不可用时自动回退。
- 本地离线模型：桌面版可下载约 310 MB 的 sherpa-onnx + Kokoro 语音包，提供 103 个中英音色。
- 系统语音：无需额外下载，音色数量和质量由操作系统决定。
- EPUB 会跟随朗读位置；带文本层的 PDF 支持逐页朗读和自动翻页；语速可调。
- 拖拽批量导入、本地文件导入、网页直链导入，自动读取标题、作者和封面。
- 统一搜索默认启用 GitHub 书库、中文维基文库、古登堡计划和 Internet Archive 公开图书，无需账号；可选 arXiv 和 Open Library 书目检索。
- 维基文库支持 EPUB 导出，Internet Archive 按需读取真实 EPUB / PDF / TXT 下载链接并导入。Open Library 结果标注公开阅读、需登录借阅或暂无电子版。
- 补充 Standard Ebooks、书格、Global Grey、Faded Page、Z-Library、Anna’s Archive 的浏览器入口；支持的站点可带关键词搜索。Z-Library / Anna’s Archive 可能有登录、验证、额度或等待要求，入口可用性取决于站点和网络。
- 网页版访问缺少跨域许可的来源需配置书源代理；维基文库等下载也可直接在浏览器完成，再导入文件。桌面版和 Android 使用原生网络请求；来源要求人机验证时，通过浏览器下载后导入。
- 支持 OPDS 以及带账号验证的 calibre-web。
- 桌面版可以直接连接本机 Calibre 书库文件夹，读取书目、作者和封面。
- 支持 HTTP / HTTPS / SOCKS4 / SOCKS5 网络代理。
.okf.zip藏书包包含藏书、论文、进度、标注和书源；采用开放的 Open Library OKF Profile，其他软件无需 LightRead SDK 即可实现读写。- 可选 WebDAV 备份，支持坚果云、Nextcloud、Alist 等服务；已有数据会增量合并。
GitHub 社区书源清单保存在 booksources.json。欢迎提交 PR 推荐合法、可直接下载书籍文件的公开仓库；不收录纯链接聚合、侵权内容或网盘跳转。
推荐使用应用内更新检查：
- 打开 LightRead，进入左下角 设置。
- 在 关于 区域点击 检查更新。
- 发现新版后，点击适合当前系统的下载按钮。桌面版会下载到系统“下载”文件夹并尝试打开安装包。
- macOS 将新版拖入“应用程序”并覆盖；Windows 运行新版安装程序；Linux 安装新版包或替换 AppImage。
- Android 在浏览器中下载 APK，再由系统安装器安装；包名、签名匹配且版本不降级时才能覆盖升级。若提示签名或应用冲突，先保留旧 App，按上方 Android（实验性） 的迁移步骤取得并验证应用目录外的备份，再处理旧版。
应用启动、返回前台和恢复联网时会检查更新。若新版本尚未提供当前平台的安装包，更新入口会打开发布页并提示等待，不会推荐其他系统的安装包。
也可以随时访问 GitHub 最新版本 手动下载。
桌面端覆盖安装不会删除藏书、论文、进度和设置。重要资料仍建议在更新前进入“设置 → 数据 → 导出藏书包”保存并核实一份 ZIP。不要为了升级而手动删除 LightRead 的应用数据目录。
先确认文件来自 github.com/yzfly/LightRead。macOS 请按上面的“右键打开 / 隐私与安全性”步骤操作；Windows 可在 SmartScreen 中查看“更多信息”；Linux AppImage 需要先添加执行权限。
这些功能需要网络。可以先到“设置 → AI 助手”测试模型连接，到“设置 → 网络”测试代理；本地阅读、书架、进度和批注不受影响。
扫描版通常只有图片，没有可选择的文字层。LightRead 可以正常显示页面，但文字相关功能需要 PDF 自带文本层；目前不内置 OCR。
不需要。不使用 Agent 时三个都不用安装；需要 Agent 时默认只安装 Pi 即可完成对话和论文十问。Codex 与 Claude Code 是可选引擎，缺失或未登录不会阻塞 Pi，也不会影响论文翻译、BabelDOC 或普通 PDF 阅读。Agent 目前仅在桌面版提供。
LightRead 会把原论文复制到独立的 current-paper 快照，并把 PDF、全文、笔记和上下文文件标记为只读；Agent 的正常写入位置是同级 workspace。原始 PDF 与批注数据库不直接交给 Agent 写入。只读属性主要防止误操作，并不是针对同一系统用户的安全沙箱。
不支持 KFX 和 DRM 加密文件。请先使用合法方式在 Calibre 等工具中转换为 EPUB、AZW3 或其他受支持格式。
需要 Node.js、Rust 工具链以及对应平台的 Tauri 2 构建依赖：
git clone https://github.com/yzfly/LightRead.git
cd LightRead
npm install
npm run tauri dev构建前端或桌面安装包：
npm run build
npm run tauri build核心结构：Vue 3 + TypeScript 负责界面，foliate-js 负责电子书，MuPDF / PDFium 负责可选的 PDF 页面渲染，PDFium 同时负责 PDF 交互和文本几何，Tauri 2 / Rust 提供桌面文件系统、SQLite、网络、本机 Agent 进程管理和其他本地能力。网页版可以通过 npm run build 生成，但桌面版才拥有文件关联、Calibre、本地离线语音、本机论文 Agent 和无跨域网络能力。
- 功能建议和问题反馈：GitHub Issues
- 作者：江树 / 云中江树
- 微信：1796060717（添加时请备注
LightRead） - 微信公众号：云中江树
欢迎提交 Issue、Pull Request 或新的合法书源。如果这个项目对你有帮助，也欢迎给仓库点一个 ⭐ Star。
GNU Affero General Public License v3.0 or later
LightRead 使用 AGPL 授权的 MuPDF，因此项目整体以 AGPL-3.0-or-later 发布。分发修改版或通过网络向用户提供修改版服务时，须依照协议提供对应源代码。
致谢：foliate-js (MIT) · MuPDF (AGPL-3.0-or-later) · PDFium (BSD-3-Clause) · BabelDOC · 截图书籍来自 古登堡计划