核心用法
bdpan-storage 是百度网盘的命令行管理工具,封装了官方开放平台的文件操作能力。用户通过授权登录后,可在 /apps/bdpan/ 目录空间内执行全套云存储操作:
文件传输:支持本地上传(upload)、云端下载(download)、分享链接直下(自动转存+下载)。文件管理:列表查询(ls)、搜索(search)、移动/复制/重命名(mv/cp/rename)、创建文件夹(mkdir)。分享协作:生成带提取码的分享链接(share)、将他人分享转存到个人网盘(transfer)。
操作采用分级确认机制:删除、覆盖类高风险操作必须二次确认;路径模糊或意图不明时主动澄清;常规查询类操作直接执行。
显著优点
1. 官方生态整合:直接对接百度网盘开放平台,传输速率受限于百度会员等级,但稳定性优于第三方爬虫方案
2. 安全设计完善:强制HTTPS下载、SHA256完整性校验、ZIP炸弹防护、路径穿越拦截,安装更新需用户多次确认
3. 交互体验优化:中文路径展示、JSON输出支持、上下文延续设计(对话中无需重复触发词)
潜在缺点与局限
- 存储空间隔离:所有文件限制在
/apps/bdpan/目录(对应"我的应用数据/bdpan/"),无法操作网盘根目录或其他位置 - 分享功能付费:生成分享链接需购买百度开放平台服务,非免费功能
- 依赖百度账号体系:登录流程需用户手动获取授权码,无法完全自动化
- 内测阶段:可能存在未公开的稳定性问题,参考文档提示"详见 notes.md"
适合人群
- 需要在 Claude Code / DuClaw 等环境中自动化处理百度网盘文件的开发者
- 习惯命令行操作、追求效率的百度网盘重度用户
- 有批量上传、定时备份、分享链转存等自动化需求的用户
常规风险
1. Token泄露风险:虽禁止Agent读取 config.json,但用户仍需保护本地配置文件
2. 误操作覆盖:上传/下载同名文件时若匆忙确认可能导致数据丢失
3. 授权码钓鱼:需警惕非官方渠道的"授权工具",应仅使用 Skill 内置的 login.sh 脚本
4. 服务依赖风险:百度网盘政策变更可能导致接口失效或收费调整