用 Material Design 3 重做安卓阅读器的界面(legado-with-MD3)
legado-with-MD3 是开源阅读 App「阅读」的 Material Design 3 重构分支,用 Kotlin 写成,支持本地 TXT、EPUB 阅读与自行导入书源规则。这篇梳理它的下载途径、可调项、阅读记录与同步能力,并把主题不兼容、Android 12 以下功能受限、当前仍是测试版这些前提讲清楚,帮安卓用户判断要不要从官方版换过来。
安卓上用「阅读」(legado)看本地书的人不少,这个开源项目的书源规则能把网页内容抓下来重新排版,界面却长期停在传统 View 风格。legado-with-MD3 是围绕界面重做的分支,作者换掉了整套主题系统,按 Material Design 3 重画界面,同时把代码逐步迁往 Jetpack Compose。
legado-with-MD3 是基于开源项目「阅读」重做的 Material Design 3 版本,用 Kotlin 写成,读取本地 TXT、EPUB 与用户自行导入的书源规则,输出排版后的阅读界面与阅读记录。
它面向已经在用「阅读」、希望界面更现代的安卓用户,平板用户与需要漫画、有声书界面的人也在其中。仓库在 https://github.com/HapeLee/legado-with-MD3,许可证 GPL-3.0,主要语言 Kotlin(占 92.9%),当前 Star 6433、Fork 729、开放 Issue 90 个。
第一次用它需要知道的事
- 它是 Android 应用,仓库给的是 Kotlin 源码工程(Kotlin 占 92.9%),不是拿来就跑的命令行工具。根目录有 gradlew、gradlew.bat、build.gradle.kts、settings.gradle、gradle.properties,但仓库里没写详细的自编译步骤。
- 主题与官方版本不兼容。README 用醒目提示写明:因为用 Monet 引擎重构了主题系统,官方版本的主题在这个版本里不再可用。
- Android 12 以下设备暂时无法使用自定义主题与动态取色。README 说这个限制要等 Jetpack Compose 迁移完成才会解决,而迁移会持续较长时间。
- 软件本身不带内容与规则。用户协议写明默认状态下不预置、不内置、不提供任何第三方网站内容、数据资源或解析规则,书源要用户自己创建、编辑或导入。
- 当前发布状态是测试版。最近一次发布为 3.26.16-beta.46(2026-10-10),发布说明自己标注「此版本为测试版,会存在不稳定问题」,下载走 GitHub Releases 或 Telegram 群组。
最短上手路径
- 到 GitHub Releases 页面(https://github.com/HapeLee/legado-with-MD3/releases)下载 APK,或从 Telegram 群组取最新版,README 说明新版本会自动发布到群组。
- 在 Android 设备上安装。仓库没有说明最低支持的 Android 版本,只说明 Android 12 以下用不了自定义主题与动态取色。
- 打开应用,导入自己准备的书源规则。仓库说明了软件不预置规则,却没有给出规则导入的操作步骤。
- 把本地 TXT 或 EPUB 加入书架,README 提到支持智能扫描本地文件。
- 进阅读界面调好排版与翻页模式,之后在阅读记录里翻时间轴与章节维度的统计。
它实际上能做哪些事
阅读与排版
- 本地 TXT、EPUB 阅读,支持智能扫描本地文件。仓库的格式清单只写到这两种。
- 排版自定义:切换字体、背景、行距、段距、加粗、简繁转换。仓库没有给出这些选项的默认值与取值范围。
- 翻页模式可选覆盖、仿真、滑动、滚动。
- 净化替换:去除广告、替换正文内容。规则要用户自己写,能拦下什么取决于规则本身。
界面与交互
- Material Design 3 主题,支持预测性返回手势与共享元素动画。
- 书架布局有更多样式可选,平板端做了专门优化;另新增书籍备注、智能伴生分组(自动归类已读与未读),并支持用手柄上下翻页。
记录、朗读与数据同步
- 阅读记录提供时间轴与章节维度统计,发布说明里也提到本地书的阅读记录。
- 有声书与朗读:发布说明提到朗读音色要写进绑定、音色池要写进本书记忆;AI 供应商支持自定义请求头,流式回包中途取消的问题也做过修复。
- 备份与同步:用户协议说明部分网络与存储权限只用于用户主动启用的本地备份、WebDAV 同步或跨设备数据同步。
参数速查
这个项目是安卓应用,没有命令行参数。可调项都散在界面设置里,仓库文档没有列出每一项的默认值或上下限,下面按类别整理。
- 排版:字体、背景、行距、段距、加粗、简繁转换。
- 翻页:覆盖、仿真、滑动、滚动四种模式。
- 阅读记录展示:时间轴、章节维度。
- 书源规则:自行创建、编辑或导入,规则内容决定能解析哪些网页内容,合法性与适用性由用户判断。
- AI 供应商:可自定义请求头(3.26.16-beta.45 的更新内容)。
- 同步:本地备份、WebDAV、跨设备同步,均由用户主动启用。
- 主题取色:走 Monet 引擎,Android 12 以下没有这一项。
输出与结果位置
- 阅读内容与进度在应用内查看,仓库没有说明可以导出成文件。
- 阅读记录与统计在应用内的记录页,按时间轴和章节两个维度呈现。
- 备份与同步数据来自用户主动开启的本地备份、WebDAV 同步或跨设备同步,仓库没有说明备份文件的具体存放路径。
- 崩溃与性能信息:用户协议写明可能集成 Firebase Crashlytics 等第三方统计或崩溃分析服务,收集匿名崩溃日志与基础设备信息。
- 新版本在 GitHub Releases 页面发布,同时同步到 Telegram 发布页与反馈群组。
实际使用中的坑
- 官方主题直接失效。原因写在 README 里:主题系统被 Monet 引擎重构过,从官方版带过来的主题在这个版本用不了,得重新配。
- Android 12 以下的机器没有自定义主题和动态取色,只能等 Compose 迁移完成,README 明确说这个过程会很长。
- 测试版本身就不稳。发布说明自述「此版本为测试版,会存在不稳定问题」,仓库当前开放 Issue 有 90 个。
- Issue 区里登上过反馈榜的问题包括崩溃闪退、书架显示异常、下载崩溃、本地字体无法调用、页面动画掉帧卡顿、键盘 Enter 被识别成换行,以及书源与同书名书籍想共存的需求。事实表里这些条目都标为已解决,但它们说明这类问题在这个分支上出现过。
替代方案一览
| 项目 | 适合谁 | 部署方式 | 主要限制 | 什么情况下选它更合适 | 项目地址 |
|---|---|---|---|---|---|
| legado-with-MD3 | 已经在用「阅读」、想要 Material Design 3 界面与更细阅读记录的安卓用户,尤其是平板用户 | Android 应用,从 GitHub Releases 或 Telegram 群组取 APK;仓库同时是 Kotlin / Gradle 源码工程 | 主题与官方版本不兼容;Android 12 以下没有自定义主题与动态取色;当前是测试版,会存在不稳定问题 | 你能接受测试版,需要新界面和更完整的阅读统计 | legado-with-MD3 |
| fscan | 要盘点自有或已授权内网资产的安全与运维人员 | 仓库没有说明 | 它做的是内网存活、端口与弱口令扫描,不涉及电子书阅读、排版与书源规则 | 你的目标是把授权范围内的网段扫一遍 | fscan |
| AutoClip | 要把长视频链接剪成多平台短视频的内容运营 | 仓库没有说明 | 它处理视频链接与剪辑分发,和本地阅读器没有交集 | 你手上要处理的是视频素材与分发渠道 | AutoClip |
这两个对比项和本项目解决的问题并不重叠,放在这里只是给做同类选型的读者一个参照:它们是各自方向上的工具,不是这个阅读器的替代品。真要说这个项目不如别人的地方,论开箱即用它比不过一条命令跑完的 CLI 工具,你得先解决 APK 从哪来、书源从哪来这两个问题,才能看到第一页内容;如果你只在电脑上看书,或者不愿意折腾书源规则,这个项目就不合适。
别踩的合规线
用户协议把这件软件的性质写得很清楚:它是用户可配置的本地化网页内容浏览工具,只提供网页访问、内容解析、文本提取、阅读排版与数据管理这些技术能力,默认不预置任何第三方内容与解析规则。规则由用户自行创建、编辑、导入,来源是否合法、内容是否准确、能不能用,都由用户自己判断并承担责任。
用户用规则访问第三方网站时,请求由用户设备直接向目标网站发起并接收数据,软件只做本地解析和展示,不修改、编辑或再分发对方内容。所以这类工具只适合访问你自己有权访问的公开内容,不要拿它做侵犯知识产权、非法传播、未授权数据获取或破坏网络服务的事。第三方规则分享平台、论坛与交流群组都是独立运营的,和开发者没有隶属关系,用了之后产生版权纠纷、数据安全或网络访问风险,责任在相关行为主体。
什么时候值得用它
你已经在用「阅读」并且受够了旧界面,想要 Material Design 3 的观感、预测性返回手势和共享元素动画,这个分支值得试。
你在两台以上设备间同步阅读进度,愿意自己配 WebDAV,并且看重时间轴与章节维度的阅读统计,它比官方版多出这些内容。
你在平板上看书,或者用手柄翻页、需要漫画与有声书界面,README 里列的这些分支特性就是为你准备的;前提是你接受它现在是测试版,出问题能自己回到 GitHub Releases 换版本,也愿意去 Telegram 群反馈。
焚评:这个项目的量化评分
本项目的选题来自 焚.com(一个按公开公式给 GitHub 项目打分的站)。焚评当前总分 9.1 分(满分 10)。下表是各维度的得分:
| 评分维度 | 得分 |
|---|---|
| 热度动量(权重 25%) | 10.0 / 10 |
| 开发活跃(权重 25%) | 10.0 / 10 |
| 社区响应(权重 15%) | 8.8 / 10 |
| 文档质量(权重 15%) | 5.0 / 10 |
| 发布节奏(权重 10%) | 10.0 / 10 |
| 风险控制(权重 10%) | 10.0 / 10 |
评分口径、权重与计算方式见焚.com 的评分方法页;数据随 GitHub 指标刷新,具体数值以焚.com 当前页面为准。本文正文为诀.com 独立撰写,评分数据由焚.com 授权引用。
内容核验说明
这个分支把官方「阅读」的界面按 Material Design 3 重做,主题系统换成 Monet 引擎,代价是官方主题不能沿用,Android 12 以下没有动态取色。仓库把发布状态、许可证与已知限制都写清楚了,当前仍是测试版。适合已在用「阅读」、愿意自己配书源和 WebDAV 的安卓用户;不想折腾书源或只在电脑上看书的人可以跳过。
文中 Star 数、Fork 数、开放 Issue 数、许可证、语言占比与发布时间均来自 GitHub 仓库公开页面,诀.com 未独立验证。排版选项的默认值与取值范围、最低支持的 Android 版本、备份文件存放路径,仓库没有说明。崩溃闪退、书架显示异常、本地字体无法调用等问题出自仓库 Issue 记录,本站未复现,也不能保证在其他设备上复现。用户反馈摘要
根据仓库 Issue 来看,提交者反馈集中在崩溃闪退、云同步后书架不显示或重叠、下载时崩溃、本地字体无法调用、页眉页脚时间电量显示异常等。其余多为功能请求:文字选中菜单希望一行显示更多项、书源与同书名书籍希望共存、把远程书籍的重新加入书架挪到小说详情页。这些 Issue 状态均为已解决;开发者也用 Issue 帖收集各测试版的遗留问题,并建议崩溃反馈先用 noR8 版本,附完整描述与录屏。
基于该仓库公开 Issue 整理,只反映提交者报告的现象与诉求,不代表诀.com 立场,也不代表问题已被确认。项目来源与说明
开源项目:HapeLee(HapeLee)
本文由诀.com 编辑基于该项目的公开信息独立撰写,属原创解读,不是对项目文档的翻译或转载;文中提到的功能与参数以官方仓库为准,代码与文档版权归原作者所有。
查看项目仓库