VideoAdGuard - B站视频植入广告检测器

VideoAdGuard 是一个基于大语言模型的B站视频植入广告检测工具，能够自动识别B站视频中的植入广告内容，并提供跳过广告的功能。

如果你觉得这个插件有用，请给项目点个Star⭐支持一下！

演示视频

News

• v1.2.9~v1.2.11 添加手动控制广告区间，修复已知bug
• v1.2.8 提供Groq代理服务
• v1.2.7 适配Firefox浏览器
• v1.2.6 支持 glm-4.5 系列模型，适配 Chrome浏览器
• v1.2.5 优化缓存机制；优化av号处理
• v1.2.4 新增限制模式，仅在有商品链接时进行识别；优化界面
• v1.2.3 新增音频识别功能，支持无字幕视频检测；新增广告检测结果缓存机制
• v1.2.2 新增关闭插件开关，优化界面，优化广告判断逻辑
• v1.2.1 支持自定义UP白名单
• v1.2.0 支持自动跳过
• v1.1.3 支持本地Ollama模型

功能特点

• 🎯 精准识别：采用大语言模型分析视频字幕，准确定位植入广告内容
• 🎵 音频识别：支持无字幕视频的音频识别检测，使用免费的Groq服务商（v1.2.3新增）
• 🚀 便捷操作：检测到广告后自动显示跳过按钮，一键跳过广告片段
• 🔄 自动跳过：支持自动跳过已识别的广告内容（v1.2.0新增）
• 💾 智能缓存：本地缓存检测结果，大幅提升重复访问速度（v1.2.3新增）
• 🌈 广泛兼容：支持多种主流浏览器，包括Edge、Chrome等
• ⚙️ 灵活定制：支持多种AI模型接入，包括智谱AI、OpenAI、DeepSeek等
• 🏠 本地部署：支持本地Ollama模型，保护隐私数据（v1.1.3新增）

安装方法

浏览器插件版（推荐）

点击上方对应浏览器的图标即可下载安装：

• Edge浏览器：Edge插件下载
• Chrome浏览器：Chrome插件下载
• Firefox浏览器：Firefox插件下载

油猴脚本版

注意：油猴版本更新不及时，如果是chromium内核浏览器推荐采用插件版

1. 安装篡改猴插件
2. 从GreasyFork安装脚本

使用方法

1. 浏览器插件版：安装完成后，点击插件图标完成设置

   

2. 油猴脚本版：安装完成后，进入B站视频页面，点击右下角齿轮图标进行设置

   

3. 设置API密钥和模型（详见下方API设置说明）

4. 打开任意带有字幕的B站视频，插件会自动检测广告内容

5. 当检测到广告时，会在视频播放器右下角显示"跳过广告"按钮

API设置说明

本插件需要配置大语言模型API才能正常工作。检测能力与大模型能力强相关，推荐使用性能更强的大模型。

大语言模型API（必需）

测试不同大模型的该项目上的效果，可选择 302.AI，立即注册获取$1赠金

• API地址：https://api.302.ai/v1/chat/completions
• 模型名称：模型列表
• API密钥：需要在302.AI注册并获取（输入邀请码 ckUgCA 获取$1赠金）

免费体验可选择 智谱AI glm-4.5-flash 模型

• API地址：https://open.bigmodel.cn/api/paas/v4/chat/completions
• 模型名称：glm-4.5-flash
• API密钥：需要在智谱AI平台注册并获取

插件兼容几乎所有大语言模型。目前我们已经测试了部分模型，但还需要更多用户的测试反馈。如果您使用了下表中的模型，请通过GitHub Issues告诉我们您的使用体验，帮助我们完善兼容性列表。

API集成平台	测试结果	API密钥官网
302.AI	✅	302.AI
硅基流动	✅	硅基流动
云雾API	✅	云雾API

模型名称	测试结果	API密钥官网
GLM	✅	智谱AI
DeepSeek	✅	DeepSeek
OpenAI	✅	OpenAI
通义千问	✅	阿里云
Gemini	✅	Gemini
Grok	✅	Grok
Anthropic Claude	❓	Claude
MiniMax	❓	MiniMax
豆包	❓	火山引擎

本地服务	测试结果	注意事项
Ollama	✅	因为跨域请求，需要设置环境变量 OLLAMA_ORIGINS = *

音频识别API（可选）

• 用途：用于无字幕视频的音频识别功能
• 推荐服务：目前只支持Groq（免费Whisper模型）
• API密钥获取：在Groq平台注册并获取
• 注意：如果要使用Groq AP，需要非国内（包括港澳台）的网络环境

注意事项

• 字幕检测：优先使用视频字幕进行检测，准确度更高
• 音频识别：无字幕视频将自动启用音频识别功能（v1.2.3新增）
• API配置：需要配置大语言模型API密钥，模型能力越强，检测效果越好
• 音频识别API：使用音频识别功能需要额外配置Groq API密钥
• 费用提醒：使用付费API时请注意token消耗和音频识别费用
• 缓存机制：检测结果会自动缓存24小时，提升重复访问速度
• 调试信息：众多调试信息会在控制台输出，遇到错误时可以查看控制台

技术原理

VideoAdGuard通过以下步骤检测视频中的植入广告

字幕检测模式（默认）

1. 获取视频字幕内容
2. 提取视频标题和置顶评论
3. 将数据发送给大语言模型进行分析
4. 根据分析结果确定广告时间段
5. 缓存检测结果到本地存储
6. 在界面上显示跳过按钮

