Skip to content

bdpan-cli v0.2.0

Choose a tag to compare

@github-actions github-actions released this 29 Oct 03:55
· 2 commits to main since this release

🚀 bdpan-cli v0.2.0 发布说明

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


📦 快速安装 (Installation)

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

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

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

uvx bdpan-cli@0.2.0 --help

方式 3:传统 pip 安装

pip install --upgrade bdpan-cli==0.2.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(auth): 纯净 BYOK 认证配置、XDG 全局配置链条与优雅登录体验(BK-0043)。
    • BK-0043 (BYOK 凭证配置与一键浏览器登录):
      • XDG 全局配置支持与优先级加载: config.py 实现配置级联加载:os.environ ➔ 当前目录 .env ➔ 全局配置 ~/.config/bdpan/.env(支持 BDPAN_CONFIG_PATH 环境变量覆盖);新增 save_global_config 将凭据写入全局 .env 并自动设置 0o600 安全访问权限;
      • 优雅异常捕获与 Traceback 清零: 消除凭据缺失时的原始 Python 异常堆栈,定义 ConfigError(RuntimeError) 并在 cli.py 顶层统一拦截,输出友好清晰的中文化配置与引导指令(Exit Code 1);在 --json 模式下返回标准化失败信封;
      • 全新 bdpan auth config 子命令: 提供 --app-key、--secret-key、--show(脱敏查看凭证来源与状态)、--path(打印配置文件物理路径)以及交互式终端引导输入,用户全局配置一次后可在任意目录执行 bdpan;
      • 一键浏览器唤起: _device_flow 在获取设备码后自动通过 webbrowser.open 唤起系统默认浏览器打开百度网盘设备授权页面,终端大字高亮显示 User Code,免去繁琐的手动复制打开步骤;
      • 单测全绿保障: 新增 tests/test_config.py(9 项单元测试)并扩展 tests/test_auth.py(1 项单元测试),全量回归测试套件增至 193 项全绿通过(193 passed in 8.78s)。
  • feat(release): 自动化 Release Notes 提取与 GitHub Release 工作流治理。
    • Release Notes 自动化提取: 引入 scripts/extract-release-notes.py,从 changelog.md 提取结构化变更并整合多渠道安装指引;
    • Release 工作流解耦: .github/workflows/release.yml 引入 create-release 阶段,开启 generate_release_notes: true,矩阵多平台二进制仅追加上传。

Full Changelog: v0.1.0...v0.2.0