BiliTools AI总结功能指南：把B站视频变成结构化Markdown摘要-开发者社区

BiliTools AI总结功能指南：把B站视频变成结构化Markdown摘要

【免费下载链接】BiliTools本项目已停止维护。项目地址: https://gitcode.com/GitHub_Trending/bilit/BiliTools

BiliTools 的「AI总结」功能解决一个很具体的问题：一个 45 分钟的教程视频，看完一次能留下多少重点？它调用哔哩哔哩官方 AI 小助手接口，自动解析视频内容，生成带章节、带时间戳的 Markdown 摘要，并随视频一起落盘保存。不用完整看一遍，也不用自己重新整理笔记。

BiliTools AI总结的数据来源

AI总结并非 BiliTools 自己生成，说白了，这个工具不做任何“总结”动作。功能说明文档写明：数据来自哔哩哔哩官方「AI 小助手」（底层模型为Shanghai-Bilibili index-20231207），接口返回时已经是结构化 JSON。BiliTools 做的只有两件事：请求官方接口，再把 JSON 整理成可读的 Markdown 文件。

入口藏在解析流程里：链接粘贴完成解析后，点「常规下载」进入参数选择，AI总结就位于「杂项」分区。

conclusion/get 接口调用说明

整个请求由一个函数完成。前端先把链接解析出视频的aid与cid（字段定义见 MediaItem 类型），再由核心接口实现用这两个参数发起调用：

const params = { aid: item.aid, cid: item.cid }; const response = await tryFetch( 'https://api.bilibili.com/x/web-interface/view/conclusion/get', { auth: 'wbi', params }, );

auth: 'wbi'表示请求 URL 要经过 WBI 算法签名，签名依赖登录账号的 Cookie——这就是该功能必须登录的原因。

getAISummary还有两种用法：传{ check: true }只返回布尔值，用于判断某个视频是否存在 AI总结；不传参数则返回完整的 Markdown 文本，不存在时返回-1。在资源选择逻辑中，登录状态下会对用户投稿的视频类资源做这一次检查，可用时自动为弹窗里的「AI总结」选项预打勾。

从 JSON 到 Markdown：摘要文件的数据流

请求只是前半程，剩下的是格式组织。接口返回的data.model_result含三个关键字段：result_type（总结类型）、summary（摘要正文）、outline（章节结构），对应类型定义中的AISummaryInfo。处理逻辑分两支：

result_type为空：该视频没有 AI总结，函数返回-1，任务被记录为“跳过”；
result_type === 2：除摘要外还有章节结构。函数遍历outline，每个 section 生成一条 H2 标题、每个要点生成列表项，并把秒级时间戳转成带t=参数的 B站播放链接，点击即可定位到对应片段。

最终文本经TextEncoder编码为字节后交给任务队列。在任务处理入口中，aiSummary只是众多子任务之一，与视频、音频、字幕等串行执行；被跳过时仅日志提示，不影响同任务的其他资源。

以一段 45 分钟的 Rust 教程为例，输入是一条链接，输出是一个文件：

输入：https://www.bilibili.com/video/BV1xx411c7mD（前端解析出 aid、cid 两个参数）

输出（落盘的 Markdown 文件，节选）：

# Rust 借用检查器入门 - BV1xx411c7mD 本视频用 45 分钟讲完所有权规则与借用检查器的完整逻辑…… ## 借用规则 - 00:02:15 - 单一所有权 - 00:02:30 - 共享引用与独占引用 - 00:04:45

还有一个容易忽略的复用：同一文件中的getNfo()也会调用getAISummary，把摘要写进 NFO 元数据的plot字段，Emby 等媒体库可以直接展示视频简介。

AI总结配置项开启方法

参数弹窗如上图所示，「杂项」分区位于字幕、NFO 元数据、弹幕、图像等选项同级。对应配置项是PopupSelect中的misc.aiSummary（配置类型），勾选提交后，selectToSubTasks会据此生成独立的aiSummary子任务。文件名遵循「设置 → 格式」的命名模板，任务类型会写进文件名，批量下载时容易区分。