墨境 MoRealm推文
在电子书阅读器领域，Legado（开源阅读）凭借强大的书源系统一直占据着独特地位。而今天要介绍的 墨境 MoRealm，正是一款站在巨人肩膀上、用 Jetpack Compose 全面重写的现代化 Android 电子书阅读器。
墨境 MoRealm：一款集现代化设计、强大书源与极致阅读体验于一身的 Android 开源阅读器
在电子书阅读器领域，Legado（开源阅读）凭借强大的书源系统一直占据着独特地位。而今天要介绍的 墨境 MoRealm，正是一款站在巨人肩膀上、用 Jetpack Compose 全面重写的现代化 Android 电子书阅读器。
🎯 它是什么？
墨境 MoRealm 是一款完全兼容 Legado 书源的 Android 电子书阅读器。与传统的“换皮”不同，它从底层 UI 到渲染引擎全部重写——基于 Google 官方推荐的 Jetpack Compose 框架构建，拥有现代化的 Material 3 设计语言，同时完整继承了 Legado 强大的书源生态。
一句话概括：Legado 的灵魂，现代 Android 的躯体。
✨ 核心亮点
1. 全格式通吃，阅读零门槛
支持 EPUB、TXT、PDF、MOBI、AZW3、CBZ、CBR 等主流电子书格式，几乎涵盖了所有你可能遇到的电子书类型。本地书籍直接导入，无需任何转换。
2. 自研 Canvas 排版引擎，顺滑阅读体验
墨境最值得称道的技术突破之一，是其自研的 Canvas 排版引擎。采用段落级 LazyColumn 瀑布流渲染策略，即便遇到超长章节也能保持丝滑滚动，彻底告别传统阅读器在大章节下的卡顿问题。
排版控制方面同样细腻入微：字体、字号、行距、段距、页边距全部可调，支持繁简一键转换，还可自定义 CSS 随心定制页面样式。
3. 5 种翻页动画 + 5 套阅读预设
阅读器提供了平移、覆盖、仿真、上下滚动、无动画共 5 种翻页效果，满足不同用户的阅读习惯。同时内置纸质、护眼、海蓝、暖黄、墨白 5 套色彩主题，自动适配日夜模式，无论白天强光还是夜间暗光都能找到最舒适的阅读方案。
4. 物理键翻页，支持蓝牙翻页器
墨境 MoRealm 支持音量键翻页、蓝牙翻页器，甚至耳机按键——全键位覆盖。躺着看书时只需按一下音量键就能翻页，让阅读体验更加沉浸。
5. 5 色高亮系统，跨设备云端同步
选词后可直接高亮标记，支持 5 种不同颜色区分阅读重点。所有高亮记录都会存入数据库并持久化，配合 WebDAV 同步功能，可在不同设备间无缝恢复阅读进度和笔记。
🔊 TTS 听书：不止是“读书”
墨境的 TTS（文字转语音）功能也是一大亮点：
- 多引擎可切换：Edge TTS（流式合成 + 本地 LRU 缓存）、系统 TTS、OpenAI 语音、自定义 API，想用哪个用哪个
- MediaStyle 通知栏控制：直接在通知栏显示书名、章节、封面，并提供上一段、暂停、下一段、倒计时等控制按钮
- +10 分钟倒计时：通知栏直接续费睡眠模式，睡前听书再也不用爬起来操作手机
- 更多 TTS 能力正在持续打磨中
📚 书源与搜索：继承 Legado 生态
墨境 MoRealm 最大的杀手锏在于完全兼容 Legado 3.x 的书源格式：
- 4 种规则引擎：CSS / XPath / JSONPath / Regex 全面覆盖，解析能力与 Legado 一致
- 灵活的书源管理：支持分组 chip（不分组、分组名、域名、类型），状态持久化，下次打开自动保留
- 一键检测（CheckSource）：勾选书源后实时检测有效性，失败原因持久化显示
- 后台自动刷新书架：并发拉取所有 WEB 书目录，新章节以红色「N 新」角标醒目提示
- 搜索元信息：结果卡片展示最新章节数、字数、分类，搜索历史自动记录
从 Legado 迁移到墨境也非常简单：我的 → 书源管理 → 右上 + → 从 JSON 导入，支持直接粘贴或从链接导入。
☁️ 同步与备份：数据永不丢失
- WebDAV 全套支持：备份、恢复、进度同步、自动调度，接口设计参考 Legado，兼容性极佳
- 本地 ZIP 备份：可勾选导出类别（书籍、书源、进度、主题、阅读样式等）
- 多设备防覆盖：备份文件名自动带设备名后缀，避免冲突
- 历史版本恢复：云端列出所有 backup_*.zip 文件，可按时间点任意恢复
- DB 升级前自动备份：避免新版本崩溃导致数据丢失
🎨 主题与外观：颜值即正义
- 6 套内置主题：墨境、纸上、赛博朋克、森林、深夜、墨水屏，风格各异
- 自定义主题支持：完整的 ThemeEntity 结构，支持导入导出 Legado 主题包
- 全局背景图：4 个 Tab 共享，可单独调节透明度和模糊度
- 日夜双背景图：阅读器可分别配置日间和夜间背景
🏷️ 多标签与自动归类
墨境内置了一套完整的书籍分类系统：
- 多对多标签体系：book_tags + tag_definitions 词表（v17 schema）
- 15 个内置题材标签：修真、玄幻、都市、言情等，关键词可编辑
- 5 层评分瀑布：用户关键词 → 元数据 → 简介 → 标题 → 来源/格式，自动识别书籍题材
- 自动建文件夹：某一题材累计 ≥3 本时自动创建带 emoji 的文件夹。用户手动创建的文件夹永久不会被自动归类引擎改动
🔧 更多实用功能
- Legado 一键搬家：书源、书籍、进度、主题一次性全面接管
- 章节缓存导出 TXT：含书名、作者、简介、净化后正文，方便离线保存
- 检查更新：自动拉取 GitHub Releases，比对版本后弹窗展示 release notes
- 侧滑返回：全 App 一致的手势操作
- 可配置选区菜单：按钮顺序和显示项均可自定义
🛠️ 技术栈：现代 Android 开发的典范
墨境 MoRealm 的技术选型代表了当前 Android 开发的最新趋势：
| 层次 | 技术选型 |
|---|---|
| UI | Jetpack Compose · Material 3 · Compose Navigation |
| 状态管理 | StateFlow / SharedFlow · Hilt DI |
| 数据层 | Room · DataStore · Coil 图片缓存 |
| 网络 | OkHttp（自签证书容错）· QuickJS · Jsoup |
| TTS | Media3 ExoPlayer · Edge TTS WSS · MediaCodec 流式解码 |
| 排版 | 自研 Canvas 渲染（CanvasRenderer / LazyScrollRenderer / SimulationReadView） |
| 异步 | Kotlin Coroutines + Mutex 单飞 |
| CI/CD | GitHub Actions（CI 测试 + LICENSE 校验 + tag 触发自动发版） |
项目要求 Android 8.0 (API 26) 及以上，代码以 Kotlin 为主（占比约 89.4%），结构清晰、模块分明，非常适合对 Android 开发感兴趣的同学学习研究。
📄 许可证与获取方式
墨境 MoRealm 采用双许可模式：
- 开源使用（GPL-3.0）：个人、学习、开源项目可免费使用，但衍生作品需以同等条款开源
- 商业使用：需获取商业许可，适用于闭源分发、商业产品集成等场景
下载最新版 APK：👉 GitHub Releases
使用指南：docs/user-guide.md
更新日志：CHANGELOG.md
🙏 致谢
墨境 MoRealm 站在巨人的肩膀上，离不开以下优秀项目的支持：
- Legado — 书源生态、规则引擎设计、备份格式参考
- Microsoft Edge TTS — 远程语音合成
- Material 3 — 视觉系统
- Jsoup / QuickJS / OkHttp — 解析与网络
📸 界面实拍
微信公众号看图：点击查看
💬 写在最后
墨境 MoRealm 是一款真正意义上的“现代 Android 阅读器”——用 Jetpack Compose 重构 UI，用自研引擎优化阅读体验，同时完整继承 Legado 丰富的书源生态。无论你是寻找一个日常使用的阅读 App 的普通用户，还是对 Android 开发、书源解析技术感兴趣的学习者，墨境 MoRealm 都值得一试。
项目还在积极迭代中，部分功能（尤其 TTS 和部分书源解析）仍在打磨阶段，欢迎在 GitHub Issues 中提出反馈和建议。
GitHub 项目地址：https://github.com/keys-cherish/morealm-reader
如果觉得项目不错，别忘了给作者点个 Star ⭐️，你的支持是开源项目持续前进的动力！