MCPcopy Index your code
hub / github.com/Sakurairinaqwq/Bilibili-Shield

github.com/Sakurairinaqwq/Bilibili-Shield @v1.4.0a

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.4.0a ↗ · + Follow
188 symbols 363 edges 2 files 4 documented · 2%

Browse by type

Functions 163 Types & classes 25
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Bilibili Omnipotent Shield (哔哩哔哩全能护盾)

哔哩哔哩全能护盾 是一个集成了广告净化、功能解锁、界面美化与安全防护于一体的 Tampermonkey 用户脚本。

本项目基于 "Railgun" 架构 重构,旨在提供 Level 5 级别的 B 站浏览体验。它不仅拥有以 御坂美琴(Misaka Mikoto) 为灵感的现代化 UI 设计,更在底层逻辑上实现了对页面元素的 DOM 级精准控制。


核心特性 (Level 5 Capabilities)

1. 超电磁炮 UI (Railgun Interface)

  • 常盘台风格设计:界面配色采用标志性的米色与电击蓝,致敬常盘台中学制服与电击使能力。
  • 物理动态交互:悬浮球采用"硬币"设计,集成物理回弹动画与呼吸效果,交互手感 Q 弹流畅。
  • Shadow DOM 隔离:控制面板运行于独立的 Shadow DOM 中,与页面样式完全隔离,杜绝冲突。

2. 绝对防御 (Absolute Defense)

  • 智能清道夫 (Smart Cleaner):基于 MutationObserver 的 DOM 级防护,精准识别并移除随机类名的广告占位符。
  • 御坂网络词库 (Misaka Network):接入云端实时更新的屏蔽规则库,支持正则表达式与白名单机制,精准过滤引战弹幕与垃圾评论。
  • 自动裁决:可选开启"自动拉黑"功能,自动将被屏蔽规则命中的恶意用户移入黑名单。
  • 弹幕力场:实时拦截并清除命中屏蔽词的弹幕节点,还你清净的观影环境。

3. 能力解禁 (Feature Unlock)

  • 超清画质解锁:突破登录限制,未登录状态下也可强制开启 1080P+ 高码率画质(自动清除本地缓存以防止回退)。
  • 访客评论查看:解锁未登录状态下的评论区加载限制,允许游客自由浏览视频评论与楼中楼。
  • 完整评论体验:支持评论翻页、最热/最新排序切换、粉丝勋章显示、图片预览等完整功能。

4. 严谨控制 (Strict Control)

  • Opt-In 策略:遵循"最小权限"原则,所有功能默认关闭。用户拥有绝对控制权,仅开启需要的模块。
  • 登录弹窗阻断:强力拦截播放暂停、每日访问时的登录诱导弹窗,归还清爽的浏览权。

功能列表 (Feature Matrix)

通用设置

功能 说明
禁止自动弹出登录 阻止 B 站的登录诱导弹窗
经典顶栏 恢复经典的橙色顶栏配色
开发者模式 开启后可在日志面板查看运行状态

净化功能 (Shield)

功能 说明
实时弹幕拦截 根据屏蔽词库过滤弹幕内容
屏蔽新闻资讯 过滤新闻类关键词内容
自动拉黑触犯者 自动将触发屏蔽词的用户加入黑名单
隐藏轮播图 隐藏首页大轮播图
隐藏左侧推广 隐藏左侧浮动入口
隐藏底部卡片 隐藏底部推广卡片
推荐流净化 过滤首页推荐中的低质内容
评论区净化 过滤垃圾广告评论
拦截广告组件 移除页面中的广告占位符
屏蔽默认头像 过滤使用默认头像的营销号

解锁功能 (Unlock)

功能 说明
解锁 1080P+ 未登录状态下解锁高清画质
防音画不同步 切换画质时防止音视频不同步
偏好画质 可选 1080P / 720P / 480P
未登录看评论 无需登录即可查看完整评论区
显示粉丝勋章 在评论区显示用户的粉丝牌
显示笔记前缀 带图片的评论显示「笔记」标识

