ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

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

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子任务。文件名遵循「设置 → 格式」的命名模板,任务类型会写进文件名,批量下载时容易区分。

适用边界与上手路径

✅ 适合知识类、教程类、讲座类视频:先读摘要建立框架,再用时间戳跳转重点片段。 ❌ 不可用:未登录;番剧、图文、音乐等非视频类型没有该选项;无 AI总结的视频会自动跳过。 ⚠️ 注意:批量高频请求可能触发风控;项目已停止维护,接口变更可能不再修复。

上手三步:

  1. git clone https://gitcode.com/GitHub_Trending/bilit/BiliTools后按文档构建,或直接使用发布包;
  2. 登录 B站账号,粘贴视频链接完成解析;
  3. 在杂项区勾选「AI总结」,摘要即随任务保存为 Markdown。

如果摘要只能给出框架,细节仍要回到原视频,这两者之间你会怎么分配时间?

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

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进