Android 本地漫画 / 小说阅读器 — 压缩包直读、本地与远程书库（WebDAV / Google Drive），专注干净、纯粹的阅读体验。
English | 简体中文
| 类别 | 格式 | 说明 |
|---|---|---|
| 漫画 | ZIP / CBZ · RAR / CBR · 7Z / CB7 · TAR / CBT | 压缩包直接读取，不预先解压、不占额外空间 |
| 电子书 | PDF · EPUB · MOBI · AZW3 / KF8 | 分页阅读 |
| 小说 | TXT | 自动章节识别 + 排版引擎 |
| 图片 | 文件夹 | 直接以图片目录为书 |
| PDF 合集 | 文件夹 | 同一子文件夹里的多个 PDF 合成一本，每个 PDF 为一章 |
- 本地仓库：把任意本地文件夹添加为仓库并扫描入库，支持多个仓库并存；
- 远程仓库：
- WebDAV — 坚果云、Alist、InfiniCLOUD 等均可接入；
- Google Drive — OAuth 授权（仅申请只读权限），ZIP / 7Z / TAR 流式翻页即时加载，RAR / PDF 首次打开自动下载缓存；
- PDF 合集：本地仓库子文件夹里有 2 个及以上 PDF 时，整个文件夹入库为一本书，每个 PDF 为一章（按文件名排序）；仓库根目录的 PDF 仍各自成书，可在「配置仓库」中按仓库关闭；
- 整理：分组、收藏、阅读历史、书签集中管理；
- BUG 反馈：「设置 → BUG 反馈」填写问题描述即可上传运行日志，成功后得到编号（自动复制），发给作者即可定位问题；
- 多选：长按封面后松手（或三点菜单「多选」）进入多选，批量转移书架、收藏 / 取消收藏、删除阅读记录、删除；
- 封面：自动提取压缩包内封面图，支持指定封面文件名；
- 书卡布局：首页及书籍列表手机端每行三张封面，屏幕宽度超过 1120dp 时四张；封面右下显示整数阅读进度，未读书显示
0%； - 书架布局：可在木质书柜和网格视图间切换，布局选择会被保存；
- 阅读统计与打卡：书架页「阅读统计」查看累计时长 / 字数 / 页数与日均；每天阅读满 5 分钟自动打卡，连续 3 / 7 / 30 / 100 / 365 天解锁铜 / 银 / 金 / 紫晶 / 彩虹徽章与同名封面边框，阅读器工具栏显示「今日 N 分钟」，数据仅存本机；
- 宽屏导航：宽度达到 800dp 后显示可折叠侧栏，阅读器使用全宽；手机保留首页／书架底栏；
- 外观：设置提供八种强调色，以及跟随系统、浅色、深色三种主题模式；
- 书籍详情页：目录、页数、阅读进度一目了然。
- 翻页模式：左右翻页 / 上下滚动（适合文字小说）；
- 漫画方向：西式（从左到右）/ 日漫（从右到左）；
- 手势：点击两侧翻页（可关闭）、双击缩放、捏合缩放；
- 显示：亮度调节（可调得比系统最低亮度更暗，适合夜间阅读）、屏幕常亮、锁定屏幕方向（跟随系统 / 竖屏 / 横屏）；
- 阅读背景：纯黑 / 深灰 / 护眼黄 / 纯白；
- 图片缩放：适合屏幕 / 适合宽度；
- 小说排版：字号、字重、行距、四向边距、字间距、首行缩进、每章自动另起一页；
- 字体：内置霞鹜文楷 / MiSans / 朱雀仿宋，支持导入自定义字体（ttf / otf / ttc）；
- 目录、书签、阅读进度记忆、文字复制。
- 「打开方式」：从文件管理器 / MT 管理器 / QQ / 微信等直接以 XY-READER 打开 zip / cbz / cbr / 7z / tar / pdf / epub / mobi / txt 等文件；
- 分享导入：从任意应用把文件分享到 XY-READER，直接入库开始阅读。
前往 Releases 页面，下载最新的 XY-READER-<版本>.apk 安装。
- 系统要求：Android 8.0（API 26） 及以上；
- Releases 页面提供的 APK 使用正式签名。同签名版本可直接覆盖升级；签名不同的安装包不能覆盖，需先卸载旧版，卸载会清除本地应用数据。
需要 JDK 17 与 Android SDK（compileSdk 36）：
# 单元测试
./gradlew :app:testDebugUnitTest
# 构建 Release APK
# 产物：app/build/outputs/apk/release/app-release.apk
./gradlew :app:assembleRelease仓库中的 outputs/ 目录不入库（APK 可由源码随时重建）；CI（GitHub Actions）在每次 push 到 main 后自动执行测试与打包，可在 Actions 页面下载产物。
本地构建 Release APK 时，若未配置正式签名，构建会回退到 debug 签名。
- 在
app/build.gradle.kts中升级appVersionName与versionCode； - （可选）编写
docs/release-notes/v<版本>.md作为本次更新说明； - 合并到
main； - 打开 Actions →「发布新版本」 → Run workflow。
完成后会自动运行测试、使用正式签名打包，并生成 tag、Release 与签名 APK，App 内置更新器即可检测到新版本。
- 进入「书架」页，点右上角「添加仓库」，打开本地仓库管理；
- 在本地仓库页点「添加」，通过系统文件选择器选择文件夹并扫描入库；
- 可以多次添加不同文件夹，作为多个仓库并存管理；
- 子文件夹里有多个 PDF 时会合成一本「PDF 合集」（每个 PDF 一章）；不需要时在本地仓库页 → 三点菜单 → 配置仓库，关闭「同文件夹 PDF 合并为一本书」后刷新仓库。
- 在首页 / 书架点击封面进入书籍详情，查看目录、页数和阅读进度，再选择继续阅读或从头开始；右下角的「开始阅读」悬浮菜单支持快捷阅读；
- 阅读中点击屏幕中间呼出工具栏：目录、书签、亮度、排版、复制文字等；
- 左右翻页模式下，点击屏幕两侧翻页（可在设置中关闭）；双击或捏合可缩放漫画页面；
- 批量整理：在首页、分组页或「全部 / 收藏 / 历史」列表中长按封面后松手进入多选（长按并拖动仍是排序 / 移组），勾选后从底部操作栏转移书架、收藏、删除阅读记录或删除，返回键退出多选。
从阅读工具栏进入，或「设置 → 阅读配置管理」。配置分为三组：
- 翻页模式：左右翻页 / 上下滚动、漫画方向、屏幕方向；
- 页面：背景色、亮度、图片缩放、点击翻页、双击缩放、屏幕常亮；
- 字体（文字小说专用）：字体、字号、字重、行距、边距、字间距、首行缩进、章首另起一页，以及导入自定义字体。
- 打开「设置 → 远程仓库」，点页面内的「添加 WebDAV 配置」按钮（空列表时显示「添加 WebDAV」）；
- 填写服务器地址与账号密码。例：坚果云使用
https://dav.jianguoyun.com/dav/，密码处需填应用密码（坚果云：账户信息 → 安全选项 → 添加应用密码），而不是登录密码。Alist、InfiniCLOUD 等同类服务配置方式一致； - 点「测试连接」确认连通后保存，然后「扫描」即可把云端书籍入库。
- 按 GOOGLE_DRIVE_SETUP.md 的指引，在你自己的 Google Cloud 控制台创建一个 OAuth 客户端（桌面应用类型，约 10 分钟，只需一次）；
- 打开「设置 → Google Drive (beta)」，点页面内的「添加 Google Drive 账号」按钮（空列表时显示「添加账号」），填入名称、Client ID、Client Secret（可选填目标文件夹 ID，不填则扫描整个 My Drive）；
- 点「授权并保存」，在浏览器中完成授权（仅申请只读权限），回到 App 点「扫描」入库。
- 文件管理器 / MT 管理器：长按或直接选择文件 → 打开方式 → XY-READER；
- 其他应用内：分享 → XY-READER；
- 也适用于直接在压缩包管理器中打开压缩包内文件。
- 软件默认不上传任何数据：无广告、无统计埋点；联网仅用于你配置的远程仓库、检查更新，以及你主动提交的 BUG 反馈；
- BUG 反馈只在你于「设置 → BUG 反馈」填写问题描述并提交时，上传问题描述、版本与设备信息和本地运行日志（已去除密码、令牌与链接参数）到作者的私有 GitHub 仓库；
- 书库数据、阅读进度、书签、阅读时长与打卡记录等全部保存在本机；
- 远程仓库（WebDAV / Google Drive）的地址与凭据仅存储在本机；
- Google Drive 授权仅申请
drive.readonly（只读）权限，软件无法修改你网盘中的任何内容。
完整隐私政策见 PRIVACY.md（应用内「设置 → 隐私政策」同文）。
| 组件 | 用途 | 许可证 |
|---|---|---|
| Jetpack Compose / AndroidX | UI 与基础框架 | Apache-2.0 |
| Kotlin | 开发语言 | Apache-2.0 |
| Room | 本地数据库 | Apache-2.0 |
| Coil | 封面图片加载 | Apache-2.0 |
| OkHttp | 网络请求（WebDAV / Range 流式读取） | Apache-2.0 |
| Apache Commons Compress | ZIP / 7Z / TAR 解析 | Apache-2.0 |
| junrar | RAR 解压 | UnRAR License（仅用于解压 RAR，不用于创建压缩包） |
| 字体 | 来源 | 许可 |
|---|---|---|
| 霞鹜文楷 Lite | LXGW WenKai | SIL OFL 1.1 |
| MiSans | © 小米科技 | 小米字体许可（免费商用） |
| 朱雀仿宋 | 璇玑造字 | SIL OFL 1.1 |
字体文件随 APK 打包分发；用户导入的自定义字体仅存于本机，版权归字体作者所有。
本项目的部分设计（章节分页、阅读器交互行为等）参考了以下开源项目的公开实现思路，在此致谢：
- 本软件是一款纯粹的本地 / 私人存储阅读工具，不提供、不内置、不托管任何书源、漫画或小说内容；
- 你通过本软件打开的全部内容均来自你自己的设备或个人网络存储，其版权归原作者及版权方所有；
- 请确保你使用本软件访问的内容来源合法；因使用本软件引起的任何版权纠纷或法律责任，由使用者自行承担；
- 本软件按「现状」（AS IS）提供，不对可用性、可靠性作任何明示或暗示的担保；因使用本软件造成的任何数据丢失或其他损失，作者不承担责任；
- 如果你喜欢某部作品，请支持正版。