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 是否正常。