Skip to content

NexHub v3.0.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 05 Oct 11:20
· 162 commits to main since this release
v3.0.0
8f28df3

NexHub v3.0.0（正式版）

四合一媒体聚合客户端（动漫 / 漫画 / 小说 / 影视）—— 源即插件 · 共创社区。

🎉 正式版说明

NexHub 3.0.0 正式版来了。这是 3.0.0 测试线（beta.1 → beta.4 加最后一轮加固）的稳定收口，基础功能完整、可安全升级。

从 v2.0.3（上一稳定版） 升级的用户，将一次性获得整个 3.0.0 线的全部能力：全新 Material 3 视觉体系、媒体服务器（Emby / Jellyfin）、ECH 加密握手、源编辑与源管理重构、三大阅读器增强、漫画动态效果，以及本轮收口的网络连通性大批量加固。

  • 这是什么阶段：3.0.0 正式版，是 3.0.0 测试线的稳定终点；相对 2.0.3 是一次大型功能跨越，但已经过 beta.1–beta.4 多轮实测打磨。
  • 数据兼容性：经代码核查，无破坏性数据变更——收藏 / 进度 / 书签 / 历史 / 分组 / 评分 / 短评可直接沿用；旧源 JSON 无需修改、无需重新导入；沿用同一签名密钥，可直接覆盖安装。
  • 建议：从 2.0.3 升级即可获得完整 3.0.0 能力；一直在 beta 线的用户直接覆盖安装即可。
  • 运行要求：ECH 由内置原生引擎（OpenSSL）驱动，现已随 Android APK（arm64-v8a / armeabi-v7a / x86_64 三架构）与 Windows 桌面端 打包生效；macOS / Linux 暂未打包原生库，会自动降级为直连，不影响其他功能。其余（代理 / DNS / Hosts / SNI）依旧全部真实生效。

⚠️ 本应用不内置任何内容源，首次打开是空的，这是正常现象。请先导入至少一个源 JSON（应用内「源管理 / 导入源」）才能看到内容。源由社区共享维护，请自行评估其合规性与内容合法性。

✨ 3.0.0 线核心能力（自 v2.0.3 以来）

🎨 全应用 Material 3 视觉体系

  • 全动态取色（莫奈跟随系统壁纸）+ 9 种调色板风格；全应用 UI 与设置统一到设计系统（连体卡、行样式、三级设置页）。
  • 侧栏 / 底栏毛玻璃（可自定义）；本地 / 网络导入独立预览页。

🖥️ 媒体服务器（Emby / Jellyfin）

  • 接入你自建的媒体服务器：浏览、搜索、播放、收藏、进度全打通；同一服务器可配置多地址，连接失败自动逐个切换备用地址 + 前台周期探活。
  • 播放前自动在「原画直连 / 直接播放 / 服务端转码」间决策；海报墙、流派 / 年份筛选与排序、详情视差头图与共享元素转场；收藏与进度本地 / 服务器双写、双向同步。

🌐 网络：ECH + 代理 / DNS / Hosts / SNI 增强

  • ECH 加密握手：内置原生引擎（OpenSSL）驱动，对直连 HTTPS 真实生效；作用域分应用级 / 源级（network.ech）/ Bangumi 专用三档；不支持 ECH 的站点逐域自适应回落；macOS / Linux 自动降级为直连。
  • 全局与源级两层网络模型：代理 / DNS（DoH、DoT）/ 自定义 Hosts / SNI / ECH，源级可逐项覆盖或继承全局。

🗂️ 源编辑与源管理重构

  • 源编辑页按「基本信息 / 网络 / 解析 / 筛选 / 高级」拆分为五个页签，长表单更易用；各模块支持按需折叠。
  • 源管理列表统一连体卡片样式 + 拖拽排序；源列表第二行展示更整洁。

