Miru 是什么、怎么装、有啥坑——一份快问快答
Miru 是什么
Miru 是一个靠扩展仓库运行的多功能资源软件——核心本体并不直接提供任何内容源，而是通过 QuickJS 引擎加载独立的 JS 扩展文件，每个扩展对应一种内容类型：bangumi 类型管动漫，manga 类型管漫画，fikushon 类型管小说。装好扩展之后，同一个 App 里就能完成看动漫、追漫画、阅读网络小说、听音乐这几类日常需求，不用在四五个独立 App 之间切来切去。
项目 2023 年启动，Miru 的完整安装和使用指南可以在 GitHub 上找到，采用 Flutter 开发，扩展用 AGPLv3 协议发布。目前稳定版本是 v1.8.1，Android APK 安装包约 17.5MB——本体非常轻，真正的体积消耗全在扩展上，按需安装即可。
安装
Android 用户 Miru下载 安装包后正常放行未知来源即可，安装过程本身没什么特殊之处——但安装完第一次打开之后，真正决定你能用多少功能的，是扩展仓库的添加和扩展的安装。
首次启动向导里会引导你添加官方扩展仓库；如果跳过了，之后也能在扩展管理页面手动添加。扩展本身都是独立的 .js 文件，Miru 有自己的扩展加载目录——在扩展管理页点右上角的导入按钮，就能直接定位到本地目录，把单个 JS 文件拖进去即可，不需要走仓库流程。文件名必须和扩展元数据里的 @package 字段完全一致，否则加载会报错，这是新手最容易踩到的第一个坑。
安装完核心扩展之后，应用还可以选择绑定 AniList 账号来同步观看列表和追更进度，但这一步完全可选，不绑定也不影响本地使用。
Miru 的扩展是怎么回事？
Miru 的所有内容能力都来自扩展，本体只是一个加载器和 UI 框架。 三种扩展类型对应三种内容消费场景：bangumi 管动漫流媒体，manga 管漫画图片流，fikushon 管网络小说文本。扩展的注册和加载都在应用内完成，开发者写好 JS 文件放进扩展目录，Miru 就能自动识别。
扩展有两种获取方式：添加一个扩展仓库让 Miru 定期拉取列表并一键安装更新，或者拿到单个 JS 文件直接拖进扩展目录。两种方式可以混用——如果你只想要某个仓库里的一两个扩展，没必要整个添加仓库，手动复制 JS 文件过去更干净。
它跟 AniList 是什么关系？
AniList（anilist.co）是一个面向全球用户的动漫和漫画追踪社区，Miru 支持把本地的观看进度、追更状态和评分同步到 AniList 账号。核心价值有两个：跨设备同步——手机上看的进度换电脑打开也能看到；以及数据备份——本地数据丢了 AniList 里还有一份。
不过同步范围有明确边界：动漫和漫画完整支持集数/章节进度、追更状态、评分；小说（fikushon 类型）完全不在 AniList 的体系里，不参与任何同步。绑定流程是 OAuth 授权，Mirv 会弹出浏览器窗口跳转到 AniList 的授权页面，登录确认后自动跳回，几分钟就能完成。
小说功能好用吗？
fikushon 扩展是三种扩展类型里最新加入的，官方仓库收录最少——找小说源的主要途径是第三方仓库和社区分享。好消息是小说扩展的实现门槛相对最低：它只需要处理文本请求，不像动漫扩展要处理视频流、也不像漫画扩展要处理图片防盗链，自己动手写一个的核心逻辑就是请求目录 → 请求章节正文 → 剥离 HTML → 按段落切分塞进数组，逻辑清晰，难度不高。
Miru 顶部搜索框在小说标签下会并行调用所有已装 fikushon 扩展的搜索方法，装多个扩展能大幅提高搜到想要作品的概率。网络小说站点数量多、覆盖广，但单站点更新频繁、域名也容易变动——多扩展并行搜索是应对这个问题的有效方式。
用 Miru 最容易踩的坑是什么？
最常见的三个坑：一是@package 和文件名不匹配导致扩展加载失败——Miru 会严格校验这一点，扩展管理页里如果看到红色错误提示，先检查文件名和元数据是否一致；二是误以为装了应用就能直接看内容——本体只是加载器，不装扩展就是空壳；三是 AniList 同步时以为小说也能跟，绑定之后发现小说进度根本没同步，这不是 bug，是功能边界。
另外，Miru 目前还没有原生云同步收藏和进度，跨设备要么靠 AniList 中转、要么手动备份本地数据——这一点在多设备重度用户那里是比较明显的短板，但也是项目路线图里明确要推进的方向。
和同类聚合 App 比怎么样？
同类的开源聚合方案不少，Miru 的核心差异点在于扩展驱动架构——它不追求本体内置所有功能，而是让扩展开发者社区来填充内容生态。AGPLv3 协议确保了修改后的代码必须开源，扩展本身又是独立文件不受主程序协议约束，这让它的扩展生态相对活跃且透明。
代价是上手门槛比"打开就能用"的闭源 App 稍高——第一次装完得花十几分钟研究扩展仓库、添加源、挑扩展。但一旦配置好，多内容类型统一入口的便利性是实打实的。如果你只看动漫，专门的动漫客户端可能体验更极致；但如果你同时追番、追漫、追文，Miru 这种聚合方案能省掉来回切 App 的麻烦。
值不值得长期用？
值得。如果你同时有动漫、漫画、网络小说三类以上的日常消费需求，Miru 能把三四个独立 App 的工作量合并到一个入口，扩展驱动的架构也让它不太容易因为某个内容源挂了就整体失效。代价是初次配置需要花点时间、扩展生态质量参差不齐需要自己筛选——但对于愿意折腾一下的重度用户来说，这个成本换回来的统一入口体验是划算的。
本文為個人基於網路公開資料整理編寫，非官方內容，僅供學習交流參考；軟體版權歸原作者所有，請支持正版；使用過程中遇到問題請查閱官方管道，本文不承擔任何責任。
