Repository navigation
Releases
聚合视频 v1.3.2
聚合视频 v1.3.2 —— 桌面界面重做 + Android 12 兼容(全平台)
Android · macOS · Linux(Arch / Fedora / openSUSE / Debian / Ubuntu / NixOS / Gentoo)
GPL-3.0-only
📱 Android 兼容范围扩大(重要)
最低支持从 Android 15 降到 Android 12(API 31),覆盖更多设备;返回键迁移 OnBackPressedDispatcher
(手势/三键行为统一,旧系统不再失效)。要求:Android 12+(arm64-v8a)。
🖥 桌面端界面重做(Linux/macOS 视觉统一)
设计 token(17 个颜色角色 × 明暗两套)+ Material Symbols 图标 + 组件库;等高 16:9 卡片网格;
macOS 同步落地(不透明底/图标字体/胶囊搜索框)。scripts/check-ui.py 保证界面只走 token。
🌟 新功能:搜索历史(三端)
空搜索词时显示历史词条(最多 15 条,去重置顶),点词条立即再搜;设置里可开关/清空,纯本地存储。
🐛 重要修复
- 拖动进度条后停播:seek 瞬间被误判"播放结束"→ 自动切条且画面冻结(Android);三端 mpv 增加
network-timeout 与断线重连 - YouTube 画质受限:SABR 实验下默认客户端只给 360p →
web_safari备选 + 档位不足自动带 cookie 重试- "请求 2K 实际 1080p"如实提示
- 「点下一个视频出错」:YouTube 搜索混入频道/播放列表条目 → 过滤 + 失败自动跳过(三端)
- 字幕「时有时无」:切歌不刷新字幕轨等四根因(Android)
- B站搜索标题 HTML 实体与时长格式(如
419:2→6:59);macOS 输入即搜改为回车触发 - Linux 隐藏来源下拉框偶发浮出压住搜索框
🙏 特别鸣谢
- @Zakkaus:桌面端 splitter/封面比例/B站标题时长四项修复(PR #3),
以及整套桌面界面重做(设计 token + Material Symbols + 组件库 + check-ui 检查)—— 本版桌面端的
新面貌主要出自他手 - @lishoujun:v1.3.0 的 YouTube 直链代理与播放链贡献
📦 安装
| 平台 | 方式 |
|---|---|
| Android 12+(arm64) | Releases 下载 hov-1.3.2-arm64.apk |
| macOS(Apple 芯片) | Releases 下载 HyperOnlineVideo-1.3.2-arm64.dmg |
| Arch / Manjaro | AUR:yay -S hov-qt(1.3.2-1) |
| Fedora 44/45 | sudo dnf copr enable houge/hov-qt && sudo dnf install hov-qt |
| openSUSE(TW / Leap) | OBS home:houge(x86_64 / aarch64 / riscv64) |
| Gentoo | gentoo-zh overlay:media-video/hov-qt |
| Debian / Ubuntu | Releases 下载 deb |
| 任意发行版 | Releases 下载 AppImage |
| NixOS | flake:github:HougeLangley/HyperOnlineVideo |
| 容器制品 | oras pull ghcr.io/hougelangley/hov-qt:1.3.2 |
完整变更:desktop/packaging/deb/debian/changelog 与提交历史。
聚合视频 v1.3.1 —— 字幕「时有时无」与「下一个视频出错」双根治(全平台)
聚合视频 v1.3.1 —— 稳定性修复版(全平台)
Android · macOS · Linux(Arch / Fedora / openSUSE / Debian / Ubuntu / NixOS)
发布日期:2026-10-17 · GPL-3.0-only
🐛 重点修复
Android(用户实测反馈 ✓)
- 字幕「时有时无」根治:逐字排查出四个根因并全修 ✓
① 切歌/连播从不刷新在线字幕轨(首条有字幕、连播后消失 ✗)
② 字幕二次解析总带失效 cookie → 改为匿名优先、cookie 重试 ✓
③ 多语言视频中文轨被无序截断丢弃 → 按系统语言排序收集 ✓
④ B站字幕退避重试 2 → 3 次 ✓ - 「点下一个视频出错」根治:YouTube 搜索结果混入频道/播放列表条目 ✗
→ 搜索侧过滤非视频形态 ✓ + 切歌失败自动跳过(上限 5 ✓ 方向感知 ✓)
🛡 稳健性(三端对齐)
- macOS / Linux 同类潜患一并消除:
- macOS:视频解析失败自动
tryPlayNext(前进最多 6 条 ✓) - Linux:新增解析失败回调 → 队列驱动失败自动跳过(上限 5 ✓ 超时不回调防风暴 ✓)
- macOS:视频解析失败自动
- 三端行为统一:队列中任何不可播放条目都会自动跳过并在界面说明 ✓
⚙️ 工程与依赖
- Kotlin/Compose 插件 2.2.20 → 2.4.21(编译 0 告警 ✓)
- Gradle 9.8.1 · AGP 9.4.1 · coroutines 1.11.0 · org.json 20260814
- CI:GHCR(GitHub Packages)产物发布 ✓ · 自托管 runner ✓ · 发布人工闸门 ✓
📦 安装
| 平台 | 方式 |
|---|---|
| Android 15+ | Releases 下载 hov-1.3.1-arm64.apk(arm64-v8a ✓) |
| macOS(Apple 芯片) | Releases 下载 HyperOnlineVideo-1.3.1-arm64.dmg(首次打开需右键→打开 ✓) |
| Arch / Manjaro | AUR:yay -S hov-qt(hov-qt 1.3.1-1 ✓) |
| Fedora 44/45 | sudo dnf copr enable houge/hov-qt && sudo dnf install hov-qt |
| openSUSE(TW / Leap) | OBS home:houge |
| Debian / Ubuntu | Releases 下载 hov-qt_1.3.1-1_amd64.deb |
| 任意发行版 | Releases 下载 HyperOnlineVideo-x86_64.AppImage |
| NixOS | flake:github:HougeLangley/HyperOnlineVideo |
🔎 验证
- Android:真机(小米 2509FPN0BC)字幕链 580/477 条实测 ✓ 连点 ⏭ ×3 全通过 ✓
- macOS:自检 119/119 ✓ 用户实测通过 ✓
- Arch Linux ARM VM:全新构建 ✓ GUI 截图验收 ✓ 自测零失败 ✓
- CI:三端门禁全绿 ✓
完整更新日志:见仓库 desktop/packaging/deb/debian/changelog · git log
聚合视频 v1.3.0 —— 社区协作里程碑(fork 整合 + YouTube 全链修复 + 字幕三端统一)
聚合视频 v1.3.0 —— 社区协作里程碑(fork 整合 + YouTube 全链修复 + 字幕三端统一)
这是一个由社区协作促成的大版本:全部平台(Android / macOS / Linux)的 YouTube 播放链、字幕链完成系统性修复;
三端行为全面对齐;代码经四维审核(重复/硬编码/重复块/未启用代码)达标。
Linux 端全部通过官方软件源安装(一键命令、自动更新),第一节即为完整安装指南。
🙏 特别鸣谢:lishoujun 的 fork 贡献(本版整合)
本版直接整合并完整保留署名了 @lishoujun 在其 fork 中的 14 个高质量提交,
其中多项是关键问题的根治方案:
| 贡献 | 解决的问题 |
|---|---|
| YtRangeProxy(分块 Range 本机中继) | 受限网络出口(VPS/数据中心 IP)下 googlevideo 直链 403 → 彻底修复 |
player_client=web_embedded 客户端策略 |
android_vr 客户端"10MB 墙"(播十几秒断流) |
| DASH 音频 mpv NODE 数组挂载 + 路径转义 | 分离音轨挂载竞态(并附 143 行 Python 回归测试) |
| 点击立即取消上一次解析 + 字幕后台抓取 | 连续点击卡顿、解析叠加 |
CLI --help / --version |
命令行可用性 |
| GitHub Actions CI 工作流 | 自动化构建基础 |
感谢这份贡献 —— 协作让这个项目变得更好。上游将持续跟进并欢迎更多 PR。
一、下载与安装(完整指南 · 复制粘贴即可)
📱 Android(手机 / 平板)
- 下载本页 Assets →
app-release-1.3.0.apk - 手机打开安装;若提示"禁止安装未知应用",按提示允许(标准流程)
- 需 Android 15(API 35)+;应用内「设置 → 关于」确认版本 1.3.0
🍎 macOS(Apple 芯片 M 系列)
- 下载 Assets →
HyperOnlineVideo-1.3.0-arm64.dmg - 打开 DMG → 拖入「应用程序」
- 首次打开被拦(未公证):右键→打开;或终端:
sudo xattr -dr com.apple.quarantine /Applications/HyperOnlineVideo.app
🐧 Linux(按发行版选择)
Arch Linux / Manjaro / EndeavourOS(AUR · clang 构建)
sudo pacman -S --needed base-devel git
git clone https://aur.archlinux.org/yay.git /tmp/yay && cd /tmp/yay && makepkg -si # 已装 yay/paru 可跳过
yay -S hov-qtFedora 44 / 45(COPR)
sudo dnf copr enable houge/hov-qt
sudo dnf install hov-qtopenSUSE Tumbleweed
sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Tumbleweed/ obs-houge
sudo zypper install hov-qtopenSUSE Leap 16.0
sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Leap_16.0/ obs-houge-leap
sudo zypper install hov-qtUbuntu 26.04(OBS 仓库 · x86_64/aarch64)
echo "deb https://download.opensuse.org/repositories/home:/houge/Ubuntu_26.04/ ./" | sudo tee /etc/apt/sources.list.d/hov-qt.list
curl -fsSL https://download.opensuse.org/repositories/home:/houge/Ubuntu_26.04/Release.key | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/hov-qt.gpg
sudo apt update && sudo apt install hov-qtDebian 13(OBS 仓库 · x86_64/aarch64)
echo "deb https://download.opensuse.org/repositories/home:/houge/Debian_13/ ./" | sudo tee /etc/apt/sources.list.d/hov-qt.list
curl -fsSL https://download.opensuse.org/repositories/home:/houge/Debian_13/Release.key | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/hov-qt.gpg
sudo apt update && sudo apt install hov-qt任意发行版(便携):下载 HyperOnlineVideo-aarch64.AppImage → chmod +x → 直接运行
NixOS(flake)
# flake.nix inputs 中:
hov-qt = { url = "github:HougeLangley/HyperOnlineVideo"; inputs.nixpkgs.follows = "nixpkgs"; };
# configuration.nix:
environment.systemPackages = [ inputs.hov-qt.packages.x86_64-linux.default ];sudo nixos-rebuild switch二、本版亮点
🎬 YouTube 冷启动播放修复(三端)
- 症状:冷启动后点第一个视频不播/无声/无画面;后续正常
- 根因(Android 日志实锤):音频挂载是固定延时命令,与首帧加载竞态;且选流优先 HLS 主清单(常无音轨)
- 修复:音频改事件驱动(file-loaded ✓ 幂等 ✓);macOS 采用
audio-files预挂载(Linux 同款);优先 DASH 分轨,HLS 仅兜底
💬 字幕链三端统一(含中文自动翻译)
- 语言判断:严格取系统语言(
Locale,与网络出口无关);按系统语言优先级排序 → 默认显示 - 中文:支持 YouTube 自动翻译轨(语言码实为
zh-Hans-en);轨名规范显示为zh-Hans(翻译) - 抗限流:匿名优先 → cookie 重试 → 429 退避重试;macOS 两步法(先取可用语言再下载 ≤2 条)
- 根治"多语言齐发被拒":改 yt-dlp 正则匹配(只请求真实存在的轨)
⚡ 画质与解析对齐
- 撤销强制客户端;匿名优先解析(失效 cookie 会触发 YouTube 降级);实测 1080p/1440p 正常选中
🧹 工程质量
- 日志时间前缀(
hh:mm:ss);解析超时 75s;四维代码审核(重复/硬编码/重复块/未启用代码)达标;三端告警清零(平台性残留有据记录)
三、完整更新日志(自 v1.2.5 起)
- 整合 fork 14 提交(YtRangeProxy / web_embedded / DASH NODE / cancel-inflight / CLI / CI)
- YouTube 冷启动影音修复(Android 事件驱动 · mac 预挂载 · DASH 优先)
- 字幕三端统一(系统语言 · 中文翻译轨 · 匿名优先 · 429 退避 · 两步法)
- 画质对齐(撤销客户端强制 · 匿名优先)
- 代码审核与告警清理(三端)
四、已知问题
- 受限出口(VPS/数据中心 IP):仅影响 YouTube 直链 → 已由 YT-PROXY 分块中继缓解;极端情况请更换线路
- Ubuntu 24.04 / Debian 12:Qt < 6.5 暂不支持(请用 26.04 / 13 或 AppImage)
- Apple 公证:macOS 应用未付费公证,首次打开按第一节处理
五、致谢
@lishoujun(fork 关键贡献 · 本版核心修复来源)· 所有提交 Issue 与实测反馈的用户 —— 这个版本属于社区。
聚合视频 v1.2.5 —— YouTube 直链可播性预检 + 全平台出口指引 + 日志时间前缀
聚合视频 v1.2.5 —— YouTube 直链可播性预检 + 全平台出口指引 + 日志时间前缀
修复性更新:针对受限网络出口(VPS/数据中心 IP)导致的 YouTube「解析成功但无法播放(403)」,
新增可播性预检与明确指引(Linux / macOS / Android 三端 ✓);全部日志加入时间前缀 ✓。
一、本版亮点
🔎 YouTube 直链可播性预检(Issue #1 ✓ 三端)
- 背景:部分出口被 YouTube 施加“仅探测”策略(>64KB 的 Range 一律 403 ✗)→ 解析成功但 mpv 打不开 ✗
- 修复:交给播放器前先做 4MB Range 探针(正常 200/206 ✓;受限 403 ✗)→ 命中即明确提示更换代理节点/线路 ✓
- 覆盖:Linux(Qt 桌面)· macOS · Android(Toast ✓)
🕒 日志时间前缀(社区建议 ✓)
- 所有日志统一
[HH:MM:SS]前缀(含 qInfo/qWarning 与 stderr ✓)——排障对照更直观 ✓
二、下载与安装
安装方式与 v1.2.4 相同:Android APK / macOS DMG / Arch(AUR)/ Fedora(Copr)/ openSUSE(OBS)/ Ubuntu 26.04 / Debian 13 / AppImage / NixOS ✓
(详细命令见 v1.2.4 说明或仓库 README ✓)
三、更新日志(自 v1.2.4 起)
- 三端:YouTube 直链 4MB Range 预检 + 受限出口指引 ✓
- 桌面端:64 处 stderr 日志 + qInfo 全量时间前缀(hovLog / messageHandler ✓)
- 工程:Issue #1 根因定位与复现实验(出口策略 ✗ 非应用缺陷 ✓)
四、已知问题
- 受限出口(VPS/数据中心 IP)下仅有提示、无法解除媒体封锁 ✗(YouTube 服务端策略 ✓)→ 请更换代理线路 ✓
- Ubuntu 24.04 / Debian 12(Qt < 6.5)暂不支持 ✓
聚合视频 v1.2.4 —— QQ 音乐歌词修复 + clang 全平台构建(Android / macOS / Linux 全平台)
聚合视频 v1.2.4 —— QQ 音乐歌词修复 + clang 全平台构建(Android / macOS / Linux 全平台)
本次为修复性更新:修复 QQ 音乐在部分环境下"歌词全黑不显示"的问题;代码经 clang 全面净化;
Linux 全渠道改用 clang/llvm 构建,并新增 Ubuntu / Debian 官方构建仓库 ✓。
Linux 端全部通过官方软件源安装(一键命令、自动更新 ✓),第一节即为完整安装指南。
一、下载与安装(小白也能看懂 · 复制粘贴即可)
📱 Android(手机 / 平板)
- 在本页下方 "Assets" 区域点击
app-release-1.2.4.apk下载 - 在手机上打开该文件;若提示「禁止安装未知应用」,按提示允许(安卓装非商店应用的标准流程 ✓)
- 安装完成后,桌面出现「聚合视频」图标即成功 ✓
要求 Android 15(API 35)及以上 ✓ 应用内「设置 → 关于」可确认版本为 1.2.4 ✓
🍎 macOS(Apple 芯片 M 系列)
- 在 "Assets" 区域下载
HyperOnlineVideo-1.2.4-arm64.dmg - 双击打开 → 把「聚合视频」拖进 应用程序 文件夹
- 第一次打开会被 macOS 拦下(未付费公证的应用都会这样 ✓ 正常现象):
- 方法 A:右键点图标 → 选「打开」→ 再点一次「打开」
- 方法 B(推荐):打开「终端」粘贴:
sudo xattr -dr com.apple.quarantine /Applications/HyperOnlineVideo.app
🐧 Linux —— 按你的发行版选一条(全部为软件源安装 ✓)
Arch Linux / Manjaro / EndeavourOS
# ① 还没装 AUR 助手的话先装 yay(已有 yay/paru 就跳过)
sudo pacman -S --needed base-devel git
git clone https://aur.archlinux.org/yay.git /tmp/yay && cd /tmp/yay && makepkg -si
# ② 安装(首次自动编译约 2-3 分钟;用 clang/llvm 构建 ✓)
yay -S hov-qtFedora 44 / 45
sudo dnf copr enable houge/hov-qt
sudo dnf install hov-qtUbuntu 26.04
sudo add-apt-repository -y ppa:houge/hov-qt 2>/dev/null || true # 若提示无此 PPA 请看下行
echo "deb https://download.opensuse.org/repositories/home:/houge/Ubuntu_26.04/ ./" | sudo tee /etc/apt/sources.list.d/hov-qt.list
curl -fsSL https://download.opensuse.org/repositories/home:/houge/Ubuntu_26.04/Release.key | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/hov-qt.gpg
sudo apt update && sudo apt install hov-qtDebian 13
echo "deb https://download.opensuse.org/repositories/home:/houge/Debian_13/ ./" | sudo tee /etc/apt/sources.list.d/hov-qt.list
curl -fsSL https://download.opensuse.org/repositories/home:/houge/Debian_13/Release.key | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/hov-qt.gpg
sudo apt update && sudo apt install hov-qtopenSUSE Tumbleweed
sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Tumbleweed/ obs-houge
sudo zypper install hov-qtopenSUSE Leap 16.0
sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Leap_16.0/ obs-houge-leap
sudo zypper install hov-qtNixOS(声明式 · flake)
在 /etc/nixos/flake.nix 的 inputs 里加:
hov-qt = {
url = "github:HougeLangley/HyperOnlineVideo";
inputs.nixpkgs.follows = "nixpkgs";
};在 configuration.nix(或 home-manager 的 home.nix)里加:
environment.systemPackages = [ inputs.hov-qt.packages.x86_64-linux.default ];然后重建:
sudo nixos-rebuild switch首次编译约 5 分钟 ✓ WebEngine 登录窗在 NixOS 下默认不链接(登录请手动放置 cookie 文件,与应用内说明一致 ✓)
二、本版亮点(v1.2.4 更新内容)
🎵 QQ 音乐歌词修复(核心修复 ✓)
- 问题:部分用户播放 QQ 音乐时右栏全黑、无标题无歌词(网易云正常 ✗)
- 根因:QQ 登录 cookie 文件随时间累积到 15KB 后,请求头超限,歌词接口(
c.y.qq.com)直接拒绝连接(HTTP 000) - 修复:歌词请求改为匿名优先;为空再用"按完整条目截断到 3KB"的 Cookie 重试一次 ✓
- 覆盖:macOS + Linux(Android 走新版接口,不受影响 ✓)
🧹 代码净化(clang 全净)
- 移除死字段 1 处 + 未使用的 lambda 捕获 4 处;clang
-Wextra告警数 5 → 0 ✓ - 全平台等价重构,行为零变化 ✓
🐧 Linux 构建体系升级
- 全渠道改用 clang/llvm 构建(clang + lld ✓):Arch / Fedora(COPR) / openSUSE(OBS) / Ubuntu / Debian ✓
- 新增 Ubuntu 26.04 与 Debian 13 官方构建仓库(x86_64 + aarch64 ✓ 一键安装 ✓)
- 实测:openSUSE Tumbleweed x86_64/aarch64/riscv64、Leap 16.0、Ubuntu 26.04、Debian 13 全目标构建成功 ✓
三、完整更新日志(自 v1.2.3 起)
- QQ 音乐:歌词全黑修复(匿名优先 + 截断 Cookie 重试;macOS/Linux 同修)
- 代码:清理死字段 + 未用捕获(clang -Wextra 零告警)
- 构建:全 Linux 渠道 clang/llvm 化;新增 Ubuntu/Debian 构建仓库
- 工程:新增 riscv64 deb 构建;全平台复验(Android 真机 / macOS 119/119 自测 / Linux E2E)
四、已知问题与说明
- B站登录:部分功能(1080P+/字幕等)需登录;若搜索异常,请在应用内重新登录 B 站 ✓
- Apple 公证:macOS 应用未做付费公证,首次打开需按第一节方法绕过(正常现象 ✓)
- QQ 音乐:若提示"需重新登录",在应用内「登录」页重新登录即可 ✓
- Ubuntu 24.04 / Debian 12:Qt 版本低于 6.5,暂不支持(请升级系统或使用 AppImage ✓)
五、致谢
感谢真实使用场景中的每一条反馈 —— 本版的 QQ 歌词修复正是来自用户的对比测试与截图 ✓
发现问题欢迎开 Issue ✓
聚合视频 v1.2.3 —— B站搜索升级(wbi 签名)+ 稳定性维护(Android / macOS / Linux 全平台)
聚合视频 v1.2.3 —— B站搜索升级(wbi 签名)+ 稳定性维护(Android / macOS / Linux 全平台)
本次为维护性更新:B 站搜索升级为官方现行 wbi 签名协议(解析更稳、抗风控 ✓);
Android 端"播完自动连播"加固;并完成 yt-dlp 版本与四平台 API 的全面核查 ✓。
Linux 端全部通过官方软件源安装(一键命令、自动更新 ✓),第一节即为完整安装指南。
一、下载与安装(小白也能看懂 · 复制粘贴即可)
📱 Android(手机 / 平板)
- 在本页下方 "Assets" 区域点击
app-release-1.2.3.apk下载 - 在手机上打开该文件;若提示「禁止安装未知应用」,按提示允许(安卓装非商店应用的标准流程 ✓)
- 安装完成后,桌面出现「聚合视频」图标即成功 ✓
要求 Android 15(API 35)及以上 ✓ 应用内「设置 → 关于」可确认版本为 1.2.3 ✓
🍎 macOS(Apple 芯片 M 系列)
- 在 "Assets" 区域下载
HyperOnlineVideo-1.2.3-arm64.dmg - 双击打开 → 把「聚合视频」拖进 应用程序 文件夹
- 第一次打开会被 macOS 拦下(未付费公证的应用都会这样 ✓ 正常现象):
- 方法 A:右键点图标 → 选「打开」→ 再点一次「打开」
- 方法 B(推荐):打开「终端」粘贴:
sudo xattr -dr com.apple.quarantine /Applications/HyperOnlineVideo.app
🐧 Linux —— 按你的发行版选一条(全部为软件源安装 ✓)
Arch Linux / Manjaro / EndeavourOS
# ① 还没装 AUR 助手的话先装 yay(已有 yay/paru 就跳过)
sudo pacman -S --needed base-devel git
git clone https://aur.archlinux.org/yay.git /tmp/yay && cd /tmp/yay && makepkg -si
# ② 安装(首次自动编译约 2-3 分钟)
yay -S hov-qtFedora 44 / 45
sudo dnf copr enable houge/hov-qt
sudo dnf install hov-qtopenSUSE Tumbleweed
sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Tumbleweed/ obs-houge
sudo zypper install hov-qtopenSUSE Leap 16.0
sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Leap_16.0/ obs-houge-leap
sudo zypper install hov-qtNixOS(声明式 · flake)
在 /etc/nixos/flake.nix 的 inputs 里加:
hov-qt = {
url = "github:HougeLangley/HyperOnlineVideo";
inputs.nixpkgs.follows = "nixpkgs";
};在 configuration.nix(或 home-manager 的 home.nix)里加:
environment.systemPackages = [ inputs.hov-qt.packages.x86_64-linux.default ];然后重建:
sudo nixos-rebuild switch首次编译约 5 分钟 ✓ WebEngine 登录窗在 NixOS 下默认不链接(登录请手动放置 cookie 文件,与应用内说明一致 ✓)
二、本版亮点(v1.2.3 更新内容)
📺 B 站搜索升级:wbi 签名(三端)
- B 站已对旧版搜索接口的风控收紧(冷请求会被拦截);本版三端统一升级为官方现行 wbi 签名协议:
nav获取密钥 → mixin 表生成签名 →w_rid = md5(query + mixin),密钥缓存 6 小时(自动跟进每日轮换 ✓)- 策略:wbi 优先,失败自动回退旧接口 ✓(双保险,用户无感 ✓)
- 实测:三端均返回 20 条搜索结果 ✓(Android 真机 / Linux 装机版 / macOS ✓)
📱 Android:播完自动连播加固
- 修复"某些环境播完不切下一首"的边界:mpv 结束后
time-pos/duration会被卸载,
个别环境结束标志不翻转 → 新增稳健兜底判据(曾正常播放过 + 双属性失效 = 已结束 ✓) - 新增诊断日志(播放结束/切歌/守卫值 ✓)——同类问题一行定位 ✓
- 说明:若您此前关闭过「设置 → 播放 → 播完自动连播(队列)」,播放器播完会按设计退出 ✓ 请确认该开关为开启状态 ✓
🔧 维护核查
- yt-dlp:三端均为最新稳定版 2026.08.19 ✓(Android 启动自更新 ✓ / macOS 跟随 Homebrew ✓ / Linux 跟随发行版 ✓)
- 四平台 API 审计:YouTube(yt-dlp ✓)/ 网易云 / QQ 音乐 均为现行最优协议 ✓ 无需变更 ✓
三、完整更新日志(自 v1.2.2 起)
- B站:搜索升级 wbi 签名(三端同款 · 旧接口自动回退 · 密钥 6h 缓存)
- Android:播完自动连播稳健兜底 + 三处诊断日志
- 维护:yt-dlp 版本核查(2026.08.19 = 最新稳定 ✓);四平台 API 审计与存档
- 工程:B站搜索解析逻辑三端抽公共函数(去重);文档补充(踩坑 #289/#290)
四、已知问题与说明
- B站登录:部分功能(1080P+/字幕等)需登录;升级后若搜索异常,请在应用内重新登录 B 站 ✓
- Apple 公证:macOS 应用未做付费公证,首次打开需按第一节方法绕过(正常现象 ✓)
- QQ 音乐:若提示"需重新登录",在应用内「登录」页重新登录即可 ✓
五、致谢
感谢真实使用场景中的每一条反馈 —— 本版的 B站 wbi 升级与 Android 连播加固均源于日常使用观察 ✓
发现问题欢迎开 Issue ✓
聚合视频 v1.2.2 —— 音乐体验大版本(QQ 真翻页 / 封面 / 字幕 / 画质 / 稳定性)
聚合视频 v1.2.2 —— 音乐体验大版本(Android / macOS / Linux 全平台 · 全发行版)
本次更新聚焦音乐体验与稳定性:QQ 音乐搜索实现真·无限下滑翻页(Desktop 协议,20 首/页);
网易云与 QQ 的翻页封面、下载内嵌封面全面修复;新增 CDN 节点择优与 mpv 日志泵,
根治"随机不播";字幕自动选轨、画质上限、长歌词自适应三端对齐;macOS 若干崩溃修复。Linux 端同样不提供打包文件下载 —— 全部通过官方软件源安装(一键命令、自动更新 ✓),第一节即为完整安装指南。
一、下载与安装(小白也能看懂 · 复制粘贴即可)
📱 Android(手机 / 平板)
- 在本页下方 "Assets" 区域点击
app-release-1.2.2.apk下载 - 在手机上打开该文件;若提示「禁止安装未知应用」,按提示允许(安卓装非商店应用的标准流程 ✓)
- 安装完成后,桌面出现「聚合视频」图标即成功 ✓
要求 Android 15(API 35)及以上 ✓ 应用内「设置 → 关于」可确认版本为 1.2.2 ✓
🍎 macOS(Apple 芯片 M 系列)
- 在 "Assets" 区域下载
HyperOnlineVideo-1.2.2-arm64.dmg - 双击打开 → 把「聚合视频」拖进 应用程序 文件夹
- 第一次打开会被 macOS 拦下(未付费公证的应用都会这样 ✓ 正常现象):
- 方法 A:右键点图标 → 选「打开」→ 再点一次「打开」
- 方法 B(推荐):打开「终端」粘贴:
sudo xattr -dr com.apple.quarantine /Applications/HyperOnlineVideo.app
🐧 Linux —— 按你的发行版选一条(全部为软件源安装 ✓)
Arch Linux / Manjaro / EndeavourOS
# ① 还没装 AUR 助手的话先装 yay(已有 yay/paru 就跳过)
sudo pacman -S --needed base-devel git
git clone https://aur.archlinux.org/yay.git /tmp/yay && cd /tmp/yay && makepkg -si
# ② 安装(首次自动编译约 2-3 分钟)
yay -S hov-qtFedora 44 / 45
sudo dnf copr enable houge/hov-qt
sudo dnf install hov-qtopenSUSE Tumbleweed
sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Tumbleweed/ obs-houge
sudo zypper install hov-qtopenSUSE Leap 16.0
sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Leap_16.0/ obs-houge-leap
sudo zypper install hov-qtNixOS(声明式 · flake)
在 /etc/nixos/flake.nix 的 inputs 里加:
hov-qt = {
url = "github:HougeLangley/HyperOnlineVideo";
inputs.nixpkgs.follows = "nixpkgs";
};在 configuration.nix(或 home-manager 的 home.nix)里加:
environment.systemPackages = [ inputs.hov-qt.packages.x86_64-linux.default ];然后重建:
sudo nixos-rebuild switch首次编译约 5 分钟 ✓ WebEngine 登录窗在 NixOS 下默认不链接(登录请手动放置 cookie 文件,与应用内说明一致 ✓)
二、本版亮点(v1.2.2 更新内容)
🎵 音乐 —— QQ 真·无限下滑翻页
- QQ 音乐搜索现在支持真·无限下滑翻页(每页 20 首,滑到底自动加载下一页并无限延续 ✓)
- 采用 QQ 现行 Desktop 搜索协议(
DoSearchForQQMusicDesktop+ 数字型分页参数),
匿名可用、登录后更稳;三端(Android / macOS / Linux)同款实现 ✓
- 采用 QQ 现行 Desktop 搜索协议(
- 翻页封面修复:搜索结果滑到后面不再"灰块" —— 修复了"同专辑多曲只显示第一张封面"的缩略图缓存缺陷 ✓
- 下载内嵌封面:下载的音乐现在会把专辑封面写进文件标签(mp3 的
attached_pic),
文件管理器 / 播放器都能看到封面 ✓(ffprobe实测验证 ✓)
🎧 音乐 —— "随机不播"根因修复
- 网易云 CDN 节点择优:网易云返回的流地址会随机落在 m701~m804 等节点,个别节点会 403;
现在会自动探测并选择可用节点(失败自动回退),根治"点了没声音、进度条不动" ✓ - mpv 日志泵:新增播放器事件/日志通道(此前播放器错误被静默吞掉),排障能力大幅提升 ✓
- 登录态降级链:请求失败自动尝试备用通道;QQ 登录态过期时会明确提示重新登录(不再静默 0 条 ✓)
💬 字幕 —— 自动选轨修复(三端)
- 修复"AI 字幕被标成(自动翻译)导致评分错位、字幕不自动选"的问题;新增裸「中文 / Chinese」兜底匹配 ✓
- B 站字幕改走直连 + 429 退避重试,VPN 环境下不再间歇性拉不到字幕 ✓
🎬 画质 —— "视频清晰度上限"设置真正生效
- 修复"设置了 1080p 但实际仍按默认档位播放"的问题(加载顺序 + UI 回填);Linux/Android 补齐设置项 ✓
✍️ 歌词 —— 长句自适应(三端)
- 长歌词不再溢出播放窗口:总高超出时自动逐档缩小字号(下限 0.55×)✓
- macOS 修复"音乐模式背景变黑、歌词变成视频字幕样式"的问题 ✓
🛡️ 稳定性 / 其他
- macOS:修复搜索后崩溃(共享缓存改为主线程单一写入口 ✓)
- macOS:修复关闭登录窗崩溃(WebEngine 析构竞态 ✓)
- Linux:修复虚拟机环境登录窗"桌面穿透"(GL 兼容 ✓)
- 播放器:修复"上一曲播完点下一首停在 0:00"的竞态 ✓
- 音乐模式:封面 + 玻璃背景 + 滚动歌词 + 逐字高亮全面对齐三端 ✓
三、完整更新日志(自 v1.2.1 起)
音乐
- QQ 搜索换用现行接口并支持真分页无限下滑(三端)
- 网易云 / QQ 翻页封面预热与回填修复
- 下载音乐内嵌封面(Linux / macOS / Android 三端)
- 网易云 CDN 节点择优(403 节点自动规避)
- mpv 事件/日志泵(播放失败不再静默)
- 登录态失效自动降级 + 明确提示
- 音乐模式:封面/玻璃背景/滚动歌词/逐字高亮对齐(Linux 修复歌词滚动 ✓)
- 音质上限(无损/320k/128k)三端对齐;左下角"音质档位"分流 ✓
字幕 / 歌词
- 自动选轨:AI 字幕误标修复 + 裸中文兜底 + B 站直连退避(三端)
- 长歌词自适应缩字(三端);macOS 音乐模式歌词修复
- 本地 sidecar 歌词(.lrc)显示与滚动修复
视频 / 画质
- 清晰度上限设置修复(Linux / macOS / Android 三端生效)
- 视频清晰度 UI 回填与切换修复
稳定性
- macOS:搜索崩溃、登录窗崩溃、音乐模式黑屏修复
- Linux:虚拟机 GL 登录窗穿透修复、关窗崩溃修复、播放器竞态修复
- Android:多 buffer 日志、输入法兼容等工程改进
打包 / 工程
- Linux 全渠道:Arch(pkgrel=12)· Ubuntu deb · Fedora rpm(Copr)· openSUSE(OBS)· AppImage · NixOS flake
- 三端代码审计清理(重复代码消除、缩进规范化)
- 文档:踩坑百科(#270-#288)、构建矩阵更新
四、已知问题与说明
- QQ 音乐搜索:接口侧当前对无效登录态/匿名访问有风控(返回 code=2001)。应用已内置降级与提示;
若提示"需重新登录",请在应用内「登录」页重新登录 QQ 音乐即可恢复(搜索结果与翻页均不受影响 ✓)。 - Apple 公证:macOS 应用未做付费公证,首次打开需按第一节方法绕过(正常现象 ✓)。
- NixOS:WebEngine 登录窗默认不链接;登录请按应用内说明手动放置 cookie 文件 ✓。
五、致谢
感谢所有测试与反馈的朋友 —— 1.2.2 的"QQ 无限下滑翻页"与"随机不播"根治均来自真实使用场景的反馈 ✓
发现问题欢迎开 Issue ✓
聚合视频 v1.2.1 —— 全平台正式发布(Android / macOS / Linux 全发行版)
聚合视频 v1.2.1 —— 全平台正式发布(Android / macOS / Linux 全发行版)
本次是首次全平台发布:Android、macOS、以及 Linux 的 Arch / Fedora / openSUSE / NixOS 全渠道同步上线 ✓
Linux 端不提供打包文件下载 —— 全部通过官方软件源安装(一键命令、自动更新 ✓),本文第一节即为完整安装指南。
一、下载与安装(小白也能看懂 · 复制粘贴即可)
📱 Android(手机 / 平板)
- 在本页下方 "Assets" 区域点击
app-release-1.2.1.apk下载 - 在手机上打开该文件;若提示「禁止安装未知应用」,按提示允许(安卓装非商店应用的标准流程 ✓)
- 安装完成后,桌面出现「聚合视频」图标即成功 ✓
要求 Android 15(API 35)及以上 ✓ 应用内「设置 → 关于」可确认版本为 1.2.1 ✓
🍎 macOS(Apple 芯片 M 系列)
- 在 "Assets" 区域下载
HyperOnlineVideo-1.2.1-arm64.dmg - 双击打开 → 把「聚合视频」拖进 应用程序 文件夹
- 第一次打开会被 macOS 拦下(未付费公证的应用都会这样 ✓ 正常现象):
- 方法 A:右键点图标 → 选「打开」→ 再点一次「打开」
- 方法 B(推荐):打开「终端」粘贴:
sudo xattr -dr com.apple.quarantine /Applications/HyperOnlineVideo.app
🐧 Linux —— 按你的发行版选一条(全部为软件源安装 ✓)
Arch Linux / Manjaro / EndeavourOS
# ① 还没装 AUR 助手的话先装 yay(已有 yay/paru 就跳过)
sudo pacman -S --needed base-devel git
git clone https://aur.archlinux.org/yay.git /tmp/yay && cd /tmp/yay && makepkg -si
# ② 安装(首次自动编译约 2-3 分钟)
yay -S hov-qtFedora 44 / 45
sudo dnf copr enable houge/hov-qt
sudo dnf install hov-qtopenSUSE Tumbleweed
sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Tumbleweed/ obs-houge
sudo zypper install hov-qtopenSUSE Leap 16.0
sudo zypper addrepo https://download.opensuse.org/repositories/home:/houge/openSUSE_Leap_16.0/ obs-houge-leap
sudo zypper install hov-qtNixOS(声明式 · flake)
在 /etc/nixos/flake.nix 的 inputs 里加:
hov-qt = {
url = "github:HougeLangley/HyperOnlineVideo";
inputs.nixpkgs.follows = "nixpkgs";
};在 configuration.nix(或 home-manager 的 home.nix)里加:
environment.systemPackages = [ inputs.hov-qt.packages.x86_64-linux.default ];然后重建:
sudo nixos-rebuild switch只想先试试:
nix run github:HougeLangley/HyperOnlineVideo✓
Ubuntu / Debian / 其它发行版(源码构建 · 约 5 分钟)
sudo apt update
sudo apt install -y git cmake ninja-build pkgconf \
qt6-base-dev qt6-declarative-dev qt6-webengine-dev \
libmpv-dev mpv ffmpeg yt-dlp
git clone https://github.com/HougeLangley/HyperOnlineVideo.git
cd HyperOnlineVideo/desktop
cmake -B build -G Ninja -DCMAKE_BUILD_TYPE=Release -DHOV_WEBENGINE=ON
cmake --build build
./build/hov-qt安装到系统(带桌面图标):
sudo cmake --install build --prefix /usr/local✓
二、本版亮点
三端下载面板与下载能力(本版主题)
- Linux(Qt6):新增下载面板(进度条 / 重试失败 / 逐条取消 / 取消全部 / 打开下载目录 / LRU 清理)与收藏面板;
视频下载修复(起播时记录直链、扩展名与 macOS 对齐);「清理」现在会真正把已结束条目从列表移除。 - macOS:新增 DownloadsPanel(字节级进度、取消全部、重试失败)、面板可拖拽缩放(关闭按钮一键可用);
- Android:下载卡片新增「取消」与「取消全部」;完成的卡片 3.5 秒自动淡出,不再堆积。
窗口与播放体验(Linux / macOS)
- 窗口几何持久化:首启 1200×720 居中;退出时保存位置与大小(PiP/全屏态不污染记忆)。
- 画中画(PiP)往返修复:进出 PiP 后左侧列表宽度、控制条不再错乱(两端同修)。
- 长文本不再撑大窗口:状态栏/信息栏粘贴超长文本时的窗口跳变已修。
- 视频独立窗口(macOS):从主窗弹出视频单独播放。
- 字幕/歌词若干修复;
main.cpp拆分为多模块(MainWindow/Playback/PlayActions/SettingsDialog…),便于后续维护。
Linux 打包矩阵(v1.2.1 核心工程)
| 渠道 | 覆盖 | 状态 |
|---|---|---|
| AUR(Arch) | x86_64 / aarch64 / riscv64 | ✅ 已发布(yay -S hov-qt) |
| Fedora Copr | Fedora 44 / 45 × x86_64 / aarch64 / riscv64 | ✅ 六个构建目标全过 |
| openSUSE OBS | Tumbleweed × 3 架构 + Leap 16.0 × 2 架构 | ✅ 五目标全过 |
| NixOS flake | x86_64 / aarch64 | ✅ 本机 rebuild 即用 |
| Ubuntu / Debian | deb 完整套件(本地构建) | ✅ lintian 零告警 |
许可元数据全线统一为 GPL-3.0-only(与仓库
LICENSE实际授予的版本一致)。
三、本次产物
| 平台 | 文件 | 大小 |
|---|---|---|
| Android | app-release-1.2.1.apk(R8 混淆) |
70.8 MB |
| macOS | HyperOnlineVideo-1.2.1-arm64.dmg |
29.3 MB |
| Linux | 无文件下载 —— 见上文各软件源(AUR / Copr / OBS / Nix flake) | — |
四、已知问题(如实)
| 问题 | 说明 |
|---|---|
| YouTube 字幕偶发获取失败 | YouTube 对部分 IP 的字幕接口限流(429),与应用无关;可稍后重试 |
| B站部分接口 412 | 同上(IP 级限流) |
| QQ 音乐 VIP 曲目匿名不可取流 | 需登录(应用内登录窗口或导入 cookie) |
| Linux riscv64 无 App 内登录窗 | Ubuntu riscv64 端口无 QtWebEngine 包 → 该架构自动降级为「手动放置 cookie」(与 AppImage 一致) |
| Ubuntu 暂无官方软件源 | 目前用源码构建(5 分钟,见上);后续如开通 OBS Ubuntu 目标会另行说明 |
五、升级说明
- 三端配置文件共用(
~/.config/hov/),覆盖升级不丢设置 / 队列 / 收藏 / 播放进度 / cookie ✓ - Android:如果此前安装的是 debug 版,与发布版签名不同,需要先卸载再安装(正式版之间可直接覆盖升级 ✓)
- Linux:AUR / Copr / OBS 用户直接
更新系统即可(包管理器自动处理 ✓)
六、致谢与反馈
- 问题反馈:https://github.com/HougeLangley/HyperOnlineVideo/issues
- 项目许可:GPL-3.0-only(详见仓库
LICENSE)
v1.2.0 —— Android 与 macOS 发布(Linux 延后至 v1.2.1)
聚合视频 v1.2.0 —— Android 与 macOS 发布(Linux 延后至 v1.2.1)
本次发布的正式产物只有两个平台:Android(APK)与 macOS(arm64 DMG)。
一、为什么本次只发 Android 与 macOS?(如实说明)
我们把"能跑"与"敢发布"分得很清楚,本版按后者执行:
| 平台 | 本次是否发布 | 原因 |
|---|---|---|
| Android | ✅ 发布 | 已通过真机完整验收:安装、启动、搜索、播放、下载、本地库、字幕、主题跟随。本版还修掉了一个真机可复现的崩溃(见下)。 |
| macOS | ✅ 发布 | 已通过本机多轮实测:SPM 构建、DMG 打包、播放、字幕、音频兜底、主题跟随全部走通。 |
| Linux(Arch / Debian / Fedora) | 🚧 本次不发布 | 打包链路已打通(Arch PKGBUILD、Debian dpkg-buildpackage、Fedora mock + Copr 均已实际出包),但:① 三发行版之间功能与打包方式尚未统一; ② 若干优化(真实 GPU 下的渲染后端验证、长时续航等)尚未完成; ③ 按既定决策,Linux 端将统一实现、统一打包后随 v1.2.1 发布。 我们不愿意把一个"能编译但不保证各处一致"的 Linux 版本当作正式版推给用户。 |
Fedora 用户可在 Copr 测试渠道提前体验(
sudo dnf copr enable houge/hov-qt),
但请务必理解为实验性、可能不稳定,正式支持见 v1.2.1。
二、本版亮点
一、崩溃与卡死根治(本版最重要)
- Android:默认渲染后端导致的原生崩溃(本版核心修复) ★
实测发现:mpv-android 的默认vo=gpu在部分机型(测试机 Xiaomi 17 Pro Max / Android 16)上
在vo线程内原生崩溃(tombstone 栈在libmpv.so,可 2/2 复现),
而vo=gpu-next(libplacebo)稳定可用(三轮复现 + PSNR 与 mpv 帧号双重佐证)。
→ 本版 Android 固定采用gpu-next,设置项中不再提供开关(避免用户误选到会崩的路径);
同时不读取历史设置,以免老版本遗留的false值把用户带回崩溃路径。 - macOS:下载落盘卡主线程 1.9 秒 —— 文件删除/移动原先在主线程执行;
改为放到 URLSession 回调(本就在后台队列),主线程只留状态更新。 - 三端:退出时偶发 SEGV —— 数据源 model 信号原以
this为接收者,析构顺序不定导致悬空调用;
改为以被访问对象为接收者(Qt 侧:谁被槽访问,谁当接收者)。 - Linux(本版未发布,一并说明):中文环境启动段错误(libmpv 要求
LC_NUMERIC=C,且校验发生在
动态库加载阶段)→ 由启动器脚本在 exec 前修正;长时间播放后abort(libmpv 的 GL fence 泄漏)
→ 在get_proc_address处包装glFenceSync/glDeleteSync记账兜底。
二、主题跟随系统(新增)
- 三端统一设置项
ui.theme = auto | dark | light(默认auto); - Android:
isSystemInDarkTheme()+ Compose 状态桥,切换即时生效; - macOS:
ThemeController单点真相(darkAqua / aqua 实测确认); - Linux 走 XDG Desktop Portal(本版未发布)。
三、字幕
- 默认显示改为"按系统语言自动选轨":按系统语言提示给字幕轨打分(精确匹配 > 同语族 > 中文简繁 > 英文兜底),
只有匹配到才自动开启 —— 而不是无脑打开第一条; - 字幕字号统一为画面高度的 2.8%(下限 13px),三端一致;
- macOS 侧修复了三处各自写 karaoke 标记导致的顺序 bug(收敛为单一写入口)。
四、音频可靠性(macOS)
- 纯音频兜底:当选中档位只有视频流(
acodec==none)时,自动改用bestAudioOnlyUrl; - 音轨看门狗:10 秒无音轨提示、15 秒无音频数据则自动换轨;
- 全部字段写入
[AUDIO]日志,便于排查。
五、搜索与界面
- 搜索结果无限下拉:每页 20 条、无开关、页数上限 YouTube 6 页 / 其它 5 页、
按"多取后截尾"翻页、URL 去重、会话代次防竞态;滚动到距底 200px 自动加载; - 卡片视图:完整缩略图(fit,不裁切)+ 标题两行 + 来源标签,真·masonry 排布;
- 状态信息不再污染结果区(独立状态行);
- 结果区尺寸启动固定为「横向 2 张 × 纵向 4 张」,拖动分隔条后记住。
六、播放可靠性(三端)
- 直链过期自愈:记录解析时刻 + 按来源 TTL(YouTube 4h / B站 2h / 音乐 30min),
过期或进度停滞 15 秒时自动重新解析并回到原位置(每条内容最多自愈一次); - 后台属性快照:主线程读 mpv 属性会拿核心锁,网络 demux 期间易冻结 →
改为后台线程 5Hz 快照,GUI 只读快照; - 缓存按来源区分:网络
cache=yes / 60s / 64MiB;本地cache=no / 4s / 8MiB(本地大缓存会导致拖动冻结)。
七、下载
- 视频不再"没有声音":
bv*+ba拆成两路时原先只下第一路 →
现为视频下完后并行下载音轨(带 Referer/UA)→ ffmpeg 本地混流(-c copy)→ 清理临时文件; - 音乐下载带封面 +
.lrc侧车;视频任务一律跳过音乐标签嵌入;B站/YouTube 下载补 Referer。
三、本次产物
| 平台 | 文件 | 说明 |
|---|---|---|
| Android | app-release-1.2.0.apk |
含 gpu-next 固定渲染后端(崩溃修复)、主题跟随、字幕按系统语言 |
| macOS | HyperOnlineVideo-1.2.0-arm64.dmg |
Apple Silicon;含主题跟随、字幕/音频修复、落盘 I/O 修复 |
校验和见随发布附带的 SHA256SUMS-1.2.0.txt(也可在 Release 附件中核对)。
Linux 产物不在本次发布内。若你是 Linux 用户,可以:
- 现在就从源码构建(
README.md已提供 Arch / Debian / Fedora 三套可照做的完整步骤);- 或试用 Fedora Copr 测试渠道(实验性,当前不稳定);
- 或等待 v1.2.1 —— 我们会把三发行版的功能与打包统一后一起发布。
四、已知问题(如实)
- Linux 端:功能与打包仍在统一中,本版不发布;Copr 渠道为实验性、可能不稳定。
- Linux 侧三处文件 I/O 仍在主线程(LRU 清理、混流替换、入队删旧文件),与 macOS 同类问题;
Linux 上未观测到卡顿,已记录待改,随 v1.2.1 处理。 - Linux Flatpak / AppImage 暂缓(AppImage 打包链路在安装布局变更后需修复)。
- 非致命日志问题:直链自愈在"直链来自上次会话恢复"时会打印一个无意义的极大秒数
(内部把绝对时间戳当成了已过时长)。仅影响日志可读性,不影响自愈行为,计划在 v1.2.1 修正。 - YouTube 字幕 429 / 机房 IP 风控属网络环境问题,非应用缺陷;VM 内 B 站 412 同理。
- macOS 应用未做公证(notarization),首次运行需在「隐私与安全性」中手动允许。
五、升级说明
- 三端共用配置:
~/.config/hov/settings.json、queue.json、播放进度与本地库均为覆盖安装不丢数据; - Android:从 v1.1.0 升级直接安装覆盖即可;若此前装的是 debug 版再装 release 版会因签名不同失败,
需先卸载(debug 与 release 签名不可混装,这是 Android 的机制,不是应用缺陷); - macOS:首次运行如被拦截,见「系统设置 → 隐私与安全性 → 仍要打开」。
六、致谢与反馈
- 感谢所有反馈问题的用户;
- 问题与建议请到 GitHub Issues:https://github.com/HougeLangley/HyperOnlineVideo/issues;
- 本项目以 GPL-3.0-or-later 开源,欢迎自行构建(README 提供三端从零构建指南)。
聚合视频 v1.1.0
聚合视频 v1.1.0 —— 三端统一发布
Android · Linux(Qt6/Wayland) · macOS(AppKit) —— 同一套配置文件、同一套快捷键、同一套自检。
本版亮点
三端都有的核心能力
- 在线播放零广告:YouTube / B站 解析直链后交给 libmpv,App 层不插播、不裁剪
- 音乐:网易云音乐 + QQ音乐 搜索、播放、歌词(含逐字高亮)、封面、下载
- 在线字幕:B站 CC(官方 API)与 YouTube 字幕(yt-dlp),App 层统一渲染
- 本地库:下载目录浏览、排序、重命名、直接播放
- 播放队列:顺序 / 单曲 / 随机 + 持久化(跨端共用
queue.json) - 进度记忆:自动续播(≥15 秒且未接近结尾才续播)
- 收藏:跨端共用
favorites.json - App 内登录:内置浏览器登录,cookie 自动落盘为 Netscape 格式(yt-dlp 可直接复用)
- 媒体控制:Android MediaSession(通知栏/锁屏)、Linux MPRIS(媒体键/playerctl)、macOS 控制中心/键盘媒体键
各端要点
| 本版新增 | |
|---|---|
| Android | 版本号 1.1.0(versionCode 2);与 v1.0.0 功能一致,含此前全部能力 |
| Linux | 进度记忆 / MPRIS 媒体键 / 在线字幕(B站官方 CC API)/ 音乐封面与播放中切音质 / 下载 LRU 清理 / 本地库 |
| macOS | 首次发布:完整界面(搜索·播放·队列·歌词字幕·本地库·设置·收藏)、媒体键、WKWebView 登录、自包含 .app + DMG |
产物
| 平台 | 文件 | 大小 |
|---|---|---|
| Android | app-release.apk(已签名,versionName 1.1.0) |
72.6 MB |
| Linux | HyperOnlineVideo-aarch64.AppImage |
88.7 MB |
| Linux | hov-qt-1.1.0-1-aarch64.pkg.tar.xz(Arch) |
497 KB |
| Linux | HyperOnlineVideo.flatpak |
40.5 MB |
| macOS | HyperOnlineVideo-1.1.0-arm64.dmg(自包含,含 48 个动态库) |
29 MB |
安装提示
- Android:安装 APK 需允许"未知来源";首次使用建议在 App 内登录(YouTube/B站/网易云/QQ音乐)
- Linux:AppImage 需
chmod +x;Arch 包用pacman -U;Flatpak 用flatpak install <文件>- AppImage / Flatpak 不含 QtWebEngine(体积考虑),登录请把 cookie 放到
~/.config/hov/cookies/ - 需要系统提供
yt-dlp(pacman -S yt-dlp/apt install yt-dlp)
- AppImage / Flatpak 不含 QtWebEngine(体积考虑),登录请把 cookie 放到
- macOS:App 未做 Apple 公证,首次打开若提示"无法验证开发者",请右键 → 打开,或执行
xattr -dr com.apple.quarantine /Applications/HyperOnlineVideo.app- App 自带 libmpv/ffmpeg,无需额外安装;在线解析仍需
brew install yt-dlp
- App 自带 libmpv/ffmpeg,无需额外安装;在线解析仍需
已知限制(如实说明)
- 三端均不绕过版权与平台规则:VIP/版权受限曲目在未登录(或非会员)时无法播放,会明确提示并自动跳到下一首
- B站 CC 字幕覆盖率取决于视频本身;YouTube 字幕在部分网络环境下会受限流影响
- 直播、番剧、付费课程等未做专门适配
- macOS 端暂无下载管理器;Android 的"仅 WiFi 下载"为移动端专属能力
- 流量直连:Android 可在 App 内彻底绕过 VPN;桌面端仅能绕过"环境变量代理"(TUN 类代理需在代理工具里配规则)
自检结果(发布前跑通)
| 平台 | 项目 | 结果 |
|---|---|---|
| Android | 单元测试 | 16 / 16 通过 |
| Linux | --queue-selftest |
52 / 52 通过 |
| macOS | --selftest-logic |
41 / 41 通过 |
许可
GPL-3.0-or-later。本项目仅用于个人学习与研究,请遵守各内容平台的用户协议。