AI 视频笔记生成工具让 AI 为你的视频做笔记

文件	最后提交记录	最后更新时间
.github	fix(ci): 移除 pnpm install 的 --frozen-lockfile 标志	2 个月前
.vscode	🐞 fix: 增加错误之后对已解析段落的缓存功能,再次重试时不再重头开始	4 个月前
BillNote_frontend	feat: 新增B站收藏自动获取脚本 + Step 1 完成	5 天前
backend	feat: 笔记按日期排序 - 文件名加 YYYY-MM-DD_ 前缀	4 天前
config	feat: 新增B站收藏自动获取脚本 + Step 1 完成	5 天前
doc	feat(system): 添加后端初始化和健康检查功能	11 个月前
nginx	fix: 性能优化、前端转写器配置、任务进度丢失及 MLX Whisper 回退问题修复	2 个月前
.dockerignore	feat(build): 全面优化打包流程，Docker 镜像自动发布到 GHCR	2 个月前
.env.example	fix: update bilibili timestamp link format to - [MM:SS](URL#t=MM:SS)	3 个月前
.gitignore	chore: 修复 .gitignore，移除数据文件的跟踪	5 天前
CLAUDE.md	fix: 性能优化、前端转写器配置、任务进度丢失及 MLX Whisper 回退问题修复	2 个月前
Dockerfile.complete	fix(docker): 优化 Vite 配置以支持 Docker 构建环境	2 个月前
LICENSE	docs: 添加 MIT 开源许可证- 在项目根目录下创建 LICENSE 文件	1 年前
README.md	feat: Step 3 - 笔记同步到 wiki + note-analyzer skill 集成	4 天前
bili_note.db	feat: 新增B站收藏自动获取脚本 + Step 1 完成	5 天前
docker-compose.gpu.yml	feat(build): 全面优化打包流程，Docker 镜像自动发布到 GHCR	2 个月前
docker-compose.yml	feat: 新增B站收藏自动获取脚本 + Step 1 完成	5 天前
package-lock.json	feat: 新增B站收藏自动获取脚本 + Step 1 完成	5 天前
run.bat	🐞 fix: 增加错误之后对已解析段落的缓存功能,再次重试时不再重头开始	4 个月前

BiliNote v2.0.0

AI 视频笔记生成工具让 AI 为你的视频做笔记

✨ 项目简介

BiliNote 是一个开源的 AI 视频笔记助手，支持通过哔哩哔哩、YouTube、抖音等视频链接，自动提取内容并生成结构清晰、重点明确的 Markdown 格式笔记。支持插入截图、原片跳转、AI 问答等功能。

📝 使用文档

详细文档可以查看这里

体验地址

可以通过访问这里进行体验，速度略慢，不支持长视频。

📦 桌面版下载

本项目提供了 Windows 和 macOS 桌面客户端，可在 Releases 页面下载最新版本。

Windows 用户请注意：一定要在没有中文路径的环境下运行。

🔧 功能特性

支持多平台：Bilibili、YouTube、本地视频、抖音、快手
支持返回笔记格式选择
支持笔记风格选择
支持多模态视频理解
支持多版本记录保留
支持自行配置 GPT 大模型（OpenAI、DeepSeek、Qwen 等）
本地模型音频转写（支持 Fast-Whisper、MLX-Whisper、Groq、BCut）
GPT 大模型总结视频内容
自动生成结构化 Markdown 笔记
可选插入截图（自动截取）
可选内容跳转链接（关联原视频）
任务记录与历史回看
基于 RAG 的笔记内容 AI 问答（支持 Function Calling）
笔记顶部视频封面 Banner 展示
工作区和生成历史面板支持折叠/展开

v2.0.0 新增

基于 RAG 的笔记内容 AI 问答功能，支持半屏/全屏模式
AI 问答支持 Function Calling，模型可主动查询原文数据
RAG 索引支持视频元信息（标题、作者、简介、标签等）
AI 回复支持 Markdown 渲染
笔记顶部新增视频封面 Banner
工作区和生成历史面板支持折叠/展开
笔记开头添加来源链接功能
YouTube 字幕优先获取，有字幕时跳过音频下载
性能优化与转写器配置改进

📸 截图预览

screenshot

🚀 快速开始

方式一：Docker 部署（推荐）

确保已安装 Docker，直接拉取预构建镜像运行：

docker pull ghcr.io/jefferyhcool/bilinote:latest

docker run -d -p 80:80 \
  -v bilinote-data:/app/backend/data \
  --name bilinote \
  ghcr.io/jefferyhcool/bilinote:latest

访问：http://localhost

也可以使用 docker-compose 本地构建：

# 标准部署
docker-compose up -d

# GPU 加速部署（需要 NVIDIA GPU）
docker-compose -f docker-compose.gpu.yml up -d

方式二：源码部署

1. 克隆仓库

git clone https://gitcode.com/kangk123/BiliNote.git
cd BiliNote
mv .env.example .env

2. 启动后端（FastAPI）

cd backend
pip install -r requirements.txt
python main.py

3. 启动前端（Vite + React）

cd BillNote_frontend
pnpm install
pnpm dev

访问：http://localhost:3015

⚙️ 依赖说明

🎬 FFmpeg

本项目依赖 ffmpeg 用于音频处理与转码，源码部署时必须安装：

# Mac (brew)
brew install ffmpeg

# Ubuntu / Debian
sudo apt install ffmpeg

# Windows
# 请从官网下载安装：https://ffmpeg.org/download.html

⚠️ 若系统无法识别 ffmpeg，请将其加入系统环境变量 PATH

Docker 部署已内置 FFmpeg，无需额外安装。

🚀 CUDA 加速（可选）

若你希望更快地执行音频转写任务，可使用具备 NVIDIA GPU 的机器，并启用 fast-whisper + CUDA 加速版本：

具体 fast-whisper 配置方法，请参考：fast-whisper 项目地址

🐳 使用 Docker 一键部署

确保你已安装 Docker，然后直接拉取预构建镜像运行：

# 拉取最新镜像
docker pull ghcr.io/jefferyhcool/bilinote:latest

# 运行容器
docker run -d -p 80:80 \
  -v bilinote-data:/app/backend/data \
  --name bilinote \
  ghcr.io/jefferyhcool/bilinote:latest

访问：http://localhost

也可以使用 docker-compose 本地构建：

# 标准部署
docker-compose up -d

# GPU 加速部署（需要 NVIDIA GPU）
docker-compose -f docker-compose.gpu.yml up -d

🧠 TODO

支持抖音及快手等视频平台
支持前端设置切换 AI 模型切换、语音转文字模型
AI 摘要风格自定义（学术风、口语风、重点提取等）
加入更多模型支持
加入更多音频转文本模型支持
基于 RAG 的笔记内容 AI 问答
笔记导出为 PDF / Word / Notion

🛠️ CLI 工具集

📥 B站收藏夹自动同步 — `scripts/bili_favorites.py`

自动从 B站 API 获取收藏夹和稍后再看列表，输出 Markdown 文件，支持增量检测。

前置依赖

pip install requests browser-cookie3

browser-cookie3 用于从 Chrome 读取加密的 B站 cookie（首次运行需允许钥匙串访问）。

使用方式

cd backend

# 查看收藏统计
python3 scripts/bili_favorites.py --stats
# 输出示例：
# 📁 收藏夹数: 6
#   ├ [53705781] 默认收藏夹 (2)
#   ├ [3983655281] 游戏 (8)
#   └ ...

# 增量模式（默认）— 只输出新增视频
python3 scripts/bili_favorites.py --output favorites_latest.md

# 全量模式 — 输出所有收藏
python3 scripts/bili_favorites.py --output favorites_all.md --full

生成的 Markdown 与 batch_v3.py 管线兼容，可直接作为输入：

python3 scripts/bili_favorites.py --output favorites_latest.md
python3 batch_v3.py favorites_latest.md

技术特点

三通道 Cookie 读取：browser-cookie3 → yt-dlp 文件 → 配置文件，自动备选
WBI 签名：自动获取密钥并签名，绕过 B站 API 限制
增量检测：基于 BVID 快照，只处理新增视频
自动分页：收藏夹超 20 个视频时自动遍历全部页面

📦 批量笔记生成 — `batch_v3.py`

批量处理一批 B站视频 BVID，自动完成下载 → 转写 → 笔记生成全流程。

python3 batch_v3.py <markdown文件>

支持断点续传（已完成带截图的 BVID 自动跳过）
并发 2 个 Worker 提升速度
自动从 Chrome 提取 B站 Cookie

📊 笔记质量分析 — `scripts/note_analyzer.py`

每篇笔记生成后自动分析质量并注入评估结果，支持持续迭代进化。

# 单篇分析
.venv311/bin/python3 scripts/note_analyzer.py note_results/xxx_markdown.md

# 批量分析 note_results/ 下所有笔记
.venv311/bin/python3 scripts/note_analyzer.py note_results/

评估维度（每项 1-5 分，加权总分）： 完整性(20%) 结构性(15%) 可操作性(20%) 截图质量(15%) 可检索性(10%) 知识密度(20%)

注入内容：评估结果以 YAML Front Matter + 可读摘要形式注入笔记头部：

---
quality_score: 4.3
quality_tags: [完整, 结构清晰, 截图充分]
wiki_potential: high
key_entities: [llama.cpp, Open-Interpreter, Holo, GGUF]
---

🗂️ 自动归档到 Wiki

每篇笔记生成后自动同步到 Obsidian Wiki：

wiki/raw/articles/{标题}_{task_id}.md    ← 笔记（截图路径已修正为相对路径）
wiki/raw/assets/screenshot_xxx.jpg        ← 截图文件

同步后 wiki-incremental-check cron（每天 06:00）会自动检测新笔记并更新 Wiki 页面。

🔄 全流程自动化

将收藏同步和笔记生成串联，实现"收藏视频 → 自动笔记 → Wiki 知识库"闭环：

# 获取新增收藏
python3 scripts/bili_favorites.py --output favorites_latest.md

# 批量生成笔记（自动分析质量 + 同步到 wiki）
.venv311/bin/python3 batch_v3.py favorites_latest.md

一键全流程

#!/bin/bash
# run_full_pipeline.sh（待构建）
cd /Users/likang/BiliNote/backend
python3 scripts/bili_favorites.py --output favorites_latest.md
.venv311/bin/python3 batch_v3.py favorites_latest.md

Step 3: 注入 wiki（待实现）

python3 scripts/wiki_inject.py


> 💡 配合 cron 可实现每日自动同步。示例（每天 08:00）：
> ```cron
> 0 8 * * * cd /path/to/BiliNote/backend && python3 scripts/bili_favorites.py --output favorites_latest.md && python3 batch_v3.py favorites_latest.md
> ```

### Contact and Join-联系和加入社区
年会恢复更新以后放出最新社区地址



## 🔎代码参考
- 本项目中的 `抖音下载功能` 部分代码参考引用自：[Evil0ctal/Douyin_TikTok_Download_API](https://github.com/Evil0ctal/Douyin_TikTok_Download_API)

## 📜 License

MIT License

---

💬 你的支持与反馈是我持续优化的动力！欢迎 PR、提 issue、Star ⭐️
## Buy Me a Coffee / 捐赠
如果你觉得项目对你有帮助，考虑支持我一下吧
<div style='display:inline;'>
    <img width='30%' src="https://img-transfer.gitcode.com?p=https%3A%2F%2Fcommon-1304618721.cos.ap-chengdu.myqcloud.com%2F8986c9eb29c356a0cfa3d470c23d3b6.jpg&projectId=kangk123/BiliNote&pageUrl=https%3A%2F%2Fgitcode.com%2Fkangk123%2FBiliNote"/>
    <img width='30%' src="https://img-transfer.gitcode.com?p=https%3A%2F%2Fcommon-1304618721.cos.ap-chengdu.myqcloud.com%2F2a049ea298b206bcd0d8b8da3219d6b.jpg&projectId=kangk123/BiliNote&pageUrl=https%3A%2F%2Fgitcode.com%2Fkangk123%2FBiliNote"/>
</div>

## ⭐ Star History

[![Star History Chart](https://api.star-history.com/svg?repos=JefferyHcool/BiliNote&type=Date)](https://www.star-history.com/#JefferyHcool/BiliNote&Date)

项目介绍

AI 视频笔记生成工具让 AI 为你的视频做笔记

BiliNote:基于 AI 技术的视频笔记生成工具项目

BiliNote v2.0.0

✨ 项目简介

📝 使用文档

体验地址

📦 桌面版下载

🔧 功能特性

v2.0.0 新增

📸 截图预览

🚀 快速开始

方式一：Docker 部署（推荐）

方式二：源码部署

1. 克隆仓库

2. 启动后端（FastAPI）

3. 启动前端（Vite + React）

⚙️ 依赖说明

🎬 FFmpeg

🚀 CUDA 加速（可选）

🐳 使用 Docker 一键部署

🧠 TODO

🛠️ CLI 工具集

📥 B站收藏夹自动同步 — scripts/bili_favorites.py

📦 批量笔记生成 — batch_v3.py

📊 笔记质量分析 — scripts/note_analyzer.py

🗂️ 自动归档到 Wiki

🔄 全流程自动化

一键全流程

Step 3: 注入 wiki（待实现）

python3 scripts/wiki_inject.py

项目介绍

📥 B站收藏夹自动同步 — `scripts/bili_favorites.py`

📦 批量笔记生成 — `batch_v3.py`

📊 笔记质量分析 — `scripts/note_analyzer.py`