BiliSail 哔帆应用图标

BiliSail · 哔帆

专注观看体验的跨平台 Bilibili 第三方客户端
基于 Flutter 与 Dart，面向 Windows、Android、macOS、iOS 和 Linux

BiliSail（哔帆）以视频、影视和直播观看为核心，提供双／多标签浏览、原生播放、弹幕、云端观看历史与本地续播，以及下载队列和离线播放。晴湾界面采用桌面分组侧栏与窄屏四项底部导航，结合自适应网格、视频卡片悬停预览、播放详情分栏和可配置快捷键。

使用声明

本应用是哔哩哔哩第三方客户端，视频、影视、直播及相关内容均来自哔哩哔哩，与官方无隶属关系。

本程序仅供学习交流与编程技术研究使用。

如果侵犯了您的合法权益，请及时联系开发者，我们会第一时间处理并删除相关内容。可通过项目问题反馈联系我们。

功能概览

模块	当前能力
内容浏览	推荐、分区；热门内含综合热门、可选期数的每周必看、入站必刷和排行榜；动态、视频动态、番剧、国创、放映厅和直播；自适应卡片网格、自动分页与列表位置保留
视频卡片	悬停封面放大与静音视频预览、添加稍后再看、操作菜单；推荐反馈保留原卡片位置并支持撤销
搜索	综合、视频、番剧、影视、直播、专栏和用户七类搜索，支持对应排序、筛选与自动分页
视频与影视	DASH 音视频分轨播放，分 P、合集与选集、合集订阅、稍后再看队列；清晰度、编码与 CDN 偏好、倍速、音量、全屏、章节与进度条缩略图
直播	HLS / FLV、可用清晰度、实时聊天与表情、画面弹幕、Super Chat 展示、用户主页跳转及弹幕发送入口
弹幕与字幕	滚动、顶部、底部弹幕，暂停与缓冲冻结、seek 重定位；样式、密度与本地过滤配置，字幕 cue 显示
账号与个人空间	扫码登录、内嵌官方网页密码／短信登录、系统安全存储；用户主页、关注分组、收藏夹查看与编辑、追番、追剧、稍后再看及消息／私信
评论与动态互动	最热／最新评论、楼中楼、表情与图片、作者装扮、服务端提供的 IP 属地、正文链接与时间点跳转；视频点赞／投币／收藏，动态点赞、评论、复制链接与转发
导航与界面	单／双／多标签模式与 Android 默认单标签、Windows／macOS 双标签独立播放窗口及媒体返回历史、Android 应用内双标签、多标签可选并发播放、桌面侧栏与窄屏首页／动态／我的／设置、我的页历史／稍后再看／收藏／下载内容标签、分类横向滚轮、紧凑播放布局、桌面平滑滚动、键盘与鼠标侧键配置、图片缓存
历史与续播	当前账号云端观看历史分页；登录点播上报云端进度，记住进度开启时本地优先、云端补充；新点播继承本次运行中最近选择的倍速
下载与离线	分 P／剧集多选、画质与编码、队列暂停/继续/重试、断点和重启恢复、文件校验；本地音视频分轨、弹幕与字幕播放
个性化	明暗主题、内置／系统字体、播放、弹幕、字幕和下载设置；手动及每日首次启动更新检查；可选空降助手，默认关闭

应用默认不添加自动遥测。空降助手启用后会查询独立第三方服务，不携带 Bilibili 账号凭据，也不自动上报。

平台与开发状态

