核心功能概述
bdpan-storage 是百度网盘官方命令行工具 Skill，为 AI Agent 提供完整的网盘文件管理能力。支持上传、下载、转存、分享、列表查询、搜索、移动、复制、重命名、创建文件夹等核心操作，所有文件操作均被严格限制在 /apps/bdpan/ 隔离目录内。
显著优点
1. 官方级可靠性
- 基于百度网盘官方 OpenAPI 构建，使用百度 CDN 官方分发渠道（
issuecdn.baidupcs.com、pan.baidu.com） - 强制 SHA256 完整性校验，安装和更新环节均不可绕过
- 登录流程通过专用脚本
login.sh执行，内置完整安全免责声明
2. 功能覆盖全面
- 文件生命周期管理：上传/下载/移动/复制/重命名/删除
- 分享生态支持：创建分享链接、提取码管理、分享链接转存
- 高级检索能力：支持按类型筛选（视频/音频/图片/文档等）、分页查询、仅文件/仅文件夹过滤
- 批量操作友好：多文件分享、文件夹整体上传下载
3. 安全架构设计
- 路径沙箱化：所有操作限定于
/apps/bdpan/，禁止..、~或绝对路径逃逸 - 敏感信息保护：Token、配置文件内容禁止输出，环境变量禁止 Agent 主动设置
- 确认机制：路径不明确、覆盖风险、操作意图模糊、代词引用等场景强制用户确认
- 更新管控：严禁自动/静默更新，必须用户明确指令
潜在局限与风险
1. 安装机制固有风险
采用 download+execute 模式，虽通过强制 SHA256 校验和官方域名限制缓解，但校验文件与安装器同源下载。若百度 CDN 被入侵，存在供应链攻击理论可能。建议安全敏感场景使用沙箱环境。
2. 付费功能限制
分享接口为百度网盘开放平台付费服务，免费用户无法直接使用分享功能。
3. 路径认知成本
用户可见中文路径（"我的应用数据/bdpan/..."）与命令参数相对路径（docs/f.txt）存在映射关系，CLI 内部再拼接为 API 路径（/apps/bdpan/...），三层语义需理解区分。
4. 内测阶段稳定性
文档明确标注内测阶段，可能存在未充分验证的边缘场景。
适合人群
- 需要在 AI Agent 工作流中自动化网盘文件管理的开发者/高级用户
- 习惯命令行操作、追求效率的技术从业者
- 有定期备份、批量转存、文件同步需求的网盘中重度用户
- 能接受 OAuth 授权流程、理解路径沙箱限制的用户
常规风险提示
- 授权安全：登录需访问百度 OAuth 授权页，确保在可信环境操作
- 覆盖风险：上传/下载遇同名文件时需主动选择覆盖/重命名/取消，误操作可能导致数据丢失
- Token 有效期：需关注登录状态，
whoami可查询有效期，过期需重新授权 - 分享合规：生成的分享链接需遵守百度网盘内容审核规则，违规资源可能被拦截