bili-sync 是什么？

🎉 bili-sync 是一个用 Rust 语言编写的高性能哔哩哔哩视频同步下载工具！
当前最新程序版本为 v2.7.2 Final，这是项目历史上最重要的版本更新，实现了从"半自动化工具"到"智能化系统"的质的飞跃。

IMPORTANT

项目来源说明

本项目 (qq1582185982/bili-sync-01) 是从原作者 amtoaer/bili-sync 的项目 fork 并进行大量更新和优化的版本。我们对原作者的贡献表示感谢，并在此基础上持续迭代。

NOTE

重大架构升级！ 从 v2.6.x 开始，视频源配置已完全迁移到数据库管理，并提供现代化的 Web 管理界面。如果您从旧版本升级，请参阅配置迁移指南。

bili-sync 是一款专为 NAS 用户编写的哔哩哔哩同步工具，由 Rust & Tokio 驱动。

它的基本的工作原理是使用用户填写的凭据定期扫描视频合集、收藏夹等，获取到本地未下载过的内容并保存到本地，维持本地视频库与哔哩哔哩网站的同步。

下载的内容包括视频、封面、弹幕、标签与简介信息等，这些文件整体保持与 Emby、Jellyfin 等媒体服务器软件兼容的文件布局，使得目的文件夹可以直接被作为媒体库添加到这些软件中，无需干预自动识别。

🌟 v2.7.2 Final 核心亮点 - 智能化系统的重大突破

🤖 智能风控处理系统 ⭐⭐⭐ - 革命性技术突破

零干预体验：检测到风控自动重置，用户完全无感知恢复
全方位检测：覆盖所有API调用点的风控监控
智能状态管理：只重置未完成任务，完美保护已完成内容
优雅错误恢复：风控不再是下载中断，而是自动化处理流程

用户体验革命：

之前：风控导致下载失败 → 用户手动重置 → 重新开始下载
现在：风控自动检测 → 智能重置 → 自动恢复 → 用户无感知

🔄 双重重置系统 - 自动化与精确控制的完美结合

自动重置系统：风控触发时的智能化处理，100%保护已完成任务
手动重置系统：5种任务类型的精确控制，强制重置vs传统重置
状态保护算法：智能保护已完成任务，避免重复下载

🖼️ 完美视觉体验 - 现代化界面的质的飞跃

图片代理技术：彻底解决B站防盗链问题，完美封面显示
动态分页系统：智能计算最佳显示数量，完美适配各种设备
现代化设计：卡片背景模糊效果，提升视觉体验

🎛️ 智能视频源管理 - 精确控制管理

一键切换：侧边栏开关按钮，实时启用/禁用视频源
智能扫描：只处理启用状态的视频源，节省资源
持久化状态：配置保存到数据库，重启后保持

📊 性能与稳定性全面提升

数据库性能优化：索引优化，查询速度提升50-80%
系统稳定性增强：构建修复，动态配置重载
智能任务队列：避免冲突的删除机制，确保数据一致性

🎯 核心优势

🤖 智能化：革命性风控处理，零干预用户体验
🔄 自动化：双重重置系统，智能保护已完成内容
🖼️ 现代化：完美视觉体验，图片代理+动态分页
⚡ 高性能：Rust + Tokio 异步并发，下载速度极快
🛡️ 安全可靠：并发冲突检测，数据安全保障
🎛️ 精确控制：视频源启用/禁用，精细化管理

🖼️ 新版 Web 界面展示

管理首页

首页界面

现代化的管理首页，清晰展示系统状态和快速操作入口。

视频源管理

收藏夹管理

收藏夹添加

自动获取并显示用户所有收藏夹，支持一键选择，无需手动输入ID。

UP主投稿

输入UP主ID即可管理其投稿视频下载。

合集管理

支持UP主合集和系列的完整管理。

番剧下载

完整支持番剧下载，包括单季和全季模式。

稍后再看

方便的稍后再看列表管理。

视频源删除

删除视频源

便捷的视频源删除管理。

任务队列管理

任务队列

智能任务队列系统，实时显示扫描状态和队列信息，确保操作安全协调。