📱 三大阅读器增强

  • 小说：字体、字号、行距、边距、主题、亮度等样式自定义，设置即时生效并持久化；双页模式、整本页码、本地 / 网络导入独立预览。
  • 漫画：双页 / 单页、翻页手势、缩放与滤镜、阅读进度持久化；图片超分辨率增强、缓存分类与自动清理。
  • 视频：基于 media_kit（libmpv）单一内核 + canvas_danmaku 弹幕渲染；后台播放 + 通知栏、画中画、跳过片头片尾、自动连播、睡眠定时。

🎭 漫画动态效果

  • 分层动效引擎，让静态漫画页拥有视差 / 呼吸 / 天气 / 光效等表现；阅读器内可开关调节（仍在持续打磨，部分机型可能不稳定，请在「设置 → 漫画阅读器」中按需开关）。

🔍 嗅探器 / 搜索 / 筛选

  • 嗅探结果面板高度可拖拽自定义，初始默认折叠；搜索改为勾选源模型，媒体服务器成为影视可选源；筛选面板分组折叠懒加载。

🔒 隐私与年龄限制

  • 默认开启年龄限制保护：18+ 源默认隐藏；无痕模式判定口径统一、状态在菜单中文字化呈现；隐藏源历史展示层过滤。

🔧 最后一轮打磨（beta.4 → v3.0.0，26 个提交）

🌐 网络连通性大批量加固

  • 请求头保真：请求头名保留原始大小写，规避 WAF 头名指纹封禁；TCP 中转桥重排请求头（Host 大写 + 首位）绕过 Cloudflare 头序指纹。
  • IP 轮转更稳：403 换 IP 重试先丢弃连接池，修复轮转空转；网络覆盖不再固化沿用值，SNI 清空不再被静默丢弃。
  • CF 边缘修复：修复 Cloudflare 1034 边缘 IP 限制与 WebView2 HTTPS 隧道解析；源登录 WebView 补接网络跟随（登录页此前从未跟随源 hosts）。
  • 自动验证：自动验证弹窗不再与弹出菜单相撞导致崩溃；验证码组件标记降级为被动语义，修复登录态详情页被误判验证墙。

🔬 抓取与解析健壮性

  • 图片流 302 重定向正确跟随，封面恢复；封面相对路径渲染空白修复；扁平 episodes 选择器被 $.list 劫持修复。
  • VideoExtractor 模式 1 允许一层嵌套花括号，修复含子对象的播放器失配；识别并自动通过常见视频采集 CMS 的「系统安全验证」页，修复搜索恒空。
  • 统一 WebView 环境 UA / Cookie 链路，修复反复验证与收藏列表取数；部分动漫源分类 / 视频慢——GET 进行中去重 + meta 相对 URL 解析 + 空直链落嗅探。

⚙️ 引擎与搜索

  • 路由支持 body / headers 声明与 {k?} 可选参数，支撑源协议迁移；搜索改为勾选源模型，媒体服务器成为影视可选源。

🎨 界面细节

  • 阅读器顶栏渐变铺到屏幕最顶端，SafeArea 只避让内容；源管理新样式仅总管理保留、主页页签短横线滑动无回弹；源管理页整卡不再包裹无源空白；详情页 Bangumi 角色 / 制作人员横排支持鼠标拖动。
  • 修复源声明 filters.route 被硬编码 category 顶掉导致筛选全失效。

🧪 测试

  • 一批源回归测试锁定（选集 / 分类 / 播放 / 收藏三形态 / 页面快照），提升后续改动的稳定性信心。

🔧 工程与文档（内部）

  • 代码注释、提交信息与文档延续中性表述清理；无新增第三方依赖，CI 四平台构建配置沿用。

🔞 年龄限制与免责说明

