一、项目简介
1. 什么是BiliNote？
BiliNote是一款开源的AI视频笔记助手，旨在帮助用户通过哔哩哔哩、YouTube等平台的视频链接，自动提取内容并生成结构清晰、重点明确的Markdown格式笔记。它不仅支持插入截图和原片跳转，还具备任务记录与历史回看功能，使用户能够高效地整理和回顾视频内容。
2. 为什么需要BiliNote？
在信息爆炸的时代，如何快速有效地从海量视频中获取核心信息成为一大挑战。传统的笔记方式耗时耗力，而BiliNote的出现则解决了这一痛点。它利用AI技术自动化处理视频内容，极大地提高了笔记生成的效率和质量。
3. 如何使用BiliNote？
访问体验地址：https://www.bilinote.app[^1.1^]。由于项目部署在Cloudflare Pages，访问速度可能较慢，请耐心等待。
二、功能特性
1. 多平台支持
BiliNote目前支持Bilibili和YouTube，未来还将加入更多平台。这意味着无论你使用哪个平台观看视频，都可以通过BiliNote进行笔记生成。
2. 本地模型音频转写
BiliNote支持使用Fast-Whisper进行音频转写，确保视频中的语音内容能够准确转换为文字[^1.2^]。
3. GPT大模型总结视频内容
借助OpenAI、DeepSeek、Qwen等大模型，BiliNote可以对视频内容进行智能总结，生成高质量的笔记[^1.3^]。
4. 自动生成结构化Markdown笔记
BiliNote能够将视频内容转化为结构化的Markdown格式笔记，便于后续查阅和编辑[^1.4^]。
5. 可选插入截图
用户可以选择性地插入视频截图，使笔记更加生动直观[^1.5^]。
6. 可选内容跳转链接
BiliNote支持生成内容跳转链接，方便用户直接跳转到原视频的对应位置[^1.6^]。
7. 任务记录与历史回看
BiliNote会自动记录用户的笔记任务，并提供历史回看功能，方便用户随时查阅之前的笔记[^1.7^]。
三、快速开始
1. 克隆仓库
git clone https://github.com/JefferyHcool/BiliNote.git
cd BiliNote
mv .env.example .env
2. 启动后端（FastAPI）
进入后端目录并安装依赖：
cd backend
pip install -r requirements.txt
uvicorn app.main:app --reload
3. 启动前端（Vite + React）
cd BiliNote_frontend
pnpm install
pnpm dev
访问：http://localhost:5173[^1.8^]。
四、依赖说明
1. FFmpeg
BiliNote依赖FFmpeg进行音频处理与转码，请根据操作系统进行安装[^2.9^]。
-
Mac (brew): brew install ffmpeg[^2.10^] -
Ubuntu / Debian: sudo apt install ffmpeg[^2.11^] -
Windows: 请从官网下载安装：https://ffmpeg.org/download.html[^2.12^]
2. CUDA加速（可选）
若你希望更快地执行音频转写任务，可使用具备NVIDIA GPU的机器，并启用fast-whisper + CUDA加速版本[^2.13^]。具体配置方法请参考：fast-whisper项目地址[^2.14^]。
3. Docker一键部署
确保已安装Docker和Docker Compose：
1. 克隆本项目
git clone https://github.com/JefferyHcool/BiliNote.git
cd BiliNote
mv .env.example .env
2. 启动 Docker Compose
docker compose up --build
默认端口：
-
前端：http://localhost:${FRONTEND_PORT}[^2.15^] -
后端：http://localhost:${BACKEND_PORT}[^2.16^]
可以在.env文件中自定义端口与环境配置[^2.17^]。
五、环境变量配置
以下是后端.env文件的示例配置：
API_BASE_URL=http://localhost:8000
OUT_DIR=note_results
IMAGE_BASE_URL=/static/screenshots
MODEl_PROVIDER=openai
OPENAI_API_KEY=sk-xxxxxx
DEEP_SEEK_API_KEY=xxx
QWEN_API_KEY=xxx
六、未来规划
1. 支持更多视频平台
BiliNote计划支持抖音及快手等更多视频平台，以覆盖更广泛的用户需求[^2.18^]。
2. 前端设置切换AI模型
用户可以在前端设置中切换不同的AI模型和语音转文字模型，满足多样化的需求[^2.19^]。
3. AI摘要风格自定义
提供多种AI摘要风格选择，如学术风、口语风、重点提取等，以满足不同场景下的笔记需求[^2.20^]。
4. 笔记导出为PDF/Word/Notion
增加笔记导出功能，支持导出为PDF、Word和Notion格式，方便用户在不同平台上使用[^2.21^]。
5. 加入更多模型支持
引入更多先进的AI模型，提升笔记生成的效果和效率[^2.22^]。
6. 加入更多音频转文本模型支持
支持更多音频转文本模型，提高语音识别的准确性和多样性[^2.23^]。
七、社区与联系
1. BiliNote交流QQ群
BiliNote的交流QQ群号为785367111，欢迎加入群组与其他用户交流使用心得和经验[^2.24^]。
2. BiliNote交流微信群
BiliNote也设有交流微信群，具体群号可在项目页面查看[^2.25^]。
八、许可协议
BiliNote采用MIT License许可协议，允许用户自由使用、修改和分发代码[^2.26^]。你的支持与反馈是我们持续优化的动力！欢迎提交PR、提issue、Star⭐️！
