BiliPai

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

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

简体中文 · English · 旧版 README

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

项目定位

BiliPai 是一个用 Kotlin 与 Jetpack Compose 构建的 Android 客户端，目标不是复刻官方应用的全部入口，而是把常用观看、互动与管理流程做得更轻、更安静、更可调。

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

[!IMPORTANT] 应用默认设置面向通用场景。安装后建议进入 设置 调整外观、动画、播放、弹幕、后台播放和插件选项。

真机预览

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

下载与安装

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

核心能力

体验设计

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

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

插件生态

[!CAUTION] 导入第三方插件前请审阅规则和能力声明，尤其是 NETWORK、LOCAL_HISTORY_READ、LOCAL_FEEDBACK_READ、PLAYER_CONTROL 等敏感能力。

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

技术栈

项目结构

BiliPai/
├── app/                 # 主应用、功能 UI、播放器、导航、ViewModel、策略与测试
├── settings-core/       # 可复用设置与偏好存储逻辑
├── network-core/        # 网络策略与底层网络支持
├── baselineprofile/     # Macrobenchmark 与 Baseline Profile
├── docs/                # Wiki、开发文档、截图资源
├── plugins/             # 插件 SDK、示例、社区目录
└── scripts/             # 发布、性能和辅助脚本

构建

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

本地开发建议使用 JDK 21+ 与 Android Studio 2024.1+。如需打包 APK，可运行：

./gradlew :app:assembleDebug

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

文档入口

最近更新

当前仓库版本号已更新到 9.6.0 / versionCode 241。公开发布说明请以 CHANGELOG.md 为准；最新完整记录为 v9.6.0：

• 竖屏视频可直连 Story、滑动中预取 playurl 并提前绑流，显著缩短切换等待。
• 楼中楼分页与竖屏评论交互全面修复，拖拽关闭评论不再引起视频回弹。
• 长按 2x 进度条冻结、弹幕 seek/倍速同步、横屏内联发弹幕等问题已修复。

路线图

参与贡献

欢迎提交 Issue 和 Pull Request。

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

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

致谢

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

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

免责声明

[!CAUTION]

1. 本项目仅供学习交流，严禁用于商业用途。
2. 数据来源于 Bilibili 官方公开接口或用户登录后的正常访问能力，版权归对应权利方所有。
3. 登录信息仅保存在本地，不会主动上传隐私数据。
4. 使用本应用观看、下载或分享内容时，请遵守相关法律法规与平台规则。
5. 如涉及版权或权益问题，请联系维护者处理。

许可证

BiliPai 非商业授权协议 1.0

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

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

Star History