Bdpan Storage

百度网盘存储 Skill

百度网盘文件管理工具，支持上传、下载、转存、分享、列表查询。所有操作限制在 /apps/bdpan/ 目录内。

适配产品: OpenClaw, Claude Code, DuClaw, KimiClaw, Manus 等。

内测阶段，使用注意事项详见 reference/notes.md

触发规则

同时满足以下两个条件才执行：

1. 用户明确提及百度网盘——消息中包含 "百度网盘"、"bdpan"、"网盘" 等关键词
2. 操作意图明确——能确定是以下操作之一：上传、下载、转存、分享、列表查看、登录、注销

不满足时，不执行任何 bdpan 命令。

确认规则

以下场景必须先向用户确认，不得直接执行：

确认时使用以下格式：

操作类型: [上传/下载/分享/列表]
源路径: [路径]
目标路径: [路径]
请确认是否执行？

前置检查

每次执行 bdpan 命令前：

1. bdpan whoami 检查登录状态，未登录则引导执行 @skills/bdpan-storage/scripts/login.sh
2. 验证路径合法性（禁止 ../，禁止 /apps/bdpan 以外的绝对路径）

核心功能

上传

bdpan upload <本地路径> <远程路径>
bdpan upload ./project/ project/          # 文件夹需加 /

步骤：确认本地路径存在 → 确认远程路径 → 用 bdpan ls 检查远程是否已存在 → 执行上传

下载

bdpan download <远程路径> <本地路径>
bdpan download report.pdf ./report.pdf
bdpan download backup/ ./backup/          # 文件夹需加 /

步骤：用 bdpan ls 确认云端路径存在 → 确认本地路径 → 检查本地是否已存在 → 执行下载

转存（仅转存到网盘，不下载到本地）

# 基本用法 - 转存到应用根目录 /apps/bdpan/
bdpan transfer <分享链接> -p <提取码>

# 提取码在链接中
bdpan transfer "https://pan.baidu.com/s/1xxxxx?pwd=abcd"

# 指定目标目录
bdpan transfer <分享链接> -p <提取码> -d my-folder/

# JSON 输出
bdpan transfer <分享链接> -p <提取码> --json

步骤：验证链接格式 → 确认有提取码 → 确认目标目录 → 执行转存

分享链接下载

# 链接中含提取码
bdpan download "https://pan.baidu.com/s/1xxxxx?pwd=abcd" <本地路径>
# 单独传入提取码
bdpan download "https://pan.baidu.com/s/1xxxxx" <本地路径> -p <提取码>
# 指定转存目录
bdpan download "<链接>" <本地路径> -t <转存目录>

步骤：验证链接格式 → 确认有提取码 → 确认本地保存路径 → 执行下载

分享

bdpan share <远程路径>
bdpan share <路径1> <路径2>               # 多文件分享

列表查询

bdpan ls                                  # 根目录
bdpan ls <目录路径>                        # 指定目录
bdpan ls --json                           # JSON 输出

登录

必须使用登录脚本执行登录：

bash scripts/login.sh

强制要求：

• ✅ 必须使用 @skills/bdpan-storage/scripts/login.sh 脚本
• ❌ 禁止直接使用 bdpan login（即使在 GUI 环境）
• ❌ 禁止直接调用 bdpan login --get-auth-url、bdpan login --set-code

登录脚本内置了完整的安全免责声明和授权流程，确保用户知情同意。

注销

bdpan logout

版本管理

bdpan update check                        # 检查更新
bdpan update                              # 执行更新（需用户确认）
bdpan update rollback                     # 回滚（需用户确认）

路径规则

所有远程路径相对于 /apps/bdpan/。有两条映射规则：

映射关系：我的应用数据 ↔ /apps

禁止：

• 命令中使用中文路径（我的应用数据/bdpan/...）
• 展示时暴露 API 路径（/apps/bdpan/...）
• 路径包含 .. 或 ~
• 绝对路径不在 /apps/bdpan 下

授权码处理

当用户在对话中发送 32 位十六进制字符串且上下文与百度网盘登录相关时，将其作为授权码处理，执行 bash scripts/login.sh --yes。

如果上下文不明确，先向用户确认："这是百度网盘授权码吗？"

参考文档

详细信息参见 reference 目录（遇到对应问题时查阅）：