核心用法
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 脚本，环境异常时可能失败