BiliSum 桌面端使用指南：从安装到第一个视频摘要的完整流程

BiliSum 是一款开源的 AI 视频摘要与知识库工具，支持 B 站、YouTube 和本地视频：它会把视频自动转写为文字，再生成结构化摘要、知识笔记、思维导图，并能沉淀为可问答的本地知识库。本文带你走通 BiliSum 桌面端从安装、配置到产出第一个视频摘要的完整流程，全程大约 10 分钟。

一、BiliSum 桌面端能做什么？

装好之后，BiliSum 会把一个视频变成一整套学习资料：

B 站 / YouTube / 本地视频 → 转写 → 文本笔记 → 图文笔记 → 思维导图 → 知识库

• 自动转写：支持云端 SiliconFlow ASR、多模态 ASR、本地 Whisper、FunASR，也优先复用 B 站官方字幕
• AI 摘要：生成核心概览、章节时间轴和知识卡片
• 知识笔记：结构化 Markdown 笔记，可导出到 Obsidian
• 思维导图：按主题组织的知识结构，支持缩放、拖拽
• 知识库问答：跨视频语义检索 + RAG 问答，数据全部保存在本机

左侧导航共四个区域：首页（工作台）、视频库（资产管理）、知识库（检索问答）、设置（运行配置）。

二、安装 BiliSum 桌面端：一键安装步骤

BiliSum 桌面端提供Windows 和 macOS两个平台安装包（当前版本见 apps/desktop/package.json，基于 Electron + React + Vite 构建）。

安装步骤：

1. 从项目 Releases 页面下载对应平台的安装包（Windows 为 Setup 安装程序，macOS 为 dmg）
2. Windows 安装器支持自定义安装目录并自动创建桌面快捷方式；macOS 直接拖入 Applications 即可
3. 首次启动后，应用会在本地用户数据目录（如 Windows 的%LOCALAPPDATA%\bilisum）初始化数据库、配置与访问令牌

💡 桌面端内置后端服务，无需手动安装 Python 环境；也支持应用内一键检查新版本并更新。

如果你更习惯命令行，还可以用npm install -g bilisum安装 CLI，与桌面端共用任务和知识库，详见 CLI 使用指南。

三、首次启动：三步完成关键配置

首次打开时，BiliSum 会自动弹出「首次启动辅助配置」向导（源码见 SetupAssistantDialog.tsx），按顺序引导你补全配置：

第 1 步：配置语音转写（必配）

进入左侧「设置」→「语音转文字」，任选其一：

第 2 步：配置 LLM 摘要（强烈推荐）

在「摘要生成」页面填入 OpenAI-compatible 端点的 Base URL、模型名和 API Key（也支持 Anthropic 和自定义端点）。配好 LLM 后，摘要、知识笔记和思维导图都会显著更完整。

第 3 步：保存并回到首页

点击保存后，首页右上角的「运行状态」会自动刷新，红色告警消失即表示配置就绪。所有配置的完整变量说明见 配置说明。

🔑遇到 B 站风控？优先使用桌面端内置的扫码登录功能获取登录态，比手动导出 cookies.txt 简单得多。

四、生成你的第一个视频摘要

配置完成后，回到首页工作台（组件源码见 HomePage.tsx），开始总结：

1. 在顶部输入框粘贴 B 站 / YouTube 视频链接，或直接输入 BV 号
2. 点击粉色「开始总结」按钮（也可展开下拉框调整本次任务的摘要偏好）
3. 支持通过「+」号旁入口导入本地视频（mp4 / mkv / mov / webm 等格式），或把文件直接拖进窗口
4. 任务提交后进入后台队列处理，多 P 视频可以批量加入处理

处理完成后，视频卡片上会显示「已完成」状态，点击卡片进入详情页查看结果。

五、解读摘要结果：知识卡片、笔记与思维导图

详情页（源码见 VideoDetailPage.tsx）包含三个核心视图：

1. 知识卡片：核心概览 + 要点列表 + 章节时间轴，还内嵌播放器可以边看视频边对照：

2. 知识笔记：完整的结构化 Markdown 笔记，包含数学公式渲染（KaTeX）、重点展开和转写全文，右下角悬浮播放器随时对照原视频：

3. 思维导图：把整节课的知识结构按主题分组，支持缩放、拖拽和节点高亮，点击节点下方还能展开对应知识点的解释。

六、进阶玩法：图文笔记与知识库问答

VLM 理解型图文笔记：在「摘要生成」中开启视觉模型配置后，笔记会同时阅读原始文字和视频截图，把画面信息组织进文章——图片跟随对应知识段落排列，不再集中堆在文末：

知识库问答：开启知识库后，每个完成的视频都会自动建立索引。在「知识库」页面可以跨视频做语义检索、关键词检索，并向所有笔记提问（RAG 问答），还支持自动/手动标签与标签关系网络。Embedding 和问答 LLM 都可以完全跑在本地，笔记、索引与配置均保存在本机：

结果导出：在详情页可将知识笔记导出为 Markdown 或Obsidian 笔记（可在设置中先指定输出目录），也可以把知识卡片一键导出为图片。多 P 视频合集还能生成全集总结。

七、常见问题速查

八、总结与延伸阅读

到这里，你已经完成了 BiliSum 桌面端的完整上手流程：下载安装 → 配置转写与 LLM → 粘贴链接开始总结 → 查看卡片/笔记/导图 → 沉淀为知识库。BiliSum 的全部数据都留在本地，非常适合把长期学习积累成自己的视频知识库。

相关文档：

• 配置说明（全部环境变量与优先级）：docs/configuration.md
• CLI 使用指南：docs/cli.md
• 桌面端前端源码：apps/desktop/src/
• 设置页分类定义：settingsConfig.tsx
• 贡献指南（打包与发布流程）：docs/contributing.md