音频识别模式

1. 当视频无字幕时，自动下载视频音频流
2. 使用Groq Whisper API进行语音识别
3. 将识别结果转换为文本格式
4. 后续流程与字幕检测模式相同

智能缓存机制

• 本地缓存检测结果，避免重复分析
• 缓存有效期为24小时，自动清理过期数据
• 大幅提升重复访问视频的检测速度

目录结构

VideoAdGuard
├── builds/                        # 构建产物（按浏览器区分）
│   ├── chrome/                    # Chrome 打包目录
│   └── firefox/                   # Firefox 打包目录
├── src/                           # 源代码目录
│   ├── services/                  # 业务逻辑与平台适配
│   ├── types/                     # 类型定义
│   └── utils/                     # 工具函数
├── manifests/                     # 浏览器清单文件
│   ├── manifest-chrome.json       # Chrome 清单
│   └── manifest-firefox.json      # Firefox 清单
├── _locales/                      # i18n 资源
├── icons/                         # 插件图标资源
├── docs/                          # 文档与站点
├── scripts/                       # 构建与辅助脚本
│   └── build.js
├── VideoAdGuard.Tampermonkey.js   # 油猴脚本版本
├── webpack.config.js              # Webpack 构建配置
├── tsconfig.json                  # TypeScript 配置
├── package.json                   # 项目依赖与脚本
├── LICENSE                        # 开源许可证
└── README.md                      # 项目说明文档

自行构建

如果你想自行构建VideoAdGuard，可以按照以下步骤进行：

1. 克隆本仓库到本地：

   git clone https://github.com/Warma10032/VideoAdGuard.git
   cd VideoAdGuard
   

2. 安装依赖：

   npm install
   

3. 构建插件：

   npm run build
   

开源与贡献

本项目完全开源，欢迎贡献代码和提出建议：

• GitHub仓库：https://github.com/Warma10032/VideoAdGuard
• 问题反馈：GitHub Issues
• 如遇任何插件不起作用问题，在提出Issues同时，附上浏览器(F12)控制台的错误日志/截图，以便我们更好地帮助你。
• 

贡献者

免责声明

本插件仅用于学习和研究目的，不得用于任何商业或非法用途。使用本插件所产生的一切后果，与作者和插件开发者无关。

许可证

本项目采用GPLv2许可证开源。

Star History

VideoAdGuard 快速上手指南

VideoAdGuard 是一款基于大语言模型的浏览器插件，专为 B 站（Bilibili）用户设计，能够自动识别视频中的植入广告并提供一键跳过或自动跳过功能。

环境准备

在使用本工具前，请确保满足以下条件：

• 浏览器环境：
  • Google Chrome（推荐）
  • Microsoft Edge
  • Mozilla Firefox
  • 或安装了 Tampermonkey（篡改猴）插件的任意主流浏览器
• API 密钥（必需）：
  • 本工具依赖大语言模型进行分析，需配置有效的 API Key。
  • 国内推荐方案：推荐使用 302.AI（输入邀请码 ckUgCA 可获赠金）或 智谱 AI（免费模型 glm-4.5-flash）。
  • 其他支持：DeepSeek、OpenAI、阿里云通义千问等。
• 音频识别（可选）：
  • 若视频无字幕，需额外配置 Groq API Key（需非国内网络环境访问）。

安装步骤

方式一：浏览器插件版（推荐）

直接访问对应浏览器的应用商店搜索 "VideoAdGuard" 或点击下方链接安装：

• Chrome 用户：前往 Chrome 网上应用店安装
• Edge 用户：前往 Microsoft Edge 加载项安装
• Firefox 用户：前往 Firefox 附加组件安装

方式二：油猴脚本版

适用于无法直接安装插件的环境：

1. 先在浏览器中安装 Tampermonkey 插件。
2. 访问 GreasyFork 脚本页 点击“安装此脚本”。

方式三：自行构建（开发者）

如需修改源码或本地调试，可执行以下命令：

# 1. 克隆仓库
git clone https://github.com/Warma10032/VideoAdGuard.git
cd VideoAdGuard

# 2. 安装依赖
npm install

# 3. 构建插件
npm run build

构建完成后，在 builds/ 目录下加载对应浏览器的扩展程序。

基本使用

1. 配置 API：

   • 安装完成后，点击浏览器右上角的 VideoAdGuard 插件图标（油猴版则是在视频页面右下角点击齿轮图标）。
   • 在设置面板中填入 API 地址、模型名称 和 API 密钥。
   • 示例配置（智谱 AI 免费版）：
     • API 地址：https://open.bigmodel.cn/api/paas/v4/chat/completions
     • 模型名称：glm-4.5-flash
     • API 密钥：从智谱 AI 控制台获取

2. 观看视频：

   • 打开任意 B 站视频页面。
   • 插件会自动获取视频字幕（若无字幕则尝试音频识别）并发送给大模型分析。

3. 跳过广告：

   • 手动模式：当检测到广告片段时，播放器右下角会出现“跳过广告”按钮，点击即可跳转。
   • 自动模式：在设置中开启“自动跳过”功能后，插件将在广告开始时自动跳过，无需人工干预。

提示：检测结果会本地缓存 24 小时，重复观看同一视频时将瞬间完成检测，无需再次消耗 API 额度。