平台	目标架构 / 系统	仓库记录的验证状态
Windows	x64 / Windows 10 1809 及以上	本地与 CI 构建、MSIX 打包／测试签名通过；游客视频／影视／直播、受控多标签并发和离线分轨播放已有原生验证，本机已有 MSIX 安装运行记录；新版安装、卸载和升级待完整回归
Android	arm64 / Android 7.0（API 24）及以上	本地与 CI 构建 APK 通过，固定 release 签名与单 arm64 ABI 校验通过；真机运行、播放、离线下载和覆盖升级待验
macOS	arm64、Intel x64 / macOS 13.0 及以上	CI 的 arm64 构建、架构校验和 DMG 打包通过；已加入 Intel x64 构建配置，首次远端构建待验；设备启动、原生播放、安装及 Gatekeeper 验收待验
iOS	arm64 / iOS 15.0 及以上	已接入工程及 CI 未签名 IPA；首次远端构建、签名安装、账号与播放实机验收待完成
Linux	x64 / AppImage 基线 Ubuntu 24.04；Flatpak Freedesktop 25.08	已接入 GTK 工程及 CI Flatpak／AppImage；首次远端构建及桌面运行待验；使用 X11／XWayland、扫码登录，详见平台扩展记录

下载与安装

安装包入口：最新正式版 · 全部版本（含预发布）。

下表由 Release 发布后自动读取附件并更新，无需手动修改版本号，安装包保留原有文件名。预发布版、各安装包的 SHA-256 校验文件与构建信息见 Releases。实际可下载平台以该版本附件为准；也可按源码运行说明自行构建。

下载版本：v1.2.4+1。

平台	最新正式版下载	安装说明
Windows x64	EXE / MSI / MSIX / 证书 CER	使用msix安装时，需要先信任对应证书；具体步骤见 MSIX 签名与安装
Android arm64	APK	固定 release 密钥，跨签名切换与覆盖升级说明见 Android 签名
macOS arm64 / Intel x64	Apple Silicon DMG / Intel x64 DMG	按芯片选择对应包；打开后将 `BiliSail.app` 拖到 `Applications`；当前配置使用 ad-hoc 签名，安装后启动需要`设置-隐私与安全性-允许BiliSail运行`
iOS arm64	未签名 IPA	安装前须自行使用 Apple 证书及 provisioning profile 签名；GitHub token 仅供 CI 上传产物使用
Linux x64	Flatpak / AppImage	Flatpak 通过 `flatpak install --user 文件.flatpak` 安装；AppImage 赋予执行权限后运行。运行库、密钥环及沙盒说明见平台扩展记录

GitHub Actions 的 CI 执行根应用和四个包的检查，并按平台构建预览产物；维护者可手动运行 Release preview 创建预览 Release 草稿，再公开发布。Release 和 CI 构建包的签名种类以各自的 build-info.json 为准。触发方式、产物校验与签名配置见 CI/CD 说明。

CI 和 Release 构建的 Windows 产物同时包含 .msix、.msi 和 .exe 安装包，均附 SHA-256；MSI 与 EXE 使用同一安装链，任选一种安装。MSI 向导提供安装目录页，EXE 可通过 Options → Browse 选择目录，后续升级默认沿用原目录，详见 Windows MSI 与 EXE。已发布版本的文件不会因工作流修改而自动补齐。

从源码运行

环境要求

项目固定使用 Flutter 3.47.6 stable / Dart 3.13.5。直接依赖采用精确版本，根应用和各包均保留锁文件。

Windows 开发还需安装 Visual Studio 2022 的“使用 C++ 的桌面开发”工作负载及 Windows SDK，并将 NuGet CLI 加入 PATH（内嵌网页插件构建使用）。Windows 密码／短信登录需要 WebView2 Runtime；来源与平台边界见登录验证。Android 和 macOS 的构建需各自的工具链，macOS 构建需在 macOS 主机上执行。

Windows 调试

下载合并组件需先从固定源码准备原生资产；Windows 额外需要 MSYS2 UCRT64 GCC/G++ 和 make。Android 使用固定 NDK 28.2.13676358，macOS 使用 Xcode 工具链。三端准备命令见 bili_mux 构建说明。

在 PowerShell 中执行：

git clone https://github.com/CKopoer/BiliSail.git
cd BiliSail
flutter pub get
.\tool\build-download-mux.ps1 -Target windows-x64
flutter run -d windows

Windows Release 构建

.\tool\build-download-mux.ps1 -Target windows-x64
flutter build windows --release
.\build\windows\x64\runner\Release\bilisail.exe

