核心用法
bdpan-storage 是百度网盘官方命令行工具的技能封装，提供完整的云端文件生命周期管理。用户通过自然语言触发网盘相关操作（上传、下载、转存、分享、搜索、移动、复制、重命名、创建文件夹），Agent 自动转换为 bdpan CLI 指令执行。
典型工作流：
1. 前置检查：自动检测工具安装状态，未安装则调用官方脚本从百度 CDN 下载
2. 认证管理：通过交互式脚本完成 OAuth2 登录（禁止直接操作 token）
3. 路径转换：用户可见中文路径（"我的应用数据/..."）与 API 路径（/apps/bdpan/...）自动映射
4. 风险分级：删除、覆盖等高危操作强制确认，列表查询等低风险操作直接执行
显著优点
- 功能完整：覆盖网盘核心场景，支持分享链接直接下载（自动转存+下载到本地）
- 来源权威：百度官方 CDN 分发，内置 SHA256 完整性校验
- 交互安全：32位授权码自动识别、模糊意图强制确认、用户取消即时中止
- 路径隔离：严格限定
/apps/bdpan/目录，禁止路径穿越攻击
潜在局限
- 付费限制：分享功能需购买百度网盘开放平台服务
- 内测状态：稳定性与 API 兼容性可能存在变动，需关注
reference/notes.md更新 - 单文件路径约束：上传时远端路径必须以文件名结尾，不能以
/结尾 - 环境依赖：需外部网络访问百度 CDN 及 OAuth 服务
适合人群
- 需要在 AI 助手会话中快速管理网盘资源的个人用户
- 有批量文件操作、自动化备份需求的轻度自动化用户
常规风险
- 凭证安全：配置文件中存储 access_token，禁止 Agent 读取输出
- 更新安全：禁止自动/静默更新，必须由用户明确指令触发
- 路径注入：已防御
..、~等穿越尝试，但需警惕非常规 Unicode 路径