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

BiliTools 完整使用指南如何用好这款免费开源的 B 站下载工具【免费下载链接】BiliTools本项目已停止维护。项目地址: https://gitcode.com/GitHub_Trending/bilit/BiliToolsBiliTools 是一款基于 Tauri 构建、完全本地运行的免费开源 B 站下载工具负责 B 站视频下载、番剧与课程保存、无损音乐收集、弹幕归档等任务所有资源均按你的账号权限解析为本地文件。本文按“上手 → 精通 → 避坑”三个阶段组织内容从安装、登录讲到批量收藏夹下载与参数调优供第一次接触它的用户完整走一遍流程。能力速览这款 B 站视频下载工具能整理哪些内容先给结论它不只是下载器而是把视频、音频、弹幕、字幕、图文、媒体库元数据打包成一套本地资源管理方案。选型前对照下表确认需求是否被覆盖即可。类别完成度关键说明视频全部常规/合集/分P/互动视频、番剧/课程/电影DASH、MP4、FLV 流上限 8K含 HDR 与杜比视界音频全部杜比全景声、Hi-Res 无损、FLAC 无损编码可选 AVC / HEVC / AV1弹幕全部实时弹幕近乎覆盖整个弹幕池历史弹幕可按日期补档ASS 或 XML 导出音乐全部FLAC 无损与 320K 两档音质单曲、歌单均可字幕全部SRT 格式播放器可自动识别挂载图文全部专栏、动态用户投稿转 Markdown 落盘收藏夹全部任意用户的公开收藏夹均可导入并批量处理媒体库全部NFO 刮削符合 KODI 规范、Emby 可识别ID3v2、Vorbis Comments 元数据写入附加全部AI 总结Markdown 带时间戳、稍后再看、封面与海报支持功能一览可参见项目 README接口细节见 媒体解析源码。安装与登录三平台安装步骤与账号权限流程上只需两件事装好程序、完成登录。真正的关键认知在后一步——能解析出什么画质与内容完全取决于你账号自身的权限大会员番剧需要大会员账号课程需要先购买。工具不绕过任何付费验证它只是把“有权限的内容”以文件形式存下来。Windows 安装从 Releases 页面取_x64-setup.exe安装包双击后按向导执行。两个前提不支持 Windows ARM 与 Windows 7系统若未装 WebView2 运行时需先到微软官网补装否则应用无法启动。macOS 安装按芯片选包Intel 选_x64.dmgApple 芯片选_aarch64.dmg系统要求 macOS 11.0 及以上。挂载镜像后把应用图标拖入“应用程序”。首次启动若被系统安全策略拦截右键应用图标选“打开”即可放行。Linux 安装提供 deb 与 rpm 两种包适用于各自发行版Ubuntu 22.04/Debian 12Fedora/CentOS 的 rpm 包官方标注尚未完整测试。进入下载目录后执行sudo apt-get install -y ./bilitools_x.y.z_amd64.debsudo dnf install -y ./bilitools_x.y.z_amd64.rpm三种登录方式与推荐顺序按当前成功率排序扫码登录B 站 App 扫码成功率最高安全性最好短信登录手机验证码成功率居中密码登录受风控影响明显官方文档已标注暂不可用不建议采用登录过程本质是模拟 Chrome 浏览器走 B 站 Web API因此账号的设备登录记录里出现的通常是“Chrome 浏览器”。各方式说明见 登录文档。登录信息存在哪里登录信息以SQLite 数据库明文形式保存在本机路径如下数据库位于Storage子目录内Windows%APPDATA%\com.btjawa.bilitoolsmacOS$HOME/Library/Application Support/com.btjawa.bilitoolsLinux$HOME/.local/share/com.btjawa.bilitools这一条直接决定了安全习惯公共电脑上不要保留登录状态。首次实操从一条链接到文件落地的五步整体流程是“粘贴 → 识别 → 勾选 → 选参数 → 执行”五步走完文件即可落盘。唯一的硬性约束在勾选环节官方明确提示单次勾选不要超过 30 个原因见后文风控部分。拿到链接。输入栏接受的范围很宽视频完整链接、av号、BV号、b23.tv短链番剧/影视ss号 /ep号 /md号课程ss号 /ep号音乐au号歌单am号用户空间、用户投稿视频/图文/音频、用户收藏夹链接带文案的分享链接直接粘贴即可识别注意仅输入纯数字或仅填课程ss/ep号时需手动指定资源分类其余情况保持“自动检测”。粘贴并搜索。搜索框回车后左侧生成资源列表。合集/番剧会列出全部集数并支持 Shift 连续多选截图即为该界面勾选条目。逐个点选或按住 Shift 框选。勾选量影响风控概率不要一次超过 30 个——解析阶段就要对每条资源发请求量越大越像爬虫行为。选参数。点“常规下载”打开参数面板勾选资源类型与规格后点“下一步”。面板默认只按选中的第一个条目取样展示参数这是刻意为之避免对整批视频同时发请求换取速度与更低的封禁风险详见 选择资源文档。执行下载。任务先落入“备选区”作为缓冲确认无误后点高亮的“开始执行”整批被规划为任务组推入队列按并发数开始下载。任务层级为队列 → 任务组 → 任务 → 子任务任务卡片带总进度条与暂停/恢复/删除操作视频/音频类子任务支持断点续传暂停即中止恢复从断点继续。机制细节见 下载与处理文档。分辨率、编码、音质速查参数面板怎么选面板选项多但底层逻辑只有一条往高了选工具负责自动回退。截图展示的就是参数面板的完整结构分辨率240P 到 8K 全档可选含 1080P 高码率、1080P 60 帧、HDR 真彩、杜比视界。若该视频没有你选的档位会自动落回它支持的最高档因此放心选最高。编码格式编码适用场景AVC (H.264)老设备、兼容性优先HEVC (H.265)同画质下文件更小电脑端首选AV1压缩效率最高但终端支持面窄视频若不提供所选编码例如 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 风控、下载慢等报错对照表排查思路统一为“现象 → 原因 → 处理”先定位是哪一类问题再按对应动作处理多数情况十分钟内可解。现象原因处理解析失败链接失效、视频被删或纯数字输入未指定分类确认链接仍可访问手动选择资源分类后重试提示412 Precondition Failed模拟浏览器的高频请求触发了 B 站风控等待约半小时或更换 IP每次勾选控制在 15 个以内少量多次官网也看不了大会员内容账号权限被风控限制到 B 站大会员账户页查看“权限已被限制”提示按指引解除下载速度慢并发数偏低、命中 PCDN 链接或网络受限调高“设置 → 下载 → 最大并发下载数”默认4过高会推高风险控制概率配置 HTTP 代理开启“尝试屏蔽 PCDN”若反而更慢则关闭弹幕不显示播放器不支持 ASS 外挂换 PotPlayer 等支持 ASS 的播放器或改用 XML 原始格式登录状态失效B 站安全策略的正常刷新重新扫码登录即可风控机制的完整说明见 风控文档更多报错可查 常见问题文档。合规边界与账号安全三条必须记住的硬性提醒只下载你有权限的内容。BiliTools 不绕过任何付费验证大会员内容配大会员账号课程先购买再解析。它提供的是技术便利版权归属始终是原作者。不要在公共设备上保留登录态。登录信息以 SQLite 明文存放在本机路径见上文“安装与登录”一节公共电脑用完即退日常优先扫码登录。了解项目现状再提预期。当前 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考