Repository navigation
Releases
Releases · nexhub-app/NexHub
NexHub v3.5.0
NexHub v3.5.0（正式版）
四合一媒体聚合客户端（动漫 / 漫画 / 小说 / 影视）—— 源即插件 · 共创社区。
🎉 正式版说明
NexHub 3.5.0 正式版来了。本次是平板 / 宽屏体验与网络可靠性两条线的合流：宽屏下列表与详情同屏展开（还带设置开关和可拖拽宽度）、小说正文净化改成开箱即用的全局规则包、加密通道（ECH）与源级媒体域名改写一起加固，另修好了 Bangumi 授权、跨平台备份导入、公告页加载等一系列真问题。基础功能完整、可安全升级。
- 这是什么版本：3.5.0 正式版；Android / Windows / Linux / macOS / iOS / 鸿蒙六平台产物统一发布在同一个 Release。
- 数据兼容性：经代码核查，无破坏性数据变更——书架 / 收藏 / 进度 / 书签 / 历史 / 分组直接沿用；旧源的书籍级净化规则会在首次打开该书时自动迁移，不会丢配置；旧源 JSON 无需修改、无需重新导入；沿用同一签名密钥可直接覆盖安装。
- 鸿蒙安装方式：HAP 统一不带签名，请用端侧签名工具自行签名后安装（或 DevEco Studio / hdc 侧载）；本版新增《鸿蒙安装与更新指南》，见 README 安装段。
⚠️ 本应用不内置任何内容源，首次打开是空的，这是正常现象。请先导入至少一个源 JSON（应用内「源管理 / 导入源」）才能看到内容。源由社区共享维护，请自行评估其合规性与内容合法性。
✨ 本次更新内容
📐 宽屏与平板：列表与详情同屏
- 双栏详情：窗口宽度 ≥1120 时，点开作品不再整页跳转——列表留在左侧、详情在右栏展开，返回键先收起右栏再退出；窗口拉窄到 1120 以下自动回落到整页模式。
- 推入式页面也能开栏：搜索、在线列表、真实网址浏览、下载页一样支持，右栏在本页内展开，不再打断你的浏览位置。
- 可调宽度：列表与详情之间新增分隔条，左右拖动即可调整，宽度在本次会话内保留，范围随窗口自适应（不会把内容挤没）。
- 设置里可关：设置 → 外观与语言 → 详情页外观 新增「双栏详情」开关（默认开）；关闭后详情恒整页打开。
- 鸿蒙平板：设备类型新增平板，平板原生全屏运行；漫画阅读器新增「宽屏自动双页」（默认关，横屏且够宽时自动跨页，竖排 / 长条不参与）。
📖 小说：正文净化开箱即用
- 规则从「每本书自己写」改成「全局一套」：随包内置 12 条常用规则（10 条默认启用，求票打赏 / 本章完标记 2 条默认关闭），装好就有净化效果。
- 旧配置不丢：此前为某本书单独写过的规则，首次打开该书时自动迁移为「仅本书」规则并保留原开关状态。
- 生效范围可选：每条规则可设「全部书籍 / 仅本书 / 仅本源」，每本书只留一个总开关（默认开），阅读器里能单独关掉。
- 规则页重做：按设置页的设计语言重排，支持长按拖动排序、一键恢复内置规则，文案全部中英双语。
🌐 网络与加密通道
- 源级媒体域名改写：源可声明媒体域名映射（把主 CDN 换成备用 CDN），封面、插图与页面共用同一条加密通道，不再出现「页面能开、封面 403」。
- 图片请求更干净：图片按源使用自身的网络档案（源级代理 / ECH 对图片真正生效）；Accept 统一为图片形态、不再自动兜底加 Referer（签名 CDN 反而要无 Referer 才放行）；补齐浏览器会一起发送的 Sec-Fetch 头。
- 加密通道（ECH）加固：DoH 引导失败时改用加密 DNS 兜底解析；服务端拒绝旧配置时按下发的 retry 配置自动重连，并按域名缓存实测可用的配置（后续连接一次到位）；握手与直连统一走 fd 模式；直连改为多 IP 逐个超时尝试，不再被一个坏 IP 拖死；补 ALPN 声明、请求头规范化（Host 置首、头名规范大小写）；并发上限 32 → 64。
- 桌面端：「跟随系统代理」现在能读到 Windows 注册表里的代理设置（多数代理软件只写注册表，之前读不到）。
🧩 源解析能力（面向源作者）
- 动态分类：源可声明分类接口，分类列表由源接口实时下发，失败自动回落到静态分类表——站点改分类不用再等源更新。
- 预取可拿响应头：单条 JSON / 文本预取会把响应头一并交给脚本，播放凭证放在响应头里的站点也能写了。
- 详情集数映射：修正详情接口里集数字段的映射，集数显示更准。
- JS 沙箱异步入口：源脚本的异步入口按 Dart-Future 形态落到统一 Promise 处理，回调时机更可预期。
- Cookie 合并：显式 Cookie 头与会话 Cookie 按名合并，不再互相顶掉。
🔔 公告、Bangumi 与稳定性
- 公告页秒开：打开先用本地（内存 → 缓存 → 内置资源）立刻渲染，再后台拉远程；远程三个来源改成阶梯并发（600ms 一档，前面的成功就不发后面的）、同一份文件不会重复下载，整体 8 秒硬上限。
- Bangumi 授权 401 修好：令牌端点支持官方地址兜底（镜像不转发也能续期）；refresh 被拒时明确提示重新授权而不是一直挂着「已登录」；过期前 12 小时自动预续期；粘贴的令牌自动净化（零宽字符 / 引号 / 多余前缀），脏令牌能自愈。
- 跨平台备份不再炸启动：导入其他平台导出的备份后，路径型配置（下载目录、导出目录、截图目录等）按平台判定并过滤，已中招的用户升级后启动即自修复；损坏的数据库文件会留档隔离而不是直接崩。
- 列表卡片点击修复：部分页面点卡片会报 Material 缺失导致崩溃，已修（同时改善涟漪裁切）。
- 多实例 Hero 冲突：空 id 条目改用稳定哈希做标签，列表里多个同类条目不再撞车。
- 标签混排漏译：详情页「奇幻 Fantasy」这类单词级混排标签不再被误判为已是目标语言；回显文本不再写进缓存。
📄 文档
- 源编写教程重组：按 22 节分级（基础 / 中级 / 高级）重新组织，官网与仓库开发文档同步，字段速查补上媒体域名改写。
- 鸿蒙安装指南：新增《鸿蒙安装与更新指南》，README 安装段改为「安装器 / 手动侧载」双路径。
⬆️ 升级方式
- Android / 桌面端：沿用同一签名密钥，可直接覆盖安装；也可在应用内「设置 → 关于 → 检查更新」自动升级。
- 鸿蒙：下载
NexHub-ohos-arm64-unsigned.hap，自行签名后覆盖安装；安装与更新细节见仓库docs/OHOS_INSTALL_GUIDE.md。
⚠️ 已知限制
- 双栏详情只在窗口宽度 ≥1120 时生效；手机、窄窗口与分屏小窗仍是整页模式。
- 鸿蒙平板已加入设备类型，平板上的细节适配仍在持续推进，遇到布局问题欢迎反馈。
- 加密通道依赖服务端下发 retry 配置：若目标边缘不下发，会自动回落到直连，此时能否连通取决于你的网络环境。
- 正文净化的内置规则是通用模板，不同站点的广告形态差异大，仍建议按需增删；规则改动在重新打开章节后生效。
📄 免责声明
- NexHub 不内置任何内容源，所有内容均来自你自行导入的「源」；请在导入前自行确认来源的合法性与安全性，使用产生的风险由用户自行承担。
NexHub v3.4.0
NexHub v3.4.0（正式版）
四合一媒体聚合客户端（动漫 / 漫画 / 小说 / 影视）—— 源即插件 · 共创社区。
🎉 正式版说明
NexHub 3.4.0 正式版来了。本次主角是桌面卡片（小组件）：把「继续观看、追更、下载、统计」直接摆到手机桌面，配色与统计页同源、深浅色跟随系统；同时修掉三类真问题——长列表入场动画刷屏、中英混排漏译、统计口径走漏隐藏源，设置里还补上了「软件公告」与「联系我们」。基础功能完整、可安全升级。
- 这是什么版本：3.4.0 正式版；Android / Windows / Linux / macOS / iOS / 鸿蒙六平台产物统一发布在同一个 Release。
- 数据兼容性：经代码核查，无破坏性数据变更——书架 / 收藏 / 进度 / 书签 / 历史 / 分组直接沿用；旧源 JSON 无需修改、无需重新导入；沿用同一签名密钥可直接覆盖安装。
- 鸿蒙安装方式：HAP 统一不带签名，请用端侧签名工具自行签名后安装（或 DevEco Studio / hdc 侧载）。
⚠️ 本应用不内置任何内容源，首次打开是空的，这是正常现象。请先导入至少一个源 JSON（应用内「源管理 / 导入源」）才能看到内容。源由社区共享维护，请自行评估其合规性与内容合法性。
✨ 本次更新内容
🖼️ 桌面卡片（Android 小组件 · 鸿蒙服务卡片）
- 8 类卡片：继续观看、追更（收藏总数与最近收藏）、下载、统计、热力图、大数字、分模块、连续打卡。Android 按尺寸自动切换小 / 中 / 大布局；鸿蒙提供 10 张可拉伸卡片，桌面拖拽即可换尺寸。
- 继续观看显示真进度：不再只是「上次看到哪一话」的旧标题，而是按实际播放 / 阅读位置显示第 N 话或第 N 集（影视附带已看分钟数），最多 8 条槽位（默认 4 条），带封面缩略图。
- 统计类卡片与 App 统计页同源：总时长 / 作品数 / 会话数三指标分色大数字，配当月月历缩略；热力图卡是当月打卡月历（格内日期数字 + 「少 → 多」图例）；大数字卡、分模块卡、连续打卡卡各有侧重。
- 点一下就能用：继续观看直达作品详情页，统计卡直达统计页，其余卡片一键回到对应模块。
- 跟着应用主题走：卡片底色、文字与强调色跟随当前主题，系统切深色 / 浅色后卡片自动变，不需要重开应用。
- 个性化设置：新增「设置 → 外观与语言 → 桌面卡片」，可选背景来源（封面 / 主题渐变 / 纯色）、模糊强度、不透明度，以及继续观看条数（3–8）。
- 数据实时：播放进度、历史与下载任务变化后自动重算并推送；应用启动首帧、切回前台各补推一次，卡片不会长期停在旧数据上。
🔔 公告与联系
- 设置新增「关于 → 软件公告」：历史公告按日期倒序展示，支持手动刷新，打开即标记已读，不会下次启动又弹一遍。
- 关于页新增「联系我们」分组：GitHub 仓库与官方 QQ 群，点击直接跳转。
- 设置搜索同步收录公告页与 QQ 群入口，搜「公告」「反馈」「QQ」都能找到。
🐞 修复
- 入场动画不再刷屏：列表交错入场从第 13 条起起点越界，触发动画库断言、每帧往日志里刷错误；现在只对前 6 条做交错，并把起点 / 终点夹在合法区间，长列表入场反而更利落。
- 中英混排不再漏译：标题里夹着成句英文时（例如「某某某 Season 2」这类），不再被判定为「已是目标语言」而原样返回；对自动检测失灵的混排文本会显式指定外文源语言重译一次，并折叠紧邻的重复片段；界面文本遇到这种回显不写缓存，改由 AI 兜底真正翻译。
- 统计不再算入隐藏源：统计总览的作品列表按源可见性过滤，总览、近 7 / 30 天活跃与平均会话都按可见列表重算；在设置里切换隐藏或年龄限制开关后立即生效，不再残留已隐藏源的记录。
🪟 平台与构建
- Windows 兼容新版 CMake：VS 自带 CMake 4.x 移除了对旧式最低版本声明的兼容，PDF 组件在下载配置阶段直接失败、构建中断；现已在项目级注入策略下限（并传给派生的子构建进程），Windows 端构建恢复正常。
📄 文档
- README 中英双语改为居中头部：应用图标、一句话定位、技术栈与发行徽章、平台徽章、语言切换与 QQ 群入口，一眼看清项目定位与下载渠道。
🧹 内部
- 桌面卡片的快照键、背景预渲染与主题快照做了跨端对齐（Android 与鸿蒙共用同一份数据契约）；本地化文案补齐中英两版。无破坏性依赖变更。
⬆️ 升级方式
- Android / 桌面端：沿用同一签名密钥，可直接覆盖安装；也可在应用内「设置 → 关于 → 检查更新」自动升级。
- 鸿蒙：下载
NexHub-ohos-arm64-unsigned.hap，自行签名后覆盖安装。 - 桌面卡片：本版起在桌面长按空白处 → 添加卡片即可找到 NexHub 的 8 类卡片；旧版添加过的统计卡（2×2 老布局）请移除后重新添加一次。
⚠️ 已知限制
- 桌面卡片仅 Android 与鸿蒙提供（iOS 与桌面端暂不支持）。
- 追更卡目前展示收藏总数与最近收藏，联网「新章检测」尚未接入，后续版本补上。
- 桌面卡片不做系统级定时刷新，数据以应用最后一次推送为准（鸿蒙另有约 30 分钟的系统兜底刷新）；建议添加卡片后先打开一次应用。
- Android 大卡固定显示 4 条记录（系统卡片容器不支持动态增删行），鸿蒙大卡显示 5 条。
- 鸿蒙卡片背景为主题色 / 纯色（平台不提供跨进程动态背景图通道），封面缩略图正常显示。
- 统计类卡片与热力图按月生成，跨月后需要应用刷新一次才会切到新月份。
- 卡片配色依赖应用最近一次主题快照：更换主题后，需打开一次应用才会同步到卡片。
📄 免责声明
- NexHub 不内置任何内容源，所有内容均来自你自行导入的「源」；请在导入前自行确认来源的合法性与安全性，使用产生的风险由用户自行承担。
NexHub v3.3.0
NexHub v3.3.0（正式版）
四合一媒体聚合客户端（动漫 / 漫画 / 小说 / 影视）—— 源即插件 · 共创社区。
🎉 正式版说明
NexHub 3.3.0 正式版来了。本次是翻译与阅读体验的一次集中升级：小说翻译加入上下文增强、术语闭环、精译模式与 AI 审校；漫画翻译改为「单次优先 + 两阶段兜底」更稳更省；小说阅读器新增多角色朗读、划词翻译、问 AI、笔记导出、划线云同步与阅读趋势图；鸿蒙端补齐 PC（2in1）适配与跨设备接续等特有能力。基础功能完整、可安全升级。
- 这是什么版本：3.3.0 正式版；Android / Windows / Linux / macOS / iOS / 鸿蒙六平台产物统一发布在同一个 Release。
- 数据兼容性：经代码核查，无破坏性数据变更——书架 / 收藏 / 进度 / 书签 / 历史 / 分组直接沿用；旧源 JSON 无需修改、无需重新导入；沿用同一签名密钥可直接覆盖安装。
- 鸿蒙安装方式：HAP 统一不带签名，请用端侧签名工具自行签名后安装（或 DevEco Studio / hdc 侧载）。
⚠️ 本应用不内置任何内容源，首次打开是空的，这是正常现象。请先导入至少一个源 JSON（应用内「源管理 / 导入源」）才能看到内容。源由社区共享维护，请自行评估其合规性与内容合法性。
✨ 本次更新内容
🌐 翻译体系升级（小说 / 漫画 / 详情页）
- 上下文增强：分块翻译注入滚动前文译文、批边界续句提示与下一段原文，并支持前章尾部衔接——长章节的指代与语气更连贯，不再「每块各译各的」。
- 术语闭环：术语表按当前批原文实际出现与否过滤；译后从译文自动提取术语（新词入库、同译合并别名、异译只记冲突不覆盖），后续分块立即生效；新增「作品术语页」展示全局 + 作品生效表与待裁决冲突，支持采用 / 保留。
- 译文缓存指纹与过期提示：原文、术语或翻译风格变更后，旧缓存会被标记过期并提示一键重译；旧缓存无指纹不会误判。
- 精译模式：每块并发生成三路不同温度草稿再逐段合成最终译文；草稿部分失败自动降级，绝不因精译失败阻断整章。默认关闭（约 4× token），切换后自动提示译文过期。
- AI 审校：审查页新增云端逐段审校，一次请求产出问题清单与修订全文；修订以「影子」形式存在，只有你采纳才写回缓存。
- 漫画翻译更稳更省：改为「单次优先 + 两阶段兜底」——视觉一次出译文，校验失败纠错重试，再降级 OCR → 逐条翻译；严格 ID 协议与定向补译避免漏译错位，每页最多 5 次请求；支持部分结果状态、后台补译与跨会话续补，覆盖层只渲染真实译文并提供徽标与手动重试。
- 详情页翻译三处修复：长按不再被手指自然抖动吞掉（40px 容错）；长按标签不再只弹「按标签搜索」提示（手势归属翻译）；翻译开关改为即时保存；已是目标语言时给出「无需翻译」提示。
📖 小说阅读与朗读
- 多角色朗读：角色卡管理（名字 / 别名 / 性别 / 双域音色绑定），路由按「角色绑定 → 全局映射 → 性别槽 → 旁白槽 → 默认」双域兜底；HTTP TTS 滑动窗口并发合成按序播放（首句即播）、音频缓存重听零网络；系统 TTS 逐句按角色分声（鸿蒙退化为单声）。
- AI 分镜归因：两段式识别本章说话人（只返回角色 / 性别 / 置信度，不返回正文），章级缓存；新说话人自动建卡，未配置 AI 时静默回退本地规则。
- 跨章连播：角色朗读可开启跨章自动续读，会话隔离防串台。
- 阅读器六项增强：选区工具条新增「翻译」「问 AI」（携带章节上下文）；笔记 / 标记支持 Markdown 导出；划线笔记 WebDAV 细粒度同步（逐书文件、集合并集合并）；统计总览新增近 7 / 30 天阅读时长趋势折线图；在线 TTS 内置 Edge 语音并支持音色试听。
- 互动阅读层：新增开关与中心点按聚焦（翻页单页且未缩放 / 未旋转时启用），只影响阅读器叠加层。
- 选区工具条宽屏等宽均分、窄屏横向滑动；工具条背景铺满到屏幕底，消除系统导航栏空白条。
⚙️ 设置与 AI
- AI 设置页重排为「通用接口 / 内容生成 / 翻译」三段分区，去掉二级折叠，嵌套小卡改平铺。
- 新增**「问 AI」专用端点配置卡**：留空自动回落通用接口，对话优先使用专用配置。
- 云同步页新增「同步划线笔记」按钮与状态卡（本机条数 / 书目数 / 上次同步结果）。
- Edge TTS 音色下拉与试听按钮统一新样式。
📱 鸿蒙（HarmonyOS / OpenHarmony）
- PC（2in1）适配：新增设备形态与窗口控制通道，按设备类型区分 PC 与手机——PC 上正常初始化桌面窗口、滚动条、阅读器窗口全屏；目录导入 6 个入口在 PC 恢复（系统文件夹选择 + 复制进沙箱），手机端保持降级。
- 特有能力补齐：跨设备接续（流转接管后按章节窗口与位置重建播放 / 阅读）、后台下载保活、应用分身（最多 5 实例）、窗口矩形记忆、状态栏点按回到顶部、旋转与 2in1 布局适配。
- CI 出包补齐 ECH 引擎：鸿蒙构建自动交叉编译
libechproxy.so并校验体积与导出符号，干净环境打出的 HAP 不再静默缺失 ECH。
🐞 修复
- Bangumi 401 自动续期：access_token 过期后自动用 refresh_token 刷新并重试原请求（并发共用一次刷新）；个人 token 无法续期时保留原始错误提示。
🙏 致谢
- 小说翻译优化的思路与体验得益于 wenyi（MIT © BigDawnGhost）——翻译管线各阶段为净室独立实现，仅在致谢面署名。
🧹 内部
- 补齐本地化生成产物（问 AI / 划线同步 / 试听等文案）；注释与文档延续中性表述清理；无破坏性依赖变更。
⬆️ 升级方式
- Android / 桌面端：沿用同一签名密钥，可直接覆盖安装；也可在应用内「设置 → 关于 → 检查更新」自动升级。
- 鸿蒙：下载
NexHub-ohos-arm64-unsigned.hap，自行签名后覆盖安装。
⚠️ 已知限制
- 精译模式与 AI 审校依赖已配置的 AI 端点，会产生更多 token 消耗（精译约 4×）。
- 多角色朗读的 AI 分镜需要配置小说总览端点；未配置时回退本地规则（精度略低）。
- 鸿蒙：本地文件夹导入、自定义任意目录、插件 / 备份导出仍受系统目录选择能力限制（PC 形态已恢复）；模拟器（x64）无视频播放与 ECH 引擎。
📄 免责声明
- NexHub 不内置任何内容源，所有内容均来自你自行导入的「源」；请在导入前自行确认来源的合法性与安全性，使用产生的风险由用户自行承担。
NexHub v3.2.0
NexHub v3.2.0（正式版）
四合一媒体聚合客户端（动漫 / 漫画 / 小说 / 影视）—— 源即插件 · 共创社区。
🎉 正式版说明
NexHub 3.2.0 正式版来了。这是鸿蒙（HarmonyOS / OpenHarmony）适配正式落地的一个版本：arm64 真机完整支持，与 Android 对齐源解析、播放、弹幕、画中画、朗读、投屏等核心链路；同时新增 iOS 未签名构建、内置免费翻译（Bing），并恢复投屏、莫奈壁纸取色、音量键翻页等能力。基础功能完整、可安全升级。
- 这是什么版本：3.2.0 正式版；Android / Windows / Linux / macOS / iOS / 鸿蒙六平台产物统一发布在同一个 Release。
- 数据兼容性：经代码核查，无破坏性数据变更——书架 / 收藏 / 进度 / 书签 / 历史 / 分组直接沿用；旧源 JSON 无需修改、无需重新导入；沿用同一签名密钥可直接覆盖安装。历史记录与收藏、下载任务会在首次启动时自动迁移到独立文件存储，过程无感、旧数据保留兜底。
- 鸿蒙安装方式：HAP 统一不带签名，请用端侧签名工具自行签名后安装（或 DevEco Studio / hdc 侧载）。
⚠️ 本应用不内置任何内容源，首次打开是空的，这是正常现象。请先导入至少一个源 JSON（应用内「源管理 / 导入源」）才能看到内容。源由社区共享维护，请自行评估其合规性与内容合法性。
✨ 本次更新内容
📱 鸿蒙（HarmonyOS / OpenHarmony）正式支持
- 四合一聚合与「源即插件」架构完整移植：源导入与解析全链路可用，内嵌 JavaScript 脚本源同样可跑（自研 QuickJS 原生桥）；漫画 / 小说 / 影视阅读观看完整。
- 视频播放：libmpv 内核（与 Android 同源），支持倍速 / 音轨 / 字幕 / 外挂字幕 / 防盗链头，弹幕同屏渲染；播放内核默认开启，亮度 / 音量手势控制升级到内置鸿蒙平台官方实现。
- 系统能力对齐：画中画小窗（含控制面板）、系统通知（RSS 等）、图片保存进系统相册（系统确认框、免权限）、剪贴板图片粘贴（原生 pasteboard）、系统级「另存为」导出。
- 朗读：系统 CoreSpeechKit 离线引擎（中文、语速、后台朗读、播放完成续读），也可配置自建在线 HTTP TTS。
- 阅读器音量键翻页：原生按键通道，支持长按连续翻页。
- 投屏恢复：设备发现改走原生 mDNS（
_googlecast._tcp），播放器顶栏投屏入口恢复。 - 莫奈取色：接入系统壁纸主色并实时跟随壁纸变化，页面切换与回前台不重复取色。
- ECH 加速随 HAP 打包：本地 ECH/DoH 代理引擎以 FFI 接入，应用级 / 源级 / Bangumi ECH 均可用。
- 数据持久化：历史 / 收藏 / 下载任务改独立文件存储，应用强杀不丢。
- 平台差异（仍存在）：本地文件夹导入改「导入文件」逐个选择；自定义下载 / 截图目录仅限应用私有目录与系统「下载」；插件与备份导出走系统分享；播客后台通知栏暂不可用；模拟器（x64）不支持视频播放与 ECH。
🍎 iOS 支持
- 新增 未签名 IPA 构建（与 Android / 鸿蒙共用包名），侧载后用 AltStore / Sideloadly 等工具自签安装。
- 全平台显示名统一为 NexHub。
🆓 内置免费翻译
- 无 AI 配置也能翻译：详情页标题 / 标签 / 简介 / 评论、小说与字幕默认走内置免费翻译，失败或不可用时自动回退已配置的 AI。
- 连续失败自动熔断（静默 5 分钟）避免反复无效请求；术语表、非标准风格等高级需求命中时自动切 AI 优先。
- UI 文本走批量聚合与本地缓存，详情页不再逐条请求。
🎬 播放器
- 投屏恢复：投屏设备发现改用原生 mDNS，顶栏投屏入口回归。
- 缓冲档位对齐：修复省流档缓冲过浅导致的轻微卡顿。
- 播放诊断日志：播放启动时记录实际软 / 硬解状态与缓存档位，卡顿类反馈可直接从日志定位（鸿蒙硬解缺失会静默回退软解）。
- 画中画接入社区适配版本，鸿蒙与 Android 双平台可用。
📚 阅读器
- 鸿蒙阅读器支持音量键翻页（原生按键拦截，长按连续翻页）。
- 鸿蒙朗读入口恢复（系统离线 TTS + 在线 HTTP TTS），此前因缺少平台实现被隐藏。
🕘 数据与稳定性
- 历史记录改独立文件持久化，修复重启后历史丢失。
- 收藏与下载任务改独立文件存储，带一次性无感迁移。
- 文件偏好按键串行写入，修复并发落盘崩溃。
- 鸿蒙 QuickJS 释放竞态刷屏修复；图片保存补写回步骤，修复「提示成功但图库没有」。
- 弹幕凭据未配置时跳过整批匹配，消除逐集无效请求与日志刷屏。
- 修复鸿蒙下取消导入导致的崩溃；导出范围选择改为实时刷新。
- 安装包按平台严格匹配；鸿蒙版检查更新改为跳转浏览器发布页（HAP 不支持应用内安装）。
🎨 界面
- 页面转场改为各平台系统默认（Android 预测性返回 / Zoom，桌面 Zoom，iOS / macOS 侧滑），不再强制零动画瞬切。
- 鸿蒙返回时强调色突变修复；加载页首帧直显壁纸主色。
- 存储位置弹层横屏 / 小窗溢出修复；低配整卡模式下源卡片不再包裹无源空白。
🧹 内部
- CI 发版纪律统一：任何
v*标签都构建全部平台，鸿蒙 HAP 追加到同一个 Release；不再使用平台后缀标签单独发版。 - 平台判定全仓收口到统一服务；鸿蒙依赖换源与本地补丁、降级矩阵、README 重写；鸿蒙构建链（hvigor）CI 自愈与失败诊断强化。
- 注释与文档延续中性表述清理；无新增破坏性依赖变更。
⬆️ 升级方式
- Android / 桌面端：沿用同一签名密钥，可直接覆盖安装；也可在应用内「设置 → 关于 → 检查更新」自动升级。
- 鸿蒙：下载
NexHub-ohos-arm64-unsigned.hap，自行签名后覆盖安装。
⚠️ 已知限制
- 鸿蒙：本地文件夹导入、自定义任意目录、插件 / 备份导出受系统目录选择能力限制，均提供替代路径；模拟器（x64）无视频播放与 ECH 引擎。
- 鸿蒙 ECH 引擎与播放内核仅有 arm64 产物，x64 调试构建已带 QuickJS / WebView 原生库。
- 内置免费翻译为非官方公开接口，可能随时失效；失效时自动回退 AI 或显示原文。
📄 免责声明
- NexHub 不内置任何内容源，所有内容均来自你自行导入的「源」；请在导入前自行确认来源的合法性与安全性，使用产生的风险由用户自行承担。
NexHub v3.1.1-ohos-beta.1
NexHub v3.1.1-ohos-beta.1（鸿蒙预览版）
四合一媒体聚合客户端（动漫 / 漫画 / 小说 / 影视）—— 源即插件 · 共创社区。
🎉 首个鸿蒙版（预览）
NexHub 鸿蒙（HarmonyOS / OpenHarmony）适配版首个预览发布。四合一聚合与「源即插件」架构完整移植：源导入与解析（含内嵌脚本源）、漫画 / 小说 / 影视阅读观看、弹幕、下载、收藏、Bangumi 同步全链路可用。基础功能完整，欢迎真机试用并反馈问题。
- 这是什么版本：鸿蒙平台首个预览版（beta），仅提供未签名安装包，适合愿意折腾侧载的用户尝鲜；Android / Windows / Linux / macOS 请继续使用各平台正式版安装包，本版本不包含其安装文件。
- 运行要求：HarmonyOS / OpenHarmony arm64 真机；模拟器暂不支持视频播放。
- 数据兼容：无破坏性变更。首次启动会自动把历史记录、收藏、下载任务迁移到独立文件存储，过程无感，旧数据保留兜底。
- 应用内更新：鸿蒙版检查到新版本时会直接打开浏览器发布页下载（HAP 不支持应用内安装）。
📲 安装方式（侧载）
- 从下方附件下载
NexHub-ohos-arm64-unsigned.hap（未签名安装包）； - 使用端侧签名安装工具对安装包自行签名后安装，或通过 DevEco Studio / hdc 安装；
- 首次打开后到「源管理 / 导入源」导入至少一个源 JSON，导入后即可使用。
⚠️ 本应用不内置任何内容源，首次打开是空的，这是正常现象。源由社区共享维护，请自行评估其合规性与内容合法性。
✨ 鸿蒙版已支持
- 源解析与阅读全链路：声明式选择器 + 内嵌 JS 脚本源（QuickJS 引擎），漫画 / 小说图文链路完整；
- 视频播放：libmpv 内核（与 Android 同源），支持倍速 / 音轨 / 字幕轨 / 外挂字幕 / 防盗链头，弹幕同屏渲染；
- 画中画：系统小窗，控制面板可播放 / 暂停 / 快进快退；
- 系统能力：系统通知（RSS 订阅等）、图片保存进系统相册（系统确认框，免权限）；
- 数据持久化：收藏 / 下载任务 / 历史记录独立文件存储，应用强杀后不丢；
- 账号与更新：Bangumi 登录与同步（应用内授权完成）、应用内更新跳转浏览器发布页。
⚠️ 已知差异（预览版）
| 功能 | 现状 | 替代 / 说明 |
|---|---|---|
| 本地文件夹导入 / 自定义下载目录 / 自定义截图目录 | 目录选择暂不可用 | 改走「导入文件」逐个选择；下载 / 截图落应用内默认位置 |
| 插件导出 / 备份导出 | 无目录选择 | 落默认位置后通过系统分享保存 |
| 源 WebView 网络跟随 | 不跟随源级代理 / hosts / DoH | HTTP 抓取链路不受影响，仅 WebView 内页面受影响 |
| 剪贴板图片导入 | 暂不可用 | 有路径复制兜底 |
| 离线朗读（TTS）/ 音量键翻页 / 投屏 | 暂不可用（入口隐藏） | — |
| Material You 莫奈取色 / ECH 加速 / 播客后台通知栏 | 暂不支持 | 回退默认主题色 / 直连 / 应用内播放不受影响 |
| 模拟器（x64） | 不支持视频播放 | 播放内核仅提供 arm64 真机产物 |
NexHub v3.1.0
NexHub v3.1.0（正式版）
四合一媒体聚合客户端（动漫 / 漫画 / 小说 / 影视）—— 源即插件 · 共创社区。
🎉 正式版说明
NexHub 3.1.0 正式版来了。本次在 3.0.0 稳定基础上继续打磨：播放器与视频嗅探能力大幅增强（逐帧步进、起播自动全屏、嗅探候选选优防广告冒充），搜索接入实时热词与更稳的提交方式，并修复历史封面丢失、应用内更新下载受阻、Windows 安装包缺 ECH 引擎等问题。基础功能完整、可安全升级。
- 这是什么阶段：3.1.0 正式版，面向全部用户的稳定更新；从 v3.0.0 覆盖安装即可。
- 数据兼容性：经代码核查，无破坏性数据变更——书架 / 历史 / 收藏 / 进度 / 书签直接沿用；旧源 JSON 无需修改、无需重新导入；沿用同一签名密钥，可直接覆盖安装。
- 运行要求：ECH 由内置原生引擎（OpenSSL）驱动，随 Android APK（三架构）与 Windows 桌面端打包生效；macOS / Linux 自动降级为直连，不影响其他功能。本版 Windows 安装包已补齐 ECH 引擎 DLL 并加 CI 产物校验。
⚠️ 本应用不内置任何内容源，首次打开是空的，这是正常现象。请先导入至少一个源 JSON（应用内「源管理 / 导入源」）才能看到内容。源由社区共享维护，请自行评估其合规性与内容合法性。
✨ 本次更新内容
🎬 播放器
- 逐帧步进：暂停时中央播放键两侧新增「上一帧 / 下一帧」按钮，按容器真实帧率精确走帧；桌面端键盘「逗号 = 上一帧、句号 = 下一帧」（播放中按下会先暂停再走帧）。
- 起播自动全屏：视频起播即进入全屏沉浸（自动横屏），底栏全屏按钮移除——移动端系统返回键退出播放页，桌面端保留 F 键全屏切换；切集 / 自动连播每集重新全屏，画中画与断流自愈不误触发。
- 播放器左缘锁定、右缘截图按钮与中央播放键对齐到同一条水平线。
- 播放失败页新增返回栏：解析失败或自动重连耗尽后，错误页顶部提供半透明返回栏，不再「卡在错误页无路可退」。
🔍 搜索
- 搜索热词接入实时数据：热词改为实时拉取注目榜条目，自动补全中文名并本地缓存；榜单不可用时自动回退实时热搜接口；历史热词胶囊支持长按删除单条。
- 源搜索改为回车提交：输入过程中不再实时跨源检索，避免打字途中连发请求；回车 / 搜索键 / 点历史与热词胶囊才会触发搜索。
🧲 视频嗅探与线路
- 嗅探候选排序选优：按「播放列表 / 整片 > ts 分片 > 视频类型 > 其它」排序取最优，无扩展名的广告占位视频不再顶掉真直链。
- 无头嗅探接入网络层被动捕获：覆盖 iframe 内播放器、Worker fetch 等钩子盲区，捕获即提前返回。
- 首次嗅探超时 12s → 15s：慢链路（播放页 → 跨域播放器 iframe → hls.js）实测可达 10s+，更从容。
- 无扩展名媒体直链提权、嗅探不再跳到顶层播放器页，修复部分站点的「精品线路」真链捕获。
🕘 历史记录
- 修复历史封面丢失：本地入口合并继承封面、封面信息穿透阅读器，缓存文件名加模块前缀防串写。
- 启动回填封面时，不可达的源打标跳过，不再整批重发封面请求。
⬆️ 更新与安装
- 修复「测速时无法下载新版本」：镜像探测加硬时限与自卫取消，候选镜像分批限流 + 总预算控制。
- Windows 安装包补齐 ECH 本地引擎 DLL 并加 CI 产物校验——此前 Windows 安装版 ECH 因缺 DLL 不生效，本版起真正可用。
🧹 内部
- 注释与文档中性化清理、CI 构建脚本调整、仓库忽略规则修订——不影响使用。
⬆️ 升级方式
- 沿用同一签名密钥，可直接覆盖安装；也可在应用内「设置 → 关于 → 检查更新」自动升级。
⚠️ 已知限制
- 逐帧步进依赖播放内核的逐帧命令能力，个别容器格式下按内核回退步长（约 1/24 秒）走帧。
- Windows ECH 引擎需本版安装包才带 DLL，请通过本版安装包覆盖安装。
📄 免责声明
- NexHub 不内置任何内容源，所有内容均来自你自行导入的「源」；请在导入前自行确认来源的合法性与安全性，使用产生的风险由用户自行承担。
NexHub v3.0.0
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 不内置任何内容源。首次安装后需要自行导入源，才能看到内容。
NexHub v3.0.0-beta.4
NexHub v3.0.0-beta.4（预发布测试版）
四合一媒体聚合客户端（动漫 / 漫画 / 小说 / 影视）—— 源即插件 · 共创社区。
🧪 预发布说明
NexHub 3.0.0 的第四个预发布测试版（beta.4） 来了。本次主线是网络连通性加固与细节打磨：ECH 加密握手引擎完成多平台化（Android 三架构 + Windows 桌面），代理 / Hosts / WebView 一整条链路打通；源编辑页拆分为五页签、筛选面板与源编辑页折叠懒加载更顺手；刘海屏沉浸全屏黑边修复；应用内更新弹窗终于能完整展示发布说明（自建轻量 markdown 渲染，不再被截断）。
- 这是什么阶段：相对 beta.3 是一次以「网络链路加固 + 界面细节打磨 + 更新弹窗修复」为主的小幅更新，仍处测试阶段，可能有个别体验问题。
- 数据兼容性：经代码核查，无破坏性数据变更——收藏 / 进度 / 书签 / 历史 / 分组 / 评分 / 短评可直接沿用；旧源 JSON 无需修改、无需重新导入；沿用同一签名密钥，可直接覆盖安装。
- 建议：想在 Windows 桌面端也用上 ECH，或遇到过更新弹窗发布说明被截断、刘海屏黑边的朋友欢迎升级并反馈；追求绝对稳定的可继续用 2.0.3 正式版。
- 运行要求：ECH 由内置原生引擎（OpenSSL）驱动，现已随 Android APK（arm64-v8a / armeabi-v7a / x86_64 三架构）与 Windows 桌面端 打包生效；macOS / Linux 暂未打包原生库，会自动降级为直连，不影响其他功能。其余（代理 / DNS / Hosts / SNI）依旧全部真实生效。
⚠️ 本应用不内置任何内容源，首次打开是空的，这是正常现象。请先导入至少一个源 JSON（应用内「源管理 / 导入源」）才能看到内容。源由社区共享维护，请自行评估其合规性与内容合法性。
✨ 本次相较 v3.0.0-beta.3 的核心变化
🌐 网络：ECH 多平台化 + 代理 / Hosts / WebView 全链路打通
- ECH 引擎多平台化：原生 ECH 引擎（OpenSSL）现已覆盖 Android 三架构（arm64-v8a / armeabi-v7a / x86_64）+ Windows 桌面端（FFI 接入）；Bangumi 的 ECH 并入连接模式「三选一」统一开关。
- 作用域不变：应用级（接管任意 https 域、逐域自适应回落）/ 源级（
network.ech可在源 JSON 或 UI 覆盖单独开关）/ Bangumi 专用三档。 - 自动降级：macOS / Linux 未打包原生库时整套自动回退为直连，不拖垮其他网络功能。
- 作用域不变：应用级（接管任意 https 域、逐域自适应回落）/ 源级（
- 源内置 Hosts 全通路生效：源 JSON 里声明的
hosts现在真正接入 WebView / 嗅探 / 下载 三条链路，并补上多 IP 故障转移（DNS 解析出多个 IP 时逐个重试，修复「浏览器能开、应用超时」）。 - 静态代理规则跟随：Android WebView 现在跟随改走静态代理规则（ProxyConfig 不支持 PAC，自动识别并避开 PAC）。
- Windows DIRECT 兜底修根因：WebView2 的
host-resolver-rules加引号防止命令行被空格切碎——这是此前 Windows 端 DIRECT 兜底从未真正生效的根因，现修复。
🗂️ 源编辑页重构
- 拆分五页签：源编辑页按「基本信息 / 网络 / 解析 / 筛选 / 高级」拆分为五个页签，长表单不再一屏滚到天荒地老。
- 模块化折叠：结合下方筛选面板的折叠懒加载能力，源编辑页各模块支持按需折叠，结构更清晰、加载更轻。
🔍 筛选面板
- 分组折叠懒加载：筛选面板的分组支持折叠，且折叠态不渲染内容（懒加载），分组多、条目长的源打开更快、更省内存。
📱 Android 刘海屏
- 沉浸全屏黑边修复：主题新增
windowLayoutInDisplayCutoutMode=shortEdges，阅读器等沉浸全屏场景的顶部黑边消除，刘海 / 挖孔屏不再被遮挡或留黑。
🔒 隐私
- 隐藏源历史展示层过滤：隐藏源（如限制级）不再在「历史」展示层露出。
- 无痕判定口径统一：无痕模式的判定逻辑统一收敛，避免不同入口口径不一致；无痕状态在菜单中文字化呈现，状态一眼可见。
🔄 应用内更新
- 发布说明完整展示：更新弹窗不再被「6 行截断」，自建轻量 markdown 渲染器，能正确展示标题、列表、加粗等基础排版，长发布说明也能读全。
🔧 工程与文档（内部）
- 代码注释、提交信息与文档延续中性表述清理。
- 本版无新增第三方依赖，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.3 一致。
📦 下载说明
- 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 不内置任何内容源。首次安装后需要自行导入源，才能看到内容。
NexHub v3.0.0-beta.3
NexHub v3.0.0-beta.3（预发布测试版）
四合一媒体聚合客户端（动漫 / 漫画 / 小说 / 影视）—— 源即插件 · 共创社区。
🧪 预发布说明
NexHub 3.0.0 的第三个预发布测试版（beta.3） 来了。本次主线是界面可定制性与网络连通性：全局字体设置、详情页外观自定义、源管理列表重做，以及此前预留的 ECH 加密握手现已实装可用；同时媒体服务器浏览与性能、嗅探器、桌面端体验继续打磨。
- 这是什么阶段：相对 beta.2 是一次以「界面个性化 + 网络增强 + 源 / 媒体服务器打磨」为主的功能型更新，仍处测试阶段，可能有个别体验问题。
- 数据兼容性：经代码核查，无破坏性数据变更——收藏 / 进度 / 书签 / 历史 / 分组 / 评分 / 短评可直接沿用；旧源 JSON 无需修改、无需重新导入；沿用同一签名密钥，可直接覆盖安装。
- 建议：想抢先体验字体 / 详情外观自定义与 ECH 连通增强的朋友欢迎升级并反馈；追求绝对稳定的可继续用 2.0.3 正式版。
- 运行要求：ECH 由内置原生引擎驱动，当前主要随 Android APK 生效；非 Android 平台或缺失原生库时自动降级为直连，不影响其他功能。
⚠️ 本应用不内置任何内容源，首次打开是空的，这是正常现象。请先导入至少一个源 JSON（应用内「源管理 / 导入源」）才能看到内容。源由社区共享维护，请自行评估其合规性与内容合法性。
✨ 本次相较 v3.0.0-beta.2 的核心变化
🌐 网络：ECH 加密握手实装可用
此前版本中 ECH 仅是「预留开关」，本次移植了原生 ECH 引擎并真正接通，对直连 HTTPS 生效，不再依赖外部代理：
- 三档作用域：应用级（接管任意 https 域，不支持 ECH 的站点由原生侧逐域自适应回落，不会搞断正常站点）、源级（只接管该源
site.baseUrl的 host，可在源 JSONnetwork.ech或 UI 覆盖里单独开关）、Bangumi 专用。 - 自动降级：原生库缺失（非 Android / 未打包）时整套自动回退为直连，不拖垮其他网络功能。
- 源作者可在源 JSON 的
network.ech声明推荐配置，跟随源一键生效。
🎨 界面与主题
- 全局字体设置：新增「跟随系统 / 三款内置 OFL 开源字体 / 自定义导入字体」三档，界面文字风格由你定。
- 详情页外观设置：封面动态强调色（从封面取主色做点缀）+ 封面模糊背景，详情页更有氛围感。
📄 详情页交互
- 窄屏下章节列表支持滑动操作，全类型内容支持网格模式，信息 chips 精简，浏览更顺手。
- 在线浏览的「换源」改为标题底部弹窗，移除了原先占位置的源 chip 栏，顶部更干净。
🗂️ 源管理
- 源列表统一为连体卡片样式，并支持拖拽排序，常用源随手置顶。
🔍 嗅探器
- 嗅探结果面板高度支持拖拽自定义，且初始默认折叠，不抢画面。
🖥️ 媒体服务器（Emby / Jellyfin）
- 浏览与性能：海报分辨率按屏幕密度自适应 + backdrop 预取，新增合集浏览，搜索历史与防串台，统计面板加入媒体服务器数据维度。
- 桌面端：支持鼠标拖动横向滚动；源管理里的媒体服务器区块随列表一起滚动。
🐛 源修复与文档
- 部分受 Cloudflare 保护的动漫源工程化修复：验证墙重抛机制、WebView2 代理支持、失效域名迁移、标签数组筛选，抓取更稳。
- 文档：媒体服务器能力并入核心特色详解（中 / 英）。
🔧 工程与文档（内部）
- 代码注释、提交信息与文档延续中性表述清理。
- 本版无新增第三方依赖，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.2 一致。
📦 下载说明
- 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 APK 生效：非 Android 平台或缺失原生库时自动降级为直连；其余（代理 / 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 不内置任何内容源。首次安装后需要自行导入源，才能看到内容。
NexHub v3.0.0-beta.2
NexHub v3.0.0-beta.2（预发布测试版）
四合一媒体聚合客户端（动漫 / 漫画 / 小说 / 影视）—— 源即插件 · 共创社区。
🇨🇳 国庆快乐
今天是 2026 年 10 月 1 日，中华人民共和国成立 77 周年。NexHub 全体共建者祝大家国庆假期快乐：愿你放假这几天能安心躺平，追番、读漫、看片两不误；出门在外的，也愿你在人海与山川之间玩得尽兴。山河远阔，人间烟火，假期愉快！🇨🇳🎉
🧪 预发布说明
NexHub 3.0.0 的第二个预发布测试版（beta.2） 来了。本次的核心是——接入你自建的媒体服务器（Emby / Jellyfin），浏览、搜索、播放、收藏、进度全打通；同时漫画阅读器迎来图片超分与缓存自动清理。
- 这是什么阶段：相对 beta.1 新增了完整的媒体服务器客户端能力与漫画图片超分，属于功能型更新。它仍处于测试阶段，可能有个别体验问题。
- 数据兼容性：经代码核查，无破坏性数据变更——收藏 / 进度 / 书签 / 历史 / 分组 / 评分 / 短评可直接沿用；旧源 JSON 无需修改、无需重新导入；沿用同一签名密钥，可直接覆盖安装。
- 建议：想抢先体验媒体服务器与超分的朋友欢迎升级并反馈；追求绝对稳定的可继续用 2.0.3 正式版。
- 运行要求：媒体服务器需要你自建并可访问的 Emby / Jellyfin 服务器；图片超分在低端设备上建议按需开启。
⚠️ 本应用不内置任何内容源，首次打开是空的，这是正常现象。请先导入至少一个源 JSON（应用内「源管理 / 导入源」）才能看到内容。源由社区共享维护，请自行评估其合规性与内容合法性。
✨ 本次相较 v3.0.0-beta.1 的核心变化
🖥️ 全新：媒体服务器接入（Emby / Jellyfin）
在 NexHub 里直接连接你自建的 Emby / Jellyfin 媒体库，电影、剧集、动漫一站式浏览与播放。
- 连接与账号：按服务器地址 + 账号登录；同一服务器可配置多个地址（局域网 / 公网），连接失败自动逐个切换备用地址，应用前台期间定期探活，地址可在设置中增删管理。
- 媒体库浏览：服务器媒体库以海报墙呈现，海报统一缓存、浏览更流畅；支持按流派、年份筛选与排序；详情页沉浸式设计——视差头图、共享元素转场，追剧也有仪式感。
- 信息徽章与界面细节：海报卡显示已看徽章与观看进度轨道，单集卡显示集数徽章；详情头标题投影与信息 chips 分层；页面加载骨架屏、入口分组统一样式，媒体库页去掉冗余大标题，界面更紧凑。
- 播放增强：播放前自动在「原画直连 / 直接播放 / 服务端转码」之间三段式决策，网络不好也能出画面；可选手动码率档位与音轨切换；播放中可查看实时播放信息（码率 / 缓冲 / 流信息）；播放器内可直接切集并自动连播。
- 慢速服务器友好：媒体元数据就绪等待放宽至 30 秒 × 两轮自愈重开，公益机 / 慢速首包的服务器也能正常起播。
- 收藏与进度双向同步：收藏、已看标记与服务器双向同步；「继续观看」一键续播到上次进度；观看进度本地与服务器双写，换设备不断档。
- 全局搜索与历史：全局搜索聚合服务器内容；服务器条目进入统一历史管理，封面自动缓存，列表显示更稳；删除媒体服务器条目时，本地历史 / 收藏联动清理。
- 多服务器并存：服务器条目使用独立命名空间统一标识，多台服务器互不串扰，与本地内容、源内容泾渭分明。
📖 漫画阅读增强
- 图片超分：漫画图片支持超分辨率增强（多档位），超分入口仅对低分辨率图片自动出现，清晰度与流量自己权衡。
- 缓存分类与自动清理：漫画图片缓存按分类管理，支持自动清理策略，磁盘不再悄悄膨胀。
- 阅读界面精简：阅读器移除冗余悬浮小卡片，画面更沉浸。
🌐 稳定性修复
- WebDAV：修复某类服务端返回的 PROPFIND 响应导致解析失败的问题。
- 播放卡死探针：播放反复加载时自动区分「服务端 Cloudflare 质询拦截」与「网络不可达」，并给出可行动的提示，不再无限转圈。
- 播放地址鉴权修复：修复播放器重定向丢失鉴权参数导致画面无限加载的问题（播放地址自动补全自鉴权参数）；详情标题台标显示优先级修正。
- Android 系统栏：修复导航条透明显示与手势条内容避让，全面屏手势下不再遮挡内容。
🔧 工程与文档（内部）
- 代码注释、提交信息与文档统一中性表述，延续 beta.1 的清理工作。
- 本版无新增第三方依赖，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.1 一致。
📦 下载说明
- 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 暂不生效：Dart TLS 栈无 ECH API、无可用插件，直连暂不可行；替代路径：代理模式选手动指向支持 ECH 的本地内核，或开启系统安全 DNS 由 WebView 路径自动启用 ECH。
- 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 不内置任何内容源。首次安装后需要自行导入源，才能看到内容。