Repository navigation
Releases
Releases · CodingRookie98/bdpan-cli
bdpan-cli v0.3.0
🚀 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 快速上手教程。
- 统一门面类 BaiduPan: 新增
- BK-0045 (Python SDK 门面类与开箱即用 API):
Full Changelog: v0.2.0...v0.3.0
bdpan-cli v0.2.0
🚀 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)。
- XDG 全局配置支持与优先级加载:
- BK-0043 (BYOK 凭证配置与一键浏览器登录):
- 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,矩阵多平台二进制仅追加上传。
- Release Notes 自动化提取: 引入
Full Changelog: v0.1.0...v0.2.0
v0.1.0
Release v0.1.0: First public open-source release of bdpan-cli