系统功能

系统设置

可视化的系统配置界面，支持实时修改配置参数。

视频详情

详细的视频信息展示和管理功能。

日志查看

日志界面

实时日志查看，方便问题排查和系统监控。

强制重置

安全的系统重置功能。

视频源删除

删除视频源

便捷的视频源删除管理。

使用截图

WARNING

媒体库类型请选择"混合内容"，否则可能导致多页视频无法正常显示。

概览

详情

播放（使用 infuse）

文件排布

功能与路线图

🎯 核心功能

🚀 新增特性 (v2.7.0)

🛡️ 删除任务队列系统 - 智能检测扫描状态，删除操作自动排队，避免并发冲突
⚙️ 配置文件完全兼容 - 修复向后兼容性问题，任何旧版本配置都能无缝升级
📚 技术文档体系完善 - 提供详细的系统架构说明和API使用指南
🔧 VitePress文档站点 - 修复构建问题，支持在线技术文档访问
⭐ 并发安全保障 - 扫描和删除操作的智能协调，数据完整性保护
🚀 用户体验优化 - 删除操作无感知，系统自动处理最佳时机
Web 管理界面增强 - 通过友好的 Web 界面直接管理视频源，无需手动编辑配置文件
收藏夹管理优化 - 自动获取并显示用户所有收藏夹，支持快速选择，解决ID精度问题
UP主合集支持 - 输入UP主ID即可查看其所有合集和系列，支持一键选择添加

🔄 持续改进

📋 开发路线图

下载单个文件时支持断点续传与并发下载
更多媒体服务器兼容性优化
高级过滤和搜索功能
批量操作和管理功能

💡 技术优势

高性能: Rust + Tokio 异步架构，支持高并发下载
易部署: 提供多平台二进制文件和 Docker 镜像
易使用: 友好的 Web 管理界面，无需命令行操作
易维护: 清晰的项目结构和完整的开发文档
高稳定: 智能错误处理和自动重试机制

bili-sync 是什么？ ​

🌟 v2.7.2 Final 核心亮点 - 智能化系统的重大突破 ​

🤖 智能风控处理系统 ⭐⭐⭐ - 革命性技术突破 ​

🔄 双重重置系统 - 自动化与精确控制的完美结合 ​

🖼️ 完美视觉体验 - 现代化界面的质的飞跃 ​

🎛️ 智能视频源管理 - 精确控制管理 ​

📊 性能与稳定性全面提升 ​

🎯 核心优势 ​

🖼️ 新版 Web 界面展示 ​

管理首页 ​

视频源管理 ​

收藏夹管理 ​

UP主投稿 ​

合集管理 ​

番剧下载 ​

稍后再看 ​

视频源删除 ​

任务队列管理 ​

系统功能 ​

系统设置 ​

视频详情 ​

日志查看 ​

强制重置 ​

视频源删除 ​

使用截图 ​

概览 ​

详情 ​

播放（使用 infuse） ​

文件排布 ​

功能与路线图 ​

🎯 核心功能 ​

🚀 新增特性 (v2.7.0) ​

🔄 持续改进 ​

📋 开发路线图 ​

💡 技术优势 ​

bili-sync 是什么？

🌟 v2.7.2 Final 核心亮点 - 智能化系统的重大突破

🤖 智能风控处理系统 ⭐⭐⭐ - 革命性技术突破

🔄 双重重置系统 - 自动化与精确控制的完美结合

🖼️ 完美视觉体验 - 现代化界面的质的飞跃

🎛️ 智能视频源管理 - 精确控制管理

📊 性能与稳定性全面提升

🎯 核心优势

🖼️ 新版 Web 界面展示

管理首页

视频源管理

收藏夹管理

UP主投稿

合集管理

番剧下载

稍后再看

视频源删除

任务队列管理

系统功能

系统设置

视频详情

日志查看

强制重置

视频源删除

使用截图

概览

详情

播放（使用 infuse）

文件排布

功能与路线图

🎯 核心功能

🚀 新增特性 (v2.7.0)

🔄 持续改进

📋 开发路线图

💡 技术优势