-legado-build

项目概述

阅读Shimmer 是一款面向重度电子书读者的 Android 阅读器。它沿用开源阅读（Legado）的书源体系与界面骨架，但把包名独立成 io.legado.app.shimmer，因此可以和 Legado、阅读 Archive 同时装在一台手机上。书源需要用户自行导入，应用不内置任何书籍内容，本地书支持 TXT 与 EPUB 两种格式。

项目	内容
平台	Android 7.0（API 24）及以上
包名	io.legado.app.shimmer
开发语言	Kotlin
版本号	以 epoch 分钟为单位的时间戳
许可	GPL-3.0

独立包名让它可以和原版 Legado 并存，书源、书架与阅读进度都能通过备份文件迁移过来。

主要功能

• 书源阅读：导入 Legado 格式书源，搜索、目录、正文与图片都走用户选定的站点
• 本地书库：直接读取 TXT 与 EPUB，EPUB 模式提供原生排版
• 高亮规则：导入本地 .red 规则文件，支持图案高亮、字体与页面 HTML/CSS/JavaScript 模板
• 听书：系统 TTS 与网络 TTS 双通道，提供跨应用悬浮控件，手动翻页时听书自动跳到当前页
• 书架管理：列表与网格视图、分组与标签、批量管理、目录定时更新
• 数据备份：本地备份与 WebDAV、对象存储备份分开处理，云端失败不中断本地备份
• 网络控制：DNS 与 DoH 可切换，支持按功能分流、域名例外与服务测速
• AI 辅助：可配置 AI 服务，用于书源搜索、书籍与章节读取、阅读记录查询

适用人群

• 需要与原版 Legado 并存使用的读者
• 自己维护书源、习惯手动导入源文件的用户
• 依赖 TTS 听书与跨应用悬浮控件的通勤读者
• 用 WebDAV 或多端备份的长期阅读者
• 想在该代码基础上二次开发的 Android 开发者

安装与迁移

新安装

1. 从 Releases 下载与机型架构匹配的 APK
2. 打开应用，在「书源管理」中导入书源文件
3. 把本地书放进手机存储，在书架页选择导入本地书籍

从旧版迁移

1. 在旧版应用中进入「备份与恢复」，导出完整备份，得到一个 .zip 文件
2. 安装阅读Shimmer，在同一入口选择该备份文件恢复
3. 核对书源、书架、阅读进度与阅读设置是否齐全
4. 确认无误后再卸载旧版，避免包名隔离导致数据找不回

系统要求

项目	要求
操作系统	Android 7.0（API 24）及以上
支持架构	arm64-v8a、armeabi-v7a
构建环境	JDK 17、Android SDK compileSdk 37
网络	在线书源需要联网，本地书可离线阅读

注意事项

• 包名隔离：新包名不会自动继承旧版数据，必须先导出备份再卸载
• API 下限：主界面渲染组件要求 API 24，Android 5.0 与 6.0 设备即使装上也无法正常显示
• EPUB 限制：普通正文的 EPUB 模式不启用段落规则与 pclick，图片 click 与替换净化仍可用
• 云备份账号：恢复备份后 WebDAV 需要重新填写账号，本地备份不受影响