nexhub

这是 nexhub-app/Nexhub，一个基于 Flutter 构建的开源跨平台媒体聚合客户端，最新版本 v2.0.0（2026 年 9 月 4 日发布），采用 Apache-2.0 协议。

项目核心定位

NexHub 把「动漫、漫画、小说、影视」四类内容统一到一个应用里浏览、搜索、阅读与观看，但其最关键的设计理念是「源即插件 · 共创社区」：

- 应用本身只是"引擎"，负责界面、阅读器、播放器、网络请求、解析调度等通用能力 - "内容从哪来"完全由「源」决定——每个源是一份可导入的 JSON 配置文件（可包含声明式选择器，或内嵌 JavaScript 脚本） - 应用不内置、不打包任何预备源，首次安装后是"空的"，必须先导入至少一个源才能看到内容

这种设计的好处是合法合规（公开仓库不含指向具体站点的内置源）且可持续（站点改版只需更新对应源文件，应用本体保持稳定）。

主要功能特性

- 四大模块独立源管理：动漫、漫画、小说、影视的源相互独立，可批量添加、校验、启用/禁用 - 全局跨库检索：一次关键词，跨四大内容库同时返回结果 - 阅读体验：小说接入系统 TTS 听书、左右翻页/上下滚动双模式；漫画阅读器支持自然排序、书签、自动下载、图片收藏等 - 播放能力：基于 media_kit（libmpv 内核），支持弹幕（canvas_danmaku）、多线路切换、倍速、字幕、硬件解码 - AI 辅助能力（v2.0.0-beta 系列已落地）：漫画页翻译（MTL）、视频字幕实时翻译、小说 AI 双语/段落翻译、内容摘要与章节配图 - 同步：接入 Bangumi 番组计划的开放 API，支持收藏/进度/评分同步 - 跨平台：支持 Android、iOS、Windows、macOS、Linux、Web（Flutter 支持的平台）

技术栈与架构

- 前端框架：Flutter / Dart（代码占比 Dart 94.6%） - 源脚本沙箱：flutter_js（QuickJS 内核） - 抽取能力：xpath_selector + html 提供声明式抽取 - 网络层：dio 统一网络请求与 Cookie 管理 - 状态管理：provider；动态配色用 dynamic_color（Material You）

架构上清晰地把"应用外壳"与"源定义"分离，站点改版时只需更新源文件，无需改应用代码——这是它最核心的架构优势。

适用场景与人群

💡 这个项目适合 Flutter 开发者、热衷于自管媒体的用户、以及愿意导入或编写源定义的人。 具体来说：

- 想要一站式聚合动漫/漫画/小说/影视的泛二次元爱好者 - 愿意自己维护选择器或 JS 抓取脚本的开发者（站点变化时能自己适配） - 想研究"源即插件"架构、声明式/脚本式解析方案的开发者

⚠️ 使用前必知的几点

1. 不是开箱即用：首次安装后没有内置源，必须自己导入源 JSON 才能看到内容，"就像买了书架，书要自己放" 2. 源的合规性由用户自负：应用不存储/中转任何受版权保护的内容，源的合法性与版权状况由提供方与使用方负责 3. 年龄分级：源作者需在 JSON 中声明 ageRating（general/teen/mature），mature（18+）源默认隐藏，需用户主动开启 4. 源可能随时失效：因为内容依赖社区维护的源，站点改版会导致选择器或脚本失效，需要源作者跟进更新 5. 早期阶段项目：仓库目前 25 Star、7 Fork、2 名贡献者，仍在快速迭代中

仓库导航

- 用户指南：获取安装、导入源、日常使用、常见问题 - 开发者指南：含源编写分级教程（基础/中级/高级）、字段规范、完整示例 - 核心特色详解：源即插件、阅读器/播放器、Bangumi 同步、网络配置等 - 更新历史：各版本完整更新日志