BiliTools 完整使用指南：如何用好这款免费开源的 B 站下载工具

【免费下载链接】BiliTools本项目已停止维护。项目地址: https://gitcode.com/GitHub_Trending/bilit/BiliTools

BiliTools 是一款基于 Tauri 构建、完全本地运行的免费开源 B 站下载工具，负责 B 站视频下载、番剧与课程保存、无损音乐收集、弹幕归档等任务，所有资源均按你的账号权限解析为本地文件。本文按“上手 → 精通 → 避坑”三个阶段组织内容，从安装、登录讲到批量收藏夹下载与参数调优，供第一次接触它的用户完整走一遍流程。

能力速览：这款 B 站视频下载工具能整理哪些内容

先给结论：它不只是下载器，而是把视频、音频、弹幕、字幕、图文、媒体库元数据打包成一套本地资源管理方案。选型前对照下表确认需求是否被覆盖即可。

支持功能一览可参见项目 README，接口细节见 媒体解析源码。

安装与登录：三平台安装步骤与账号权限

流程上只需两件事：装好程序、完成登录。真正的关键认知在后一步——能解析出什么画质与内容，完全取决于你账号自身的权限：大会员番剧需要大会员账号，课程需要先购买。工具不绕过任何付费验证，它只是把“有权限的内容”以文件形式存下来。

Windows 安装

从 Releases 页面取_x64-setup.exe安装包，双击后按向导执行。两个前提：不支持 Windows ARM 与 Windows 7；系统若未装 WebView2 运行时，需先到微软官网补装，否则应用无法启动。

macOS 安装

按芯片选包：Intel 选_x64.dmg，Apple 芯片选_aarch64.dmg（系统要求 macOS 11.0 及以上）。挂载镜像后把应用图标拖入“应用程序”。首次启动若被系统安全策略拦截，右键应用图标选“打开”即可放行。

Linux 安装

提供 deb 与 rpm 两种包，适用于各自发行版（Ubuntu 22.04+/Debian 12+；Fedora/CentOS 的 rpm 包官方标注尚未完整测试）。进入下载目录后执行：

sudo apt-get install -y ./bilitools_x.y.z_amd64.deb

sudo dnf install -y ./bilitools_x.y.z_amd64.rpm

三种登录方式与推荐顺序

按当前成功率排序：

1. 扫码登录：B 站 App 扫码，成功率最高，安全性最好
2. 短信登录：手机验证码，成功率居中
3. 密码登录：受风控影响明显，官方文档已标注暂不可用，不建议采用

登录过程本质是模拟 Chrome 浏览器走 B 站 Web API，因此账号的设备登录记录里出现的通常是“Chrome 浏览器”。各方式说明见 登录文档。

登录信息存在哪里

登录信息以SQLite 数据库明文形式保存在本机，路径如下（数据库位于Storage子目录内）：

• Windows：%APPDATA%\com.btjawa.bilitools
• macOS：$HOME/Library/Application Support/com.btjawa.bilitools
• Linux：$HOME/.local/share/com.btjawa.bilitools

这一条直接决定了安全习惯：公共电脑上不要保留登录状态。

首次实操：从一条链接到文件落地的五步

整体流程是“粘贴 → 识别 → 勾选 → 选参数 → 执行”，五步走完文件即可落盘。唯一的硬性约束在勾选环节：官方明确提示单次勾选不要超过 30 个，原因见后文风控部分。

1. 拿到链接。输入栏接受的范围很宽：

   • 视频：完整链接、av号、BV号、b23.tv短链
   • 番剧/影视：ss号 /ep号 /md号；课程：ss号 /ep号
   • 音乐：au号；歌单：am号
   • 用户空间、用户投稿（视频/图文/音频）、用户收藏夹链接
   • 带文案的分享链接直接粘贴即可识别
   • 注意：仅输入纯数字或仅填课程ss/ep号时，需手动指定资源分类，其余情况保持“自动检测”。

2. 粘贴并搜索。搜索框回车后，左侧生成资源列表。合集/番剧会列出全部集数并支持 Shift 连续多选，截图即为该界面：

3. 勾选条目。逐个点选或按住 Shift 框选。勾选量影响风控概率，不要一次超过 30 个——解析阶段就要对每条资源发请求，量越大越像爬虫行为。

4. 选参数。点“常规下载”打开参数面板，勾选资源类型与规格后点“下一步”。面板默认只按选中的第一个条目取样展示参数，这是刻意为之：避免对整批视频同时发请求，换取速度与更低的封禁风险（详见 选择资源文档）。

5. 执行下载。任务先落入“备选区”作为缓冲，确认无误后点高亮的“开始执行”，整批被规划为任务组推入队列，按并发数开始下载。任务层级为队列 → 任务组 → 任务 → 子任务：任务卡片带总进度条与暂停/恢复/删除操作，视频/音频类子任务支持断点续传（暂停即中止，恢复从断点继续）。机制细节见 下载与处理文档。

分辨率、编码、音质速查：参数面板怎么选

面板选项多，但底层逻辑只有一条：往高了选，工具负责自动回退。截图展示的就是参数面板的完整结构：

分辨率：240P 到 8K 全档可选（含 1080P 高码率、1080P 60 帧、HDR 真彩、杜比视界）。若该视频没有你选的档位，会自动落回它支持的最高档，因此放心选最高。

编码格式：

视频若不提供所选编码（例如 8K 无 H.264），工具会遍历可用编码并自动挑最兼容的一种。

