Windows部署BiliNoteDocker安装、AI视频转写、Markdown笔记与cpolar远程访问前言我平时看技术视频最麻烦的环节往往不是播放而是把视频里的操作沉淀下来。一个教程可能同时包含命令、界面设置和口头解释单纯收藏链接过几天还得重新定位关键片段全部手工记录又很占时间。尤其是换了电脑或者在外面突然需要查一条命令时原来保存在本机的零散截图也不方便管理。我想要的是一套能部署在自己电脑上、能指定模型、能输出 Markdown、还能从其他设备访问的整理工具。BiliNote 正好对应这条工作流先解析视频并获取可处理的音频内容再借助转写引擎和大模型整理出摘要、章节与重点按需附上截图及时间戳。它支持多种视频来源与笔记风格但实际处理效果仍受视频质量、平台访问条件、转写模型和 AI 服务影响不能把生成的内容直接视为准确的原文记录。本次我使用 Windows Docker 运行 BiliNote依次完成环境检查、第三方脚本部署、AI API 和 Fast-Whisper 设置再用一个视频链接演示笔记生成。考虑到笔记和模型配置保存在本地后半部分还会配置 cpolar 的 HTTPS 公网地址说明如何从外网进入页面以及哪些凭证和访问权限需要额外保护。全文保留操作命令和截图既能看明白方案也能按步骤自己复现。1. BiliNote先把视频整理成可复用的笔记BiliNote 是一个开源 AI 视频笔记助手项目地址JefferyHcool/BiliNote。它不是视频播放器也不是简单把字幕整段复制出来而是将视频中的可提取内容经过转写和模型整理输出便于复盘的笔记。对我来说它值得尝试的地方主要在于这些实际功能视频来源支持 Bilibili、YouTube、抖音、快手以及本地视频能否成功解析还与平台限制、视频权限和网络条件有关。语音转文字可配置 Fast-Whisper 等转写方案将讲解内容变成后续整理的基础材料。Markdown 输出把摘要、章节和重点组织成可编辑文本方便再加工。截图与时间戳按需将画面和对应时间保留下来避免单凭文字猜测操作界面。原片跳转需要核查步骤时可以返回视频对应片段。笔记风格选择根据内容选精简、详细、教程、学术或会议纪要等形式。模型自选可配置兼容的模型服务例如 OpenAI、DeepSeek、Qwen 等具体以服务商接口为准。历史与版本查看以往任务必要时为同一视频生成不同风格的笔记。我更愿意把它理解为一个“视频材料整理助手”它负责先产出草稿我再检查关键命令、数据和结论。原视频仍是重要依据尤其是技术教程。2. Windows 环境准备与 BiliNote 部署本篇采用 Windows Docker。先确保 Docker Desktop 能运行再执行原文所用的第三方部署脚本部署完成后才进入模型配置和视频测试。具体端口、容器组成可能随脚本版本变化以下以本次示例的 3015 端口为准。2.1 安装并检查 Docker Desktop从 Docker 官方页面下载安装适用于 Windows 的 Docker Desktophttps://www.docker.com/products/docker-desktop/安装完成后启动程序等待 Docker 引擎处于运行状态。打开 PowerShell执行下面两条命令docker--versiondockercompose version能显示 Docker 与 Compose 的版本信息说明命令行工具已可调用正式部署前还应确认 Docker Desktop 本身已正常启动。如果出现命令不存在或无法连接引擎先处理安装、WSL 及引擎启动问题。2.2 使用原文部署脚本这篇原始实践采用的是第三方 PowerShell 脚本并非 BiliNote 官方仓库中的部署命令。为了与截图和操作保持一致下面保留原始命令irm https://gitee.com/jun-wan/script/raw/master/bilinote_deploy/deploy-bilinote.ps1|iex执行前的必要检查irm ... | iex会把远端脚本下载后直接执行。建议先查看脚本内容、确认来源和脚本将创建的目录、容器、端口及权限再在自己信任的环境里运行不要仅因为命令短就把它视为无风险的“官方一键安装”。如果想走官方路径可以另行参考 BiliNote 官方项目 和 官方 Docker 部署仓库但不要把两套方式的目录和端口混用。按照脚本提示选择1安装随后由脚本拉取镜像、建立容器并启动相关服务。如果安装向导询问是否启用 GPU 加速先判断电脑是否有 NVIDIA 显卡并且 Docker 的 GPU 容器环境已配置好。满足条件可以选择Y尚未配置时选择N优先跑通 CPU 路径。选择了 GPU 并不代表一定能用上 CUDA仍要以实际容器和转写日志为准。安装完成后先保留终端输出便于核对部署目录与服务端口。打开浏览器访问http://localhost:3015如果页面正常出现说明本机 Web 入口已经可访问还需在下一节完成 AI 模型和语音转写配置才能验证真正的笔记生成功能。若3015被占用可以检查脚本生成的.env根据当前部署文件实际使用的字段调整APP_PORT或FRONTEND_PORT例如改为3016再重启相应容器。改完之后后文 cpolar 的本地地址也要使用实际端口。3. 从配置模型到生成第一份笔记页面能打开只是第一步。接下来按“模型服务 → 转写引擎 → 必要的平台凭证 → 视频生成”的顺序配置排错也更清楚。3.1 添加 AI 模型在 BiliNote 中进入全局设置 → AI 模型配置填写模型服务商要求的参数供应商名称自定义比如 siliconflow / deepseek / qwen API Key你的模型平台密钥 Base URL模型供应商提供的接口地址保存后点击连接测试验证通过再刷新模型列表并选择这次要使用的模型。这里的 API Key 是模型服务商提供的密钥和 cpolar 登录账号不是一回事不要将它放到截图、笔记正文或公开仓库里。BiliNote 的开源部署和外部模型调用是两回事。即使本地程序可以自行部署模型平台仍可能有额度、速率和计费规则生成笔记前最好先了解自己的账户用量。3.2 配置 Fast-Whisper 转写在音频转写配置中选择Fast-Whisper根据设备情况下载模型。原文按以下档位说明tiny速度快适合先测试 base / small识别效果更好适合日常使用 medium / large效果强但更吃电脑配置第一次测试优先选tiny或base确认视频能完成下载、转写和总结再决定是否使用更大的模型。模型越大往往意味着更高的内存和计算开销转写质量还受原视频音质、口音和专业术语影响。3.3 按需配置视频平台 Cookie某些平台的视频解析可能需要登录状态原文以抖音、快手等作为例子。如果遇到需要认证的内容进入 BiliNote 的下载配置页面按实际需要填写对应平台的 Cookie。原文演示的获取顺序如下操作只应在自己有权限使用的账号上进行在对应视频网站登录账号按F12打开浏览器开发者工具进入Network / 网络面板刷新页面或打开需要处理的视频选择对应请求查看Headers / 请求头找到并复制需要的cookie内容返回 BiliNote 下载配置页面粘贴并保存。Cookie 相当于登录凭证可能允许他人以你的身份访问平台。不要发布在教程、聊天群或 Git 仓库里也不要向不可信的部署脚本或他人提供。对版权或访问受限的视频应遵守平台规则并确认有权处理该内容。3.4 用视频链接生成笔记现在可以找一个自己有权观看的 B 站教程视频复制链接在 BiliNote 首页填写内容。原文操作项如下视频平台哔哩哔哩 视频链接粘贴 BV 链接 模型选择选择刚才配置好的模型 笔记风格教程风格 / 详细风格 / 精简风格 笔记格式按需勾选截图、时间戳、跳转链接设置好之后点击生成笔记。处理时间会随视频长度、下载条件、转写模型和所选 AI 服务变化不能保证复制链接后立刻出结果。生成完成后先检查标题、摘要、重点与章节再结合截图、时间戳返回视频核实具体操作。对于代码或参数不建议只依赖 AI 摘要有必要时手动修正 Markdown并保存为后续可以复用的学习记录。4. 为什么还要配置 cpolar做到这里示例中的 BiliNote 已经可以在本机localhost:3015使用。不过我有时不在这台 Windows 电脑前想打开之前生成的笔记单靠这个本地地址就不够了。localhost指向的是当前使用的设备手机在外网访问它并不会自动连回家中的电脑。cpolar 的作用是将本地 Web 服务映射成可从外部访问的地址。它不负责视频转写也不负责生成笔记BiliNote 负责内容处理cpolar 负责连接。公网访问之前应先确认笔记是否涉及私人内容、模型凭证或视频平台 Cookie并做好访问保护。4.1 Windows 安装 cpolar访问 cpolar 官网使用“免费使用”入口注册账号并下载 Windows 版本安装包。根据安装向导完成安装。此处的图示是 Windows 安装流程不要与前面 Docker 容器安装混为一谈。完成后在安装 cpolar 的电脑上打开浏览器访问http://localhost:9200使用 cpolar 账号登录 Web 管理界面。5. 为 BiliNote 建立远程访问地址登录 cpolar Web UI 后进入隧道管理 → 创建隧道。这次连接的是 BiliNote 的 Web 端口因此需要将隧道本地地址指向前面部署成功的3015而不是 cpolar 管理后台的9200。按照原文的配置填写隧道名称自定义且不要与现有隧道重名协议http本地地址3015域名类型临时测试可用随机域名这篇演示长期使用的二级子域名地区China Top。需要固定地址时先到 cpolar 控制台的预留 → 保留二级子域名选择地区、输入希望使用的名称并保留。固定子域名的可用性及套餐条件以自己的账号页面为准不能把免费随机域名与固定地址当作同一功能。保留成功后复制实际获得的名称返回隧道创建或编辑页面把名称填写到Sub Domain栏确认地区与预留时一致再创建或更新隧道。然后进入状态 → 在线隧道列表查看刚才生成的公网地址。用手机移动网络或另一台外网设备打开 HTTPS 地址检查页面是否加载并尝试查看一份既有笔记。只看到首页还不能代表所有生成、上传和截图接口都能正常工作必要时再做完整功能验证。长期访问还要求 Windows 电脑、Docker 容器及 cpolar 服务持续运行。公网域名固定只意味着地址不随随机隧道改变不代表主机断电或服务停止后仍能连接。建议优先使用 HTTPS并按实际能力配置访问认证或其他限制不要把模型密钥、Cookie 和私人学习记录直接暴露给所有访问者。6. 总结这次我把一条视频学习流程真正串了起来在 Windows 上部署 BiliNote配置模型和语音转写按需处理平台凭证再把教程视频整理成带重点、截图和时间戳的 Markdown 笔记。最后通过 cpolar 为本地 Web 页面增加远程入口让不在电脑旁的时候也可以继续查看资料。最有价值的变化不是“几秒钟就能写完笔记”而是减少重复查找视频片段的工作把重要内容留下来。AI 生成的摘要可以作为第一稿关键技术步骤仍要自己复核而在远程访问方面也要同时管好模型 Key、Cookie、服务权限和备份。这样积累下来的资料才更适合以后真正拿出来用。