BilibiliHistoryFetcher 项目安装与配置指南

1. 项目基础介绍

BilibiliHistoryFetcher 是一个开源项目，用于获取、处理、分析和可视化哔哩哔哩用户的观看历史数据。该项目提供了从数据获取到可视化展示的完整数据处理流程，并支持自动化运行和邮件通知功能。项目主要使用 Python 编程语言开发。

2. 项目使用的关键技术和框架

• Python：项目的主要编程语言。
• SQLite：用于本地存储和管理数据。
• FFmpeg：用于视频下载和转码。
• Yutto：用于哔哩哔哩视频下载。
• FasterWhisper：用于视频音频转文字。
• DeepSeek AI API：用于生成视频摘要。

3. 项目安装和配置的准备工作

在开始安装之前，请确保您的系统中已安装以下软件：

• Python 3.10 或更高版本
• SQLite 3
• FFmpeg
• Git（用于克隆项目）

详细的安装步骤

步骤 1：克隆项目

打开终端或命令行，运行以下命令克隆项目到本地：

git clone https://github.com/2977094657/BilibiliHistoryFetcher.git
cd BilibiliHistoryFetcher

步骤 2：安装依赖

在项目根目录下，运行以下命令安装所需的 Python 包：

pip install -r requirements.txt

步骤 3：配置文件

在 config/config.yaml 文件中，配置以下信息：

• B 站用户认证：填写您的 SESSDATA。
• 邮件通知配置：填写 smtp_server、smtp_port、sender、password 和 receiver。
• DeepSeek AI API 配置：填写 api_key 和 api_base。
• 服务器配置：填写 host 和 port。

步骤 4：运行程序

配置完成后，运行以下命令启动程序：

python main.py

或者，如果您已经配置了 Docker 环境，可以使用 Docker 启动项目：

docker build -t bilibili-history-fetcher -f docker/Dockerfile .
docker run -d -v ./config:/app/config -v ./output:/app/output -p 8899:8899 --name bilibili-history-fetcher bilibili-history-fetcher

步骤 5：自动化任务（可选）

如果需要配置自动化任务，请在 config/scheduler_config.yaml 文件中设置定时任务。

完成以上步骤后，您应该能够成功运行 BilibiliHistoryFetcher 项目，并开始获取和处理哔哩哔哩的观看历史数据。