BiliTools 哔哩哔哩工具箱教程：五步保存整部番剧到本地

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

BiliTools 是一款免费开源（GPL-3.0-or-later）的哔哩哔哩下载与资源管理桌面应用，基于 Tauri（用 Web 前端加 Rust 后端的轻量桌面框架）构建，覆盖 Windows、macOS、Linux 三大平台。它不止能下载视频，还能处理歌单、NFO 元数据刮削和弹幕存档。先说一个前提：项目在 v1.4.0 后进入稳定状态，目前已停止维护，现有功能完整，但不必期待后续有大量新特性。

下面用一个完整任务演示：把《某科学的超电磁炮T》的全部剧集保存到本地，附带 1080P 画面、SRT 字幕和实时弹幕。

BiliTools 怎么用：五步完整流程

第一步：扫码登录

应用基于登录账号解析资源，先登录。官方建议扫码登录（成功率扫码 > 短信 > 密码，密码登录目前因风控问题暂不可用）。登录本质是模拟 Chrome 浏览器的登录过程，所以登录后账号安全页大概率显示设备为「Chrome 浏览器」，不必惊讶。

第二步：粘贴链接拿集数列表

在搜索页粘贴番剧链接，或直接输入 ss / ep 号，资源分类保持默认的「自动检测」，点搜索。左侧出现番剧信息卡（播放、收藏数、简介）和集数列表。勾选想保存的剧集，可单个勾选，也可以按住 Shift 连续选择，然后点右侧「常规下载」。批量操作时官方建议一次别勾超过 30 项，更推荐少量多次、每次 15 个左右，降低触发风控的概率。

第三步：六组参数决定输出

参数页分六组，常用选项如下：

最底部「音视频 / 视频 / 音频」决定任务类型。选「音视频」时，应用会自动调用 FFmpeg 把 DASH 分发的无声视频流与无画音频流混流成一个可播放文件。全部设好点「下一步」，任务进入「备选区」。

第四步：备选区与并发执行

备选区里的任务只等待、不开始。点「开始执行」后，这一批任务被规划成一个任务组推入进行队列，按设置 → 下载里的「最大并发下载数」并行跑。任务层级是「队列 → 任务组 → 任务 → 子任务」：并发以任务为单位，同一任务的子任务（视频、字幕、弹幕等）则串行执行保证连续性。任务卡片描边颜色即状态：灰等待、蓝进行、绿完成、黄暂停、红失败，暂停的任务支持断点续传。

第五步：确认完成文件

任务卡片全部变绿后，文件从临时目录写入输出目录，默认结构是「输出目录 → 顶层文件夹 → 子文件夹」，视频、字幕、弹幕、NFO 放在一起，可直接被 Emby 识别。

BiliTools 怎么装：四条命令跑起来

普通用户建议直接装官方 Releases 安装包：Windows 先确认装有 WebView2 运行时（Tauri 应用渲染网页的系统组件，不支持 Windows 7）；macOS 下载对应芯片的 dmg（不要用 tar.gz）；Linux 用 deb/rpm 包配合 apt 或 dnf 安装。想自己跑最新代码，需要 Node.js 20+ 与 pnpm：

git clone https://gitcode.com/GitHub_Trending/bilit/BiliTools cd BiliTools pnpm install pnpm dev

第一行拿代码，第二行进目录，第三行装前端依赖（Vue、Pinia 等），最后一行以 Tauri 开发模式启动，边编译 Rust 后端边打开窗口，看到主界面即成功。所有本地数据（登录信息、任务记录、配置）都存在本机 SQLite 数据库中，是明文存储，删库即重置应用：

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

BiliTools 进阶玩法：弹幕变字幕与自定义命名

⚙️弹幕转字幕。在设置 → 策略里开启「将 XML 弹幕转换为 ASS 字幕」，应用会调用内置的 DanmakuFactory 把弹幕 XML 转成 ASS 外挂字幕。用 PotPlayer 一类播放器挂载这份字幕，下载完的片子也能「看弹幕」。弹幕的字体、滚动时长、显示区域等，可以编辑数据目录里的DanmakuFactory.json微调。

自定义命名格式。命名页支持给顶层文件夹、子文件夹、文件名分别设{变量}模板。比如顶层文件夹设为{container} - {showtitle} ({downtime:YYYY-MM-DD_HH-mm-ss})、子文件夹设为({index}) {mediaType} - {title}，产物就是「收藏夹 - 标题 (下载日期) / (1) 视频 - 标题」这样的整齐结构。非法字符会被自动替换成下划线，还可开「自动检测重名」防止覆盖。

另外两个值得留意的开关：「尝试屏蔽 PCDN」会尝试优先选质量更高的下载链接，若开启后下载失败或变慢，关掉重试即可；「下载限速」单位是 KiB/s，填 0 取消限速，修改后需重启应用生效。

BiliTools 常见问题：三个高频坑

❓杀毒软件报 BiliTools 是木马？代码中并无恶意内容，这属于 Tauri 架构的已知误报问题。稳妥做法是确认安装包来自官方发行渠道，首次运行时加信任放行。

macOS 提示「已损坏，无法打开」？这是系统的隔离标记。打开终端执行下面命令移除后重新打开即可：

sudo xattr -r -d com.apple.quarantine /Applications/BiliTools.app

提示 412 Precondition Failed、无法选择下载参数？典型的风控信号，等半小时或换 IP，官方更推荐前者；同时检查「最大并发下载数」是否设得过高，调低一些。还有一点常被忽略：需要大会员权限或购买的内容，你的账号没有对应权限就解析不了。

项目状态与参与方式

项目按 GPL-3.0-or-later 协议发布，任何二次分发必须继续开源并保留原作者与版权信息。界面支持简体中文、繁体中文、英语、日语四种语言，明暗主题可切换。想参与项目的话，路径参考 CONTRIBUTING.md：提交带足信息（含日志）的 Issue，或参与 v2 版本的功能讨论。

最后提醒一句：这个工具适合学习与个人存档，内容版权归原权利人所有，请合理下载，别用于盗版或传播。如果你的需求就是「把 B 站的视频存到本地」，按上面的五步流程先跑一遍即可。

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