legado-with-MD3

# Legado with MD3

<p align="left">
  <a href="https://github.com/HapeLee/legado-with-MD3">简体中文</a> ｜ 
  <a href="https://github.com/HapeLee/legado-with-MD3/blob/main/English.md">English</a>
</p>

## 📖 介绍

**Legado with MD3** 是基于开源项目 [阅读 (Legado)](https://github.com/gedoor/legado) 开发的 Material
Design 3 风格重构版本。

本项目在对 UI 进行重绘的基础上，加入了多项分支独有功能，并正在逐步从传统 View 迁移至 Jetpack Compose
框架，目标是提供更加现代、流畅且一致的阅读体验。

---

## ✨ 分支特性

相比于官方版本，本项目具有以下独有特性：

* **全新主题：** 全新 Material Design 3 设计界面，支持 **预测性返回手势** 与 **共享元素动画**。
* **阅读界面：** 更加个性化的阅读界面与菜单配置。
* **阅读记录：** 提供详尽的阅读记录，支持 **时间轴** 与 **章节维度** 统计。
* **体验增强：** 更健全的 **漫画阅读** 、 **有声书** 与 **发现** 等界面体验。
* **书架布局：** 更多的书架布局选择，针对 **平板端** 进行了专门的界面优化。
* **实用功能：** 新增书籍备注、智能伴生分组（自动归类已读/未读），支持**手柄**上下**翻页**。

---

## 🛠️ 核心功能

1. **多格式支持：** 支持本地 TXT、EPUB 阅读，智能扫描本地文件。
2. **高度自定义：** 切换字体、背景、行距、段距、加粗、简繁转换等。
3. **净化替换：** 强力去除广告，替换正文内容。
4. **翻页模式：** 覆盖、仿真、滑动、滚动等多种模式随心切换。
5. **完全开源：** 无广告，持续迭代优化。

---

## 从源码构建

首次检出后运行 `git submodule update --init modules/miuix`。设置 `ANDROID_HOME` 指向 Android SDK，再使用 JDK 21 运行 Gradle。Miuix 的源码提交由子模块固定。

## 💬 交流

* **Telegram 群组：** [Legado with MD3](https://t.me/materado)
* **版本发布：**
  最新版本会自动发布至群组，也可在 [GitHub Releases](https://github.com/HapeLee/legado-with-MD3/releases)
  下载。

---

## ❤️ 致谢

感谢以下优秀开源项目提供的灵感与技术支持：

* [gedoor/legado](https://github.com/gedoor/legado) (这个项目最吊的老爹)
* [Luoyacheng/legado](https://github.com/Luoyacheng/legado) (提供了更多的扩展功能)
* [rimvoid/legado](https://github.com/rimvoid/legado) (提供了更多的扩展功能)
* [ItosEO/COUI-Kit](https://github.com/ItosEO/COUI-Kit) (使用 Compose 复刻和优化 ColorOS 17 UI 风格的UI库)
* [compose-miuix-ui/miuix](https://github.com/compose-miuix-ui/miuix) (使用 Compose 复刻和优化 HyperOS 4 UI 风格的UI库)
* [feice11/mochi-compose](https://github.com/feice11/mochi-compose) (软、弹、跟手的 Jetpack Compose 组件库)
* [Kyant0/AndroidLiquidGlass](https://github.com/Kyant0/AndroidLiquidGlass) (适用于 Compose Multiplatform 的可自定义 Liquid Glass 特效库)
* [komikku-app/komikku](https://github.com/komikku-app/komikku) (提供了界面灵感与漫画相关实现参考)
* [FoedusProgramme/Gramophone](https://github.com/FoedusProgramme/Gramophone) (提供了界面灵感)
* [jordond/MaterialKolor](https://github.com/jordond/MaterialKolor) (基于 Jetpack Compose
  优秀的取色实现)
* [Calvin-LL/Reorderable](https://github.com/Calvin-LL/Reorderable) (基于 Jetpack Compose
  优秀的拖动排序实现)
* 以及更多开源项目...

## ⚠️ 用户协议与免责声明

> **【特别提示】**
> 在下载、安装或使用本软件前，请您务必仔细阅读并充分理解本协议及免责声明的全部内容。您一旦下载、安装或使用本软件，即视为已阅读、理解并同意接受本声明的全部内容。

### 一、软件性质说明

1. 本软件是一款用户可配置的本地化网页内容浏览工具，提供网页访问、内容解析、文本提取、阅读排版与数据管理等技术功能。
2. 本软件默认状态下不预置、不内置、不提供任何第三方网站内容、数据资源或解析规则。
3. 本软件开发者不提供任何内容运营、内容存储、内容发布或内容传播服务。
4. 用户可基于自身需求，自行配置或导入第三方规则，以实现对公开网页内容的个性化浏览与处理。

### 二、用户行为与规则说明

1. 用户可自行创建、编辑、导入或使用第三方分享的解析规则（以下简称"规则"）。
2. 相关规则仅用于定义网页内容的获取、提取与显示方式，其来源、合法性、准确性与适用性均由用户自行判断并承担责任。
3. 用户使用规则访问第三方网站时，相关网络请求由用户设备直接向目标网站发起并接收数据。本软件仅提供本地解析与展示能力，不对第三方网站内容进行修改、编辑或再分发。
4. 用户应遵守所在地法律法规、网络安全要求以及相关网站的服务协议与版权规范，不得利用本软件从事侵犯知识产权、非法传播、未授权数据获取、破坏网络服务或其他违法违规行为。

### 三、第三方内容与社区说明

1. 任何由第三方建立或维护的规则分享平台、论坛、交流群组、网站或其他社区，均属于独立运营的第三方平台，与本软件开发者无隶属关系。
2. 开发者不参与第三方规则、内容