高效掌握B站观看历史:BilibiliHistoryFetcher全面数据管理指南
高效掌握B站观看历史:BilibiliHistoryFetcher全面数据管理指南
BilibiliHistoryFetcher是一款功能强大的开源工具,专为B站用户设计,能够全面获取、管理和分析个人观看历史数据。无论您是普通用户希望备份自己的观看记录,还是技术爱好者想要深入分析观看行为,这个工具都能提供一站式解决方案。
为什么需要B站历史数据管理工具?
在数字时代,我们的观看习惯蕴含着丰富的信息价值。BilibiliHistoryFetcher正是为了帮助用户:
- 数据备份与安全:防止历史记录丢失,永久保存珍贵的观看记忆
- 行为分析与洞察:了解自己的观看偏好,发现潜在的兴趣变化
- 内容归档与整理:系统化保存喜欢的视频和内容
- 自动化管理:减少手动操作,让数据同步变得轻松简单
核心功能亮点:全方位数据掌控能力
🎯 智能历史记录获取与存储
BilibiliHistoryFetcher能够高效获取用户的B站历史记录,并安全存储到本地数据库中。系统支持多种数据库格式,包括SQLite和MySQL,确保数据的安全性和可移植性。
操作建议:首次使用时,只需在config/config.yaml中配置您的SESSDATA,系统就会自动开始数据采集。
📊 深度数据分析与可视化
工具内置强大的数据分析引擎,能够生成详细的年度总结报告,包括:
- 观看时间分布热力图
- 最常观看的UP主统计
- 视频类型偏好分析
- 观看趋势变化图表
BilibiliHistoryFetcher提供直观的数据可视化界面
📥 批量视频下载与归档
支持一键下载用户的所有投稿视频、收藏夹内容,以及用户动态。下载功能支持断点续传和并行下载,大幅提升下载效率。
技术提示:下载功能基于Yutto实现,支持多种视频格式和质量选择,确保下载的视频质量与原始内容一致。
🔄 自动化任务与邮件通知
系统支持定时任务调度,可以自动同步最新数据,并通过邮件发送运行日志和统计报告。这意味着您可以设置一次,系统就会持续为您服务。
三种快速部署方式:选择最适合您的方案
方案一:Docker容器化部署(推荐)
对于有一定技术基础的用户,Docker部署是最简单高效的方式:
# 拉取最新镜像
docker pull ghcr.io/2977094657/bili-history-fetcher:latest
# 运行容器
docker run -d -v ./config:/app/config -v ./output:/app/output -p 8899:8899 --name bilibili-api ghcr.io/2977094657/bili-history-fetcher:latest
优势:环境隔离、一键部署、易于维护和升级。
方案二:传统Python环境部署
如果您习惯传统的Python开发环境:
# 克隆项目
git clone https://gitcode.com/gh_mirrors/bi/BilibiliHistoryFetcher
# 安装依赖
cd BilibiliHistoryFetcher
pip install -r requirements.txt
# 启动服务
python main.py
注意:确保您的Python版本为3.10或更高,并已安装SQLite3和FFmpeg。
方案三:Windows免安装版
对于Windows用户,项目提供了打包好的可执行文件,无需安装任何依赖:
- 从发布页面下载
BilibiliHistoryAnalyzer.exe - 双击运行即可
- 按提示配置必要的参数
数据迁移与备份策略
核心原则:迁移时只需拷贝整个output目录即可。
迁移步骤:
- 停止正在运行的服务
- 备份
output文件夹中的所有内容 - 在新环境中恢复数据:
- 本地运行:将
output放到项目根目录 - Docker运行:通过
-v参数挂载目录 - 打包版运行:放在可执行文件同级目录
- 本地运行:将
重要提示:认证信息存储在config/目录中,不属于数据迁移范畴。迁移后需要在新的config/config.yaml中重新配置SESSDATA等敏感信息。
高级功能:找回近14天的缓存图片
这是一个独特的功能,能够找回B站App在过去14天内屏幕上显示过的所有图片,包括:
- 视频封面
- UP主头像
- 推荐页视频封面
- 评论区图片
- 动态图片
- 表情包
操作流程:
- 使用MT管理器导出手机缓存
- 运行
BiliImagePipeline.exe处理缓存文件 - 在
by_date目录中按日期查看恢复的图片
项目架构与数据管理
BilibiliHistoryFetcher采用模块化设计,主要组件包括:
核心模块
routers/:包含所有API路由处理scripts/:各类数据处理和工具脚本config/:配置文件目录
数据存储结构
项目采用分层数据存储策略,确保数据的安全性和可维护性:
- 主历史记录数据库:
bilibili_history.db - 视频详情数据库:
video_details.db - 图片下载记录数据库:
image_downloads.db - 按日期归档的历史快照:
history_by_date/YYYY/MM/DD.json
实用技巧与最佳实践
配置优化建议
- 定时任务设置:建议将数据同步任务设置为每天凌晨执行,避免影响正常使用
- 存储空间管理:定期清理
temp/和tmp_video/目录中的临时文件 - 日志监控:关注
logs/目录下的运行日志,及时发现并解决问题
性能调优
- 对于大量历史数据,建议分批处理
- 下载视频时合理设置并发数,避免对网络造成过大压力
- 定期对数据库进行优化和压缩
社区支持与交流
如果您在使用过程中遇到问题,或者有功能建议,欢迎加入我们的交流社区:
扫描二维码加入BiliFetcher交流群,群号:1030089634
持续发展与未来规划
BilibiliHistoryFetcher是一个活跃的开源项目,持续接收社区贡献。项目团队正在开发更多实用功能,包括:
- 更智能的数据分析算法
- 移动端应用支持
- 云端同步功能
- 更多数据可视化选项
开始您的B站数据管理之旅
无论您是想要备份珍贵的观看记忆,还是希望深入分析自己的观看行为,BilibiliHistoryFetcher都能为您提供完整的解决方案。通过简单的部署步骤,您就可以开始享受自动化数据管理的便利。
行动建议:立即尝试部署,体验数据管理的便捷。建议从Docker部署开始,这是最快速且稳定的方式。记得定期备份您的output目录,确保数据安全。
通过BilibiliHistoryFetcher,您不仅能更好地管理自己的B站观看数据,还能从中发现有趣的观看模式,让每一次点击都变得更有价值。
更多推荐


所有评论(0)