音质：64K / 128K / 132K / 192K / 320K 五档，外加杜比全景声、Hi-Res 无损、无损 FLAC 三档高级档。两个自动处理规则：只下音频时，FLAC 会被 FFmpeg 做标准化；音视频同时下载且选了无损时，自动封装进 MKV 容器（MP4 容器装不下 FLAC 流），无需手动干预。

弹幕：实时弹幕覆盖弹幕池几乎全部内容；历史弹幕按指定日期拉取，当天无数据时自动回退到当日弹幕。格式二选一——ASS 带样式，PotPlayer 一类播放器可直接外挂；XML 是原始数据，适合存档与二次转换。

字幕：选定语言后下载为 SRT，文件名遵循name.lang.srt规则；与视频同目录存放时，播放器能自动识别并挂载。

流媒体格式：默认保持 DASH。除非清楚自己在做什么，不要改成 MP4/FLV，说明见 流媒体格式文档。

五个进阶技巧：弹幕归档、收藏夹批量与媒体库刮削

基础流程跑通后，下面五项才是效率差距的来源。每条先说结论，再给做法。

1. 历史弹幕归档：老视频也能“看弹幕”。追完的番剧多年后重温，只要当初按日期补过历史弹幕，弹幕仍在。做法：勾选“历史弹幕”并指定日期，导出 ASS 格式，用 PotPlayer 外挂加载即可。

2. 收藏夹批量搬家：公开收藏夹一次搬空。任意用户的公开收藏夹链接都能解析。做法：粘贴收藏夹链接 → 列表多选 → 批量下发任务，再开启“设置 → 通用 → 自动开始下载”，接近“贴完链接坐等文件”的效果。

3. NFO 刮削：下载完直接进 NAS 媒体库。勾选“合集/剧集刮削”会生成tvshow.nfo与poster.jpg，勾选“单集刮削”再生成每集的 NFO 文件，结构遵循 KODI 规范、Emby 可识别。丢进媒体库后海报、简介、演职员自动匹配。

4. 命名模板：配置一次，目录永久整齐。在“设置 → 命名”中分别配置顶层文件夹、子文件夹、文件名的格式，可用变量包括{container}、{showtitle}、{title}、{index}、{mediaType}、{taskType}、{downtime}等；{pubtime}与{downtime}支持 ISO 8601 自定义时间格式（或ts填 UNIX 时间戳），非法字符会自动替换为下划线。例如顶层文件夹设为{container} - {showtitle} ({downtime:YYYY-MM-DD_HH-mm-ss})，落盘效果就是“收藏夹 - 标题 (2026-08-17_16-00-00)”这类结构。

5. AI 总结 + 图文转 Markdown：内容不止存文件。勾选 AI 总结后，工具调用 B 站 AI 小助手生成带分段跳转时间戳的 Markdown 总结；专栏与动态则整体转成 Markdown，保留标题、作者、点赞投币数据，方便直接喂给笔记工具。

真实用法：追番党、课程党与音乐收藏者各怎么做

追番党：做法——整部番剧的ss号贴入，全选集数，勾选 1080P + ASS 实时弹幕 + 单集刮削，开启自动开始后把目录挂进 Kodi。收益——新番离线追看不掉档，重温时弹幕与海报、简介一个不缺。

课程学习者：做法——课程ss/ep号入库，整系列下载并勾选 SRT 字幕，命名模板按课程名归档。收益——离线学习时字幕全程跟随，按课程分好的目录不用二次整理。

音乐收集者：做法——歌单am号或用户音频空间贴入，勾选无损 FLAC，在“设置 → 策略”开启元数据写入，封面、标题、艺人、专辑自动补齐；后续想导入手机，再开“将音频转换为 MP3 格式”统一转码。收益——一个元数据完整、随取随用的无损曲库。

常见问题排查：412 风控、下载慢等报错对照表

排查思路统一为“现象 → 原因 → 处理”：先定位是哪一类问题，再按对应动作处理，多数情况十分钟内可解。

风控机制的完整说明见 风控文档，更多报错可查 常见问题文档。

合规边界与账号安全：三条必须记住的硬性提醒

1. 只下载你有权限的内容。BiliTools 不绕过任何付费验证：大会员内容配大会员账号，课程先购买再解析。它提供的是技术便利，版权归属始终是原作者。

2. 不要在公共设备上保留登录态。登录信息以 SQLite 明文存放在本机（路径见上文“安装与登录”一节），公共电脑用完即退，日常优先扫码登录。

3. 了解项目现状再提预期。当前 v1.4.x 版本已进入稳定状态、暂缓更新，功能完整，日常使用没有障碍；v2 重构已在规划中。有开发能力的话可以 clone 仓库研读或参与贡献，架构为前端 Vue + 后端 Rust 的 Tauri 应用，媒体解析核心在 src/services/media/ 目录：

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

从单条视频到整部番剧，从一首歌到整张歌单，BiliTools 把 B 站内容当作一个完整资源库来对待：弹幕可归档、音乐带元数据、番剧能刮削进媒体库、图文直接变 Markdown。建议现在就装上应用、完成扫码登录，挑一个你看得最多的视频把五步流程完整跑一遍，随后在设置页用五分钟配好命名模板与默认参数——这套一次性的配置，会让之后每次下载都省掉重复操作。

【免费下载链接】BiliTools本项目已停止维护。项目地址: https://gitcode.com/GitHub_Trending/bilit/BiliTools