# Technical Documentation: hanydd/BilibiliSponsorBlock
> ℹ️ **Provenance:** Hybrid Fusion: `hanydd/BilibiliSponsorBlock` (README + 1 In-Tree Chapters) · [CodeWiki Reference](https://codewiki.google/github.com/hanydd/BilibiliSponsorBlock) · Recency: Active (< 180 days)
## 1. Project Overview & Quickstart (hanydd/BilibiliSponsorBlock)
小电视空降助手
受够了视频中无处不在的赞助广告了吗？受够了看了一半才发现的软广视频了吗？小电视空降助手是一款帮你精准空降到广告之后的浏览器插件。插件自动获取并跳过广告片段，让你的视频体验毫无中断！
除了广告之外，插件还支持跳过其他类别的片段，例如开场结尾的动画、一键三连提示，或者直接空降到视频封面的位置。插件中所有的标注片段都来自网友标注，您也可以提交自己的片段来为空降指挥部添砖加瓦。
想知道大佬们提交了多少片段？在[排行榜](https://www.bsbsb.top/stats/)看看吧。
目前本项目由我个人在业余时间维护，如果你想支持我，欢迎查看[赞助](https://www.bsbsb.top/donate/)。
本插件移植自插件[SponsorBlock](https://github.com/ajayyy/SponsorBlock)，保留了大部分的 UI 和使用方法，加入了一些小电视特色的功能。
# 安装
- 目前上架了[Chrome 应用商店](https://chromewebstore.google.com/detail/eaoelafamejbnggahofapllmfhlhajdd)，[火狐应用商店](https://addons.mozilla.org/en-US/firefox/addon/bilisponsorblock/)。如果你知道更多流行的浏览器插件商店，欢迎留言~
- 如果你无法打开上面的商店，可以尝试从 [GitHub Release](https://github.com/hanydd/BilibiliSponsorBlock/releases/latest) 页面获取未打包的插件。
1. 根据您浏览器的类型下载适合的版本，Chrome、Edge、360 和基于 Chromium 的国产浏览器下载 `ChromiumExtension.zip`；火狐浏览器下载`FirefoxExtension.zip`。并解压缩。
1. 打开浏览器的插件管理页面，启用“开发者模式”，点击`加载已解压的扩展程序`，选择刚刚下载解压的插件文件夹，就可以完成安装。
## macOS Safari 安装（源码构建）
Safari 版本通过 Safari Web Extension 打包。项目已提供一键脚本：
```bash
# 先准备配置文件和依赖
cp config.json.example config.json
npm ci
# 构建 Safari 扩展并生成 macOS Xcode 工程
npm run build:safari:macos
```
默认会在项目根目录生成 `safari/` Xcode 工程。然后：
1. 使用 Xcode 打开 `safari/` 工程并编译运行。
1. 打开 Safari -> 设置 -> 扩展，启用对应扩展。
可选环境变量（用于自定义工程信息）：
```bash
BSB_SAFARI_APP_NAME="小电视空降助手" \
BSB_SAFARI_BUNDLE_ID="top.bsbsb.safari" \
BSB_SAFARI_PROJECT_DIR="safari" \
npm run build:safari:macos
```
# 功能
## 使用说明
如果你使用过原插件，你会发现在核心功能和交互上，本插件基本没有做出大的改动。可以先参照原插件的使用方法尝试使用。
可以先在这个[示例视频](https://www.bilibili.com/video/BV1bY4y1v7Mb/)上试一试精准空降的快乐！
视频使用说明正在计划制作中。
## 相比[原插件](https://github.com/ajayyy/SponsorBlock)变化
- 放弃了多语言支持，只支持简体和繁体中文。
- 放弃了移动端H5网页支持。
- 放弃了第三方镜像站支持。如果有使用人数多的镜像站，欢迎讨论添加支持。
- 加入了绑定搬运视频的功能。绑定的视频可以自动从 SponsorBlock 数据库中获取片段信息。
- 更新 UI。
## 功能更新计划
参考 [Github Project](https://github.com/users/hanydd/projects/2/)
# 服务端及数据
为了方便大家二次开发，所有片段的数据现在开放下载：https://download.bsbsb.top/database.zip
# API
API文档：https://github.com/hanydd/BilibiliSponsorBlock/wiki/API
测试视频 [BV14741127BN](https://www.bilibili.com/video/BV14741127BN)
本项目对 API 改动不大，也可以先参考[原项目文档](https://wiki.sponsor.ajay.app/w/API_Docs)。
# 搭建项目
详见 [CONTRIBUTING.md](CONTRIBUTING.md)
# 致谢
感谢[ajayyy](https://github.com/ajayyy)创造的[SponsorBlock](https://github.com/ajayyy/SponsorBlock)给我的启发！
### 开源协议
本项目遵循 GNU GPL v3 开源协议。
## 2. In-Tree Documentation Chapters (hanydd/BilibiliSponsorBlock)
小电视空降助手
受够了视频中无处不在的赞助广告了吗？受够了看了一半才发现的软广视频了吗？小电视空降助手是一款帮你精准空降到广告之后的浏览器插件。插件自动获取并跳过广告片段，让你的视频体验毫无中断！
除了广告之外，插件还支持跳过其他类别的片段，例如开场结尾的动画、一键三连提示，或者直接空降到视频封面的位置。插件中所有的标注片段都来自网友标注，您也可以提交自己的片段来为空降指挥部添砖加瓦。
想知道大佬们提交了多少片段？在[排行榜](https://www.bsbsb.top/stats/)看看吧。
目前本项目由我个人在业余时间维护，如果你想支持我，欢迎查看[赞助](https://www.bsbsb.top/donate/)。
本插件移植自插件[SponsorBlock](https://github.com/ajayyy/SponsorBlock)，保留了大部分的 UI 和使用方法，加入了一些小电视特色的功能。
# 安装
- 目前上架了[Chrome 应用商店](https://chromewebstore.google.com/detail/eaoelafamejbnggahofapllmfhlhajdd)，[火狐应用商店](https://addons.mozilla.org/en-US/firefox/addon/bilisponsorblock/)。如果你知道更多流行的浏览器插件商店，欢迎留言~
- 如果你无法打开上面的商店，可以尝试从 [GitHub Release](https://github.com/hanydd/BilibiliSponsorBlock/releases/latest) 页面获取未打包的插件。
1. 根据您浏览器的类型下载适合的版本，Chrome、Edge、360 和基于 Chromium 的国产浏览器下载 `ChromiumExtension.zip`；火狐浏览器下载`FirefoxExtension.zip`。并解压缩。
1. 打开浏览器的插件管理页面，启用“开发者模式”，点击`加载已解压的扩展程序`，选择刚刚下载解压的插件文件夹，就可以完成安装。
## macOS Safari 安装（源码构建）
Safari 版本通过 Safari Web Extension 打包。项目已提供一键脚本：
```bash
# 先准备配置文件和依赖
cp config.json.example config.json
npm ci
# 构建 Safari 扩展并生成 macOS Xcode 工程
npm run build:safari:macos
```
默认会在项目根目录生成 `safari/` Xcode 工程。然后：
1. 使用 Xcode 打开 `safari/` 工程并编译运行。
1. 打开 Safari -> 设置 -> 扩展，启用对应扩展。
可选环境变量（用于自定义工程信息）：
```bash
BSB_SAFARI_APP_NAME="小电视空降助手" \
BSB_SAFARI_BUNDLE_ID="top.bsbsb.safari" \
BSB_SAFARI_PROJECT_DIR="safari" \
npm run build:safari:macos
```
# 功能
## 使用说明
如果你使用过原插件，你会发现在核心功能和交互上，本插件基本没有做出大的改动。可以先参照原插件的使用方法尝试使用。
可以先在这个[示例视频](https://www.bilibili.com/video/BV1bY4y1v7Mb/)上试一试精准空降的快乐！
视频使用说明正在计划制作中。
## 相比[原插件](https://github.com/ajayyy/SponsorBlock)变化
- 放弃了多语言支持，只支持简体和繁体中文。
- 放弃了移动端H5网页支持。
- 放弃了第三方镜像站支持。如果有使用人数多的镜像站，欢迎讨论添加支持。
- 加入了绑定搬运视频的功能。绑定的视频可以自动从 SponsorBlock 数据库中获取片段信息。
- 更新 UI。
## 功能更新计划
参考 [Github Project](https://github.com/users/hanydd/projects/2/)
# 服务端及数据
为了方便大家二次开发，所有片段的数据现在开放下载：https://download.bsbsb.top/database.zip
# API
API文档：https://github.com/hanydd/BilibiliSponsorBlock/wiki/API
测试视频 [BV14741127BN](https://www.bilibili.com/video/BV14741127BN)
本项目对 API 改动不大，也可以先参考[原项目文档](https://wiki.sponsor.ajay.app/w/API_Docs)。
# 搭建项目
详见 [CONTRIBUTING.md](CONTRIBUTING.md)
# 致谢
感谢[ajayyy](https://github.com/ajayyy)创造的[SponsorBlock](https://github.com/ajayyy/SponsorBlock)给我的启发！
### 开源协议
本项目遵循 GNU GPL v3 开源协议。
--- METRICS ---
- Files Extracted: 2
- Estimated Token Budget: ~1201 tokens
- Recency Window: Active (< 180 days)
- Canonical Reference: https://codewiki.google/github.com/hanydd/BilibiliSponsorBlock