企业官网建设流程全解析

BilibiliHistoryFetcher终极指南：三步搞定你的B站观影数据宝库

【免费下载链接】BilibiliHistoryFetcher获取b站历史记录，一键下载用户所有的视频，动态，收藏夹，找回14天内b站在屏幕上显示过的图片，生成详细的年度总结，自动化任务，下面链接是对应前端项目地址: https://gitcode.com/gh_mirrors/bi/BilibiliHistoryFetcher

你是否曾经想过要回顾自己在B站看了哪些视频？或者想要备份那些珍贵的收藏内容？BilibiliHistoryFetcher就是这样一个神奇的工具，它能帮你把散落在B站各个角落的观看记录、收藏内容、动态信息全部收集起来，构建属于你自己的B站数据档案馆！🚀

无论你是想要进行个人观影习惯分析，还是需要批量下载视频内容，甚至是想找回那些一闪而过的缓存图片，这个开源项目都能满足你的需求。它支持多种部署方式，从零基础的Windows用户到技术达人，都能找到适合自己的使用方法。

一、为什么你需要这个工具？三大核心价值解析

1. 数据备份与归档：再也不怕内容消失

B站上的视频可能会因为各种原因下架或删除，但通过BilibiliHistoryFetcher，你可以将喜欢的视频、收藏夹内容、动态信息全部备份到本地。这不仅仅是简单的链接收藏，而是真正的文件级备份！

2. 观影习惯分析：了解真实的自己

你知道自己一年在B站看了多少小时吗？最常看哪些类型的视频？哪个UP主是你的真爱？这个工具能帮你生成详细的年度观影报告，让你对自己的观看习惯有清晰的认知。

3. 内容管理系统：打造个人媒体库

通过批量下载功能，你可以将B站内容转化为本地资源，建立个人媒体库。无论是学习资料、娱乐视频还是收藏的精品内容，都能随时离线访问。

加入QQ交流群[1030089634]获取实时技术支持

二、零基础快速上手：三种部署方式任你选

方案一：Windows小白专用版（最简单）

如果你是Windows用户，对技术操作不太熟悉，这个方法最适合你：

1. 下载可执行文件：从项目发布页面获取打包好的exe文件
2. 双击运行：后端和前端程序分别运行
3. 开始使用：打开浏览器访问界面即可

💡提示：这种方式完全不需要安装Python或任何依赖，就像使用普通软件一样简单！

方案二：Docker一键部署（最推荐）

如果你已经熟悉Docker，这是最优雅的部署方式：

# 克隆项目代码 git clone https://gitcode.com/gh_mirrors/bi/BilibiliHistoryFetcher.git cd BilibiliHistoryFetcher # 一键启动所有服务 docker-compose up -d

启动后访问以下地址：

• 可视化界面：http://localhost:5173
• API接口文档：http://localhost:8899/docs
• 后端管理界面：http://localhost:8899

方案三：源码部署（最灵活）

如果你是开发者或需要深度定制，可以使用源码部署：

# 使用uv包管理器（推荐） uv sync uv run main.py # 或使用传统pip方式 pip install -r requirements.txt python main.py

三、核心功能深度体验：不只是历史记录

🎯 1. 智能历史记录获取

BilibiliHistoryFetcher不仅能获取基本的观看记录，还能：

• 按日期自动归档历史数据
• 智能去重和清理无效记录
• 支持历史数据的增量同步
• 生成可视化的观看热力图

📊 2. 数据分析与可视化

内置强大的分析引擎，提供：

• 年度观影报告：详细统计观看时长、视频数量、UP主分布
• 观看习惯分析：识别你的观影高峰时段和偏好类型
• 视频热度分析：分析哪些视频最受欢迎
• 互动数据分析：统计点赞、投币、收藏行为

📥 3. 批量下载与管理

支持多种下载场景：

• 一键下载用户所有投稿视频：备份UP主的全部作品
• 收藏夹批量下载：将收藏的内容全部保存到本地
• 动态内容归档：保存用户发布的所有动态
• 智能重命名：根据视频信息自动生成有意义的文件名

🖼️ 4. 缓存图片找回神器

这个功能特别实用！B站App会在本地缓存最近14天内显示过的图片，包括：

• 视频封面（即使你没点开视频）
• UP主头像
• 评论区图片
• 动态配图
• 表情包和广告图片

通过简单的操作，就能找回这些珍贵的图片资源。

四、配置指南：三步完成个性化设置

第一步：获取B站认证信息

在浏览器中登录B站，打开开发者工具（F12），找到Cookie中的SESSDATA字段，复制这个值。

第二步：修改配置文件

打开config/config.yaml文件，找到以下关键配置项：

