--- slug: "bdpan-storage" source_type: "readme" source_url: "https://cdn.jsdelivr.net/gh/baidu-netdisk/bdpan-storage@main/README.md" repo: "https://github.com/baidu-netdisk/bdpan-storage" source_file: "README.md" branch: "main" ---

baidu-drive

百度网盘 AI Skill — 让 Agent 一句话操作你的网盘

Version License Skill

上传 / 下载 / 转存 / 分享 / 搜索 / 移动 / 复制 / 重命名 / 创建文件夹
适配 Claude Code · OpenClaw · DuClaw · KimiClaw · Manus 等 AI Agent

Baidu Netdisk AI Skill — Manage cloud files with natural language.
Compatible with Claude Code · Cursor · Codex CLI · Gemini CLI · OpenClaw · DuClaw · KimiClaw · Manus

--- ## 一键安装 ```bash npx skills add https://github.com/baidu-netdisk/bdpan-storage/skills --skill baidu-drive ``` 首次使用时，Skill 会自动引导完成 CLI 工具安装和百度网盘登录授权。 ## 用自然语言操作网盘 安装完成后，在你的 AI Agent 中直接说： ``` 帮我上传 ./report.pdf 到百度网盘 ``` ``` 从网盘下载 backup/ 文件夹到本地 ``` ``` 转存这个链接：https://pan.baidu.com/s/1xxxxx?pwd=abcd ``` ``` 搜索网盘里所有 PDF 文件 ``` ``` 把网盘里的 report.pdf 分享给同事 ``` Skill 自动识别意图、执行操作、返回格式化结果。 ## 功能 | 功能 | 说明 | 示例指令 | |------|------|---------| | **上传** | 上传文件或文件夹到网盘 | "上传 ./data.csv 到网盘" | | **下载** | 从网盘下载到本地 | "下载网盘里的 report.pdf" | | **分享链接下载** | 通过分享链接 + 提取码下载 | "下载这个网盘分享 https://pan.baidu.com/s/1xxx 提取码 abcd" | | **转存** | 将分享内容转存到自己的网盘 | "转存这个链接到网盘" | | **分享** | 生成分享链接（1天、7天、30天、永久） | "把 report.pdf 分享给别人" | | **列表查询** | 查看网盘文件列表 | "看看网盘里有什么文件" | | **搜索** | 按关键词/类型搜索 | "在网盘搜一下所有图片" | | **移动** | 移动文件到指定目录 | "把 report.pdf 移动到 backup 目录" | | **复制** | 复制文件到指定目录 | "复制 config.yaml 到 backup" | | **重命名** | 重命名文件或文件夹 | "把 old.pdf 重命名为 new.pdf" | | **创建文件夹** | 在网盘中新建文件夹 | "在网盘里新建一个 projects 文件夹" | ## 使用示例 ### 上传并分享 ``` 帮我上传 ./report.pdf 到网盘并分享 ``` ``` 上传并分享成功! 链接: https://pan.baidu.com/s/xxxxxxx 提取码: abcd 有效期: 7 天 ``` ### 查看文件列表 ``` 查看我网盘里的文件 ``` ``` 类型 大小 修改时间 文件名 ------ ------------ -------------------- -------- 目录 - 2026-02-20 10:30:00 backup 文件 1.5 MB 2026-02-25 15:20:00 report.pdf 文件 256 KB 2026-02-24 09:15:00 config.yaml 共 3 项 ``` ### 转存分享链接 ``` 帮我转存这个链接到网盘 https://pan.baidu.com/s/1xxxxx?pwd=abcd ``` ``` 转存成功! 文件: 项目资料.zip (128 MB) 目标目录: 我的应用数据/bdpan/ ``` ## 安全设计 | 特性 | 说明 | |------|------| | **作用域隔离** | 所有操作限制在 `/apps/bdpan/` 目录，无法访问用户其他文件 | | **无删除操作** | 不提供删除命令，从根本上防止误删 | | **修改前确认** | 移动、重命名、覆盖等操作执行前必须用户确认 | | **OAuth 2.0** | 授权码模式认证，不存储用户密码 | | **Token 保护** | 配置文件含 Token，Agent 禁止读取或输出其内容 | | **安全传码** | 授权码通过 stdin 传递，不暴露在进程列表中 | | **SHA256 校验** | 安装和更新的二进制文件强制完整性校验 | | **更新需确认** | 禁止自动或静默更新，必须用户明确指令并确认 | > 本工具处于公测期（BETA），建议备份重要数据，并人工审核每条 AI 执行的命令。 ## 系统支持 | 平台 | 架构 | 状态 | |------|------|:----:| | macOS | arm64 / amd64 | ✅ | | Linux | arm64 / amd64 | ✅ | | Windows (WSL) | amd64 | ✅ | | Windows (原生) | — | ❌ | ## 故障排除 遇到问题时，直接对 Skill 说： - **Token 过期** — "百度网盘 token 过期了" → 自动引导重新登录 - **检查状态** — "检查网盘登录状态" → 显示当前认证信息 - **更新** — "更新一下 bdpan" → 检查并更新 Skill 和 CLI 更多故障排查指南参见 [troubleshooting.md](https://github.com/baidu-netdisk/bdpan-storage/blob/HEAD/skills/baidu-netdisk/reference/troubleshooting.md)。 ## 项目结构 ``` bdpan-storage/ ├── skills/baidu-netdisk/ # Skill 主目录 │ ├── SKILL.md # Skill 定义（Agent 行为规范） │ ├── VERSION # 版本号 │ ├── reference/ # 参考文档 │ │ ├── bdpan-commands.md # 完整命令手册 │ │ ├── authentication.md # 认证流程说明 │ │ ├── examples.md # 使用示例 │ │ └── troubleshooting.md # 故障排查 │ └── scripts/ # 管理脚本 │ ├── install.sh # 安装 │ ├── login.sh # 登录 │ ├── update.sh # 更新 │ └── uninstall.sh # 卸载 ├── .github/workflows/ # CI/CD ├── docs/ # 文档资源 └── Makefile # 打包工具 ``` ## 打包与发布 ```bash make help # 查看可用命令 make pack SKILL=baidu-netdisk # 打包指定 Skill make pack-all # 打包所有 Skills ``` 推送 tag 自动触发 GitHub Release： ```bash git tag v1.2.0 git push origin v1.2.0 ``` ## 参与贡献 欢迎参与共建！详见 [贡献指南](https://github.com/baidu-netdisk/bdpan-storage/blob/HEAD/docs/contributing.md)。 1. Fork 本仓库 2. 基于 `main` 创建功能分支 3. 提交 PR（使用 [Conventional Commits](https://www.conventionalcommits.org/) 格式） ## 加入社区

加入社区

扫码添加，备注「github」即可入群

- 与核心开发团队直接交流 - 提交 Bug 反馈和功能建议 - 参与 Skill 共建计划 ## 许可证 [Apache License 2.0](https://github.com/baidu-netdisk/bdpan-storage/tree/HEAD/LICENSE)