Skip to content

bdpan-cli v0.3.0

Latest

Choose a tag to compare

@github-actions github-actions released this 29 Oct 07:48

🚀 bdpan-cli v0.3.0 发布说明

百度网盘工程化 CLI 管理工具。基于官方开放平台协议构建,支持多平台免安装独立二进制运行、多账号凭证管理与影视媒体库自动化刮削。


📦 快速安装 (Installation)

方式 1:uv tool 安装(推荐,隔离环境)

uv tool install bdpan-cli@0.3.0
# 若已安装旧版,执行升级:
uv tool upgrade bdpan-cli

方式 2:即用即走(免安装运行)

uvx bdpan-cli@0.3.0 --help

方式 3:传统 pip 安装

pip install --upgrade bdpan-cli==0.3.0

方式 4:跨平台单文件二进制(免 Python 运行时)

可在下方 Assets 附件中直接下载对应操作系统单文件独立二进制可执行包,赋予执行权限后加入 PATH 即可运行:

  • bdpan-linux-amd64 (Linux x86_64)
  • bdpan-macos-arm64 (macOS Apple Silicon)
  • bdpan-windows-amd64.exe (Windows x86_64)

⚡ 快速配置与登录 (Quickstart)

# 1. 配置百度开放平台凭证(全局配置一次,写入 ~/.config/bdpan/.env)
bdpan auth config --app-key <YOUR_APP_KEY> --secret-key <YOUR_SECRET_KEY>

# 2. 授权登录网盘账号(自动唤起默认浏览器打开授权页)
bdpan auth login

# 3. 立即使用
bdpan whoami
bdpan ls /

📝 详细更新日志 (Changelog)

  • feat(sdk): 提供 Python SDK 高层门面类 BaiduPan(BK-0045)。
    • BK-0045 (Python SDK 门面类与开箱即用 API):
      • 统一门面类 BaiduPan: 新增 src/bdpan_cli/client.py,聚合 FileManager、Uploader、Downloader、AccountClient、MediaInfoClient 以及 TokenManager,提供简洁易用的 Pythonic 方法(list_dir/ls、mkdir、rename、move/mv、copy/cp、delete/rm、tree、upload、download、get_media_info、whoami、get_quota 等);
      • 灵活初始化机制: 支持零配置自动初始化(按优先级自动检索环境变量 ➔ 当前目录 .env ➔ XDG 全局配置 ~/.config/bdpan/.env),亦支持显式传入 app_key / secret_key、account 别名或 access_token;
      • 模块顶层导出: 在 src/bdpan_cli/__init__.py 中导出 BaiduPan 门面及 FileManagerError、UploadError、DownloadError、AccountError 等核心异常契约;
      • 测试与文档覆盖: 新增 tests/test_client.py(8 项单元测试),全量回归测试套件达 203 项全绿通过;在中英文 README、docs/tutorials/user-guide.md 与 skills/bdpan-cli/SKILL.md 中同步增补 Python SDK 快速上手教程。

Full Changelog: v0.2.0...v0.3.0