安装指南 (Installation)

  1. 安装脚本管理器:Tampermonkey (推荐) 或 Violentmonkey。
  2. 点击脚本安装链接(或将源码复制到新建脚本中)。
  3. 打开 Bilibili 任意页面,屏幕右下角将出现一枚 旋转的硬币
  4. 点击硬币打开控制面板,根据需求勾选相应功能开关。

云端规则同步 (Misaka Network Sync)

脚本接入御坂网络,支持云端屏蔽词库实时同步。

同步机制

  • 自动同步:每 24 小时自动检查并拉取最新规则
  • 手动同步:在控制面板点击「立即更新云端词库」按钮
  • 覆盖策略:云端数据会完全覆盖本地缓存,确保规则库始终最新

规则优先级

白名单 > 黑名单 > 本地预设词

即使内容命中黑名单,如果同时存在于白名单中,也不会被过滤。

本地预设词

以下关键词为脚本内置,不受云端规则影响:

免费教程、实操变现、日入、加我、v信、淘宝、兼职

支持范围 (Supported Pages)

匹配域名

  • www.bilibili.com - 主站视频
  • t.bilibili.com - 动态页面
  • space.bilibili.com - 用户空间
  • manga.bilibili.com - 漫画站

评论解锁支持

  • 视频页 (/video/BV.../video/av...)
  • 番剧页 (/bangumi/play/...)
  • 动态页 (t.bilibili.com/...)
  • 专栏页 (/read/cv...)

常见问题 (FAQ)

Q: 评论加载失败怎么办?

A: 可能是 B 站 API 变更或网络波动,请尝试: 1. 刷新页面重试 2. 手动更新云端词库 3. 检查浏览器控制台是否有报错信息 4. 确认是否有其他脚本产生冲突

Q: 控制面板/悬浮球消失了?

A: 点击浏览器扩展栏中的 Tampermonkey 图标,找到本脚本,点击「强制重置 UI」菜单项。

Q: 自动拉黑功能不生效?

A: 自动拉黑功能需要登录状态下才能执行,因为需要获取 CSRF Token 来调用 B 站 API。

Q: 如何贡献屏蔽词?

A: 请联系作者提交你的屏蔽词建议。云端规则更新后,所有用户将在下次同步时自动获取。


致谢 (Credits)

本项目是基于开源社区优秀作品的深度融合与二次开发。特别感谢以下脚本的原作者,是你们的代码奠定了本项目的基石:

  • Bilibili - 在未登录的情况下自动并无限试用最高画质
  • 作者:DD1969
  • 贡献:提供了核心的画质解锁逻辑与播放器参数注入方案。

  • Bilibili - 在未登录的情况下照常加载评论

  • 作者:DD1969
  • 贡献:提供了精妙的 WBI 签名算法与 API 请求拦截方案,实现了评论区的完美复原。

在此向以上开发者致以最诚挚的谢意。


隐私与安全 (Privacy)

  • 本地运行:本脚本所有逻辑均在浏览器本地执行,不会收集用户的任何个人信息。
  • 网络请求:脚本仅会向以下地址发起请求:
  • api.bilibili.com:用于获取评论数据和执行拉黑操作(直接与 B 站服务器通信)。
  • arkn.icu:用于同步云端屏蔽词库(仅读取 JSON 文件)。
  • 开源透明:代码完全开源且未压缩,欢迎随时审查代码逻辑。

免责声明 (Disclaimer)

本项目仅供技术研究与学习交流使用。

使用者因违反 Bilibili 平台规则而产生的任何后果(包括但不限于账号封禁),由使用者自行承担。

请在下载后 24 小时内删除,如果您喜欢 Bilibili,请购买大会员支持正版。


Only my Railgun can shoot it.

Core symbols most depended-on inside this repo

Shape

Method 139
Class 25
Function 24

Languages

TypeScript100%

Modules by API surface

Bilibili-Shield-Beta-1.3.1.user.js166 symbols
script.js22 symbols

For agents

$ claude mcp add Bilibili-Shield \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page