Skip to content

Latest commit

 

History

370 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

简体中文 | English

当前最新版 v2.0.0-beta.2(预发布测试版)。上一稳定版为 v1.2.0(本地内容下载 / 导入稳定性大修 + 三大阅读器体验增强)。项目持续迭代中,欢迎通过 Pull Request / issues 贡献代码和想法。完整更新历史见 RELEASE_NOTES

NexHub

四合一媒体聚合客户端(动漫 / 漫画 / 小说 / 影视)—— 源即插件 · 共创社区模式的开源阅读 / 观看工具。

NexHub 是一个基于 Flutter 构建的跨平台媒体聚合客户端,把「动漫、漫画、小说、影视」四类内容统一到一个应用里浏览、搜索、阅读与观看。


📚 文档导航

文档 说明
📖 核心特色详解 源即插件、阅读器 / 播放器、Bangumi 同步、网络配置等特色能力详解
🧭 用户使用指南 获取安装、导入源、日常使用、常见问题
🛠️ 开发者指南(含源编写) 环境准备、项目结构、源编写分级教程(基础 / 中级 / 高级)、字段规范、完整示例
📜 更新历史 各版本完整更新日志

一、项目简介

NexHub 的核心设计理念是 「源即插件 · 共创社区」

  • 应用只提供「引擎」,负责界面、阅读器、播放器、网络请求、解析调度等通用能力;
  • 「内容从哪来」由「源」决定。每个源是一份可导入的 JSON 配置文件(可包含声明式选择器,或内嵌 JavaScript 脚本),描述如何从一个具体站点抓取列表、详情、章节与内容;
  • 应用不内置、不打包任何预备源。所有源由用户自行导入,或在社区中共享。任何人都可以自己写一份源 JSON,导入后即可解析该站点的内容,无需改动任何应用代码

这种设计的收益:

  1. 合法与安全:公开仓库不包含任何指向具体站点的「内置源」,降低版权与合规风险;
  2. 可持续与开放:解析能力由社区共同维护,站点改版只需更新对应源文件,应用本体保持稳定。

⚠️ 正因为「不内置源」,首次安装后的 NexHub 是「空的」——你需要导入至少一个源,才能看到内容。这就像买了一个书架,但书要自己放上去。


🗺️ 路线规划(TODO · 规划中 · 欢迎参与)

以下功能尚未实现,是后续版本的重点方向。设计存在大量取舍,欢迎到 GitHub Discussions / Issues 提意见:

  1. 漫画翻译(MTL):漫画图片机翻嵌字 / 气泡替换,降低跨语言漫画阅读门槛;
  2. 视频实时翻译:影视字幕 / 实时字幕翻译,支持外挂与内嵌字幕的语言切换;
  3. 增加其他同步方式:在现有 Bangumi 同步之外,接入 AniList、MyAnimeList、Trakt、SIMKL、MDList 等更多后端,并支持跨后端双向同步与可配置冲突策略;
  4. AI 搜源 / 自然语言检索:在应用内用自然语言搜源、看番 / 看书助手等更深度的 AI 辅助。

已实现:小说翻译(AI 双语 / 段落翻译)、AI 内容摘要与章节配图已在 v2.0.0-beta.2 落地;漫画 / 视频翻译仍在规划中。


二、源即插件 · 共创社区

NexHub 的生命力来自社区共同维护的「源」。我们欢迎任何人参与:

  • 使用方:导入社区共享的源,按自己需要组织内容;
  • 创作者:编写自己的源 JSON,描述如何解析某个站点,分享给他人;
  • 贡献者:完善引擎、阅读器、播放器、文档,或提出 Issue / PR。

应用只提供引擎,解析能力来自社区。站点改版只需更新对应源文件,应用本体保持稳定——这就是「源即插件 · 共创社区」的价值。


三、免责声明

