BiliTools：B站视频下载与弹幕管理全攻略

BiliTools是一款跨平台的哔哩哔哩工具箱，致力于解决B站内容下载过程中的技术门槛问题。该工具集成视频解析、批量下载、弹幕处理等核心功能，通过直观的用户界面和智能任务管理系统，帮助用户高效获取和管理B站视频资源。无论是番剧收藏、课程保存还是弹幕备份，BiliTools都能提供稳定可靠的解决方案。

一、用户痛点深度解析

B站内容下载长期面临三大核心挑战：链接解析兼容性不足，难以处理不同类型的视频URL；批量下载管理复杂，缺乏智能调度机制；弹幕数据获取困难，无法完整保存互动内容。传统工具往往存在操作繁琐、功能单一或兼容性问题，无法满足用户多样化需求。

二、核心价值：技术与体验的平衡

BiliTools采用Tauri框架构建，实现了原生应用性能与Web技术灵活性的完美结合。项目核心优势在于：多平台一致性体验，支持Windows、macOS和Linux系统；模块化架构设计，确保功能扩展与维护便捷性；开源社区驱动，持续响应用户需求与B站API变化。

三、快速上手：四步完成视频下载

智能解析引擎：多格式链接一键识别

将B站视频链接粘贴至搜索框，系统自动识别内容类型（普通视频、番剧、音乐、课程等）。核心模块：[src/services/media/data.ts]中的getMediaInfo函数处理不同类型媒体信息，支持BV号、AV号等多种标识格式。

参数配置中心：个性化下载选项

解析完成后，可配置清晰度（4K至360P）、编码格式（AVC/HEVC/AV1）、弹幕类型（实时/历史）等参数。高级设置支持音视频分离下载、字幕选择和存储路径自定义，满足不同场景需求。

任务队列管理：高效批量处理

添加多个任务后，系统自动进行队列调度，支持断点续传和优先级调整。核心模块：[src/services/queue.ts]实现智能资源分配，避免网络拥塞，提升下载效率。

媒体库整合：一站式内容管理

下载完成的视频自动分类存储，支持按标题、日期、类型等多维度检索。历史记录功能方便用户追踪之前下载的内容，实现资源有序管理。

四、特色功能：超越传统下载工具

弹幕全量保存：完整记录互动历史

通过[src/services/media/dm.ts]模块，将原始protobuf格式弹幕数据转换为通用XML格式，支持实时弹幕抓取和历史弹幕归档，完整保存视频的互动语境。

智能格式转换：多场景适配

集成FFmpeg工具链，自动处理不同编码格式的兼容性问题。用户可根据设备需求选择输出格式，确保在手机、平板、电视等多终端流畅播放。

跨平台同步：无缝切换工作流

支持配置文件导出导入，实现多设备间的设置同步。Linux用户可通过[src-tauri/binaries/linux]目录下的原生工具获得最佳性能体验。

五、专业使用技巧

1. 登录认证：通过B站账号登录可解锁更高清晰度选项，核心实现：[src/services/login.ts]。
2. 并发控制：根据网络带宽调整同时下载任务数（建议设置为2-3个），避免限速。
3. 定期更新：关注项目CHANGELOG.md获取功能更新，通过内置 updater 组件一键升级。
4. 高级设置：在[src/components/SettingsPage]中配置下载策略，优化存储使用和下载速度。

六、开始使用与版本信息

1. 获取源码：git clone https://gitcode.com/GitHub_Trending/bilit/BiliTools
2. 参考官方文档：[docs/guide/install.md]完成环境配置
3. 当前稳定版本：v1.2.0（支持B站最新API协议）

BiliTools持续迭代更新，近期将新增直播回放下载和字幕翻译功能。欢迎通过项目issue反馈使用问题或功能建议，共同完善这款开源工具。