移动或分发便携构建时，需保留整个 Release 目录，包括原生 DLL 和 data。播放器原生库由插件从固定来源下载，首次构建需能访问 GitHub。运行应用无需另行安装 FFmpeg；测试媒体的生成才使用本机 FFmpeg。

使用说明

设置“关于”提供项目 GitHub 地址和“检查更新”。每天首次打开应用时会自动检查已发布版本（包含预览版）；发现新版本后弹窗提示，点击“前往 Release”可查看说明并下载。自动检查失败时保持安静，可随时手动重试；应用不会自动下载或安装更新。

桌面工作区支持固定根页面，以及搜索、视频、影视、直播播放、用户和历史等标签。根标签固定，最多打开 16 个标签；标签状态保留至本次运行结束。每个播放标签拥有独立播放器，切换到普通页面时媒体继续播放；是否允许不同播放标签同时播放由下方设置控制。关闭播放标签只停止并释放该标签的播放器。

页面导航提供单／双／多标签，Android 默认单标签，其他平台默认双标签；已保存的有效选择保持，旧单标签偏好可直接恢复。单标签按实际访问顺序返回，从视频进入 UP 主空间后返回原播放页并保留会话、进度与分 P；最后一次出栈释放页面和会话，详见单标签记录。Windows 和 macOS 双标签的所有媒体共用一个独立播放窗，标题栏返回可回到上一媒体，媒体历史为空时关闭播放窗；系统关闭按钮直接关闭播放窗并回到浏览。在本次应用运行期间，关闭播放窗后再打开媒体会恢复正常窗口的位置、尺寸和最大化状态；点击还原仍回到此前的普通窗口大小。退出应用后清除这份记忆。双标签浏览返回会关闭离开的搜索、用户等临时页；Android 双标签在应用内切换浏览与播放，保留页面状态和媒体返回历史。macOS 从无原生主控制器的 engine 启动，再创建主浏览窗和播放窗，原因与验证边界见播放崩溃修复。

首页、动态、直播、我的、消息、下载、设置属于同一固定根标签，一级切换不另开标签，各自保留列表与筛选。“我的”以紧凑资料区展示等级、经验、硬币及关注/粉丝/动态，直接分标签显示历史、稍后再看、收藏和下载；桌面直播直接显示推荐直播、我的关注、观看记录。首页、动态和直播保留头像与搜索，头像仍打开账号抽屉；动态首次进入默认视频动态，之后保留本次选择。设置只保留分类与设置内容。

常用快捷键

操作	默认快捷键
播放 / 暂停	`Space`
前进 / 后退	`→` / `←`，默认 3 秒
临时加速	长按 `→`，默认 3 倍速
提高 / 降低音量	`↑` / `↓`
切换 / 退出全屏	`F`、`F11` 或 `Enter` / `Esc`
收起 / 展开视频信息	`W` 或 `F12`
开关弹幕 / 字幕	`D` 或 `F9` / `F6`
降低 / 提高倍速	`F1` 或 `;` / `F2` 或 `'`
切换 1 / 2 倍速	`Ctrl+1`
上一 / 下一分 P	`Z`、`N` 或 `,` / `X`、`M` 或 `.`
刷新当前页面	`Ctrl+R` 或 `F5`
新建 / 关闭标签	`Ctrl+T` / `Ctrl+W`
下一个 / 上一个标签	`Ctrl+Tab` / `Ctrl+Shift+Tab`

开发与文档

工程结构

lib/
├── app/                  # 组合根、路由、主题与工作区
├── core/                 # 存储、安全凭据、取消与平台能力
├── domain/               # 共享领域类型
├── features/             # 按 domain / data / application / presentation 分层
└── shared/               # 共用数据映射与 ui 组件
packages/
├── bili_api/             # 纯 Dart 协议与 API 包
├── bili_player/          # 通用播放器契约、media_kit 适配与 VideoSurface
├── bili_danmaku/         # 无网络的有界弹幕调度与绘制
└── bili_mux/             # 独立精简原生组件，仅处理本地 MP4 无损封装
docs/                     # 设计、决策与验证记录
tool/                     # 检查、原生测试与构建打包脚本

