# Technical Documentation: ScottSloan/Bili23-Downloader
> ℹ️ **Provenance:** Hybrid Fusion: `ScottSloan/Bili23-Downloader` (README + 1 In-Tree Chapters) · [CodeWiki Reference](https://codewiki.google/github.com/ScottSloan/Bili23-Downloader) · Recency: Active (< 180 days)
## 1. Project Overview & Quickstart (ScottSloan/Bili23-Downloader)
Bili23-Downloader
## ⚡ 程序特性
| 特性 | 详细说明 |
| :--- | :--- |
| 🖥️ **跨平台支持** | 完美兼容 **Windows**（含 Win 7）、**Linux** 和 **macOS** 三大桌面操作系统。 |
| 🎨 **现代 UI 设计** | 基于 Fluent Design 设计语言，支持浅色 / 深色主题无缝切换，原生适配高分屏，并会记住窗口位置与大小，下次启动自动恢复。 |
| 🚀 **多线程与加速**| 原生集成多线程并行下载、断点续传及网络异常自动重试机制，提供极致的下载速率，同时支持全局下载限速。 |
| 🔗 **多类型解析** | 全面支持：`投稿视频`、`番剧`、`电影`、`课程`、`互动视频`、`音乐（au/am）`、`UP主空间`、`收藏夹`、`每周必看`、`订阅合集`、`追番追剧`、`稍后再看`、`历史记录`等。 |
| 🔍 **批量与检索** | 支持一次粘贴多条投稿视频链接**批量解析**；个人空间、收藏夹、历史记录与稍后再看支持**关键词搜索**（可选择只筛选当前页或搜索全部内容）；解析完成后还可按预设条件**自动勾选**下载项。 |
| ⚙️ **音视频自定义**| **画质**：`8K`、`4K`、`HDR`、`杜比视界`等 **音质**：`Hi-Res 无损`、`杜比全景声`等 **编码**：`AVC`、`HEVC`、`AV1`下载前可实时预览本次将要下载的媒体内容。 |
| 💬 **弹幕与字幕** | **弹幕**：`xml`、`ass`、`json`**字幕**：`srt`、`lrc`、`txt`、`ass`、`json`支持自定义弹幕与字幕样式、指定字幕语言，并可将 `ass` 格式的弹幕和字幕嵌入 `mkv` 容器中。 |
| 🖼️ **封面与章节**| 无损保存原图质量（`jpg`、`png`、`avif`、`webp`），原生支持将封面嵌入最终的视频文件（可选嵌入后删除原图），并支持写入视频的**章节信息**。 |
| 🧩 **NFO 元数据** | 自动刮削并生成符合 **Kodi**、**Jellyfin**、**Emby** 等媒体中心标准格式的本地媒体元数据。 |
| 📁 **分类与命名** | 内置强大规则引擎，可为投稿视频、番剧、课程、互动视频、收藏夹、个人空间、历史记录、稍后再看、每周必看、音乐等类型分别设置命名模板与多级目录分类存储模式。 |
| 📦 **封装格式转化**| 智能音视频流混合提取，支持封装输出为 `mp4` 或 `mkv`，充分满足不同播放设备的兼容需求。 |
| 🚫 **重复下载检测**| 自动记录下载历史，再次下载相同内容时给出提示并可直接跳过，避免重复占用带宽与磁盘空间。 |
| 🌐 **网络与代理** | 支持**不使用代理**、**使用系统代理**、**手动设置**三种代理模式，可根据地理位置选择 CDN 节点以改善下载速度，并支持自定义 User-Agent 与 Host。 |
| 📋 **剪贴板监控** | 自动识别复制到剪贴板中的 B 站链接，确认后即可直接进入解析下载流程。 |
| 🌍 **国际化支持** | 内置多语言界面，开箱可用：简体中文、繁体中文、English。 |
| 🔒 **账号安全登录**| 支持快捷安全的**扫码登录**、**短信验证登录**与 **Cookie 登录**。 |
| 📖 **完全开源免费**| 基于 **GPL-3.0** 协议发布，代码完全开源、无内购、无广告，拥抱社区共建。 |
## 📥 下载地址
当前提供两种下载方式，可按使用场景选择：
- [**GitHub Releases**](https://github.com/ScottSloan/Bili23-Downloader/releases/latest) - 适合访问 GitHub 较稳定的用户，获取最新发布版本。
- [**官网下载（国内用户推荐）**](https://bili23.scott-sloan.cn/doc/releases.html) - 适合国内用户，通常访问更快、更稳定。
## 🪧 使用协议
本项目仅供个人学习与研究用途，下载内容**仅限于个人非商业使用，严禁用于任何形式的商业目的、公开传播或分发**。
本软件仅基于用户账号的合法访问权限操作，**不会绕过任何付费墙或平台知识产权保护措施**。请勿将本软件用于批量抓取或任何违反目标平台服务条款的行为。
**免责声明**：用户需完全自行承担使用本项目可能带来的所有风险（包括但不限于账号封禁、版权纠纷等）。项目开发者不对任何人因使用或无法使用本软件所引发的任何直接或间接法律纠纷、损害承担责任。
继续使用即表示您已充分理解并同意遵守上述全部条款。
## 🔑 开源许可
本项目在 **GPLv3 License** 许可协议下进行发布。
wbi 签名、部分接口以及 buvid3 等参数生成参考 [SocialSisterYi/bilibili-API-collect](https://github.com/SocialSisterYi/bilibili-API-collect)
## 🛠️ 参与贡献
欢迎提出新的点子~
Made with [contrib.rocks](https://contrib.rocks).
## 🌟 社区交流
加入社区，获取项目最新动态、问题答疑和技术交流。
- [QQ 交流群](https://qm.qq.com/q/KX3uJIFIYK)
- [QQ 频道](https://pd.qq.com/s/8941to1p0)
> 如需提问，请提供**问题描述**、**完整日志**，以便我们更好地提供帮助。
## 💪 支持作者
本项目由开发者 [Scott Sloan](https://github.com/ScottSloan) 利用业余时间独立开发与维护，初衷是为大家提供纯粹、无广告且高效的 B 站本地下载工具。
> **⭐️ 点亮星标**
> 如果这款工具为你节省了宝贵的时间，欢迎在项目右上角为其点亮一颗 **Star**！
> 你的支持能让更多有需要的人看到这个项目，这也会成为作者持续更新的最大动力。
### ☕️ 请作者喝杯咖啡
除了日常的代码维护外，处理复杂的跨平台环境以及重构发布都耗费了大量的时间与精力。如果软件确实帮你解决了不少麻烦，欢迎通过下方的赞助码请作者喝杯咖啡。**这是对“为爱发电”最实在的认可！**
## 2. In-Tree Documentation Chapters (ScottSloan/Bili23-Downloader)
Bili23-Downloader
## ⚡ 程序特性
| 特性 | 详细说明 |
| :--- | :--- |
| 🖥️ **跨平台支持** | 完美兼容 **Windows**（含 Win 7）、**Linux** 和 **macOS** 三大桌面操作系统。 |
| 🎨 **现代 UI 设计** | 基于 Fluent Design 设计语言，支持浅色 / 深色主题无缝切换，原生适配高分屏，并会记住窗口位置与大小，下次启动自动恢复。 |
| 🚀 **多线程与加速**| 原生集成多线程并行下载、断点续传及网络异常自动重试机制，提供极致的下载速率，同时支持全局下载限速。 |
| 🔗 **多类型解析** | 全面支持：`投稿视频`、`番剧`、`电影`、`课程`、`互动视频`、`音乐（au/am）`、`UP主空间`、`收藏夹`、`每周必看`、`订阅合集`、`追番追剧`、`稍后再看`、`历史记录`等。 |
| 🔍 **批量与检索** | 支持一次粘贴多条投稿视频链接**批量解析**；个人空间、收藏夹、历史记录与稍后再看支持**关键词搜索**（可选择只筛选当前页或搜索全部内容）；解析完成后还可按预设条件**自动勾选**下载项。 |
| ⚙️ **音视频自定义**| **画质**：`8K`、`4K`、`HDR`、`杜比视界`等 **音质**：`Hi-Res 无损`、`杜比全景声`等 **编码**：`AVC`、`HEVC`、`AV1`下载前可实时预览本次将要下载的媒体内容。 |
| 💬 **弹幕与字幕** | **弹幕**：`xml`、`ass`、`json`**字幕**：`srt`、`lrc`、`txt`、`ass`、`json`支持自定义弹幕与字幕样式、指定字幕语言，并可将 `ass` 格式的弹幕和字幕嵌入 `mkv` 容器中。 |
| 🖼️ **封面与章节**| 无损保存原图质量（`jpg`、`png`、`avif`、`webp`），原生支持将封面嵌入最终的视频文件（可选嵌入后删除原图），并支持写入视频的**章节信息**。 |
| 🧩 **NFO 元数据** | 自动刮削并生成符合 **Kodi**、**Jellyfin**、**Emby** 等媒体中心标准格式的本地媒体元数据。 |
| 📁 **分类与命名** | 内置强大规则引擎，可为投稿视频、番剧、课程、互动视频、收藏夹、个人空间、历史记录、稍后再看、每周必看、音乐等类型分别设置命名模板与多级目录分类存储模式。 |
| 📦 **封装格式转化**| 智能音视频流混合提取，支持封装输出为 `mp4` 或 `mkv`，充分满足不同播放设备的兼容需求。 |
| 🚫 **重复下载检测**| 自动记录下载历史，再次下载相同内容时给出提示并可直接跳过，避免重复占用带宽与磁盘空间。 |
| 🌐 **网络与代理** | 支持**不使用代理**、**使用系统代理**、**手动设置**三种代理模式，可根据地理位置选择 CDN 节点以改善下载速度，并支持自定义 User-Agent 与 Host。 |
| 📋 **剪贴板监控** | 自动识别复制到剪贴板中的 B 站链接，确认后即可直接进入解析下载流程。 |
| 🌍 **国际化支持** | 内置多语言界面，开箱可用：简体中文、繁体中文、English。 |
| 🔒 **账号安全登录**| 支持快捷安全的**扫码登录**、**短信验证登录**与 **Cookie 登录**。 |
| 📖 **完全开源免费**| 基于 **GPL-3.0** 协议发布，代码完全开源、无内购、无广告，拥抱社区共建。 |
## 📥 下载地址
当前提供两种下载方式，可按使用场景选择：
- [**GitHub Releases**](https://github.com/ScottSloan/Bili23-Downloader/releases/latest) - 适合访问 GitHub 较稳定的用户，获取最新发布版本。
- [**官网下载（国内用户推荐）**](https://bili23.scott-sloan.cn/doc/releases.html) - 适合国内用户，通常访问更快、更稳定。
## 🪧 使用协议
本项目仅供个人学习与研究用途，下载内容**仅限于个人非商业使用，严禁用于任何形式的商业目的、公开传播或分发**。
本软件仅基于用户账号的合法访问权限操作，**不会绕过任何付费墙或平台知识产权保护措施**。请勿将本软件用于批量抓取或任何违反目标平台服务条款的行为。
**免责声明**：用户需完全自行承担使用本项目可能带来的所有风险（包括但不限于账号封禁、版权纠纷等）。项目开发者不对任何人因使用或无法使用本软件所引发的任何直接或间接法律纠纷、损害承担责任。
继续使用即表示您已充分理解并同意遵守上述全部条款。
## 🔑 开源许可
本项目在 **GPLv3 License** 许可协议下进行发布。
wbi 签名、部分接口以及 buvid3 等参数生成参考 [SocialSisterYi/bilibili-API-collect](https://github.com/SocialSisterYi/bilibili-API-collect)
## 🛠️ 参与贡献
欢迎提出新的点子~
Made with [contrib.rocks](https://contrib.rocks).
## 🌟 社区交流
加入社区，获取项目最新动态、问题答疑和技术交流。
- [QQ 交流群](https://qm.qq.com/q/KX3uJIFIYK)
- [QQ 频道](https://pd.qq.com/s/8941to1p0)
> 如需提问，请提供**问题描述**、**完整日志**，以便我们更好地提供帮助。
## 💪 支持作者
本项目由开发者 [Scott Sloan](https://github.com/ScottSloan) 利用业余时间独立开发与维护，初衷是为大家提供纯粹、无广告且高效的 B 站本地下载工具。
> **⭐️ 点亮星标**
> 如果这款工具为你节省了宝贵的时间，欢迎在项目右上角为其点亮一颗 **Star**！
> 你的支持能让更多有需要的人看到这个项目，这也会成为作者持续更新的最大动力。
### ☕️ 请作者喝杯咖啡
除了日常的代码维护外，处理复杂的跨平台环境以及重构发布都耗费了大量的时间与精力。如果软件确实帮你解决了不少麻烦，欢迎通过下方的赞助码请作者喝杯咖啡。**这是对“为爱发电”最实在的认可！**
--- METRICS ---
- Files Extracted: 2
- Estimated Token Budget: ~1539 tokens
- Recency Window: Active (< 180 days)
- Canonical Reference: https://codewiki.google/github.com/ScottSloan/Bili23-Downloader