grill-me 完整指南：5 步把模糊想法勘探成可辩护的图纸
2026/10/17 6:46:35
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 与 ARM |
| macOS | 下载 dmg 挂载后拖入"应用程序" | Intel 选 x64、Apple 芯片选 aarch64；勿用 tar.gz 直接运行 |
| Linux | sudo apt-get install -y ./bilitools_x.y.z_arch.deb | Debian/Ubuntu 用 deb，Fedora/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 可直接识别。整季内容建议少量多次分批下载，避免一次性勾选过多触发风控。
离线弹幕挂到播放器上
弹幕存成 XML，PotPlayer 却不认？在设置 → 策略开启"将 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），仅供参考