Bilibili-Evolved项目音频下载功能故障排查指南

问题现象分析

在Bilibili-Evolved项目的最新版本(2.9.3)中，用户反馈音频下载功能出现异常。具体表现为：当用户尝试通过脚本下载B站视频(BV1bLpveFEtE)的音频时，选择"仅音频(dash)"选项后，系统没有任何响应，下载链接未能正常弹出。

环境配置说明

典型故障环境配置如下：

• 操作系统：Windows 11 23H2(9月最新版)
• 浏览器：Edge 129/Brave 1.68(内核127)
• 脚本管理器：Tampermonkey v5.3.0(MV3正式版)
• 播放器版本：HTML5播放器 v4.8.48
• 网络环境：江苏电信直连

可能原因排查

1. User-Agent修改影响

部分用户尝试通过User-Agent Switcher and Manager插件修改浏览器标识，但测试表明：

• 切换回默认User-Agent后功能恢复正常
• 故障与User-Agent修改存在一定关联性

2. StreamSaver组件问题

核心下载功能依赖StreamSaver组件，可能出现以下问题：

• 资源完整性校验失败(哈希值不匹配)
• CDN资源加载异常
• 与浏览器广告拦截插件(如uBlock Origin、AdGuard)冲突

3. 网络环境限制

特殊网络环境下可能出现：

• GitHub资源访问受限
• CDN节点不可达
• 防火墙拦截特定域名请求

解决方案建议

临时解决方案

1. 版本回退：回退至2.8.13版本可暂时解决下载问题
2. 代理配置：合理配置网络代理规则，确保streamsaver相关资源可访问
3. 环境清理：临时禁用广告拦截插件进行测试

长期解决方案

1. 组件完整性校验：确保StreamSaver组件哈希值匹配
2. 备用资源源：考虑增加备用CDN或自托管关键资源
3. 错误处理优化：增强下载失败时的错误提示机制

技术原理补充

Bilibili-Evolved的音频下载功能基于DASH协议实现，该协议允许将视频和音频流分开处理。当出现下载异常时，可能是以下环节出现问题：

1. 元数据获取：脚本无法正确解析视频的DASH manifest
2. 流媒体分段：音频分段地址生成失败
3. 下载器初始化：StreamSaver实例化过程被阻断

建议用户在遇到类似问题时，优先检查浏览器控制台是否有相关错误日志，这将有助于更精准地定位问题根源。