检查与调试

根应用与四个包的格式、静态分析和离线测试：

.\tool\check.ps1

Windows 原生受控媒体与安全存储测试：

.\tool\test-windows-media.ps1

显式运行游客公开 API 与媒体 CDN 烟测：

.\tool\test-windows-media.ps1 -Online

# 纯 Dart API 只读烟测
Push-Location packages\bili_api
dart run tool\live_smoke.dart
Pop-Location

正常测试使用 fake transport、repository、player 和人工生成的媒体，无需真实账号。播放诊断保存在本机应用数据目录的 logs 下，限制容量并过滤账号、请求头和媒体 URL，不自动上传；路径与排查方法见播放错误排查。

文档入口

文档	内容
文档索引	全部设计与功能验证记录
整体架构	功能分层、独立包、状态与生命周期
API 与会话	接口、鉴权、错误处理与账号隔离
播放、直播与弹幕	播放会话、媒体请求与弹幕时钟
下载与离线播放	下载队列、断点恢复、文件校验与离线播放边界
快捷键实施记录	输入作用域、页面刷新、键位录制与验证
CI/CD 与安装包	三端构建、MSIX／APK／DMG、签名与安装说明
实施与验收	开发阶段与平台验收要求
架构决策	重要技术选择及其依据
开发约定	代码、文档、测试与交付规则
第三方说明	依赖、原生二进制与资源来源

项目原名 Bili Lite，当前工程名为 bilisail。更名后的安装与数据标识以及数据空间变化见项目更名记录。

参与贡献

欢迎通过 Issues 反馈问题、提出建议，通过 Pull Requests 改进代码、文档和平台适配。

反馈问题：附上应用版本、操作系统、复现步骤、预期与实际结果；播放问题可提供公开视频 BV 号及脱敏诊断。请勿提交 Cookie、token、二维码 key 或带签名参数的媒体 URL。
提出改进：说明使用场景与预期行为。较大的功能或架构调整建议先通过 Issue 讨论。
提交修改：先阅读文档索引与 AGENTS.md，保持改动聚焦，并在 PR 中说明变更、验证结果和未测项。代码改动运行 tool/check.ps1；原生播放改动补充受影响平台的构建与实机验证。纯文档改动检查链接、路径和内容一致性即可。

贡献者

感谢所有参与代码、文档、测试和问题反馈的贡献者。

致谢

感谢以下项目及其维护者提供的参考与基础能力：

项目	与 BiliSail 的关系
biliuwp-lite（原项目） / ywmoyue 维护分支	功能、桌面布局与交互参考；部分图标资源来源见资源记录
bili-kernel	C# / .NET API 项目，为协议模型、鉴权与职责划分提供参考
PiliPlus	播放器配置、Android Surface 生命周期与弹幕优化思路参考；具体采用范围见移植记录
Flutter / Dart	跨平台界面与语言运行时
Riverpod / go_router	应用状态、依赖注入与路由
media_kit / mpv / FFmpeg	播放适配与原生媒体解码基础
Dio / Drift / flutter_secure_storage	网络、结构化存储与系统安全凭据
BilibiliSponsorBlock	可选空降助手的公开查询协议与服务
Star History / contributors-img	README 的 Star 趋势与贡献者展示

参考项目的具体采用范围见参考文档，资源、字体和原生组件的来源及许可范围见第三方说明。

感谢 Linux DO 社区的支持

Star 趋势

如果 BiliSail 对你有帮助，欢迎点亮 Star，支持项目持续完善。

许可与第三方资源

本项目尚未确定开源许可证。第三方依赖与素材保留各自许可和权利范围，公开源码不代表所有资源均已取得再分发授权。

部分参考图标目前仅记录了本机预览的采用范围，对外发行前仍需核实；原生播放器及其子依赖的许可材料也需单独归档。详见第三方来源与分发检查及资源来源。