NexHub 默认开启年龄限制保护：标记为 18+（成人 / mature） 的源在默认设置下自动隐藏，不会出现在浏览、搜索与源列表中。如需访问，须在「设置 → 内容分级」中手动开启「显示限制级内容」，并确认你已年满法定成年年龄。

  • 源作者责任：请在源 JSON 中如实填写 ageRating 字段（general 全年龄 / teen 青少年 16+ / mature 成人 18+，支持 all/16/r18/nsfw 等别名，缺省 general）。应用仅依据该字段自动分级与隐藏，最终的内容合规性与年龄适宜性由源的提供方与使用方负责。
  • 内容责任：NexHub 为开源技术演示项目，本身不提供、不存储、不中转任何内容，所有内容均来自用户自行导入的源或用户自行连接的媒体服务器。对于相应内容的版权、合法性及适宜性，NexHub 不做任何形式的担保或背书。
  • 合规提示：若你所在地区法律禁止访问此类内容，或你未满法定成年年龄，请勿开启限制级内容显示。使用本软件即表示你已阅读、理解并同意仓库内完整的《免责声明》（依据中华人民共和国相关法律法规拟定）。

源字段完整说明见网站文档「源编写教程 · 源字段完整参考」一节，或仓库 lib/core/models/plugin_config.dart。

🛠️ 构建与发布

  • CI 四平台（Android / Windows / Linux / macOS）build 命令均注入 --dart-define=BANGUMI_CLIENT_ID 与 BANGUMI_CLIENT_SECRET（来自仓库 Secrets），官方 Release 包的 Bangumi OAuth 登录开箱可用。
  • Gradle 仓库顺序沿用既有修复（google() / mavenCentral() 优先、阿里云兜底），四平台均可正常出包。
  • 本版无新增依赖，构建链与 beta.4 一致。

📦 下载说明

  • Android：APK 按 CPU 架构分包，绝大多数手机请选 arm64-v8a；很旧的机型选 armeabi-v7a；模拟器 / x86 平板选 x86_64。装错架构会提示「安装包无效」。也提供 app-release.apk 通用包（单文件全架构，无需挑架构，体积较大）。
  • Windows：NexHub-setup-*.exe 为安装包（支持中英文、非管理员安装），NexHub-windows-x64.zip 为免安装便携版。若被 SmartScreen 拦截，点「更多信息 → 仍要运行」。
  • Linux：NexHub-linux-x64.tar.gz 为免安装版（解压即运行）；NexHub-linux-x64.deb 为 Debian / Ubuntu 系安装包；NexHub-linux-x64.AppImage 为单文件便携版（赋予可执行权限后双击运行）。
  • macOS：NexHub-macos.zip 为免安装版，NexHub-macos.dmg 为磁盘镜像（挂载后拖入「应用程序」）。首次打开需在「系统设置 → 隐私与安全性」中放行。

⚠️ 已知限制

  • 媒体服务器依赖自建环境：需要你自己部署并可访问的 Emby / Jellyfin 服务器；公网地址的可达性取决于服务器自身的网络配置与账号权限，应用侧不做穿透与内网代建。
  • 漫画动态效果仍在打磨：动效种类与稳定性会持续迭代，当前版本可能在部分机型上表现不稳定，请在「设置 → 漫画阅读器」中按需开关。
  • ECH 多平台进度：现已随 Android（三架构）与 Windows 桌面端 生效；macOS / Linux 暂未打包原生库，自动降级为直连；其余（代理 / DNS / Hosts / SNI）依旧全部真实生效。
  • SNI 运行时可控但仍受栈限制：现可在网络设置中配置「域名 → SNI 映射」与「免 SNI（绕 SNI 封锁）」，仅对直连 https 生效；走外部代理时由代理自理；部分站点仍需实测。
  • 自建构建的 Bangumi OAuth 不可用：未注入凭据时请改用 Access Token 登录，或自行到 bgm.tv/dev/app/create 注册应用（回调地址 nexhub://oauth/callback）；
  • Bangumi 吐槽仅只读；源站评论的可用操作取决于源 JSON 声明了哪些路由；
  • 遇到问题优先到 Issues 反馈。

🙏 参与共创

  • 反馈 Bug → Issues
  • 路线规划 / 新功能想法 → Discussions
  • 写源 / 改引擎 → 欢迎 Pull Request
  • 漫画动态效果等特性由社区贡献者共建，感谢每一位参与的人。

NexHub 不内置任何内容源。首次安装后需要自行导入源，才能看到内容。

Assets 13
Loading