BBDown

BBDown 是一个使用 Python 重新实现的哔哩哔哩下载与解析命令行工具。

0.0.1 已按固定原版基线完成 CLI、配置、元数据、WEB/TV/APP/INTL 播放地址、字幕、弹幕、下载、混流、二维码登录和 serve HTTP API 的功能等价验证。具体自动化与线上证据见等价性证据矩阵。

安装

要求 CPython 3.12 或更高版本，推荐使用 uv：

uv tool install bbdown

安装后可以使用任一等价命令：

BBDown --version
bbdown --help
bbd doctor
BBDown login
BBDown logintv
BBDown serve --listen http://127.0.0.1:23333

HTTP 服务

BBDown serve 默认监听 http://0.0.0.0:23333，保留原版任务提交、查询、清理和完成回调接口。默认开放访问以保持兼容；暴露到不可信网络时，应使用 --token 或 BBDOWN_SERVER_TOKEN 启用 Bearer 认证，并用可重复的 --cors-origin 限制浏览器来源。

$env:BBDOWN_SERVER_TOKEN = "<从安全存储读取的值>"
BBDown serve --cors-origin https://console.example

完整路由和 JSON 字段见 HTTP API 文档。

外部工具

音视频下载与封装兼容 FFmpeg、MP4Box 和 aria2c。项目不会自动下载这些程序；可以通过 --ffmpeg-path、--mp4box-path、--aria2c-path 指定位置，或运行 BBDown doctor 检查 PATH。DASH/FLV 音视频、封面、字幕、弹幕与混流已经接入 CLI。

开发

uv sync --all-groups
uv run ruff format --check .
uv run ruff check .
uv run basedpyright
uv run interrogate src
uv run pytest
uv run mutmut run  # 仅支持具有 fork 的 POSIX 环境
uv build

完整文档通过 uv run mkdocs serve 本地预览。

原版差分测试

原版固定在 origin.lock.json 记录的提交。Windows/PowerShell 下可准备本地 oracle：

.\scripts\setup-origin-oracle.ps1
$env:DOTNET_ROOT = "<脚本输出的目录>"
$env:BBDOWN_DOTNET = "<脚本输出的路径>"
$env:BBDOWN_ORIGIN_DLL = "<脚本输出的路径>"
uv run pytest tests/oracle -m oracle --no-cov

在线烟测

Monthly live smoke 每月及手动下载匿名、会员样本的单个分 P，并同时启用 360P 优先及音视频最小码率选择。匿名任务用固定原版和 Python 版各下载一次，再执行 ffprobe 语义差分；样本可通过仓库变量 BBDOWN_SMOKE_INPUT 覆盖。会员烟测必须配置仓库变量 BBDOWN_MEMBER_SMOKE_INPUT 和 Secret BBDOWN_MEMBER_COOKIE。Cookie 只会写入运行器的临时私有凭据文件，不作为命令行参数或日志输出，产物只保留在临时运行器中。预留的 TV/APP 认证 Secret 名称分别为 BBDOWN_TV_TOKEN 和 BBDOWN_APP_TOKEN。月度烟测会分别通过 WEB、TV、APP 三种认证路径下载低清晰度样本；三类凭据只能由仓库所有者写入受保护的 GitHub Secrets，工作流和测试不提供默认值，也不回显其内容。

全部在线烟测任务运行在带有 self-hosted、linux、x64、bbdown-live-smoke 标签的专用 GitHub Actions Runner 上，以使用已验证可访问 Bilibili 的网络。该主机必须预装 git、 ffmpeg 和 ffprobe；工作流会校验这些工具，但不会通过 sudo 修改持久化宿主机。 Python、uv 和固定的 .NET SDK 由已固定提交哈希的官方 Actions 在任务目录中配置。认证任务无论成功与否都会显式清理临时凭据和下载产物。

Bilibili 当前会对旧的 /x/web-interface/view 返回 HTTP 412，因此 Python 客户端仅在该状态下回退到响应结构等价的 /x/web-interface/wbi/view。线上差分构建仍固定检出原版提交，随后仅对临时 oracle 的同一元数据 URL 应用可审计的一行兼容补丁，避免把已失效的上游入口误判为实现差异。

性能回退门禁

固定的 BV 往返、轨道排序、字幕转换和弹幕渲染工作负载不访问网络，也不与 Native AOT 比速度：

