BiliNote 部署搭建
https://github.com/JefferyHcool/BiliNote
- 这是一个taui项目
- 本人mac, docker镜像没有。 改成了普通的 前端 + python后端 ,本地开发调试ok
python后端启动
- 进入后端目录
- uv init
- uv pip install -r requirements.txt
- uv add mlx-whisper
-ctranslate2==4.5.0
+ctranslate2==4.7.1
- uv run main.py
![]()
前端
- 修改 proxy vite.config.ts 跳过nginx
proxy: {
'/api': {
target: "http://127.0.0.1:8483",
changeOrigin: true,
},
'/static': {
target: "http://127.0.0.1:8483",
changeOrigin: true,
},
},
- 修改python 的跨域问题
allow_origins=["*"], # 开发环境临时允许所有来源

cc分析的步骤
BiliNote 工作流详解
📝 视频下载和分析的完整步骤
步骤 阶段 做什么 核心代码
1 解析 识别视频链接来自哪个平台 _get_downloader(platform)
2 下载/字幕 优先查找平台字幕(B站/YouTube/抖音等) downloader.download_subtitles()
3 缓存 如果有缓存转写笔记,直接用缓存 读取 {task_id}_transcript.json
4 下载媒体 如无字幕或需截图,下载音视频 _download_media() + yt-dlp
5 提取音频 从视频中提取音频轨道 FFmpeg:ffmpeg -i video.mp4 -q:a 0 -map a audio.mp3
6 转写音频 用 AI 模型将音频转为文字 Whisper/Groq/MLX/等
7 分块处理 长转写分段,避免 token 超限 RequestChunker
8 生成笔记 用 LLM 生成结构化 Markdown GPT/Deepseek/Qwen
9 截图处理 可选:从视频截取关键帧 FFmpeg 关键帧提取
10 时间链接 可选:添加视频时间戳链接 标记处理
11 保存 文件 + 数据库持久化 save_note_to_file()
🔧 关键依赖和工具
📂 项目代码位置
功能 位置
平台下载器 downloaders
转写引擎 transcriber
LLM 接口 gpt
业务逻辑 note.py (NoteGenerator 类)
API 路由 note.py
前端表单 HomePage
