BiliNote - 强大的AI视频笔记神器（markdown 笔记 思维导图）
created: 2026-07-08T15:21:43 (UTC +08:00) tags: [BiliNote、Docker、AI 笔记、视频转笔记、Markdown、部署教程] author: AI茶馆
BiliNote Docker 部署与使用教程
标签：BiliNote、Docker、AI 笔记、视频转笔记、Markdown、部署教程
资源地址：https://pan.quark.cn/s/36d2292ce6b8
项目来源：GitHub - JefferyHcool/BiliNote: AI 视频笔记生成工具 让 AI 为你的视频做笔记 · GitHub
BiliNote 是一个开源的 AI 视频笔记生成工具，能把 Bilibili、YouTube、抖音、快手等平台的视频内容自动总结成结构化的 Markdown 笔记。
2. 为什么不推荐源码部署
源码部署虽然可行，但坑很多，主要体现在：
环境依赖多：需要同时安装 Python 和 Node.js。
依赖体积大：后端
pip install要下载大量包，安装完成后文件夹可达 5–10 GB。容易报错：例如依赖版本不存在、虚拟环境激活失败等。
运行 Bug 多：即使供应商和模型都配置正确，也常卡在“下载音频”或“转写文字”步骤，笔记一直生成不出来。
因此，推荐直接使用 Docker 部署，可以避开大部分环境和依赖问题。
3. Docker 一键部署
茶馆已经打包好了 Docker 镜像和启动脚本，步骤如下：
3.1 安装 Docker Desktop
双击
Docker Desktop Installer.exe。一路点击“下一步”完成安装。
安装完成后打开 Docker Desktop，确保引擎处于运行状态，不需要登录。
3.3 运行启动脚本
进入 up主提供的目录，双击运行
start-bilinote.bat。脚本会自动检测 Docker 状态，导入本地镜像
bilinote.tar.gz，并创建/启动容器。首次运行大约需要 1–2 分钟；后续再次运行会直接启动已有容器。
3.4 打开 Web 界面
容器启动成功后，浏览器访问
http://127.0.0.1
4. 全局配置
4.1 AI 模型配置
进入“全局配置” → “添加供应商”：
名称：随意填写，例如“硅基”。
API Key：填入你的 API 密钥。
API 地址：填到
/v1结尾，例如https://api.siliconflow.cn/v1。类型：暂时保持默认即可。
重要 Bug 处理
保存供应商后，模型列表可能不会立即出现。需要：
返回 BiliNote 主界面刷新页面。
再进入“全局配置”，点击对应供应商，然后“刷新模型”。
此时“选择模型”下拉框才会加载出可用模型。
模型选择建议
必须选择多模态/视觉模型（Vision），否则“视频理解”和“原片截图”功能无法使用。
判断方法：在模型中转站或模型广场里，筛选“视觉”或“多模态”标签。
常见选择：
国外：GPT、Gemini 系列基本都是多模态。
国内：Qwen、MiniMax 有视觉模型；GLM 5.15.2 / GLM-5 不是视觉模型。
视觉模型性能不需要太强，因为只是理解截图，不是写代码。
4.2 音频转写配置
在 Docker 内不推荐使用本地模型。
选择在线转写引擎即可，例如“必剪（在线）”、“快手（在线）”、“Groq（在线）”、“MLX Whisper（仅 macOS）”。
任选其一，保存即可。
4.3 下载配置
按平台填写对应的 Cookie：
Bilibili
YouTube
抖音
快手
获取 Cookie 方法：
打开对应网站，按
F12打开开发者工具。切换到 Application / 应用 → Cookies。
找到对应站点的 Cookie，复制后填入 BiliNote。
4.4 部署监控
Docker 版本已经内置好大部分服务，主要确认以下三项为可用状态：
后端 FastAPI
模型
FFmpeg
CUDA GPU 在 Docker 里可能显示不可用，会自动使用 CPU 模式，不影响生成笔记。
5. 生成笔记
返回首页，按以下步骤操作：
选择平台：本地视频、Bilibili、YouTube、抖音、快手。
粘贴视频链接。
选择模型。
选择笔记风格：例如“精简”。
开启视频理解：如果需要原片截图，勾选“视频理解”下的“原片截图”。
点击“生成笔记”。
等待时间
根据视频长度和任务难度，通常10 分钟以内可以完成。
如果超过十几分钟仍未生成，说明部署或配置存在问题，需要检查全局配置和部署监控。
生成效果
生成完成后，BiliNote 会输出带目录、截图和要点总结的 Markdown 笔记，基本能覆盖视频核心内容。
6. 关键结论
源码部署不推荐：环境复杂、体积大、Bug 多。
Docker 部署最省心：up主已提供镜像和启动脚本，双击运行即可。
模型必须选视觉/多模态：否则视频理解功能无法使用。
配置保存后记得刷新页面：否则模型列表可能加载不出来。
按平台填好 Cookie：否则无法下载部分站点视频。
生成超时请检查部署监控：重点看 FastAPI、模型、FFmpeg 是否正常。