BiliTools 使用指南：30MB 免费方案，把 B 站视频、弹幕和无损音乐存进硬盘
【免费下载链接】BiliTools本项目已停止维护。项目地址: https://gitcode.com/GitHub_Trending/bilit/BiliTools
BiliTools 是一款免费开源的 B 站下载桌面应用，能把 B 站视频、弹幕、字幕与无损音乐存到本地，应用本体仅约 30MB。本文带你过四件事：能力边界、第一次下载、参数调优与项目现状。
能力边界先行：它能存哪些资源
| 资源 | 你能拿到什么 | 账号权限要求 |
|---|---|---|
| 视频（番剧 / 课程 / 电影 / 合集） | 最高 4K、8K、HDR、杜比视界，DASH / MP4 / FLV 三种流格式 | 1080P 以上需大会员，课程需购买 |
| 音乐 / 歌单 | 无损 FLAC、320K、杜比全景声、Hi-Res | 仅限有下载权限的曲目 |
| 弹幕 | 实时弹幕 + 历史弹幕（可按日期选），ASS / XML 两种格式 | 无 |
| 字幕 | SRT 格式 | 仅限带字幕的视频，缺失时自动跳过 |
| 其他 | 封面、NFO 刮削、ID3v2 元数据、AI 总结、收藏夹、稍后再看 | 无 |
一切资源都按你自己 B 站账号的权限解析，应用不破解任何付费机制——没开大会员就没有 1080P，没买课程就解析不了课程，这是设计使然，也是合规底线。
解析入口很宽：常规链接、b23 短链、AV/BV 号、番剧 SS/EP/MD 号、课程 SS/EP 号、音乐 AU/AM 号、收藏夹编号，甚至直接输入 UID，都能自动识别；纯数字和课程 SS/EP 号需要手动选择资源分类。
第一次下载三步走：安装、登录、首单
安装：Windows 运行 .exe 安装程序（需 WebView2 运行时）；macOS 挂载 .dmg 后把应用拖进"应用程序"；Debian / Ubuntu 用sudo apt install装 .deb，Fedora 用sudo dnf install装 .rpm。
登录：点左下角用户图标进入登录页。成功率排序是扫码 > 短信 > 密码，扫码最稳，密码登录目前因平台风控暂不可用。登录逻辑模拟 Chrome 请求 B 站 Web API，所以账号后台显示的登录设备大概率是"Chrome 浏览器"，属正常现象。
解析与下载：把链接粘贴进搜索框，回车或点"自动检测"。解析完成后左侧是资源列表、右侧是下载入口——常规下载直接弹出参数面板，高级下载进入完整参数配置。确认后点"下一步"，任务进入备选区，再点"开始执行"才真正开始下载。
图为深色主题下的番剧解析界面：粘贴播放页链接后列出全部集数，勾选后点"常规下载"或"高级下载"即可，合集右下方还有"正片 / PV"等分类页签。
为什么值得给它一个下载位
两个真实场景：你追的番剧因版权到期从 B 站消失，本地那份才留得下；你想把课程整理成知识库，离线归档比在线逐集看方便得多。B 站内容在线的本质是"借用"，下载落地才是"拥有"。
再往上一层价值：BiliTools 按 Kodi 规范生成 NFO 与poster.jpg封面，配合自定义命名格式，下载产物能直接被 Kodi / Plex 识别成完整的剧集海报墙——不是散落的视频文件，而是规范媒体库。
参数深水区：画质、弹幕、命名与数据落点
画质与编码怎么选
分辨率从 360P 一路到 8K，编码提供三种：
| 你的场景 | 推荐编码 |
|---|---|
| 手机观看、求最大兼容 | AVC (H.264) |
| 电脑存储、同码率更好画质 | HEVC (H.265) |
| 新硬件、长期存档 | AV1 |
若目标资源没有你选的分辨率或编码，应用会自动回退到该资源支持的最高规格，无需手动调整；流媒体格式保持默认的DASH即可，它是当前画质最好、速度最快的方案。
弹幕与字幕输出
三种格式用途不同：ASS是带样式的可挂载字幕，开启"将 XML 弹幕转换为 ASS 字幕"（内置 DanmakuFactory 执行转换）后，用 PotPlayer 这类播放器挂载即可边看边刷弹幕；XML是原始弹幕数据，适合存档；SRT是字幕，按name.lang.srt命名，与视频同目录存放时播放器会自动挂载。B 站弹幕下载同时覆盖实时弹幕与历史弹幕，后者可选日期，当天无弹幕时自动回退。
图为高级下载参数面板：分辨率、编码格式、比特率、流媒体格式、字幕、NFO、弹幕、封面都在这里勾选，确认后点"下一步"。
命名格式自定义
设置页用{变量}配置顶层文件夹、子文件夹与文件名：
顶层文件夹：{container} - {showtitle} ({downtime:YYYY-MM-DD_HH-mm-ss}) 子文件夹：({index}) {mediaType} - {title} 文件名：{taskType} - {title}下载后形如收藏夹 - 标题 (2026-08-17_16-00-00)/(1) 视频 - 标题/音视频 - 标题.mp4。/、*等非法字符一律自动替换为下划线，时间变量还支持{downtime:ts}输出秒级时间戳，详见 docs/guide/settings.md。
数据都存在哪
所有配置、下载记录与登录信息以 SQLite 明文存在本地：
- Windows：
%APPDATA%\com.btjawa.bilitools - macOS：
$HOME/Library/Application Support/com.btjawa.bilitools - Linux：
$HOME/.local/share/com.btjawa.bilitools
设置页支持数据库导出与导入，方便备份迁移；注意"存储 → 缓存"里的数据库缓存就是全部应用数据，清除等于重置。
按角色抄作业：追番、课程与音乐各三行
追番党
- 输入：番剧播放页链接或 SS 号
- 参数选择：1080P + AVC 或 HEVC + 实时弹幕（ASS）+ 合集/剧集刮削，每次勾选 ≤15 集
- 产出物：
tvshow.nfo+poster.jpg+ 逐集 mp4，Kodi / Plex 直接可用
课程学习者
- 输入：课程 SS 号 / EP 号（注意手动选择课程分类）
- 参数选择：勾选 SRT 字幕，用命名格式把不同老师的课程分文件夹存放
- 产出物：课程视频 + SRT 字幕，B 站课程离线归档，还可转 MP3 通勤时听
音乐收藏者
- 输入：歌单 AM 号或音乐 AU 号
- 参数选择：无损 FLAC + 启用元数据嵌入，不要开"将音频转换为 MP3"
- 产出物：带 ID3v2 标签（歌手、专辑、封面、流派）的 FLAC，一套完整的 B 站无损音乐下载曲库
别踩这些坑
DASH、MP4、FLV 到底选哪个？保持 DASH。MP4 目前主要服务付费试看资源（如付费番剧试看集），画质音质大多欠佳；FLV 基本退役，仅存档保留。不要随意改动参数里的"流媒体格式"。
批量下载会触发风控吗？⚠️ 会。应用内明确提示不要一次勾选超过 30 个任务，官方建议每次≤15 个。遇到412 Precondition Failed，要么等半小时，要么换网络 IP，官方更推荐前者，详见 docs/guide/risk.md。
下载一半退出应用怎么办？文件会滞留在临时目录。视频 / 音频子任务支持断点续传，重启后继续即可；字幕、NFO、弹幕等其他子任务会先完成当前项再暂停。确定不再续传时，到"缓存"里一键清除临时文件。
无损音乐能开"音频转 MP3"吗？不要。设置页明确这是强制转换，对高音质 / 高比特率音频必然损失音质——无损版留作存档，需要便携时另出一份 MP3 副本，分开存放。
macOS 能用 tar.gz 包吗？不能。官方文档明确提醒切勿直接用 tar.gz，请下载 .dmg 镜像。
项目还在维护吗？⚠️ 如实说：项目在 v1.4.0 正式版发布后进入稳定状态、暂缓更新，当前版本 v1.4.7；README 中提到 v2 已提上日程，但短期内不会再有新功能。核心下载链路完整稳定、可用，但请接受这一现状。
底层怎么跑起来的
前端是 Vue 3 + TypeScript（Pinia 状态管理），后端是 Rust，两者由 Tauri 打包成桌面应用——这正是它约 30MB、远小于同类 Electron 应用的原因。下载环节由 aria2c 多线程加速，FFmpeg 负责音视频混流与 FLAC/MP3 转码，DanmakuFactory 负责弹幕 XML 转 ASS。
想读源码的话：前端界面在 src/，Rust 后端（下载队列、aria2c / FFmpeg 封装、存储层）在 src-tauri/src/。安装依赖后运行pnpm dev进入开发模式，pnpm build构建生产版本。
最后三句话
- 适合你：想把 B 站番剧、课程、音乐和弹幕存到本地、且有对应会员或购买权限的人。
- 推荐理由一句话：30MB 的体积、按自身权限解析不碰付费机制、每个参数都落到实处，稳定在 v1.4.7。
- 行动建议：下次看到想留的合集或歌单，收藏的同时顺手存一份到本地——本地那份才是唯一确定的拥有。
【免费下载链接】BiliTools本项目已停止维护。项目地址: https://gitcode.com/GitHub_Trending/bilit/BiliTools
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