本声明依据中华人民共和国相关法律法规(包括但不限于《中华人民共和国网络安全法》《中华人民共和国著作权法》《信息网络传播权保护条例》《中华人民共和国未成年人保护法》等)及一般国际惯例拟定。使用本软件即表示你已阅读、理解并同意本声明全部内容。

  1. 技术演示性质:NexHub 是一款开源的「聚合 / 阅读工具」技术演示项目,其本身不提供、不存储、不中转任何受版权保护的内容,也不内置任何指向具体站点的内容源

  2. 「源」由用户自行负责:本软件的所有内容均来自用户自行导入的「源」。源所对应的站点内容、其合法性、准确性、完整性,以及源本身的合规性与版权状况,完全由源的提供方与使用方负责,与本软件作者及贡献者无关。

  3. 遵守法律法规:使用者应当严格遵守所在地法律法规,包括但不限于网络安全、著作权、信息网络传播权保护等相关规定。你仅可将本软件用于个人学习、技术研究与非商业用途,不得利用本软件实施任何侵犯他人著作权、隐私权、商业秘密或其它合法权益的行为,不得用于任何商业用途或非法传播。

  4. 版权与侵权处理:若你导入的源涉及受版权保护的内容,请仅在与权利人授权范围相符的前提下使用;如权利人认为相关源或内容侵犯其合法权益,请联系该源的提供方予以移除,本软件作者将予以必要配合。

  5. 「按现状」提供:本软件按「现状(AS IS)」提供,不作任何明示或默示的担保(包括但不限于适用性、可靠性、无病毒、无错误的担保)。对于因使用或无法使用本软件所导致的任何直接、间接、偶然、特殊或后果性损失,作者与贡献者不承担任何责任

  6. 未成年人保护:若使用者为未成年人,请在监护人的指导下使用本软件,并遵守《中华人民共和国未成年人保护法》等相关规定,避免接触不适宜的内容。

  7. 年龄限制与内容分级:NexHub 内置年龄分级(ageRating)体系——源作者应在源 JSON 中如实声明 ageRatinggeneral 全年龄 / teen 青少年 16+ / mature 成人 18+)。mature(18+)源在默认设置下会自动隐藏,用户需在设置中主动开启年龄限制内容后才会显示。应用只负责按分级规则过滤展示不对任何源的实际内容作审查、背书或担保;源所指向的站点是否允许其内容被访问、抓取与传播,由源作者与使用者自行判断并承担相应责任。请勿导入、传播违反所在地法律法规或侵犯他人权益的源与内容。

  8. 地域合规:如果你所在国家或地区的法律禁止或限制本软件的使用,请立即停止使用。本软件在不同司法管辖区的合法性由使用者自行判断与承担。

  9. 账号与隐私:使用本软件过程中产生的浏览历史、导入的源等数据,默认仅保存在你本地设备;若你启用任何云同步或第三方服务,请自行了解并接受该服务方的隐私政策与数据处理方式。本仓库的公开代码不包含任何个人隐私、密钥或凭据

  10. 免责范围:本声明构成你与本软件作者及贡献者之间就本软件使用的完整谅解。如本声明任何条款被认定为无效,不影响其余条款的效力。


四、致谢

感谢以下项目与社区,NexHub 的建立离不开它们:

  • Legado(及其各类改版)的「书源」规则系统,为 NexHub「源即插件」的解析与共创理念提供了核心启发(尤其小说源的声明式 / 脚本式写法)。NexHub 小说分页器以独立 Dart 实现借鉴了 Legado ChapterProvider 的分页算法,未复制其源码;Legado 上游仓库未附带明确的开源许可证,本致谢仅作启发署名,不暗示任何许可授权。
  • Mihon(Tachiyomi 衍生版,及其各类改版)的扩展源架构与漫画阅读器交互,为 NexHub 的漫画解析与阅读体验提供了重要参考。Mihon 以 Apache License 2.0 发布(© Mihon contributors)。
  • RSSHub 的 RSS 聚合能力为 NexHub 的订阅功能提供了服务基础。RSSHub 以 AGPL-3.0 发布(© DIYgod),NexHub 仅作为客户端调用其实例,未修改或再分发其源码。
  • Flutter 与 Dart 团队,提供优秀的跨平台框架;
  • flutter_js(quickjs 内核),为源内嵌脚本提供安全的 JS 沙箱;
  • xpath_selectorhtml,提供声明式抽取能力;
  • dio,统一的网络请求与 Cookie 管理;
  • provider,状态管理;
  • dynamic_color,Material You 动态配色;
  • media_kit(libmpv 内核),影视播放能力;
  • Bangumi 番组计划 提供开放 API,使 NexHub 的收藏 / 进度 / 评分同步与条目资料展示成为可能(NexHub 仅作为第三方客户端调用其公开接口);
  • canvas_danmaku,弹幕渲染;
  • 猫抓 cat-catch 等开源嗅探项目(cat-catch / VBrowser-Android / VidDown / pup-sniffer)的「网络拦截 + DOM 检测 + API 钩子」嗅探方法论,为 NexHub 内置嗅探功能提供了重要参考(仅借鉴方法论,未引入其代码,应用以 Apache-2.0 协议开源);
  • 所有为「源即插件 · 共创社区」理念做出贡献的开发者、源作者与用户。

五、开源协议

本项目以 Apache License 2.0(Apache-2.0) 协议开源,详见仓库根目录的 LICENSE 文件与 NOTICE 第三方署名文件。

Apache-2.0 允许在任何项目中免费使用、复制、修改与分发本软件(含闭源或商业产品),但须:保留版权与许可声明、在修改文件中标注变更、若上游含 NOTICE 文件须随附其署名内容。本软件按「原样」提供,不提供任何担保。 如本项目包含第三方组件的衍生内容,其署名与许可见 NOTICE


NexHub · 源即插件 · 共创社区

About

NexHub 是一个基于 Flutter 构建的跨平台媒体聚合客户端,把「动漫、漫画、小说、影视」四类内容统一到一个应用里浏览、搜索、阅读与观看。

Topics

Resources

Stars

20 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages