bili23-cli 0.1.0__tar.gz

bili23_cli-0.1.0/.gitignore

@@ -0,0 +1,30 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.egg
+build/
+dist/
+.eggs/
+
+# Virtual envs
+.venv/
+venv/
+env/
+
+# uv
+uv.lock
+
+# Editors / OS
+.vscode/
+.idea/
+.DS_Store
+*.swp
+
+# Test downloads
+*.mp4
+*.m4s
+*.flv
+*.mkv
+_test-output/

bili23_cli-0.1.0/CHANGELOG.md

@@ -0,0 +1,22 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+## [0.1.0] - 2026-07-07
+
+### Added
+- Initial release.
+- Headless CLI reusing the Bili23-Downloader GUI login session (`config.json`).
+- Wbi signature (`w_rid`) implementation for modern Bilibili API auth.
+- Parse + download user-uploaded videos (BV/av): `wbi/view` → `wbi/playurl` → multi-threaded Range download → `ffmpeg` merge.
+- Quality selection (`-q`: auto/8K/…/360P) and codec selection (`-c`: auto/AVC/HEVC/AV1).
+- Multi-part video support (`-p`).
+- Anonymous fallback (`--no-cookie`).
+
+[Unreleased]: https://github.com/1WorldCapture/bili23-cli/compare/v0.1.0...HEAD
+[0.1.0]: https://github.com/1WorldCapture/bili23-cli/releases/tag/v0.1.0

bili23_cli-0.1.0/LICENSE

@@ -0,0 +1,17 @@
+GNU GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
+
+Copyright (C) 2026 Lyon Liang
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU General Public License as published by
+the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+GNU General Public License for more details.
+
+You should have received a copy of the GNU General Public License
+along with this program.  If not, see <https://www.gnu.org/licenses/>.

bili23_cli-0.1.0/PKG-INFO

@@ -0,0 +1,156 @@
+Metadata-Version: 2.4
+Name: bili23-cli
+Version: 0.1.0
+Summary: Headless CLI for downloading Bilibili videos — reuses the Bili23-Downloader GUI login session, no separate login required.
+Project-URL: Homepage, https://github.com/1WorldCapture/bili23-cli
+Project-URL: Repository, https://github.com/1WorldCapture/bili23-cli
+Project-URL: Issues, https://github.com/1WorldCapture/bili23-cli/issues
+Author: Lyon Liang
+License-Expression: GPL-3.0-only
+License-File: LICENSE
+Keywords: bili23,bilibili,bilibili-downloader,cli,video-downloader
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Multimedia :: Video
+Requires-Python: >=3.9
+Requires-Dist: httpx>=0.27
+Description-Content-Type: text/markdown
+
+# bili23-cli
+
+> Headless CLI for downloading Bilibili videos — **reuses the [Bili23-Downloader](https://github.com/ScottSloan/Bili23-Downloader) GUI login session**, so the CLI never asks you to log in.
+
+Give it a Bilibili URL, get an `.mp4`. That's it.
+
+```bash
+bili23-cli "https://www.bilibili.com/video/BV1GE411Q7Ew/"
+```
+
+## Why this exists
+
+The official [Bili23-Downloader](https://github.com/ScottSloan/Bili23-Downloader) is a Qt GUI app — great for clicking around, but not scriptable. The author's separate [CLI repo](https://github.com/ScottSloan/Bili23-Downloader-CLI) was last published to PyPI in **2022** and is now stale (missing modern Bilibili auth: Wbi signing, buvid/ticket cookies, etc.).
+
+`bili23-cli` is a **modern, dependency-light rewrite** that:
+
+- 🍪 **Reuses your GUI login** — reads the cookie the GUI already stored, so you get your account's quality (1080P / 4K / VIP) without logging in again.
+- 🔐 **Implements current Bilibili auth** — Wbi signature (`w_rid`), full cookie set (SESSDATA / buvid3/4 / bili_ticket / …), correct UA & Referer.
+- 🪶 **Minimal dependencies** — only [`httpx`](https://www.python-httpx.org/) + system `ffmpeg`. No PySide6 / Qt.
+- 🧵 **Multi-threaded** — 4 MB chunked Range downloads.
+- 🎛️ **Selectable quality / codec** — `-q 1080P -c HEVC`, or `auto` for best-available.
+
+## Prerequisites
+
+1. **The GUI app installed & logged in** — [Bili23-Downloader](https://github.com/ScottSloan/Bili23-Downloader/releases). Log in once; `bili23-cli` reads its session cookie.
+   - This is how you get high quality. Anonymous use (`--no-cookie`) works but is limited to ~480P and some videos 403.
+2. **ffmpeg** on your `PATH` (for merging audio + video):
+   - macOS: `brew install ffmpeg`
+   - Linux: `sudo apt install ffmpeg`
+   - Windows: <https://ffmpeg.org/download.html>
+3. **Python ≥ 3.9**.
+
+## Installation
+
+### As a standalone tool (recommended)
+
+```bash
+# with uv
+uv tool install bili23-cli
+
+# or with pipx
+pipx install bili23-cli
+```
+
+This installs the `bili23-cli` command globally, in an isolated environment.
+
+### From source
+
+```bash
+git clone https://github.com/1WorldCapture/bili23-cli.git
+cd bili23-cli
+uv tool install .     # or: pipx install .
+```
+
+## Usage
+
+```bash
+bili23-cli <URL-or-BVid> [options]
+```
+
+### Examples
+
+```bash
+# Simplest: download to current dir, auto best quality
+bili23-cli "https://www.bilibili.com/video/BV1GE411Q7Ew/"
+
+# Bare BV id works too
+bili23-cli BV1GE411Q7Ew
+
+# Choose quality + codec, output dir
+bili23-cli BV1GE411Q7Ew -o ~/Downloads -q 1080P -c HEVC
+
+# Multi-part video: pick part 3
+bili23-cli "https://www.bilibili.com/video/BVxxxxx/" -p 3
+
+# More threads
+bili23-cli BV1GE411Q7Ew -t 16
+```
+
+### Options
+
+| Option | Description |
+|---|---|
+| `url` | Bilibili video URL or bare BV id (positional) |
+| `-o, --output DIR` | Output directory (default: current dir) |
+| `-q, --quality` | `auto` / `8K` / `杜比视界` / `HDR` / `4K` / `1080P60` / `1080P+` / `1080P` / `720P` / `480P` / `360P` (default: `auto`) |
+| `-c, --codec` | `auto` / `AVC` / `HEVC` / `AV1` (default: `auto`, prefers AVC > HEVC > AV1) |
+| `-p, --page N` | Part number, 1-based (default: `1`) |
+| `-t, --thread N` | Download threads (default: `8`) |
+| `--no-merge` | Don't merge; keep `video.m4s` / `audio.m4s` |
+| `--no-cookie` | Skip the GUI login cookie (anonymous; quality limited) |
+| `--keep-parts` | Keep `.m4s` parts after merge |
+
+## How it works
+
+### Auth reuse (the key trick)
+
+The GUI stores your login in (macOS) `~/Library/Application Support/Bili23 Downloader/config.json` under the `Cookie` key. `bili23-cli` reads it and rebuilds the exact cookie dict the GUI sends — including `SESSDATA`, `bili_jct`, `buvid3/4`, `bili_ticket`, and the `CURRENT_FNVAL=4048` flag — so the CLI looks indistinguishable from the GUI to Bilibili's servers.
+
+On each run it also calls `/x/web-interface/nav` to fetch fresh **Wbi signing keys** (`img_key` / `sub_key`) — it does **not** trust the cached values, which silently expire.
+
+### Download pipeline
+
+Only two API calls are needed:
+
+1. `GET /x/web-interface/wbi/view?bvid=…` (+ Wbi sig) → title, `cid`, parts
+2. `GET /x/player/wbi/playurl?bvid=…&cid=…&qn=…&fnval=4048&fourk=1` (+ Wbi sig) → DASH `video[]` / `audio[]` CDN URLs
+
+Then: multi-threaded Range download of `video.m4s` + `audio.m4s`, followed by `ffmpeg -c copy` into `.mp4`.
+
+See [`docs/research-notes.md`](docs/research-notes.md) for the full reverse-engineering writeup of the GUI's internals.
+
+## Scope (v0.1)
+
+**Supported:** user-uploaded videos (BV/av) — parse, quality/codec selection, multi-threaded download, merge.
+
+**Not yet:** bangumi / movies / courses / audio / favorites (different APIs), danmaku / subtitles / cover / metadata, batch download, cross-process resume, login flow (by design — reuse the GUI).
+
+## Acknowledgements
+
+This project is an independent CLI companion to — and **not affiliated with** — [ScottSloan/Bili23-Downloader](https://github.com/ScottSloan/Bili23-Downloader). The auth and download logic is a clean-room reimplementation based on studying that project's source.
+
+Bilibili is a trademark of Shanghai Kuoyu Network Technology Co., Ltd. This tool is for personal use; please respect Bilibili's Terms of Service and copyright.
+
+## License
+
+[GPL-3.0](LICENSE)

bili23_cli-0.1.0/README.md

@@ -0,0 +1,127 @@
+# bili23-cli
+
+> Headless CLI for downloading Bilibili videos — **reuses the [Bili23-Downloader](https://github.com/ScottSloan/Bili23-Downloader) GUI login session**, so the CLI never asks you to log in.
+
+Give it a Bilibili URL, get an `.mp4`. That's it.
+
+```bash
+bili23-cli "https://www.bilibili.com/video/BV1GE411Q7Ew/"
+```
+
+## Why this exists
+
+The official [Bili23-Downloader](https://github.com/ScottSloan/Bili23-Downloader) is a Qt GUI app — great for clicking around, but not scriptable. The author's separate [CLI repo](https://github.com/ScottSloan/Bili23-Downloader-CLI) was last published to PyPI in **2022** and is now stale (missing modern Bilibili auth: Wbi signing, buvid/ticket cookies, etc.).
+
+`bili23-cli` is a **modern, dependency-light rewrite** that:
+
+- 🍪 **Reuses your GUI login** — reads the cookie the GUI already stored, so you get your account's quality (1080P / 4K / VIP) without logging in again.
+- 🔐 **Implements current Bilibili auth** — Wbi signature (`w_rid`), full cookie set (SESSDATA / buvid3/4 / bili_ticket / …), correct UA & Referer.
+- 🪶 **Minimal dependencies** — only [`httpx`](https://www.python-httpx.org/) + system `ffmpeg`. No PySide6 / Qt.
+- 🧵 **Multi-threaded** — 4 MB chunked Range downloads.
+- 🎛️ **Selectable quality / codec** — `-q 1080P -c HEVC`, or `auto` for best-available.
+
+## Prerequisites
+
+1. **The GUI app installed & logged in** — [Bili23-Downloader](https://github.com/ScottSloan/Bili23-Downloader/releases). Log in once; `bili23-cli` reads its session cookie.
+   - This is how you get high quality. Anonymous use (`--no-cookie`) works but is limited to ~480P and some videos 403.
+2. **ffmpeg** on your `PATH` (for merging audio + video):
+   - macOS: `brew install ffmpeg`
+   - Linux: `sudo apt install ffmpeg`
+   - Windows: <https://ffmpeg.org/download.html>
+3. **Python ≥ 3.9**.
+
+## Installation
+
+### As a standalone tool (recommended)
+
+```bash
+# with uv
+uv tool install bili23-cli
+
+# or with pipx
+pipx install bili23-cli
+```
+
+This installs the `bili23-cli` command globally, in an isolated environment.
+
+### From source
+
+```bash
+git clone https://github.com/1WorldCapture/bili23-cli.git
+cd bili23-cli
+uv tool install .     # or: pipx install .
+```
+
+## Usage
+
+```bash
+bili23-cli <URL-or-BVid> [options]
+```
+
+### Examples
+
+```bash
+# Simplest: download to current dir, auto best quality
+bili23-cli "https://www.bilibili.com/video/BV1GE411Q7Ew/"
+
+# Bare BV id works too
+bili23-cli BV1GE411Q7Ew
+
+# Choose quality + codec, output dir
+bili23-cli BV1GE411Q7Ew -o ~/Downloads -q 1080P -c HEVC
+
+# Multi-part video: pick part 3
+bili23-cli "https://www.bilibili.com/video/BVxxxxx/" -p 3
+
+# More threads
+bili23-cli BV1GE411Q7Ew -t 16
+```
+
+### Options
+
+| Option | Description |
+|---|---|
+| `url` | Bilibili video URL or bare BV id (positional) |
+| `-o, --output DIR` | Output directory (default: current dir) |
+| `-q, --quality` | `auto` / `8K` / `杜比视界` / `HDR` / `4K` / `1080P60` / `1080P+` / `1080P` / `720P` / `480P` / `360P` (default: `auto`) |
+| `-c, --codec` | `auto` / `AVC` / `HEVC` / `AV1` (default: `auto`, prefers AVC > HEVC > AV1) |
+| `-p, --page N` | Part number, 1-based (default: `1`) |
+| `-t, --thread N` | Download threads (default: `8`) |
+| `--no-merge` | Don't merge; keep `video.m4s` / `audio.m4s` |
+| `--no-cookie` | Skip the GUI login cookie (anonymous; quality limited) |
+| `--keep-parts` | Keep `.m4s` parts after merge |
+
+## How it works
+
+### Auth reuse (the key trick)
+
+The GUI stores your login in (macOS) `~/Library/Application Support/Bili23 Downloader/config.json` under the `Cookie` key. `bili23-cli` reads it and rebuilds the exact cookie dict the GUI sends — including `SESSDATA`, `bili_jct`, `buvid3/4`, `bili_ticket`, and the `CURRENT_FNVAL=4048` flag — so the CLI looks indistinguishable from the GUI to Bilibili's servers.
+
+On each run it also calls `/x/web-interface/nav` to fetch fresh **Wbi signing keys** (`img_key` / `sub_key`) — it does **not** trust the cached values, which silently expire.
+
+### Download pipeline
+
+Only two API calls are needed:
+
+1. `GET /x/web-interface/wbi/view?bvid=…` (+ Wbi sig) → title, `cid`, parts
+2. `GET /x/player/wbi/playurl?bvid=…&cid=…&qn=…&fnval=4048&fourk=1` (+ Wbi sig) → DASH `video[]` / `audio[]` CDN URLs
+
+Then: multi-threaded Range download of `video.m4s` + `audio.m4s`, followed by `ffmpeg -c copy` into `.mp4`.
+
+See [`docs/research-notes.md`](docs/research-notes.md) for the full reverse-engineering writeup of the GUI's internals.
+
+## Scope (v0.1)
+
+**Supported:** user-uploaded videos (BV/av) — parse, quality/codec selection, multi-threaded download, merge.
+
+**Not yet:** bangumi / movies / courses / audio / favorites (different APIs), danmaku / subtitles / cover / metadata, batch download, cross-process resume, login flow (by design — reuse the GUI).
+
+## Acknowledgements
+
+This project is an independent CLI companion to — and **not affiliated with** — [ScottSloan/Bili23-Downloader](https://github.com/ScottSloan/Bili23-Downloader). The auth and download logic is a clean-room reimplementation based on studying that project's source.
+
+Bilibili is a trademark of Shanghai Kuoyu Network Technology Co., Ltd. This tool is for personal use; please respect Bilibili's Terms of Service and copyright.
+
+## License
+
+[GPL-3.0](LICENSE)

bili23_cli-0.1.0/pyproject.toml

@@ -0,0 +1,48 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "bili23-cli"
+version = "0.1.0"
+description = "Headless CLI for downloading Bilibili videos — reuses the Bili23-Downloader GUI login session, no separate login required."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "GPL-3.0-only"
+license-files = ["LICENSE"]
+authors = [{ name = "Lyon Liang" }]
+keywords = ["bilibili", "bilibili-downloader", "bili23", "video-downloader", "cli"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Multimedia :: Video",
+]
+dependencies = [
+    "httpx>=0.27",
+]
+
+[project.urls]
+Homepage = "https://github.com/1WorldCapture/bili23-cli"
+Repository = "https://github.com/1WorldCapture/bili23-cli"
+Issues = "https://github.com/1WorldCapture/bili23-cli/issues"
+
+# uv tool install bili23-cli 后，命令名是 bili23-cli
+[project.scripts]
+bili23-cli = "bili23_cli.cli:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/bili23_cli"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/bili23_cli", "README.md", "LICENSE", "CHANGELOG.md"]

bili23_cli-0.1.0/src/bili23_cli/__init__.py

@@ -0,0 +1,6 @@
+"""Bili23-Downloader 的 headless CLI。
+
+复用 GUI 版本（Bili23-Downloader）登录后的 cookie 数据，给一个 B 站地址即可下载。
+详见：https://github.com/ScottSloan/Bili23-Downloader
+"""
+__version__ = "0.1.0"

bili23_cli-0.1.0/src/bili23_cli/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

bili23_cli-0.1.0/src/bili23_cli/cli.py

@@ -0,0 +1,216 @@
+"""CLI 主流程编排：参数解析 → 加载 GUI 鉴权 → 解析 → 下载 → 合并。
+
+用法：
+    python -m bili23_cli <B站地址> [选项]
+"""
+from __future__ import annotations
+
+import argparse
+import shutil
+import sys
+import time
+from pathlib import Path
+
+from . import config as cfg_mod
+from . import download, merge, parse, wbi
+from .client import make_client
+from .naming import sanitize
+
+
+def _format_size(n: int) -> str:
+    if n >= 1 << 30:
+        return f"{n / (1 << 30):.2f} GB"
+    if n >= 1 << 20:
+        return f"{n / (1 << 20):.1f} MB"
+    if n >= 1 << 10:
+        return f"{n / (1 << 10):.1f} KB"
+    return f"{n} B"
+
+
+_last_progress_ts = 0.0
+_last_progress_pct = -1
+
+
+def _progress_bar(downloaded: int, total: int, *, label: str = ""):
+    """简单文本进度条（写 stderr，节流：≥100ms 且 ≥1% 变化才刷新）。"""
+    global _last_progress_ts, _last_progress_pct
+    pct = 0 if total <= 0 else min(downloaded * 100 // total, 100)
+    now = time.time()
+    # 节流：除非完成，否则至少间隔 100ms 且百分比有变化才刷新
+    if pct != 100 and (now - _last_progress_ts < 0.1 or pct == _last_progress_pct):
+        return
+    _last_progress_ts = now
+    _last_progress_pct = pct
+
+    bar = "█" * (pct // 5) + "░" * (20 - pct // 5) if total > 0 else "?" * 20
+    sys.stderr.write(
+        f"\r  {label} [{bar}] {pct:3d}%  {_format_size(downloaded)}/{_format_size(total)}"
+    )
+    sys.stderr.flush()
+    if total > 0 and downloaded >= total:
+        sys.stderr.write("\n")
+
+
+def build_parser() -> argparse.ArgumentParser:
+    p = argparse.ArgumentParser(
+        prog="bili23-cli",
+        description="Bili23-Downloader 的 headless CLI —— 复用 GUI 登录态下载 B 站视频",
+        epilog="示例：\n  python -m bili23_cli BV1GE411Q7Ew\n"
+               "  python -m bili23_cli 'https://www.bilibili.com/video/BV1GE411Q7Ew/' -q 1080P -c HEVC",
+        formatter_class=argparse.RawDescriptionHelpFormatter,
+    )
+    p.add_argument("url", help="B 站视频地址或 BV 号")
+    p.add_argument("-o", "--output", default=".", help="输出目录，默认当前目录")
+    q_group = p.add_mutually_exclusive_group()
+    q_group.add_argument("-q", "--quality", default="auto",
+                         choices=["auto", "8K", "杜比视界", "HDR", "4K", "1080P60", "1080P+", "1080P", "720P", "480P", "360P"],
+                         help="清晰度（默认 auto，按可用最高优先级）")
+    p.add_argument("-c", "--codec", default="auto",
+                   choices=["auto", "AVC", "HEVC", "AV1"],
+                   help="视频编码（默认 auto，偏好 AVC>HEVC>AV1）")
+    p.add_argument("-p", "--page", type=int, default=1, help="分 P 序号，从 1 开始（默认 1）")
+    p.add_argument("-t", "--thread", type=int, default=8, help="下载线程数（默认 8）")
+    p.add_argument("--no-merge", action="store_true", help="不合并，保留 video.m4s / audio.m4s")
+    p.add_argument("--no-cookie", action="store_true", help="不读取 GUI 登录态（匿名下载）")
+    p.add_argument("--keep-parts", action="store_true", help="合并后保留 m4s 临时文件")
+    return p
+
+
+def _resolve_qn(quality: str) -> int:
+    # 清晰度名字 → id（与 parse.VIDEO_QUALITY_NAME 对齐；auto=200）
+    name_to_id = {
+        "8K": 127, "杜比视界": 126, "HDR": 125, "4K": 120, "1080P60": 116,
+        "1080P+": 112, "1080P": 80, "720P": 64, "480P": 32, "360P": 16, "auto": 200,
+    }
+    return name_to_id.get(quality, 200)
+
+
+def _resolve_codec(codec: str) -> int:
+    return {"auto": 20, "AVC": 7, "HEVC": 12, "AV1": 13}.get(codec, 20)
+
+
+def main(argv: list[str] | None = None) -> int:
+    args = build_parser().parse_args(argv)
+
+    # ---- 1. 检查 ffmpeg ----
+    if not args.no_merge and not merge.ffmpeg_available():
+        print("⚠️  未找到 ffmpeg，将下载但无法合并（可用 --no-merge 或先装 ffmpeg）", file=sys.stderr)
+
+    # ---- 2. 加载 GUI 鉴权 ----
+    cookies: dict[str, str] = {}
+    ua = ""
+    if not args.no_cookie:
+        try:
+            gui_cfg = cfg_mod.load_gui_config()
+            cookies = cfg_mod.build_cookies(gui_cfg)
+            ua = cfg_mod.get_user_agent(gui_cfg)
+            logged = cfg_mod.is_logged_in(gui_cfg)
+            print(f"✓ 已复用 GUI 登录态（is_login={logged}, cookie 字段 {len(cookies)} 个）", file=sys.stderr)
+        except cfg_mod.ConfigNotFoundError as e:
+            print(f"⚠️  {e}", file=sys.stderr)
+            print("   将以匿名方式下载（清晰度会受限）。可用 --no-cookie 显式跳过。", file=sys.stderr)
+
+    client = make_client(cookies, ua)
+
+    # ---- 3. 拉 wbi keys + 校验登录态 ----
+    print("→ 获取鉴权信息…", file=sys.stderr)
+    # fetch_wbi_keys 返回 (img_key, sub_key, nav_data)
+    img_key, sub_key, nav_data = wbi.fetch_wbi_keys(client)
+    wbi_keys = (img_key, sub_key)
+    used_cookie = bool(cookies)
+    if used_cookie and not nav_data.get("isLogin"):
+        print("⚠️  GUI 登录态已过期，请在 GUI 中重新登录后重试（将以匿名继续，清晰度受限）", file=sys.stderr)
+    elif nav_data.get("isLogin"):
+        print(f"✓ 登录有效：{nav_data.get('uname', '?')}"
+              f"（大会员：{'是' if nav_data.get('vipStatus') else '否'}）", file=sys.stderr)
+    else:
+        print("ℹ️  匿名访问（清晰度受限）", file=sys.stderr)
+
+    # ---- 4. 解析视频 ----
+    bvid = parse.extract_bvid(args.url)
+    print(f"→ 解析视频 {bvid}…", file=sys.stderr)
+    meta = parse.parse_video(client, bvid, wbi_keys)
+    print(f"  标题：{meta.title}")
+    print(f"  UP 主：{meta.up_name}    分 P 数：{len(meta.pages)}")
+
+    # 选 P
+    if args.page < 1 or args.page > len(meta.pages):
+        print(f"⚠️  分 P 序号 {args.page} 越界（共 {len(meta.pages)} P），使用第 1 P", file=sys.stderr)
+        page_idx = 0
+    else:
+        page_idx = args.page - 1
+    page = meta.pages[page_idx]
+    cid = page["cid"]
+    if len(meta.pages) > 1:
+        print(f"  当前选择：第 {page['page']} P — {page['part']}")
+
+    # ---- 5. 拿 playurl + 选流 ----
+    want_qn = _resolve_qn(args.quality)
+    want_codec = _resolve_codec(args.codec)
+    # 用请求的 qn（auto 时传 80 占位，触发返回所有 dash 流）
+    playurl = parse.get_playurl(client, bvid, cid, 80 if want_qn == 200 else want_qn, wbi_keys)
+    avail = parse.available_qualities(playurl)
+    avail_names = [f"{parse.VIDEO_QUALITY_NAME.get(q, q)}" for q in avail]
+    print(f"  可用清晰度：{', '.join(avail_names)}", file=sys.stderr)
+
+    video_stream, audio_stream = parse.select_streams(playurl, want_qn, want_codec)
+    if video_stream:
+        qn = video_stream.quality_id
+        print(f"  选定：{parse.VIDEO_QUALITY_NAME.get(qn, qn)} / {parse.CODEC_NAME.get(video_stream.codec_id, video_stream.codec_id)}",
+              file=sys.stderr)
+
+    # ---- 6. 下载 ----
+    out_dir = Path(args.output).expanduser().resolve()
+    out_dir.mkdir(parents=True, exist_ok=True)
+    base_name = sanitize(meta.title if len(meta.pages) == 1 else f"{meta.title}_P{page['page']}_{page['part']}")
+    # 临时文件加 pid 防冲突
+    tag = f"bili23_{bvid}"
+    video_tmp = out_dir / f"video_{tag}.m4s"
+    audio_tmp = out_dir / f"audio_{tag}.m4s"
+    output = out_dir / f"{base_name}.mp4"
+
+    streams_to_dl = []
+    if video_stream:
+        streams_to_dl.append(("video", video_stream, video_tmp))
+    streams_to_dl.append(("audio", audio_stream, audio_tmp))
+
+    for label_s, s, tmp in streams_to_dl:
+        # 探测大小
+        size = s.file_size or parse.probe_size(client, s.url, s.backup_urls)
+        print(f"→ 下载 {label_s}（{_format_size(size) if size else '大小未知'}）…", file=sys.stderr)
+        t0 = time.time()
+
+        def cb(d, t, _label=label_s):
+            _progress_bar(d, t, label=_label)
+
+        download.download_stream(
+            client, s.url, tmp,
+            total_size=size, backup_urls=s.backup_urls,
+            thread_count=args.thread, on_progress=cb, label=label_s,
+        )
+        dt = time.time() - t0
+        if size and dt > 0:
+            print(f"  {label_s} 完成，平均 { _format_size(int(size / dt))}/s", file=sys.stderr)
+
+    # ---- 7. 合并 ----
+    if args.no_merge:
+        print(f"\n✓ 已保留分片（--no-merge）：", file=sys.stderr)
+        for _, _, tmp in streams_to_dl:
+            print(f"   {tmp}", file=sys.stderr)
+    else:
+        print("→ 合并音视频…", file=sys.stderr)
+        if video_stream:
+            merge.merge_video_audio(video_tmp, audio_tmp, output)
+            if not args.keep_parts:
+                video_tmp.unlink(missing_ok=True)
+                audio_tmp.unlink(missing_ok=True)
+        else:
+            # 纯音频
+            audio_out = out_dir / f"{base_name}.m4a"
+            merge.remux_audio_only(audio_tmp, audio_out)
+            output = audio_out
+            if not args.keep_parts:
+                audio_tmp.unlink(missing_ok=True)
+        print(f"\n✅ 完成：{output}", file=sys.stderr)
+
+    return 0

bili23_cli-0.1.0/src/bili23_cli/client.py

@@ -0,0 +1,40 @@
+"""httpx 客户端封装。
+
+对应 GUI `src/util/network/request.py` 的核心（去掉 Qt 相关的 NetworkRequestWorker）：
+  - cookie / UA / Referer 注入
+  - 重试、超时、跟随重定向
+  - 统一的 get_json 帮助函数（检查 code==0）
+"""
+from __future__ import annotations
+
+import httpx
+
+
+def make_client(cookies: dict[str, str], user_agent: str) -> httpx.Client:
+    """构造一个注入了鉴权信息的 httpx.Client。
+
+    对应 GUI request.py:_create_client() + _apply_cookies()。
+    cookie 直接以 dict 形式传入（httpx 会作为请求 Cookie 头发出）。
+    """
+    transport = httpx.HTTPTransport(retries=3)
+    return httpx.Client(
+        cookies=cookies,
+        headers={
+            "User-Agent": user_agent,
+            # B 站要求带 Referer，否则很多接口会拒绝
+            "Referer": "https://www.bilibili.com/",
+        },
+        follow_redirects=True,
+        timeout=httpx.Timeout(15.0, connect=10.0),
+        transport=transport,
+    )
+
+
+def get_json(client: httpx.Client, url: str, *, params: dict | None = None) -> dict:
+    """GET 一个 B 站 API，返回 JSON，并校验 code==0。失败抛 RuntimeError。"""
+    resp = client.get(url, params=params)
+    resp.raise_for_status()
+    data = resp.json()
+    if data.get("code") != 0:
+        raise RuntimeError(f"接口返回错误 code={data.get('code')}: {data.get('message', data)}")
+    return data["data"]

bili23_cli-0.1.0/src/bili23_cli/config.py

@@ -0,0 +1,103 @@
+"""读 GUI 版本（Bili23-Downloader）的 config.json，复用其登录后的鉴权数据。
+
+对应 GUI 源码 `src/util/common/config.py` 的 ConfigItem 定义 和
+`src/util/network/request.py:203-223` 的 `get_cookies()`。
+
+我们直接读 config.json 的 `["Cookie"]` section（已是普通 JSON），
+不依赖 PySide6 / qfluentwidgets，从而实现 headless 复用。
+"""
+from __future__ import annotations
+
+import json
+import os
+import sys
+from pathlib import Path
+from typing import Optional
+
+
+def _gui_config_paths() -> list[Path]:
+    """返回各平台 GUI config.json 的候选路径（取自 GUI 的 QStandardPaths.AppDataLocation 语义）。"""
+    home = Path.home()
+    app = "Bili23 Downloader"
+    if sys.platform == "darwin":
+        return [home / "Library" / "Application Support" / app / "config.json"]
+    if sys.platform == "win32":
+        # %APPDATA% 下；也兼容 roaming/local
+        base = os.environ.get("APPDATA") or str(home / "AppData" / "Roaming")
+        return [Path(base) / app / "config.json"]
+    # Linux / 其他：XDG
+    xdg = os.environ.get("XDG_DATA_HOME") or str(home / ".local" / "share")
+    return [Path(xdg) / app / "config.json"]
+
+
+class ConfigNotFoundError(FileNotFoundError):
+    """找不到 GUI 的 config.json。"""
+
+
+def find_gui_config() -> Path:
+    """定位 GUI 的 config.json。找不到则抛 ConfigNotFoundError。"""
+    for p in _gui_config_paths():
+        if p.exists():
+            return p
+    raise ConfigNotFoundError(
+        "未找到 Bili23-Downloader (GUI) 的 config.json，尝试过：\n  "
+        + "\n  ".join(str(p) for p in _gui_config_paths())
+        + "\n请先安装 GUI 版本并登录：https://github.com/ScottSloan/Bili23-Downloader"
+    )
+
+
+def load_gui_config(path: Optional[Path] = None) -> dict:
+    """读取 GUI 的 config.json 全文。"""
+    path = path or find_gui_config()
+    return json.loads(Path(path).read_text(encoding="utf-8"))
+
+
+def get_user_agent(cfg: dict) -> str:
+    """从 config 取 UA；缺失时回退到 GUI 默认值（config.py:374）。"""
+    return (
+        cfg.get("Advanced", {}).get("user_agent")
+        or "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
+        "(KHTML, like Gecko) Chrome/147.0.0.0 Safari/537.36 Edg/147.0.0.0"
+    )
+
+
+def build_cookies(cfg: dict) -> dict[str, str]:
+    """复刻 GUI `request.py:get_cookies()`：把 config 的 Cookie section 转成请求 cookie 字典。
+
+    关键点（来自 GUI 源码 request.py:203-223）：
+      - config 的 `uuid` 字段对应 cookie 名 `_uuid`（键名不对称）
+      - `b_nut` / `bili_ticket_expires` 要 str() 化
+      - `CURRENT_FNVAL=4048` / `CURRENT_QUALITY=0` 是硬编码常量（DASH+全格式位掩码）
+      - 登录态字段（SESSDATA 等）仅在 is_login=True 时加入
+    """
+    ck = cfg.get("Cookie", {})
+
+    cookies: dict[str, str] = {
+        "_uuid": ck.get("uuid", ""),
+        "b_lsid": ck.get("b_lsid", ""),
+        "b_nut": str(ck.get("b_nut", 0)),
+        "bili_ticket": ck.get("bili_ticket", ""),
+        "bili_ticket_expires": str(ck.get("bili_ticket_expires", 0)),
+        "buvid_fp": ck.get("buvid_fp", ""),
+        "buvid3": ck.get("buvid3", ""),
+        "buvid4": ck.get("buvid4", ""),
+        "CURRENT_FNVAL": "4048",
+        "CURRENT_QUALITY": "0",
+    }
+
+    if ck.get("is_login"):
+        cookies.update(
+            {
+                "bili_jct": ck.get("bili_jct", ""),
+                "DedeUserID": ck.get("DedeUserID", ""),
+                "DedeUserID__ckMd5": ck.get("DedeUserID__ckMd5", ""),
+                "SESSDATA": ck.get("SESSDATA", ""),
+            }
+        )
+
+    return cookies
+
+
+def is_logged_in(cfg: dict) -> bool:
+    """config 里记录的登录态（仅本地标记；真实有效性靠 nav 接口确认）。"""
+    return bool(cfg.get("Cookie", {}).get("is_login", False))

bili23_cli-0.1.0/src/bili23_cli/download.py

@@ -0,0 +1,143 @@
+"""多线程分片下载（Range 请求）。
+
+对应 GUI `src/util/download/downloader/downloader.py` 的 ChunkWorker（去掉 QRunnable/QThreadPool）：
+  - 预分配文件 → 按 chunk 切片 → 线程池并发 Range 下载 → seek 写入
+  - 重试（5xx/429/超时），指数退避
+  - on_progress 回调报告进度
+
+B 站 dash 流是 m4s，可随机访问（支持 Range），适合分片。
+"""
+from __future__ import annotations
+
+import threading
+import time
+from concurrent.futures import ThreadPoolExecutor, as_completed
+from pathlib import Path
+from typing import Callable
+
+import httpx
+
+CHUNK_SIZE = 4 * 1024 * 1024  # 4MB，对齐 GUI downloader.py:274
+MAX_RETRIES = 5
+RETRYABLE_STATUS = {408, 429, 500, 502, 503, 504}
+
+ProgressCb = Callable[[int, int], None]  # (downloaded_bytes, total_bytes)
+
+
+def download_stream(
+    client: httpx.Client,
+    url: str,
+    dest_path: Path,
+    *,
+    total_size: int,
+    backup_urls: list[str] | None = None,
+    thread_count: int = 8,
+    on_progress: ProgressCb | None = None,
+    label: str = "",
+) -> None:
+    """下载一个流到 dest_path，多线程分片。
+
+    total_size 由调用方通过 probe_size 得到（>0 时用预分配 + 分片；<=0 时单线程直连下载）。
+    """
+    dest_path.parent.mkdir(parents=True, exist_ok=True)
+
+    if total_size <= 0:
+        # 探测失败：单线程顺序下载兜底
+        _download_sequential(client, url, dest_path, backup_urls, on_progress, label)
+        return
+
+    # 预分配文件
+    with open(dest_path, "wb") as f:
+        f.truncate(total_size)
+
+    chunks = _calc_chunks(total_size, CHUNK_SIZE)
+    done_bytes = [0] * len(chunks)  # 各分片已下载字节（加锁累加）
+    lock = threading.Lock()
+
+    def report():
+        if on_progress:
+            with lock:
+                downloaded = sum(done_bytes)
+            on_progress(downloaded, total_size)
+
+    urls = [url] + (backup_urls or [])
+    headers_base = {"Referer": "https://www.bilibili.com/"}
+
+    def worker(idx: int, chunk_range: tuple[int, int]):
+        start, end = chunk_range  # [start, end)
+        attempts = 0
+        last_err: Exception | None = None
+        while attempts < MAX_RETRIES:
+            u = urls[attempts % len(urls)] if urls else url
+            try:
+                # httpx stream 模式发 Range
+                with client.stream(
+                    "GET", u, headers={**headers_base, "Range": f"bytes={start}-{end - 1}"},
+                ) as r:
+                    if r.status_code in RETRYABLE_STATUS:
+                        raise httpx.HTTPStatusError(f"retryable {r.status_code}", request=r.request, response=r)
+                    r.raise_for_status()
+                    written = 0
+                    with open(dest_path, "r+b") as f:
+                        f.seek(start)
+                        for buf in r.iter_bytes(chunk_size=64 * 1024):
+                            f.write(buf)
+                            written += len(buf)
+                            with lock:
+                                done_bytes[idx] = written
+                            report()
+                return  # 该分片完成
+            except Exception as e:
+                last_err = e
+                attempts += 1
+                time.sleep(min(2 ** (attempts - 1), 8))
+        raise RuntimeError(f"分片 {idx} ({start}-{end}) 下载失败，重试 {MAX_RETRIES} 次：{last_err}")
+
+    with ThreadPoolExecutor(max_workers=thread_count) as pool:
+        futures = {pool.submit(worker, i, c): i for i, c in enumerate(chunks)}
+        for fut in as_completed(futures):
+            fut.result()  # 抛出异常即终止
+
+    report()
+
+
+def _download_sequential(
+    client: httpx.Client, url: str, dest_path: Path,
+    backup_urls: list[str] | None, on_progress: ProgressCb | None, label: str,
+) -> None:
+    """单线程顺序下载（total_size 未知时的兜底）。"""
+    urls = [url] + (backup_urls or [])
+    headers = {"Referer": "https://www.bilibili.com/"}
+    last_err: Exception | None = None
+    for attempt in range(MAX_RETRIES):
+        u = urls[attempt % len(urls)] if urls else url
+        try:
+            with client.stream("GET", u, headers=headers) as r:
+                r.raise_for_status()
+                total = int(r.headers.get("Content-Length", 0))
+                downloaded = 0
+                with open(dest_path, "wb") as f:
+                    for buf in r.iter_bytes(chunk_size=64 * 1024):
+                        f.write(buf)
+                        downloaded += len(buf)
+                        if on_progress:
+                            on_progress(downed := downloaded, total)
+            return
+        except Exception as e:
+            last_err = e
+            time.sleep(min(2 ** attempt, 8))
+    raise RuntimeError(f"{label} 顺序下载失败：{last_err}")
+
+
+def _calc_chunks(total: int, piece: int) -> list[tuple[int, int]]:
+    """把 [0, total) 切成 piece 大小的 [start, end) 区间列表。
+
+    对齐 GUI downloader.py:444-461 的 calc_chunk_list。
+    """
+    chunks = []
+    n = (total + piece - 1) // piece
+    for i in range(n):
+        start = i * piece
+        end = min((i + 1) * piece, total)
+        chunks.append((start, end))
+    return chunks

bili23_cli-0.1.0/src/bili23_cli/merge.py

@@ -0,0 +1,48 @@
+"""ffmpeg 合并音视频。
+
+对应 GUI `src/util/ffmpeg/command.py` 的 merge_video_audio。
+dash 流是分离的 video.m4s + audio.m4s，用 ffmpeg `-c copy` 无损封装成 mp4。
+"""
+from __future__ import annotations
+
+import shutil
+import subprocess
+from pathlib import Path
+
+
+def ffmpeg_available() -> bool:
+    return shutil.which("ffmpeg") is not None
+
+
+def merge_video_audio(video_path: Path, audio_path: Path, output_path: Path) -> None:
+    """合并 video.m4s + audio.m4s → output.mp4（无损 copy）。
+
+    对应 GUI ffmpeg/command.py:35-63（无封面分支）。
+    """
+    if not ffmpeg_available():
+        raise RuntimeError("未找到 ffmpeg。音视频合并依赖 ffmpeg，请先安装：\n"
+                           "  mac:  brew install ffmpeg\n  linux: sudo apt install ffmpeg\n"
+                           "  win:  https://ffmpeg.org/download.html")
+
+    cmd = [
+        "ffmpeg", "-y",
+        "-i", str(video_path),
+        "-i", str(audio_path),
+        "-c:v", "copy", "-c:a", "copy",
+        str(output_path),
+    ]
+    result = subprocess.run(cmd, capture_output=True)
+    if result.returncode != 0:
+        raise RuntimeError(
+            f"ffmpeg 合并失败 (exit {result.returncode}):\n"
+            f"{result.stderr.decode('utf-8', errors='replace')[-1000:]}"
+        )
+
+
+def remux_audio_only(audio_path: Path, output_path: Path) -> None:
+    """纯音频：m4s → m4a（直接 copy，仅改容器）。对应 GUI 的纯音频分支。"""
+    cmd = ["ffmpeg", "-y", "-i", str(audio_path), "-c:a", "copy", str(output_path)]
+    result = subprocess.run(cmd, capture_output=True)
+    if result.returncode != 0:
+        # 兜底：直接重命名
+        shutil.move(str(audio_path), str(output_path))

bili23_cli-0.1.0/src/bili23_cli/naming.py

@@ -0,0 +1,16 @@
+"""文件名清洗。对应 GUI util/format/file_name.py 的合法文件名过滤。"""
+from __future__ import annotations
+
+import re
+
+# Windows / macOS / Linux 通用的非法文件名字符
+_ILLEGAL = re.compile(r'[/\\:*?"<>|]')
+
+
+def sanitize(name: str, max_len: int = 120) -> str:
+    """清洗成合法文件名：去掉非法字符，裁剪长度，去首尾空白/点。"""
+    name = _ILLEGAL.sub("", name)
+    name = name.strip().strip(".").strip()
+    if len(name) > max_len:
+        name = name[:max_len].rstrip()
+    return name or "bilibili_video"

bili23_cli-0.1.0/src/bili23_cli/parse.py

@@ -0,0 +1,202 @@
+"""视频解析：wbi/view（元信息）+ wbi/playurl（下载流）。
+
+对应 GUI：
+  - `src/util/parse/parser/video.py` 的 get_video_info / get_bvid
+  - `src/util/parse/preview/previewer.py` 的 get_video_info（playurl）
+  - `src/util/download/parse/video_info.py` / `audio_info.py` 的流选择
+
+关键 API：
+  - view:  https://api.bilibili.com/x/web-interface/wbi/view   （+Wbi）
+  - playurl: https://api.bilibili.com/x/player/wbi/playurl     （+Wbi，fnval=4048）
+"""
+from __future__ import annotations
+
+import re
+from dataclasses import dataclass
+from typing import Optional
+
+from . import wbi
+
+# 清晰度 / 编码常量（照搬 GUI common/data/media_info.py）
+VIDEO_QUALITY_NAME = {
+    127: "8K", 126: "杜比视界", 125: "HDR", 120: "4K", 116: "1080P60",
+    112: "1080P+", 100: "AI", 80: "1080P", 64: "720P", 32: "480P", 16: "360P",
+}
+# 清晰度优先级（从高到低，auto 模式按此选）
+VIDEO_QUALITY_PRIORITY = [127, 126, 125, 120, 116, 112, 100, 80, 64, 32, 16]
+# 视频编码
+CODEC_NAME = {7: "AVC/H.264", 12: "HEVC/H.265", 13: "AV1"}
+CODEC_PRIORITY = [7, 12, 13]  # AVC → HEVC → AV1（GUI 默认偏好）
+# 音频优先级
+AUDIO_QUALITY_PRIORITY = [30251, 30250, 30280, 30232, 30216]
+
+VIEW_API = "https://api.bilibili.com/x/web-interface/wbi/view"
+PLAYURL_API = "https://api.bilibili.com/x/player/wbi/playurl"
+
+
+def extract_bvid(url_or_bvid: str) -> str:
+    """从 URL 或裸 BV/av 号中提取 BV 号。
+
+    对应 GUI video.py:238-243 / 209-212。av→BV 转换暂不支持（测试地址是 BV）。
+    """
+    s = url_or_bvid.strip()
+    m = re.search(r"BV[0-9A-Za-z]{10}", s)
+    if m:
+        return m.group(0)
+    raise ValueError(f"无法从输入中识别 BV 号：{url_or_bvid!r}（暂仅支持 BV 号与含 BV 的 URL）")
+
+
+@dataclass
+class VideoMeta:
+    bvid: str
+    aid: int
+    title: str
+    up_name: str
+    cid: int  # 默认（第一 P）的 cid
+    pages: list[dict]  # [{"cid":.., "part":.., "page":..}]
+
+
+@dataclass
+class StreamInfo:
+    """单个待下载流（video 或 audio）。"""
+    url: str
+    file_size: int
+    media_type: str  # "video" | "audio"
+    quality_id: int
+    codec_id: int
+    backup_urls: list[str]
+
+
+def parse_video(client, bvid: str, wbi_keys: tuple[str, str]) -> VideoMeta:
+    """调 wbi/view 拿视频元信息。对应 GUI parser/video.py:274-293。"""
+    query = wbi.sign({"bvid": bvid}, *wbi_keys)
+    data = client.get(f"{VIEW_API}?{query}")
+    data.raise_for_status()
+    j = data.json()
+    if j.get("code") != 0:
+        raise RuntimeError(f"view 接口错误：{j.get('message', j)}")
+
+    d = j["data"]
+    return VideoMeta(
+        bvid=d["bvid"],
+        aid=d["aid"],
+        title=d["title"],
+        up_name=d.get("owner", {}).get("name", ""),
+        cid=d["cid"],
+        pages=[
+            {"cid": p["cid"], "part": p.get("part", str(p.get("page", ""))), "page": p.get("page", 1)}
+            for p in d.get("pages", [])
+        ],
+    )
+
+
+def get_playurl(client, bvid: str, cid: int, qn: int, wbi_keys: tuple[str, str]) -> dict:
+    """调 wbi/playurl 拿 dash 数据。对应 GUI previewer.py:118-143 / parse_worker.py:79-96。
+
+    fnval=4048 是组合位（DASH+HDR+4K+杜比+8K+AV1），拿到所有可用清晰度/编码。
+    """
+    params = {"bvid": bvid, "cid": cid, "qn": qn, "fnver": 0, "fnval": 4048, "fourk": 1}
+    query = wbi.sign(params, *wbi_keys)
+    resp = client.get(f"{PLAYURL_API}?{query}")
+    resp.raise_for_status()
+    j = resp.json()
+    if j.get("code") != 0:
+        raise RuntimeError(f"playurl 接口错误：{j.get('message', j)}")
+    return j["data"]
+
+
+def available_qualities(playurl_data: dict) -> list[int]:
+    """从 dash.video 里提取可用清晰度（qn），降序去重。"""
+    qns = {v["id"] for v in playurl_data.get("dash", {}).get("video", [])}
+    return sorted(qns, reverse=True)
+
+
+def select_streams(
+    playurl_data: dict,
+    qn: int = 200,        # 200 = auto，按优先级选最高
+    codec_id: int = 20,   # 20 = auto
+) -> tuple[Optional[StreamInfo], StreamInfo]:
+    """选择 video 流（按 qn + codec）和 audio 流（按优先级选最高）。
+
+    返回 (video_stream_or_None, audio_stream)。纯音频稿件 video 为 None。
+    对应 GUI download/parse/video_info.py + audio_info.py 的选择逻辑。
+    """
+    dash = playurl_data.get("dash", {})
+    video_streams = dash.get("video", [])
+    audio_streams = dash.get("audio", [])
+
+    # ---- 选 video ----
+    video: Optional[StreamInfo] = None
+    if video_streams:
+        # 确定 qn
+        if qn == 200:  # auto
+            avail = available_qualities(playurl_data)
+            chosen_qn = next((q for q in VIDEO_QUALITY_PRIORITY if q in set(avail)), avail[0])
+        else:
+            chosen_qn = qn
+        # 在该 qn 下选 codec
+        candidates = [v for v in video_streams if v["id"] == chosen_qn]
+        if codec_id == 20 and candidates:  # auto codec
+            chosen_codec = next((c for c in CODEC_PRIORITY if c in {v["codecid"] for v in candidates}),
+                                candidates[0]["codecid"])
+        else:
+            chosen_codec = codec_id
+        chosen = next((v for v in candidates if v["codecid"] == chosen_codec), candidates[0]) if candidates else None
+        if chosen:
+            video = _to_stream(chosen, "video")
+
+    # ---- 选 audio（按优先级）----
+    chosen_audio = None
+    if audio_streams:
+        # 按 id 匹配优先级；GUI 还会处理 dolby/flac，这里取普通 audio 里最高优先级
+        ids = {a["id"] for a in audio_streams}
+        best_id = next((q for q in AUDIO_QUALITY_PRIORITY if q in ids), audio_streams[0]["id"])
+        chosen_audio = next(a for a in audio_streams if a["id"] == best_id)
+    elif video is None:
+        raise RuntimeError("playurl 既无视频流也无音频流，无法下载")
+    audio = _to_stream(chosen_audio, "audio")
+    return video, audio
+
+
+def _to_stream(item: dict, media_type: str) -> StreamInfo:
+    """从 dash 里的一个流条目构造 StreamInfo（含备份 URL）。
+
+    对应 GUI download/parse/query_worker.py 的 URL 提取逻辑。
+    """
+    url = item.get("baseUrl") or item.get("base_url") or item.get("url", "")
+    backups = item.get("backupUrl") or item.get("backup_url") or item.get("backupUrls", [])
+    return StreamInfo(
+        url=url,
+        file_size=int(item.get("size", 0) or 0),
+        media_type=media_type,
+        quality_id=item.get("id", 0),
+        codec_id=item.get("codecid", 0),
+        backup_urls=list(backups),
+    )
+
+
+def probe_size(client, url: str, backup_urls: list[str] | None = None) -> int:
+    """HEAD 探测文件大小；容错 CDN 不返回 Content-Length 的情况。
+
+    B 站 CDN 偶发 HEAD 不带 Content-Length，此时回退 GET stream 读 header 或 Content-Range。
+    """
+    candidates = [url] + (backup_urls or [])
+    for u in candidates:
+        if not u:
+            continue
+        try:
+            r = client.head(u, headers={"Referer": "https://www.bilibili.com/"})
+            cl = r.headers.get("Content-Length")
+            if cl and cl.isdigit() and int(cl) > 0:
+                return int(cl)
+            # 回退：GET stream（不下载 body）
+            g = client.get(u, headers={"Referer": "https://www.bilibili.com/"}, stream=True, params={})
+            cl = g.headers.get("Content-Length")
+            if not cl and g.headers.get("Content-Range"):
+                cl = g.headers["Content-Range"].split("/")[-1]
+            g.close()
+            if cl and cl.isdigit():
+                return int(cl)
+        except Exception:
+            continue
+    return 0  # 探测失败，交给分片下载自己处理

bili23_cli-0.1.0/src/bili23_cli/wbi.py

@@ -0,0 +1,75 @@
+"""Wbi 签名（B 站接口鉴权）。
+
+照搬 GUI 源码 `src/util/parse/parser/base.py:16-63` 的算法：
+  mixinKeyEncTab → getMixinKey(img_key+sub_key)[:32] → 加 wts + 排序 + 剔除!'()*
+  → md5(query+mixin_key) → w_rid。
+
+参考：https://github.com/SocialSisterYi/bilibili-API-collect (WBI 签名)
+"""
+from __future__ import annotations
+
+import time
+import urllib.parse
+from functools import reduce
+from hashlib import md5
+from pathlib import Path
+from typing import Tuple
+
+# 固定的混淆表（GUI base.py:16-21）
+MIXIN_KEY_ENC_TAB = [
+    46, 47, 18, 2, 53, 8, 23, 32, 15, 50, 10, 31, 58, 3, 45, 35, 27, 43, 5, 49,
+    33, 9, 42, 19, 29, 28, 14, 39, 12, 38, 41, 13, 37, 48, 7, 16, 24, 55, 40,
+    61, 26, 17, 0, 1, 60, 51, 30, 4, 22, 25, 54, 21, 56, 59, 6, 63, 57, 62, 11,
+    36, 20, 34, 44, 52,
+]
+
+# nav 接口返回的 wbi_img URL 的 stem 就是这两个 key（GUI user.py:25-29）
+NAV_API = "https://api.bilibili.com/x/web-interface/nav"
+
+
+def get_mixin_key(img_key: str, sub_key: str) -> str:
+    """用混淆表对 img_key+sub_key 重新排列，取前 32 位作为签名密钥。"""
+    raw = img_key + sub_key
+    return reduce(lambda s, i: s + raw[i], MIXIN_KEY_ENC_TAB, "")[:32]
+
+
+def sign(params: dict, img_key: str, sub_key: str) -> str:
+    """对请求参数做 Wbi 签名，返回完整的 query string（含 wts + w_rid）。
+
+    对应 GUI base.py:44-63 的 enc_wbi()。
+    """
+    mixin_key = get_mixin_key(img_key, sub_key)
+    curr_time = round(time.time())
+
+    params = dict(sorted({**params, "wts": curr_time}.items()))
+    # 剔除 B 站规定的非法字符
+    params = {
+        k: "".join(filter(lambda ch: ch not in "!'()*", str(v)))
+        for k, v in params.items()
+    }
+
+    query = urllib.parse.urlencode(params)
+    w_rid = md5((query + mixin_key).encode()).hexdigest()
+    params["w_rid"] = w_rid
+    return urllib.parse.urlencode(params)
+
+
+def fetch_wbi_keys(client) -> Tuple[str, str, dict]:
+    """调 /x/web-interface/nav 拉 img_key / sub_key（该接口本身无需 Wbi 签名）。
+
+    对应 GUI user.py:21-29。注意：不信任 config.json 里存的旧值，每次实时拉取。
+    返回 (img_key, sub_key, nav_data)，nav_data 含 isLogin/uname/vipStatus 等。
+    """
+    resp = client.get(NAV_API)
+    resp.raise_for_status()
+    data = resp.json()
+    # 注意：nav 接口在未登录时返回 code=-101，但 data.wbi_img 仍然存在
+    # （Wbi 签名密钥与登录态无关，匿名也可用于对 wbi 接口签名）
+    payload = data.get("data") or {}
+    wbi = payload.get("wbi_img")
+    if not wbi or "img_url" not in wbi:
+        raise RuntimeError(f"nav 接口未返回 wbi_img：{data.get('message', data)}")
+
+    img_key = Path(wbi["img_url"]).stem
+    sub_key = Path(wbi["sub_url"]).stem
+    return img_key, sub_key, payload