Baidu Drive

核心功能

bdpan-storage 是百度网盘的官方命令行管理工具 Skill，为 Agent 提供完整的网盘文件操作能力。支持上传、下载、转存、分享、列表查询、搜索、移动、复制、重命名、创建文件夹等核心功能。

显著优点

1. 功能完整覆盖：几乎涵盖百度网盘 Web/移动端的所有核心文件操作，包括分享链接的转存与下载、批量文件管理、按类型搜索等高频需求
2. 安全沙箱设计：强制限制在 /apps/bdpan/ 目录内操作，路径合法性验证严格，防止越权访问用户网盘其他区域
3. 明确的确认机制：路径模糊、覆盖风险、操作意图不明确时必须向用户确认，避免误操作
4. 登录安全可控：禁用裸 bdpan login，强制使用封装脚本 login.sh，内置完整授权流程和安全免责声明
5. 更新不可静默：明确禁止自动更新，必须由用户主动发起，保留确认环节

潜在局限与风险

1. 安装执行风险：install.sh 从百度 CDN 下载二进制并执行，属 download+execute 模式，虽内部有 SHA256 校验但仍需信任百度官方渠道
2. Token 管理敏感：配置文件含 OAuth Token，虽禁止 Agent 输出，但本地存储仍存在泄露风险
3. 分享接口付费：创建分享链接需购买百度开放平台服务，免费用户无法使用
4. 目录限制较死：只能操作 /apps/bdpan/，无法管理网盘根目录或其他区域
5. 内测阶段：文档标注为内测，API 稳定性、长期维护存在不确定性

适合人群

• 需要在 Agent 工作流中自动化网盘文件传输的开发者/高级用户
• 频繁使用分享链接转存、批量上传下载的重度网盘用户
• 能接受命令行操作、理解 OAuth 授权流程的技术用户

常规风险

• 社交工程攻击：攻击者可能诱导用户授权恶意应用，需用户自行辨认官方登录流程
• Token 泄露：配置文件权限不当或环境共享可能导致授权凭证泄露
• 误操作覆盖：虽有多重确认，但用户确认失误仍可能导致文件丢失
• 服务依赖：完全依赖百度网盘服务可用性和 API 政策，存在服务变更或限流风险

核心用法

百度网盘存储 Skill 是一款面向 Agent 的百度网盘文件管理工具，基于 bdpan CLI 实现完整的云端文件生命周期管理。用户通过自然语言指令即可触发上传、下载、转存、分享、搜索、移动、复制、重命名、创建文件夹等操作。Skill 采用严格的触发规则——必须同时满足"明确提及百度网盘关键词"和"操作意图明确"两个条件才会执行，有效避免误触发。

使用前需完成前置检查：自动安装 bdpan CLI（如未安装）、引导登录认证、验证路径合法性。所有文件操作被限制在 /apps/bdpan/ 目录内，路径支持相对路径写法，CLI 内部自动拼接完整 API 路径，展示时转换为中文路径名。支持分享链接直接下载（含提取码自动识别）、批量转存、JSON 格式输出等高级功能。

显著优点

来源可信度高：由百度官方开发维护，信任分级为 T1（知名大公司），所有网络请求均指向百度官方域名，具备企业级安全保障。

安全机制完善：实现多层安全防护——强制用户确认流程（路径不明确、文件已存在、意图模糊等场景必须确认）、SHA256 完整性校验、Token 加密存储、授权码安全传递（通过 stdin 管道避免命令行泄露）。安全限制具有最高优先级，不可被用户指令覆盖。

功能覆盖全面：涵盖网盘核心使用场景，从基础的上传下载到分享链接管理，从单文件操作到批量处理，满足个人备份、团队协作、资源转存等多种需求。

用户体验优化：上下文延续机制允许在连续对话中省略关键词；完善的中文路径映射和清晰的输出格式；详细的错误排查文档和示例支持。

潜在缺点与局限性

动态代码风险：安装和更新过程从百度官方 CDN 下载并执行二进制文件，属于 L1 级动态代码加载。虽已实施来源校验和完整性验证，但理论上仍存在供应链攻击风险（如 CDN 入侵、DNS 劫持）。

权限粒度较粗：Skill 需要访问用户全部网盘数据（通过百度网盘 API），虽然操作被限制在 /apps/bdpan/ 目录，但技术上具备更广泛的访问权限，百度开放平台尚未提供更细粒度的 OAuth Scope 控制（如只读、指定目录访问）。

付费功能限制：分享功能为百度网盘开放平台付费接口，需额外购买服务才能使用。

环境依赖要求：依赖系统标准工具（curl/wget/unzip/shasum），部分精简环境可能需要手动安装依赖。

适合的目标群体

• 个人云存储用户：需要频繁在本地与百度网盘之间传输文件，希望简化操作流程的用户
• 内容创作者与资源管理者：需要整理、备份、分享大量素材文件的设计师、视频创作者、自媒体运营者
• 自动化需求用户：希望构建定时备份、批量同步等自动化工作流的技术用户
• 团队协作场景：需要共享网盘资源、管理团队成员文件访问的轻量级协作需求

使用风险与注意事项

供应链安全风险：首次安装和更新时从远程下载可执行文件，建议在高安全需求场景下使用沙箱环境执行，或手动审查下载的二进制文件。

Token 安全存储：OAuth Token 存储于本地配置文件（~/.config/bdpan/config.json），需确保文件权限正确（建议 0600），防止其他用户读取。

数据隐私边界：Skill 能够访问用户网盘中的全部文件（尽管操作被限制在指定目录），用户应充分了解此权限范围，避免存储高度敏感的个人隐私数据。

网络稳定性依赖：所有操作依赖百度网盘 API 服务，受网络状况、百度服务端稳定性、账号状态（如空间不足、会员过期）等因素影响。

BETA 阶段稳定性：当前处于内测阶段，部分功能可能存在未知问题，建议参考 reference/notes.md 了解已知限制。