一键安装
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。
项目结构
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 # 打包工具
打包与发布
make help # 查看可用命令
make pack SKILL=baidu-netdisk # 打包指定 Skill
make pack-all # 打包所有 Skills
推送 tag 自动触发 GitHub Release：
git tag v1.2.0
git push origin v1.2.0
参与贡献
欢迎参与共建！详见 贡献指南。
- Fork 本仓库
- 基于
main 创建功能分支
- 提交 PR（使用 Conventional Commits 格式）
加入社区
- 与核心开发团队直接交流
- 提交 Bug 反馈和功能建议
- 参与 Skill 共建计划
许可证
Apache License 2.0
