mr

项目概述

MR 是一款基于 Flutter 的跨平台多媒体阅读器，兼容阅读（Legado）的书源规则体系，包括 CSS、JSONPath、XPath、JavaScript 规则与 java 桥接对象。它把小说、漫画、音频与视频四类内容整合到同一个应用中，同一套书源在 Android、iOS、鸿蒙、Web 与桌面端都能使用。

一套书源规则，读小说、看漫画、听有声书与看视频。

主要功能

• 规则兼容：支持 CSS/JSoup 选择器、JSONPath、XPath、JavaScript、正则替换与模板规则
• JS 引擎：基于 QuickJS 的 C 原生引擎，支持 ES2020 与跨引擎共享作用域
• 加密兼容：提供 CryptoJS API 与 java 桥接加密方法，底层统一走 C 原生实现
• 四种阅读器：小说阅读器、漫画阅读器、音频播放器与视频播放器
• 图片解密：支持封面解密与正文图片解密，自定义 ImageProvider 让图片缓存可正常复用
• 书源管理：兼容 Legado JSON 导入导出，支持书源调试与执行追踪树
• 跨平台：Android、iOS、鸿蒙、Web、Windows、Linux、macOS 同一代码库
• 崩溃防护：全局错误捕获、异步错误兜底与启动崩溃日志恢复

适用人群

• 想在多个平台使用同一套书源的用户
• 需要在一个应用里看小说、漫画、听有声书与看视频的人
• 想调试与开发书源规则的开发者
• 使用 Flutter 做跨平台阅读应用的开发者

快速上手

1. 安装 Flutter 3.41 及以上版本
2. 执行 flutter pub get 安装依赖
3. 连接设备后运行 flutter run
4. 在书源管理中导入 Legado 书源 JSON，开始搜索与阅读
5. 构建安装包可执行 flutter build apk、flutter build ios 或 flutter build hap

核心优势

• 一次编写多端可用：书源无需针对平台修改，Web 端会自动启动跨域代理
• 性能扎实：规则解析与加密由 C 原生实现，并内置内存追踪与超时熔断
• 调试友好：执行追踪树可以看清每条规则取到什么、哪一步为空
• 稳定优先：崩溃日志服务最先初始化，所有服务初始化都带兜底

系统要求

项目	要求
操作系统	Android、iOS、HarmonyOS、Web、Windows、Linux、macOS
开发环境	Flutter 3.41 及以上
构建依赖	Android NDK 28.x、CMake 3.22 及以上

注意事项

• 不支持 Legado 的 java 包类（io.legado.app.* 原生类），依赖这些类的书源可能无法运行
• 鸿蒙构建产物未签名，需要自行用 DevEco Studio 签名后安装
• 项目全量使用中文注释与中文标识符，阅读源码时需要留意
• 应用不提供内容，需要自行导入书源