# B站用户的SESSDATA，用于API认证 SESSDATA: "这里粘贴你的SESSDATA" # 邮件通知配置（可选） email: smtp_server: smtp.qq.com smtp_port: 587 sender: "你的QQ邮箱" password: "邮箱授权码" receiver: "接收邮箱"

第三步：自定义输出目录

默认情况下，所有数据都会保存在output目录下。你可以根据需要调整存储位置，确保有足够的磁盘空间。

五、数据迁移与备份：无缝切换使用环境

核心原则：迁移时只需要拷贝整个output目录！

常见迁移场景：

1. 本地开发转生产部署：将本地的output目录复制到服务器
2. Windows转Linux：跨平台数据迁移
3. Docker容器迁移：更换宿主机或升级容器
4. 版本升级：保留历史数据升级到新版本

迁移步骤：

# 1. 停止当前服务 # 2. 备份output目录 cp -r output /backup/output_$(date +%Y%m%d) # 3. 在新环境恢复 # 本地运行：将output放到项目根目录 # Docker运行：挂载到容器/app/output目录 # 打包版：放在可执行文件同级目录

⚠️注意：配置文件config/config.yaml需要在新环境中重新配置，因为它包含认证信息。

六、output目录结构详解：你的数据档案馆

了解output目录的结构，能帮助你更好地管理数据：

output/ ├── bilibili_history.db # 主历史记录数据库 ├── video_details.db # 视频详情数据库 ├── image_downloads.db # 图片下载记录 ├── database/ # 业务分库集合 │ ├── bilibili_comments.db # 评论数据库 │ ├── bilibili_dynamic.db # 动态数据库 │ └── bilibili_favorites.db # 收藏夹数据库 ├── history_by_date/ # 按日期归档的历史快照 │ └── 2024/12/31.json ├── analytics/ # 统计分析结果 ├── download_video/ # 已下载的视频内容 ├── images/ # 用户头像和封面缓存 └── logs/ # 运行日志记录

七、避坑指南：常见问题快速解决

❓ 问题1：SESSDATA获取失败

解决方法：

1. 确保在B站网页版登录状态
2. 清除浏览器缓存后重新登录
3. 使用无痕模式获取Cookie

❓ 问题2：视频下载速度慢

解决方法：

1. 检查网络连接稳定性
2. 调整并发下载数量（在配置文件中修改）
3. 使用代理服务器（如果需要）

❓ 问题3：Docker容器启动失败

解决方法：

1. 检查Docker服务是否正常运行
2. 确认端口8899和5173未被占用
3. 查看容器日志：docker logs bilibili-api

❓ 问题4：图片找回功能无效

解决方法：

1. 确保手机缓存文件路径正确
2. 缓存文件必须在14天内生成
3. 使用MT管理器正确导出压缩包

八、高级技巧：发挥工具最大价值

技巧1：自动化任务调度

利用内置的调度器，可以设置定期任务：

• 每天自动同步最新观看记录
• 每周生成观影报告
• 每月备份重要内容

技巧2：数据导出与分析

支持多种数据导出格式：

• JSON格式：用于程序处理
• Excel表格：用于数据分析
• HTML报告：用于可视化展示

技巧3：多用户管理

通过配置文件可以管理多个B站账号的数据，适合UP主或内容管理者使用。

技巧4：API二次开发

项目提供了完整的RESTful API接口，支持自定义开发：

• 集成到自己的应用中
• 开发新的数据分析功能
• 构建个性化仪表板

九、生态扩展：与其他工具完美配合

BilibiliHistoryFetcher不是孤立的工具，它可以与以下项目完美配合：

• BiliHistoryFrontend：配套的前端可视化界面，提供更友好的操作体验
• Yutto：功能强大的B站视频下载工具，支持更多格式和选项
• FasterWhisper：高效的音频转文字工具，可用于视频内容分析

十、开始你的B站数据之旅吧！

现在你已经全面了解了BilibiliHistoryFetcher的强大功能。无论你是想要备份珍贵的视频内容，还是分析自己的观影习惯，或是建立个人媒体库，这个工具都能帮助你实现。

立即行动：

1. 选择最适合你的部署方式
2. 配置好B站认证信息
3. 开始收集和探索你的B站数据
4. 加入社区交流使用心得

记住，数据是最宝贵的资产。通过BilibiliHistoryFetcher，你不仅是在备份内容，更是在记录自己的数字足迹。开始你的数据探索之旅，发现更多关于自己的故事！

✨小提示：定期备份output目录，你的数据会更加安全。建议每月进行一次完整备份，确保珍贵内容不会丢失。

【免费下载链接】BilibiliHistoryFetcher获取b站历史记录，一键下载用户所有的视频，动态，收藏夹，找回14天内b站在屏幕上显示过的图片，生成详细的年度总结，自动化任务，下面链接是对应前端项目地址: https://gitcode.com/gh_mirrors/bi/BilibiliHistoryFetcher