Lagrange Reader：Android 离线阅读器

项目简介

Lagrange Reader 是一款独立的 Android 阅读客户端，用于浏览、下载、阅读和收听托管在 BookOrbit、Komga 或 Kavita 服务器上的书籍。它并不是这些服务商的官方应用，而是社区项目。

服务器始终是书库数据的事实来源，Lagrange 只作为 Android 客户端：它自带 Compose 界面、基于 Room 的本地目录与缓存、离线下载、后台同步、基于 Readium 的阅读器以及 Media3 有声书播放，因此断网时仍可继续阅读和收听，恢复连接后再把排队的进度同步回服务器。

主要功能

• 离线优先书库：浏览已缓存书籍，随时重新打开已下载的 EPUB、PDF、CBZ 及支持的有声书文件。
• 双向同步：把本地阅读/收听进度上报服务器，接收服务器端的进度与状态变化，并在重连后重放离线期间排队的进度。
• EPUB 阅读：分页章节、主题、字号、独立边距、章节/页码导航、精确续读、常亮模式、按书库选择字体、导入自定义 .ttf/.otf 字体，以及支持句子高亮、0.5×–2× 速度与音调的 Android 文字转语音朗读。
• PDF 与漫画阅读：Readium 驱动的 PDF 与图片阅读器，支持全屏控制、翻页、断点续读，以及 CBZ 与在线 CBR 支持。
• 有声书播放：紧凑与完整播放器，支持拖动进度、章节切换、上一章/下一章、播放速度、睡眠定时、续播、横竖屏自适应布局与会话历史。
• 书库浏览：首页、书库、系列、作者、搜索、成就、本地书籍、筛选、排序与系列导航。
• 可靠的离线下载：进度显示、取消、重试/更新流程、缓存校验与安全的本地替换。
• 个性化设置：五种应用主题、阅读器主题、方向锁定、减弱动效、移动网络下载策略、缓存管理与后台网络控制。

支持的格式

MOBI、AZW、AZW3、FB2 目前不在支持范围内。

安装与使用

1. 安装最新的 Lagrange release。
2. 打开应用，选择 BookOrbit、Komga 或 Kavita，输入服务器地址（在家以外网络建议使用 HTTPS）。
3. 使用服务器管理员提供的账号登录。
4. 浏览书库、打开书籍，或在书籍详情页下载内容以便离线使用。

登录方式：BookOrbit 支持用户名/密码与 WebView 中的服务器托管 OIDC；Komga 支持 Basic Auth 与 WebView 中的 OAuth2/OIDC；Kavita 支持用户名/密码与 WebView 中的 OIDC。原生 OIDC/AppAuth 尚未实现。

注意事项

• 需要 Android 8.0（API 26）或更高版本的手机或平板。
• 本应用不是独立电子书阅读器，也不提供 BookOrbit、Komga 或 Kavita 服务器；没有服务器账号时请先搭建相应服务。
• 进度上传经过排队与节流，会受网络状况影响；跨设备的章节内位置可能只是近似值。
• 客户端不包含行为遥测、广告追踪、分析 SDK 或远程崩溃上报服务。

许可证：GPL-3.0。

本作品整理自 GitHub 开源项目 van-geaux/lagrange-reader，原作者 @van-geaux，许可证 GPL-3.0。中文介绍由 AI 根据项目 README 整理，以原仓库为准。