uv run python scripts/performance_gate.py

CI 使用宽松的绝对预算阻止数量级回退；较慢的本地诊断环境可用 --budget-multiplier 2 临时放宽，但 CI 始终使用默认预算。

媒体产物差分

安装 FFmpeg/ffprobe 后，可以比较原版与 Python 版产物的轨道类型及数量、编码、画面尺寸、音频布局、时长、语言、字幕、封面 disposition、章节和关键元数据。容器索引、码率及编码器版本不参与比较，默认允许 0.25 秒封装时长误差：

uv run python scripts/compare_media.py origin.mp4 python.mp4

许可证

本项目采用 MIT License，归属信息见 LICENSE 与 NOTICE。

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bbdown-0.0.1.tar.gz (96.8 kB view details)

Uploaded Sep 7, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

bbdown-0.0.1-py3-none-any.whl (133.6 kB view details)

Uploaded Sep 7, 2026 Python 3

File details

Details for the file bbdown-0.0.1.tar.gz.

File metadata

Download URL: bbdown-0.0.1.tar.gz
Upload date: Sep 7, 2026
Size: 96.8 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for bbdown-0.0.1.tar.gz
Algorithm	Hash digest
SHA256	`6c3c29cd3f54a20c43e39d5b4340a46b53f085427937aa9c25cf74131b4cf671`
MD5	`398df2421bdd6cf3511c16185a58b180`
BLAKE2b-256	`4df36255e732737b8e8aa856b08d3e5becf49731123f3dfdf7ae7f8b2cc56f21`

See more details on using hashes here.

Provenance

The following attestation bundles were made for bbdown-0.0.1.tar.gz:

Publisher: release.yml on LittleGraper/BBDown

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: bbdown-0.0.1.tar.gz
- Subject digest: 6c3c29cd3f54a20c43e39d5b4340a46b53f085427937aa9c25cf74131b4cf671
- Sigstore transparency entry: 2747722902
- Sigstore integration time: Sep 7, 2026
Source repository:
- Permalink: LittleGraper/BBDown@6c73ba77354be8b60223934abc20e3393fc27a4e
- Branch / Tag: refs/tags/v0.0.1
- Owner: https://github.com/LittleGraper
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@6c73ba77354be8b60223934abc20e3393fc27a4e
- Trigger Event: push

File details

Details for the file bbdown-0.0.1-py3-none-any.whl.

File metadata

Download URL: bbdown-0.0.1-py3-none-any.whl
Upload date: Sep 7, 2026
Size: 133.6 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: uv/0.11.21 {"installer":{"name":"uv","version":"0.11.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for bbdown-0.0.1-py3-none-any.whl
Algorithm	Hash digest
SHA256	`76c5d2c0d9b3eefead90cd47b16aac3e5c45913cd92e7dccfb8cd5d537a5293f`
MD5	`a96a1e814ec2ecd9d8158d61596d229b`
BLAKE2b-256	`5b7db263cb476ac878a400fe1f2553d62ed00b9441ab538350d1c83681bd98d4`

See more details on using hashes here.

Provenance

The following attestation bundles were made for bbdown-0.0.1-py3-none-any.whl:

Publisher: release.yml on LittleGraper/BBDown

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: bbdown-0.0.1-py3-none-any.whl
- Subject digest: 76c5d2c0d9b3eefead90cd47b16aac3e5c45913cd92e7dccfb8cd5d537a5293f
- Sigstore transparency entry: 2747722884
- Sigstore integration time: Sep 7, 2026
Source repository:
- Permalink: LittleGraper/BBDown@6c73ba77354be8b60223934abc20e3393fc27a4e
- Branch / Tag: refs/tags/v0.0.1
- Owner: https://github.com/LittleGraper
- Access: private
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@6c73ba77354be8b60223934abc20e3393fc27a4e
- Trigger Event: push

Release history Release notifications | RSS feed

0.0.1.post1

Sep 7, 2026 2 files

This release

0.0.1 This release

Sep 7, 2026 2 files

Pre-release

0.0.1a0

Sep 7, 2026 2 files

bbdown 0.0.1

BBDown

安装

HTTP 服务

外部工具

开发

原版差分测试

在线烟测

性能回退门禁

媒体产物差分

许可证

Key dates

1 maintainer

Credits

License expression

Requires

Classifiers

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed