NextPili

用 Rust 持有协议与凭据、用 Flutter 做桌面壳，经 flutter_rust_bridge 2.12 贯通的 B 站第三方客户端骨架。

Important: 本仓库为 审阅专用 / 非开源。允许本地克隆阅读；禁止未授权的生产使用、再分发与商业利用。完整条款见 LICENSE。

NextPili 是桌面优先（Linux / Windows / macOS）的 B 站客户端工程，并已接入 Android 壳（手机/平板断点与底栏见 docs/ux/multi-platform.md）。业务与签名在 Rust；UI 只做展示与交互。domain 无 IO；凭据不得进入 Flutter 持久化层。

Flutter (app/)  --FRB-->  core  --> domain
                              |--> auth / http / store / media

请求从 Flutter 经 core 进入业务 crate；网络、鉴权与凭据读写都在 Rust。

权威入口：Documentation。实现契约与进度只在 docs/ 定义；本页不复制全文。

NextPili/
├── crates/
│   ├── core/      # FFI + 用例编排
│   ├── domain/    # 纯领域（无 IO）
│   ├── auth/      # 账号 / Cookie / WBI / AppSign
│   ├── http/      # B 站 HTTP 客户端
│   ├── store/     # 本地持久化
│   └── media/     # 播放源规范化
├── app/           # Flutter 桌面壳
├── docs/          # Essentials / Guides / HIG / Reference
└── scripts/       # 测试与 FRB codegen

用 crates/* 按职责切边界；改 crates/core/src/api 后跑 scripts/codegen.sh。

启用桌面目标：

flutter config --enable-linux-desktop
# windows / macos 同理

把 Flutter 目标打开到 Linux / Windows / macOS，再在 app/ 下运行。

Linux 桌面穿透 / blur： 壳层透明后，live blur 依赖合成器协议 ext-background-effect-v1（runner：desktop_compositor_blur.cc）。GNOME/Mutter 预计 ≥51 才支持；50.x 上只有透明、无模糊是预期行为。KWin（Plasma 6.7+）、Hyprland、Niri 等已实现该协议的环境可测 live blur。自检：wayland-info | grep background_effect。

安装 FRB 代码生成器：

cargo install flutter_rust_bridge_codegen --version 2.12.0 --locked

运行 Rust 工作区测试：

cargo test --workspace
# 或
./scripts/test-rust.sh

修改 crates/core/src/api 后重新生成 FRB 绑定：

./scripts/codegen.sh

启动 Flutter 桌面壳（以 Linux 为例）：

cd app
flutter pub get
flutter run -d linux

Android（真机 / 模拟器，需 Android SDK + NDK + Rust Android targets）：

# 一次性：Rust Android 目标
rustup target add aarch64-linux-android armv7-linux-androideabi \
  x86_64-linux-android i686-linux-android

# 若主机 JDK ≥ 25，请为 Gradle 指定 JDK 17/21（AGP 8.11 + Kotlin DSL）
# 例如写入 ~/.gradle/gradle.properties：
# org.gradle.java.home=/path/to/jdk-21

cd app
flutter pub get
flutter run -d <device-id>   # flutter devices 查看

应用 ID：nextpili.rownix.dev。

P0–P5 已完成；P6 进行中（写操作部分 + 动态 + 直播 REST + 番剧可播已交付；直播弹幕 WS / 多账号待办）。切片与验收以 Roadmap 为准。

已打通（摘要）：

• Workspace 与 crate 边界：domain / auth / store / http / media / core
• FRB：ping · api_version · bootstrap · 登录/账号 / feed / video / play_url / settings / search / library
• 账号持久化（accounts.json，无 Cookie 粘贴导入）与 buvid3（device.json）
• WBI / AppSign 与 HTTP 管线（Cookie / CSRF / 签名）
• 短信登录与桌面/平板 TV 扫码；推荐/热门/详情；playurl → media_kit 播放与清晰度
• 评论 + 弹幕 Overlay（REST）；搜索；历史 / 稍后再看 / 收藏只读
• 设置：preferred_qn / 代理（Rust store，热更新 HTTP 客户端）

本作品 不是 OSI 开源软件。Cargo 元数据为 UNLICENSED。

完整条款见 LICENSE。

• Documentation Home
• Architecture
• Roadmap
• LICENSE