BiliTools 完整使用指南：从粘贴链接到离线媒体库的 B 站资源归档

BiliTools 完整使用指南从粘贴链接到离线媒体库的 B 站资源归档【免费下载链接】BiliTools本项目已停止维护。项目地址: https://gitcode.com/GitHub_Trending/bilit/BiliTools想离线保存一部 4K 番剧下载器却只给到 720P弹幕、字幕一个都没留下——问题往往不在视频而在工具。BiliTools 是一款基于 Tauri 构建的免费开源哔哩哔哩工具箱安装包仅约 30 MB核心解决B 站资源本地化归档视频、番剧、课程、音乐、实时/历史弹幕、字幕、封面、NFO 元数据都能一并落到本地文件夹。它不绕过付费验证而是基于你账号的真实权限解析——有对应会员或已购买才能解析对应资源。五分钟内跑通第一个任务安装、登录与首次解析从装好到第一个文件落地最短路径就三步安装、扫码登录、粘贴链接。三种系统的安装方式安装包只从项目 Releases 页面获取第三方渠道的分发包无法保证完整性与安全性。系统安装方式注意Windows下载 x64-setup.exe 双击安装需 WebView2 运行时Win11 通常自带不支持 Win7 与 ARMmacOS下载 dmg 挂载后拖入应用程序Intel 选 x64、Apple 芯片选 aarch64勿用 tar.gz 直接运行Linuxsudo apt-get install -y ./bilitools_x.y.z_arch.debDebian/Ubuntu 用 debFedora/CentOS 用 rpm扫码登录与Chrome 浏览器提示点左下角用户图标登录成功率排序为扫码 短信 密码密码登录受风控影响暂不建议。登录过程实际模拟 Chrome 浏览器所以账号后台设备显示为Chrome 浏览器属正常现象凭据加密保存在本地数据库重启无需重登。粘贴链接完成第一次下载搜索框粘贴链接回车。支持 BV/AV 号、b23.tv 短链、番剧 SS/EP 号、课程号、音乐 AU 号、歌单 AM 号、用户空间、收藏夹乃至带 share_source 的分享文案。番剧会展开为集数列表按住 Shift 点击可连续勾选点常规下载进入参数面板分辨率可选 240P 到 8K编码 AVC/HEVC/AV1流媒体格式保持默认 DASH 即可。下一步后任务进入备选区点开始执行开跑。场景拆解整季番剧、离线弹幕与无损歌单按真实使用场景拆三个最常见的组合需求。整季番剧归档进 Kodi / Emby 媒体库番剧下完散成一堆文件媒体库认不出来勾选合集/剧集刮削生成tvshow.nfo与海报再勾单集刮削为每集生成独立 NFO数据遵循 KODI 规范Emby 可直接识别。整季内容建议少量多次分批下载避免一次性勾选过多触发风控。离线弹幕挂到播放器上弹幕存成 XMLPotPlayer 却不认在设置 → 策略开启将 XML 弹幕转换为 ASS 字幕内置的 DanmakuFactory 会在下载后自动转出 ASS挂载到本地视频即可看到飘屏转换参数可通过DanmakuFactory.json自定义。历史弹幕支持按日期抓取转换逻辑见src/services/media/dm.ts。无损歌单进本地曲库FLAC 下完没有标签选无损 FLAC下载应用会自动完成 FLAC 标准化并写入 ID3v2 标签封面、标题、流派、职员。想投喂手机音乐 App可在策略里开启将音频转换为 MP3但高音质源不建议开启以免损失音质。下载页机制备选区、任务组与状态色下载页层级是 队列 → 任务组 → 任务 → 子任务任务组即调度器实现见src-tauri/src/services/queue/负责组织组内任务的调度。备选区与添加即下载新添加的任务先进入备选区缓冲不会立刻开跑点备选区的开始执行后整批任务被规划为一个新任务组推入进行队列按设置 → 下载 → 最大并发下载数并发处理全部处理完进入完成队列。想要添加即下载在设置 → 通用打开自动开始下载即可。状态色、断点续传与改参数卡片描边即状态灰等待、蓝进行、绿完成、黄暂停、红失败。视频/音频子任务支持暂停后断点续传字幕、NFO 类子任务会跑完当前步骤再暂停。任务尚在备选区时点子任务信息区可重选参数如改分辨率。重试会从头重跑非必要别用。进阶配置命名变量、策略开关与参数回退两个页面决定产出质量设置 → 命名 与 设置 → 策略。用命名变量定制文件夹结构顶层文件夹、子文件夹、文件名三层均可自定义变量格式为{变量}。例如顶层{container} - {showtitle} ({downtime:YYYY-MM-DD})文件名{taskType} - {title}。时间变量支持 ISO8601 与{var:ts}两种写法/\:*等非法字符会自动替换为下划线。文件先写入临时目录处理完成后再复制到输出目录。策略页与默认参数的自动回退策略页属高级配置不确定含义的开关别动。尝试屏蔽 PCDN会优先选择质量更高的链接但个别网络下反而变慢遇到就关闭重试将视频转换为 MP4会顺带把音频转为 AAC适合兼容性优先的场景。设置 → 下载中的默认选项还参与自动回退资源最高只有 720P 而你设了 1080P 时会自动降到该资源支持的最高画质不会报错中断。排坑手册按症状对号入座下面两张表覆盖绝大多数翻车现场按你看到的症状直接找处理。解析与风控类412 基本等于风控BiliTools 本质是模拟 Chrome 请求 B 站 API偶发会被识别为爬虫批量勾选任务是主因。症状原因处理解析时提示 412 Precondition Failed触发风控一次性勾选任务过多是最常见诱因等半小时再试或更换网络保持每次 ≤15 个任务大会员 / 已购内容解析失败登录失效或会员权限受限重新扫码登录在 B 站账号后台检查大会员状态下载行为与文件类速度问题九成出在限速与 PCDN 链接质量文件问题基本是命名与组织策略没配。症状原因处理下载速度慢限速设置或 PCDN 链接质量差设置 → 下载中限速填 0 即不限速关闭尝试屏蔽 PCDN重试输出文件杂乱未配置命名格式或组织策略设置 → 命名配置三层命名开启顶层文件夹/子文件夹临时目录残留文件下载途中退出应用设置 → 存储 → 缓存中清除临时文件无法归类的报错在设置 → 存储 → 缓存中导出日志随反馈一并附上定位会快很多。定位与下一步谁适合用它BiliTools 的定位很清晰给 B 站重度用户提供一套看到什么就能存什么的本地归档方案适合有离线观看、媒体库整理、无损听歌需求且愿意按自己账号权限合理使用工具的人。行动清单未安装从 Releases 页面下载对应平台安装包按第一节流程完成首次下载已安装试一次 NFO 刮削 历史弹幕转 ASS 自定义命名的组合拳把旧下载重新整理批量下载并发数保持默认坚持每次不超过 15 个任务的节奏获取源码与开发模式前端 Vue 组件在src/后端 Rust 服务在src-tauri/src/队列调度在src-tauri/src/services/queue/。项目自 v1.4.0 起进入稳定期并已停止更新功能成熟日常使用不受影响后续可关注 v2 的规划讨论。获取源码git clone https://gitcode.com/GitHub_Trending/bilit/BiliTools安装依赖后执行npm run tauri dev即可进入开发模式。下载内容版权归原权利人所有建议仅用于个人学习与研究。【免费下载链接】BiliTools本项目已停止维护。项目地址: https://gitcode.com/GitHub_Trending/bilit/BiliTools创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考