bili-rust CLAUDE.md

CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

What this is

Tauri 2 desktop Bilibili client. Cargo workspace with two members:

• src-tauri/ — Rust backend (Tauri host process, Bilibili API client)
• ui/ — Leptos 0.8 + WASM frontend, built by Trunk

The release profile in the workspace Cargo.toml uses lto = true, codegen-units = 1, strip = true — first release build is slow, subsequent ones are cached.

Reference

• Upstream Bilibili HTTP API docs: https://sessionhu.github.io/bilibili-API-collect/ — primary source for endpoint shapes, query params, and the WBI signing scheme. Consult this before adding a new Bili::* method.

Commands

Task	Command
Dev (hot-reload UI + backend)	cargo tauri dev
Release build (binary + bundles)	cargo tauri build
Release binary, no installers	cargo tauri build --no-bundle
Linux installers + binary tarball (deb/rpm → dist/)	./scripts/linux.sh
Cross-build Windows NSIS installer from Linux (→ dist/)	./scripts/windows.sh (needs mingw-w64-gcc + nsis)
UI alone (WASM → ui/dist/)	cd ui && trunk build --release
UI dev server only	cd ui && trunk serve --port 1420
Backend type-check	cargo check -p bili-rust (or cd src-tauri && cargo check)
Live integration smoke test	cargo test --test smoke -- --ignored --nocapture (requires valid cookies.json)
Refresh login cookies	Launch the app and visit /login — the in-app QR flow writes cookies.json

cargo tauri dev/build auto-runs the Trunk step via tauri.conf.json's beforeDevCommand/beforeBuildCommand — don't run Trunk separately unless iterating on the UI in isolation.

Prereqs: rustup target add wasm32-unknown-unknown, cargo install trunk tauri-cli@^2.

Architecture

Backend (src-tauri/src/)

• lib.rs — run() is the Tauri entry point. Loads cookies.json once at startup, builds an Arc<Bili> HTTP client, registers the bilistream:// and biliimg:// URI scheme handlers, and exposes commands.
• api.rs — Bili struct wraps a singleton reqwest::Client + cookie jar. WBI keys cached in Arc<RwLock<Option<(WbiKeys, Instant)>>> with a 1-hour TTL. Shared to commands via Tauri State<Arc<Bili>>.
• commands.rs — #[tauri::command]s grouped by purpose: read (get_user_info, get_rcmd, get_related, get_play_info, get_view_info, get_danmaku, get_comments, get_action_state), write (like_video, coin_video, triple_video, follow_user, feed_dislike), and diagnostics (get_decoder_probe). All return Result<_, String> (errors stringified at the Tauri boundary). Register new commands in lib.rs's invoke_handler!.
• wbi.rs — Bilibili WBI signature scheme (mixin-key permutation + wts/w_rid). Most endpoints reject unsigned requests with HTTP 412 — always sign via Bili's helpers, don't hand-build query strings.
• stream.rs — Async URI scheme handler. Rewrites HTTPS DASH segment URLs to bilistream://seg/<base64> and image URLs to biliimg://img/<base64> so the frontend can embed them without CSP violations. The handler proxies the actual HTTPS fetch through Bili so Bilibili CDN's Referer/Origin requirements are met.
• cookies.rs — Reads cookies.json at startup (path overridable via BILI_COOKIES). The in-app QR flow (commands::qr_login_poll → Bili::replace_cookies) writes cookies.json and swaps the in-memory session atomically, so re-login does not require an app restart.
• danmaku.rs — Parses Bilibili's list.so XML response, auto-detecting raw deflate vs. pre-inflated payloads.