核心用法
bdpan-storage 是面向 Claude Code 等 Agent 环境设计的百度网盘命令行管理工具,提供完整的文件生命周期操作:上传、下载、转存、分享、搜索、移动、复制、重命名及目录管理。所有操作限定在 /apps/bdpan/ 沙箱目录内,通过 bdpan CLI 与百度网盘 Open API 交互。
显著优点
1. 功能完整性:覆盖网盘核心场景,包括分享链接直接下载(自动转存+下载)、批量转存、带提取码的分享生成、多维度搜索(按类别/目录/文件过滤)
2. 安全架构严谨:强制 OAuth2 授权码登录(禁止密码模式)、Token 文件禁止读取输出、双步确认机制(安装/更新均需 SHA256 校验+用户确认)、路径防穿越保护
3. Agent 友好设计:JSON 输出支持、明确的触发规则与上下文延续机制、风险分级确认策略(删除/覆盖高敏感操作强制确认)
4. 环境隔离:工作目录严格限定,避免误操作系统文件
潜在缺点与局限性
- 付费接口限制:分享功能依赖百度开放平台付费服务,免费用户无法使用
- 路径转换复杂度:用户可见中文路径("我的应用数据")与命令行 API 路径(
/apps/bdpan/)需手动映射,增加学习成本 - 单文件上传限制:远端路径必须以文件名结尾,不能以
/结尾,易因格式错误失败 - 第三方非官方:非百度官方出品,长期维护依赖社区
适合人群
- 需要脚本化/自动化管理百度网盘的开发者与高级用户
- Claude Code、DuClaw 等 Agent 环境用户
- 对数据安全有要求、愿意接受操作确认流程的谨慎型用户
常规风险
- 授权码泄露风险:32 位 OAuth 授权码一旦泄露可导致账号被接管,系统强制确认机制降低概率
- 文件覆盖风险:上传/下载目标存在同名文件时需二次确认,但批量场景仍可能误操作
- API 稳定性风险:百度网盘开放政策调整可能导致功能受限
- 依赖外部脚本:安装/登录/更新依赖
${CLAUDE_SKILL_DIR}/scripts/下的 shell 脚本,环境异常时可能失败