BiliTools：全功能B站资源解析与下载工具

BiliTools是一款基于Tauri v2构建的跨平台哔哩哔哩工具箱，提供视频、音乐、番剧、课程等资源的高效解析与下载功能，支持4K、HDR等多种画质及弹幕、字幕获取，是B站内容爱好者的必备工具。

零基础部署指南 🚀

环境准备

使用BiliTools前需确保系统已安装两个核心依赖：

• Rust 2021+：提供后端性能支持的系统级编程语言
• Node.js 20+：运行前端界面的JavaScript运行环境

项目获取与依赖安装

1. 通过终端克隆项目代码库：

   git clone https://gitcode.com/GitHub_Trending/bilit/BiliTools
   

2. 进入项目目录并安装依赖：

   cd BiliTools && npm install
   

启动与构建

• 开发模式：启动带热重载的开发环境

  npm run tauri dev
  

• 生产构建：生成可执行应用程序

  npm run tauri build
  

技术原理速览

BiliTools采用Tauri框架实现跨平台能力，前端使用Vue构建交互界面，后端通过Rust调用系统资源。核心实现机制是解析B站API接口获取媒体资源信息，借助aria2c实现多线程下载，通过ffmpeg处理音视频转码，集成DanmakuFactory实现弹幕格式转换，形成"解析-下载-处理"的完整工作流。

基础操作指南 📋

资源解析流程

1. 启动应用后，在顶部地址栏输入B站视频/番剧URL或直接粘贴AV/BV号
2. 点击搜索按钮，工具将自动解析资源信息并展示可下载内容
3. 在左侧导航栏选择"下载"图标进入任务管理界面

图1：BiliTools暗色系界面展示番剧解析结果

下载参数配置

解析完成后，点击"高级下载"按钮进入参数配置面板：

图2：亮色系界面的下载参数配置面板

配置项说明：

• 分辨率选择：从360P到4K超高清的多种画质选项
• 编码格式：支持AVC(H.264)、HEVC(H.265)和AV1等编码标准
• 流媒体格式：可选择DASH、MP4或FLV格式
• 附加资源：可同时下载封面、字幕和历史弹幕

进阶使用技巧 🔧

批量下载管理

1. 在番剧解析页面勾选多集内容
2. 使用"全选"功能快速选择连续集数
3. 配置统一下载参数后点击"批量下载"
4. 在下载队列中可调整任务优先级或暂停/恢复任务

个性化设置

通过左侧设置图标进入配置界面：

• 存储路径：在"下载设置"中自定义文件保存位置
• 格式转换：在"高级设置"中启用自动转码为MP3功能
• 界面主题：支持明暗两种主题切换（如图1和图2所示）

多来源资源支持

除常规视频外，BiliTools还支持：

• 音乐资源解析：专辑、单曲和歌单批量下载
• 课程内容保存：支持付费课程的离线学习（需登录账号）
• 直播回放获取：可下载已结束的直播内容

格式与画质对比表

画质等级	分辨率	适用场景	典型文件大小
流畅	360P	网络条件差时	50-150MB/集
标清	480P	手机小屏观看	150-300MB/集
准高清	720P	平板观看	300-600MB/集
高清	1080P	电脑/电视观看	600-1.5GB/集
超清	4K	大屏设备	2-5GB/集

常见问题排查

1. 下载速度慢

解决方法：

• 检查网络连接稳定性
• 在设置中增加aria2c线程数（默认4线程，最大支持16线程）
• 避免同时下载超过3个任务

2. 解析失败提示"API错误"

解决方法：

• 确认URL格式正确（支持av号、bv号或完整播放页链接）
• 尝试重新登录账号（部分资源需登录权限）
• 检查网络代理设置，确保可正常访问B站服务器

3. 视频下载后无法播放

解决方法：

• 尝试选择不同的编码格式（推荐AVC/H.264兼容性最佳）
• 检查本地播放器是否支持所选格式（建议使用VLC或PotPlayer）
• 在"高级设置"中启用"下载后自动修复文件"选项

4. 弹幕文件无法加载

解决方法：

• 确认下载时已勾选"弹幕"选项
• 弹幕文件默认与视频文件同名，扩展名为.xml
• 使用支持弹幕的播放器（如弹弹play）打开视频

核心技术生态

BiliTools整合了多个开源项目构建完整功能体系：

• aria2c：提供高效多线程下载能力
• ffmpeg：处理音视频编解码与格式转换
• DanmakuFactory：实现弹幕格式标准化处理
• bilibili-API-collect：提供API接口支持

通过这些技术的有机结合，BiliTools实现了对B站资源的全方位解析与处理能力，同时保持了跨平台兼容性和高效性能表现。

官方文档：docs/index.md 配置模板：src-tauri/tauri.conf.json