什么是bdpan-storage
bdpan-storage 是一款专为开发者和管理员设计的百度网盘命令行工具，旨在通过简洁的命令行接口高效管理百度网盘中的文件资源。该工具深度适配 OpenClaw、Claude Code、DuClaw、KimiClaw、Manus 等主流 AI 开发平台，可在自动化工作流中无缝集成网盘操作。所有文件操作均被限制在 `/apps/bdpan/` 目录范围内，确保数据隔离与安全性。工具当前处于内测阶段，支持上传、下载、转存、分享链接解析、文件列表查询等核心功能，适用于需要批量处理云端文件或构建自动化备份流程的场景。 该工具的核心设计理念是“安全可控”与“意图明确”。在执行任何操作前，系统会先检查用户登录状态，并通过内置脚本引导完成授权流程，避免直接暴露敏感认证信息。同时，工具严格遵循路径规则：命令中使用 API 路径（如 `/apps/bdpan/docs/f.txt`），但展示给用户时转换为友好中文名（如“我的应用数据/bdpan/docs/f.txt”），防止误操作。此外，对于可能覆盖已有文件的场景，工具会主动向用户确认操作类型（覆盖/重命名/取消），确保数据完整性。 bdpan-storage 特别适合在开发环境中使用，例如自动同步项目文档到云端、批量下载模型配置文件、或通过分享链接快速获取第三方资源。其 JSON 输出模式便于与其他脚本或 CI/CD 流水线集成，实现无人值守的文件管理任务。虽然目前仅支持百度网盘，但其模块化设计为未来扩展其他云存储服务预留了空间。整体而言，这是一款面向技术用户的轻量级、高可靠性的网盘管理工具，尤其适合追求效率与自动化的新一代开发者。
核心功能特点
- 支持上传本地文件或文件夹至百度网盘指定目录
- 支持从百度网盘下载文件到本地，自动处理同名冲突
- 支持通过分享链接转存文件到网盘，无需下载到本地
- 提供文件列表查询功能，支持递归查看目录结构
- 内置登录与注销机制，支持 WebView 授权流程
- 支持 JSON 格式输出，便于脚本集成与自动化处理
适用场景
bdpan-storage 最典型的应用场景是在开发环境中实现文件与云端的自动化同步。例如，开发者可以在代码提交后自动触发 `bdpan upload` 命令，将生成的日志文件或构建产物上传至百度网盘，方便团队共享或长期归档。对于需要频繁访问远程资源的场景，如调用外部 API 返回百度网盘分享链接，可通过 `bdpan transfer` 命令直接将内容转存至指定目录，省去手动操作的繁琐步骤。这种能力特别适用于 AI 训练数据的预处理流程，能够快速整合多来源的公开数据集。 另一个高频使用场景是批量下载与备份。假设某项目依赖多个分散在百度网盘中的配置文件，管理员可以编写简单脚本，利用 `bdpan download` 命令将这些文件统一拉取到本地工作区，确保环境一致性。同样，当需要将本地重要资料定期备份至云端时，也可配置定时任务执行上传操作，形成自动化的数据保护机制。由于所有操作均在受控目录内进行，企业用户可放心用于内部知识库管理，避免敏感信息外泄。 此外，bdpan-storage 还适合用于教育或协作场景中的资源共享。教师可将课件材料通过分享链接发布，学生则使用 `bdpan transfer` 一键保存至个人学习空间；团队成员也能快速分享项目文档，提升协作效率。工具的确认机制和路径校验功能进一步降低了误操作风险，使得非专业用户也能在指导下安全使用。总体来看，无论是个人开发者还是团队协作，bdpan-storage 都能显著简化网盘文件管理流程，释放更多精力聚焦于核心任务。