An open API service indexing awesome lists of open source software.

https://github.com/HSSkyBoy/BBZQ

由 Kotlin 全量编写的哔哩哔哩增强 Xposed 模组
https://github.com/HSSkyBoy/BBZQ

Last synced: 5 days ago
JSON representation

由 Kotlin 全量编写的哔哩哔哩增强 Xposed 模组

Awesome Lists containing this project

README

          

# BBZQ
> 使用 `libxposed API 102`、由 Kotlin 全量编写的哔哩哔哩增强 Xposed 模组

![Kotlin](https://img.shields.io/badge/Kotlin-2.4.10-7F52FF?logo=kotlin&logoColor=white)
![API](https://img.shields.io/badge/libxposed-API%20102-orange)
![License](https://img.shields.io/badge/license-Mulan%20PubL%20v2-blue)

---

## 简介
BBZQ 是一款适配 libxposed API 102 的哔哩哔哩功能增强模组,采用 Kotlin 完整实作,旨在去除不必要内容、优化核心体验,同时提供各类实用功能。
模组通过 `META-INF/xposed/java_init.list` 完成入口注册,核心逻辑入口为 `io.github.bbzq.BbzqModule`;配套设置页面内嵌于哔哩哔哩宿主应用外,方便快捷开关各项功能、调整个性化参数,整体架构便于后续迭代维护与功能扩展。

---

## 版本适配说明

| 模块版本 | 哔哩哔哩版本 |
| ------- | ------ |
| v1.0.1 | 8.97.0 |
| v1.0.2 | 8.98.0 |
| v1.0.3 | 8.99.0 |
| v1.1.0+ | 9.0.0+ |

> 说明:
> v1.0.3 的 CI 构建版本推荐 9.0.0。
> 从 v1.1.0 开始,模组将仅适配 9.0.0 及以上版本 (包括概率)。

---

## 使用方式

1. 安装模组 APK
2. 在支持 `libxposed API 102` 的 Xposed 框架中启用該模组
3. 将哔哩哔哩加入作用域
4. 重启目标应用
5. 进入 `我的 → 设置 → 高级设置`
6. 启用需要的功能

> [!WARNING]
> **避坑提示:** 请勿使用 Hide My Applist (HMA) 等应用隐藏模组去对「哔哩哔哩」或「BBZQ」启用隐藏列表,否则会导致功能失效或应用崩溃。
> 參考 https://github.com/HSSkyBoy/BBZQ/issues/5 和 https://github.com/HSSkyBoy/BBZQ/issues/17

> 桌面图标是模组自身介绍页,不是独立的调试工具。
> 双击 版本 有隐藏的秘密。

---

## 功能

### 分享与链接

- **净化分享链接** - 将 `b23.tv` / `bili2233.cn` 短链还原为普通链接,并保留 `p`、`t` 等定位参数。
- **普通链接分享** - 关闭小程序式分享(QQ / 微信),复制分享链接时尽量转换为 av 号形式。

### 复制增强

- **去除长按复制** - 禁用应用内各场景里长按后直接复制到剪贴板的行为,减少误触。
- **长按自由复制** - 需先开启「去除长按复制」;拦截到复制动作时弹出可自由选择文本的窗口。

### 下载功能

- **自定义下载线程** - 在下载设置里显示「自定义下载线程」,并可单独调整同时缓存数。
- **自定义同时缓存数** - 支持自定义同时缓存的数量。

### 启动净化

- **跳过开屏广告** - 清理启动时的开屏广告响应,减少进入目标应用时的等待。
- **关闭青少年模式弹窗** - 检测到青少年模式提醒弹窗时自动关闭。
- **禁止 App 检查更新** - 拦截应用内更新检查,避免弹出版本更新提示。

### 首页净化

- **移除首页推荐广告** - 过滤推荐流中的大横幅、信息流广告及广告推广视频。
- **移除首页推荐图文** - 过滤推荐流中的图文动态卡片。
- **移除首页推荐游戏推广** - 过滤推荐流中的游戏推广卡片。
- **默认以详情页打开竖屏视频** - 首页推荐中的竖屏视频点开后默认进入详情页。
- **首页推荐预加载** - 扩大原生预取距离,减少滑到底部时的等待。
- **首页卡片过滤** - 按类型多选过滤首页推荐卡片,可选类型:广告、图文、游戏推广、直播、课堂、竖屏视频、大屏视频。
- **标题关键词屏蔽** - 配置关键词列表,标题匹配的推荐卡片将被过滤。
- **首页 Tab 过滤** - 根据扫描到的首页 Tab 列表,屏蔽不需要的 Tab 入口。
- **移除首页游戏图标** - 隐藏首页顶部游戏入口图标。
- **移除首页推荐搜索词** - 清空首页搜索框内的推荐搜索词。
- **隐藏整个首页内容** - 将首页容器下的子页面内容隐藏。
- **按组件自定义隐藏** - 根据检测到的首页组件,选择性保留或隐藏特定内容区域。

### 动态页净化

- **首选打开视频标签** - 在动态页优先自动切换到视频标签。
- **移除同城标签** - 隐藏动态页里的同城入口。
- **移除校园标签** - 隐藏动态页里的校园入口。

### 播放净化

- **屏蔽视频页广告** - 阻止视频详情页播放器下方横幅、推荐列表、应用下载、好物推荐广告创建。
- **屏蔽播放互动组件** - 移除播放器里的投票、预约、打卡、关注引导、商业活动卡、广告浮层和商业跳转按钮。
- **跳过视频激励广告** - 自动尝试完成视频激励页(RewardAdActivity)。
- **自动点赞视频** - 进入视频详情页时自动点击点赞按钮。
- **透明播放器状态栏** - 让视频详情页延伸到状态栏区域并将状态栏背景设为透明;部分系统仍会保留状态栏图标。
- **屏蔽播放器竖屏控件** - 隐藏播放器控制层中的“竖屏”切换按钮。

### 空降助手

基于 [BilibiliSponsorBlock](https://github.com/hanydd/BilibiliSponsorBlock) 社区数据库,在视频播放时按片段时间轴自动跳过选定分类的内容。功能默认关闭,入口默认隐藏

支持的跳过分类:

| 分类 | 说明 |
|------|------|
| `sponsor` | 赞助商广告,付费推广、推荐和直接广告 |
| `selfpromo` | 自我推广,UP 主引流、关注提醒、推广其他内容 |
| `interaction` | 互动提醒,点赞、投币、评论等互动号召 |
| `intro` | 片头,与正文关系不大的固定开场 |
| `outro` | 片尾,结束卡、鸣谢和结尾引导 |
| `preview` | 预览回顾,下集预告、前情提要和重复回顾 |
| `music_offtopic` | 离题音乐,与内容无关的纯音乐或演奏片段 |
| `poi_highlight` | 精彩片段高光,值得直接空降或重点标记的内容 |
| `filler` | 填充内容,与主线关系较弱的灌水片段 |
| `exclusive_access` | 独家访问抢先体验,用于整段视频标签 |

片段数据按视频 BV 号的 SHA-256 前缀向 `bsbsb.top` API 查询,结果缓存 5 分钟,仅匹配当前分 P 的 cid。

### 竖屏视频净化

- **净化竖屏视频广告** - 按标签过滤竖屏视频流中的广告、直播、购物和推广内容,并统计累计拦截条数。

可选过滤标签:广告、直播、短剧、购物、电视剧、纪录片、娱乐、电影、音乐、话题

### 视频评论区

- **完全隐藏评论区** - 从视频详情页移除评论区标签。
- **阻止点击快速回复** - 点击评论文字时不再自动弹出回复输入框。
- **移除评论区投票** - 过滤评论区中的顶踩票选与站队组件。
- **移除评论区关注按钮** - 移除评论右侧的关注他人按钮。
- **移除评论区关键词高亮搜索** - 禁用评论文字中的关键词点击搜索跳转。
- **屏蔽空评论区引导** - 当暂无评论时不显示一键发送评论的引导提示。
- **移除评论区反馈弹窗** - 屏蔽评论区体验反馈和问卷弹窗。
- **移除评论区运营推广** - 隐藏评论区顶部的运营活动和推广横幅。

### 我的页面定制

- **隐藏大会员入口** - 移除“我的”页面中的大会员卡片展示。
- **保留大会员占位空间** - 隐藏大会员入口时保留其占位空间,避免页面跳动。
- **完整数字显示** - 在"我的"和空间页显示完整的播放与统计数字,禁用单位缩写。

---

## 构建

**环境要求**

| 项目 | 版本 |
|------|--------|
| JDK | 21 |
| Android Gradle Plugin | 9.2.1 |
| Kotlin | 2.4.10 |
| Gradle Wrapper | 9.4.1 |

**Debug 构建**

```bash
./gradlew assembleDebug
```

**Release 构建**

```bash
./gradlew assembleRelease
```

### 预期限制

- 不再适配旧国际版(白色图示版),不再适配 9.0.0 以前版本
- 设置入口依赖宿主设置页结构,大版本更新后可能不会及时适配
- 暂不计划支持地区解锁功能

---

## 许可证

本项目使用木兰公共许可证,第 2 版(Mulan PubL v2)。
完整授权见 [LICENSE](https://license.coscl.org.cn/MulanPubL-2.0)。