核心用法
bdpan-storage 是百度网盘官方提供的命令行文件管理工具，专为 Claude Code 等 AI 编程环境设计。所有操作被严格限制在 /apps/bdpan/ 沙箱目录内，通过 bdpan 命令实现完整的网盘生命周期管理。
基础工作流：
1. 环境准备：首次使用需执行安装脚本 bash ${CLAUDE_SKILL_DIR}/scripts/install.sh，完成 SHA256 校验的两步确认安装
2. 身份认证：必须通过专用登录脚本 bash ${CLAUDE_SKILL_DIR}/scripts/login.sh 完成 OAuth2 授权，严禁直接调用 bdpan login
3. 文件操作：支持上传（upload）、下载（download）、转存（transfer）、分享（share）、搜索（search）、移动/复制/重命名（mv/cp/rename）等核心功能
特色能力：
- 分享链直读：支持直接解析
https://pan.baidu.com/s/xxxx格式链接，自动处理提取码，可选择转存到网盘或下载到本地 - 智能路径映射：命令中使用相对路径（如
docs/file.txt），展示时转换为中文名（如我的应用数据/bdpan/docs/file.txt） - 风险分级确认：删除操作、覆盖上传等高风险行为强制二次确认；列表查询等低风险操作直接执行
显著优点
1. 官方背书：百度网盘开放平台原生支持，API 稳定性与持续性有保障
2. 安全沙箱：路径强制限定在 /apps/bdpan/，杜绝路径穿越攻击，Token 等敏感凭据禁止读取输出
3. 交互友好：分享链接自动识别、转存/下载双模式、中文路径展示，降低国内用户使用门槛
4. 更新可控：安装/更新均采用两步确认+SHA256 校验机制，用户可在应用前审查文件内容
潜在局限
1. 付费墙：分享功能依赖百度网盘开放平台付费接口，免费用户无法使用
2. 目录限制：所有操作被锁定在特定沙箱目录，无法直接管理网盘根目录或其他位置文件
3. 登录依赖：未登录状态下所有功能不可用，且登录流程需人工介入授权码交互
4. 生态封闭：仅支持百度网盘，无法跨平台管理阿里云盘、天翼云盘等其他国内网盘
适合人群
- 开发者/DevOps：需要在 CI/CD 或脚本环境中自动化处理百度网盘文件
- 内容创作者：频繁接收网盘分享链接，需要批量转存、整理素材
- 多设备用户：跨 Linux/macOS/Windows 终端统一管理网盘资源
- 隐私敏感用户：偏好命令行工具，不愿在浏览器中常驻网盘 Web 端
常规风险
- Token 泄露：虽 Agent 被禁止输出配置文件，但用户环境若被入侵，本地存储的 access_token 仍可能被盗用
- 误操作覆盖：上传/下载同名文件时若跳过确认，可能导致数据丢失（Skill 已内置高风险管理）
- 服务中断：百度网盘 API 限速、封号策略调整可能影响工具可用性
- 社交工程：分享链接可能携带恶意文件，转存后建议本地杀毒扫描后再打开