BiliPai

原生、纯净、可扩展的第三方 Bilibili Android 客户端

_{面向日常使用的现代 Android 客户端：视频、番剧、直播、动态、下载、插件与大屏体验。}

简体中文 · English

_{README 更新：2026-07-31 · 当前构建版本以 app/build.gradle.kts 为准 · 已发布版本以 CHANGELOG.md 为准}

BiliPai 是一个基于 Kotlin 与 Jetpack Compose 的第三方 Bilibili Android 客户端，覆盖视频、番剧、直播、动态、消息、离线缓存等日常使用流程，并支持插件扩展与平板/折叠屏等大屏形态。

• 日常使用优先：首页、搜索、视频详情、番剧、直播、动态、消息、个人中心与离线缓存覆盖主流程。
• 播放体验优先：DASH、高清画质、弹幕、手势、后台播放、画中画、听视频模式与横竖屏策略持续优化。
• 原生体验优先：Material You、Material 3、Miuix、液态玻璃、平板/折叠屏布局与系统媒体控制接入。
• 可扩展优先：内置插件稳定分发，JSON 规则插件可 URL 导入，源码级插件能力持续推进。
• 隐私克制：登录信息保存在本地，权限尽量收敛，使用统计仅记录匿名日活与基础使用情况。

以下图片来自当前真机截图目录，后续 README 改版也会继续沿用这组资产。

安装 APK 时可能需要允许“安装未知来源应用”。如果遇到播放画质、登录状态或缓存问题，请先确认当前版本、网络环境和账号权限。

BiliPai 的界面围绕“内容优先、控制轻量、动效克制”调整。

• Material You / Android 原生：支持动态主题色、Material 3 与 Miuix 子风格、排版和 motion 策略。
• Liquid Glass：底栏、顶部区域、播放器面板等关键层接入毛玻璃/液态玻璃视觉。
• iOS 风格底栏：胶囊指示器、阻尼回弹、模糊背景与大屏侧边栏之间保持统一。
• 播放器覆盖层：控制栏、弹幕、预览图、手势区域和横屏信息栏分层处理，减少互相遮挡。
• 可调而非强制：外观、动画、播放器、弹幕、插件和后台行为均尽量提供设置入口。

初见推荐致谢原作者 wangdaodao 的 TabulaBili 与 tjsky 的 TabulaBili-Plus，BiliPai 仅实现 Android 端内置插件形态。

BiliPai/
├── app/                         # Android 应用壳、业务功能与绝大多数运行时代码
│   └── src/main/java/com/android/purebilibili/
│       ├── app/                 # Application、启动初始化与顶层装配
│       ├── core/                # 网络、存储、播放器、插件、主题和 UI 公共能力
│       ├── data/                # API/数据库模型与 Repository
│       ├── domain/              # 可复用 UseCase 与纯业务规则
│       ├── feature/             # 视频、首页、动态、直播、设置等业务场景
│       ├── navigation/          # 路由兼容、入口策略与顶层导航装配
│       └── navigation3/         # NavKey、返回栈、Entry/Scene 与预测返回
├── design-system/               # 三套风格共享的主题、组件、动效、模糊与适配策略
├── settings-core/               # 可复用设置策略
├── network-core/                # 可复用网络回退与推荐策略
├── plugin-sdk/                  # 推荐、播放器、弹幕插件接口与能力声明
├── baselineprofile/             # 启动、首页、设置和视频详情性能基准
├── docs/                        # Wiki、插件开发文档与截图资源
├── plugins/                     # SDK 文档、JSON/源码示例、皮肤示例与社区索引
└── scripts/                     # CI、发布、性能采集与 Baseline Profile 工具

git clone https://github.com/jay3-yy/BiliPai.git
cd BiliPai
./gradlew :app:compileDebugKotlin

本地开发使用 JDK 21；Android Studio、Android SDK 与 Gradle 环境需兼容 AGP 9.3.1 和 compileSdk 37。如需生成可安装的本地测试 APK，可运行：

./gradlew :app:assembleDev

google-services.json 是可选项：放入 app/ 后启用 Firebase Crashlytics / Analytics；缺失时构建脚本会跳过相关能力。

当前开发构建为 9.9.9.1 / versionCode 266；最新有完整发布记录的版本为 v9.9.8.9。公开发布状态与下载请以 GitHub Releases 和 CHANGELOG.md 为准：

• 构建基线升级至 AGP 9.3.1 / Gradle 9.5 / Compose BOM 2026.06.01。
• Navigation3 runtime/UI 对齐至官方 1.2.0-alpha07，继续收敛预测返回真实来源页与整卡稳定性。
• 视频详情整卡过渡新增冻结会话、稳态隐藏景深层和连续播放器返回策略，并扩展性能门槛。
• 首页顶部、底部、分段控件和详情操作区复用同源液态玻璃 chrome。
• 动态转发文本支持表情图片和原动态跳转；搜索顶栏与全屏 FILL 视口稳定性继续修复。

完整优先级、完成条件与非目标见 路线图。

欢迎提交 Issue 和 Pull Request。

1. Fork 本仓库。
2. 从主分支创建 feature/xxx 或 fix/xxx 分支。
3. 保持改动聚焦，补充必要测试或说明。
4. 提交 PR，并描述改动目的、影响范围和验证结果。

维护者会优先处理可复现的问题、清晰的功能补全、真实设备反馈和带有验证记录的修复。

BiliPai 依赖并参考了多个优秀开源项目：

如有遗漏，欢迎通过 Issue 或 PR 补充。

BiliPai 非商业授权协议 1.0

你可以自由使用、复制、修改、编译和分发本项目或其修改版本；修改后的版本可以闭源分发，无需公开源代码，也无需在作品、文档、界面或发布说明中加入致谢。

本项目及其修改版本不得用于盈利、付费分发、商业服务、广告变现或其他商业目的。如需商业使用，必须事先取得版权持有人的单独书面授权。