百度网盘文件管理工具,以"命令式高效操作"为核心视角,所有操作限制在 /apps/bdpan/ 目录内。适配所有支持SKILL.md的Agent平台。

本免费版提供核心文件管理能力(上传/下载/转存/分享/搜索/移动/复制/重命名/创建/删除)。记忆备份恢复、大文件后台下载与批量操作为专业版功能。

触发规则

网盘文件操作触发

同时满足以下条件才执行:

1. 用户消息中包含明确指向百度网盘的关键词,至少匹配以下之一:
   • 百度网盘、百度云盘、bdpan、baidu netdisk、baidu pan、baidu drive、pan.baidu.com
2. 操作意图明确(上传/下载/转存/分享/查看/搜索/移动/复制/重命名/创建文件夹/删除/登录/注销)
3. 对于写操作(上传、删除、移动、覆盖式下载、公开分享),即使触发词命中,也必须先列出"将要执行的操作 + 影响范围"并取得用户显式确认(y)后再执行

不要触发的情况:

• 用户仅说"网盘""云盘""云存储""百度云"等泛指或可能指向其他百度产品的词,未明确指向百度网盘 → 应反问"您指的是百度网盘(pan.baidu.com)吗?"再决定
• 用户在讨论其他云盘服务(OneDrive、Google Drive、阿里云盘、夸克网盘等)
• 仅复述、引用或摘要历史聊天记录中的网盘内容,而无新的操作意图

未通过触发规则时,禁止执行任何 bdpan 命令。

已知限制

1. 登录:必须使用 bash ${CLAUDE_SKILL_DIR}/scripts/login.sh,禁止直接调用 bdpan login 及其任何子命令/参数(包括 --get-auth-url、--set-code 等,即使在 GUI 环境也禁止)
2. Token/配置:禁止读取或输出 ~/.config/bdpan/config.json 内容(含 access_token 等敏感凭据)
3. 更新/登录:更新必须由用户明确指令触发,禁止自动或静默执行;Agent 禁止使用 --yes 参数执行 update.sh 或 login.sh
4. 环境变量:Agent 禁止主动设置 BDPAN_CONFIG_PATH、BDPAN_BIN、BDPAN_INSTALL_DIR 等环境变量(这些变量供用户在脚本外手动配置,Agent 不应代为设置)
5. 路径安全:禁止路径穿越(..、~)、禁止访问 /apps/bdpan/ 范围外的绝对路径
6. 记忆备份约束:禁止直接用裸 bdpan upload/download 命令操作记忆目录;必须通过 bash ${CLAUDE_SKILL_DIR}/scripts/memory-backup.sh 脚本执行,以确保 manifest 生成、路径安全检查、safety net 备份等机制正常运行(记忆备份为专业版功能)

• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

前置检查

每次触发时按顺序执行:

1. 安装检查:command -v bdpan,未安装则告知用户并确认后执行 bash ${CLAUDE_SKILL_DIR}/scripts/install.sh(用户确认后可加 --yes 跳过安装器内部确认)
2. 登录检查:bdpan whoami,未登录则引导执行 bash ${CLAUDE_SKILL_DIR}/scripts/login.sh
3. 路径校验:验证远端路径在 /apps/bdpan/ 范围内

确认规则(差异化:分层风险模型)

额外规则:

• 操作意图模糊("处理文件"→确认上传还是下载)→ 必须确认
• 序数/代词引用有歧义("第N个"、"它"、"上面那个")→ 必须确认
• 用户取消意图("算了"、"不要了"、"取消")→ 立即中止,不执行任何命令

使用流程

30秒:确认登录状态

bdpan whoami

未登录则运行: bash ${CLAUDE_SKILL_DIR}/scripts/login.sh

60秒:浏览文件并执行一次操作

bdpan ls

bdpan ls --order time --desc

bdpan upload ./local-file.txt docs/local-file.txt

120秒:完成完整操作流程

1. 前置检查(安装→登录→路径校验)
2. 浏览文件(参见快捷命令模板)
3. 选择操作(上传/下载/转存/分享/搜索/移动/复制/重命名/创建/删除)
4. 路径校验与确认(参见确认规则)
5. 执行操作并报告结果

快捷命令模板(差异化核心)

将常用操作封装为快捷命令,减少输入:

浏览类快捷命令

bdpan ls

bdpan ls docs/ --order name

bdpan ls docs/ --order time --desc

bdpan ls docs/ --order size --desc

bdpan ls docs/ --folder

bdpan ls docs/ --json

搜索类快捷命令

bdpan search "报告"

bdpan search "会议" --category 1

bdpan search "截图" --category 3

bdpan search "合同" --category 4

bdpan search "项目" --dir-only

单文件操作快捷命令

bdpan upload ./local.txt docs/local.txt

bdpan download docs/local.txt ./local.txt

bdpan mv docs/old.txt archive/

bdpan cp docs/template.txt templates/

bdpan rename docs/old-name.txt new-name.txt

bdpan mkdir docs/new-folder

bdpan rm docs/unwanted.txt

分享类快捷命令

bdpan share docs/report.pdf

bdpan share docs/report.pdf --period 0

bdpan share docs/report.pdf --period 30

bdpan share docs/file1.txt docs/file2.txt --period 7

转存类快捷命令

bdpan transfer "https://pan.baidu.com/s/1xxxxx?pwd=abcd"

bdpan transfer "https://pan.baidu.com/s/1xxxxx" -p abcd

bdpan transfer "https://pan.baidu.com/s/1xxxxx" -p abcd -d downloads/

文件分类视图(差异化)

通过 --json 输出配合本地处理,生成分类视图:

按类型分类

bdpan ls docs/ --json | jq -r '.[] | .path' | grep -oE '\.[^.]+$' | sort | uniq -c | sort -rn

按大小分类

bdpan ls docs/ --json | jq -r '
  if .size > 104857600 then "大文件(>100MB)"
  elif .size > 10485760 then "中文件(10-100MB)"
  elif .size > 1048576 then "小文件(1-10MB)"
  else "微小文件(<1MB)"
  end' | sort | uniq -c

按时间分类

bdpan ls docs/ --json | jq -r '.created_at | .[0:7]' | sort | uniq -c

智能路径校验(差异化)

路径补全

bdpan ls docs/ --folder

越界检测

validate_path() {
  local path="$1"
  if [[ "$path" == *"..",* ]] || [[ "$path" == *~* ]]; then
    echo "错误: 路径包含禁止字符(.. 或 ~)"
    return 1
  fi
  if [[ "$path" == /* ]]; then
    echo "错误: 命令参数禁止使用绝对路径,请使用相对路径"
    return 1
  fi
  return 0
}

validate_path "docs/file.txt"    # 通过
validate_path "../etc/passwd"    # 拒绝
validate_path "/etc/passwd"      # 拒绝

操作意图识别(差异化)

歧义消除决策树

用户输入 → 是否包含明确操作动词?
├─ 否 → 反问:"您想做什么?(上传/下载/查看/搜索/移动/删除/分享)"
└─ 是 → 操作对象是否明确?
        ├─ 否 → 反问:"请确认操作对象(哪个文件/目录?)"
        └─ 是 → 路径是否在 /apps/bdpan/ 范围内?
                ├─ 否 → 提示路径越界,建议合法路径
                └─ 是 → 风险等级判断(高/中/低)
                        ├─ 高 → 列出影响范围,等待确认
                        ├─ 中 → 路径模糊时确认
                        └─ 低 → 直接执行

序数/代词引用处理

用户:"把第3个文件移到archive"

处理流程:
1. 查询当前目录文件列表
2. 定位第3个文件(按当前排序)
3. 向用户确认:"将移动 [文件名] 到 archive/,确认?(y/n)"
4. 用户确认后执行 bdpan mv <文件名> archive/

路径规则

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

禁止: 命令中使用中文路径(我的应用数据/...)、展示时暴露 API 路径(/apps/bdpan/...)。

授权码处理

用户发送 32 位十六进制字符串时,先确认:"这是百度网盘授权码吗?确认后将执行登录流程。" 确认后执行 bash ${CLAUDE_SKILL_DIR}/scripts/login.sh(不使用 --yes,保留安全确认环节)。

管理功能

安装

bash ${CLAUDE_SKILL_DIR}/scripts/install.sh [--yes]

安装器从百度 CDN(issuecdn.baidupcs.com)下载并执行。注意:install.sh 不执行本地 SHA256 校验,完整性依赖 HTTPS 传输保护。安全敏感场景建议先手动审查安装器内容或在沙箱中执行。

登录 / 注销 / 卸载

bash ${CLAUDE_SKILL_DIR}/scripts/login.sh              # 登录(内置安全免责声明)
bdpan logout                                            # 注销
bash ${CLAUDE_SKILL_DIR}/scripts/uninstall.sh [--yes]   # 卸载

更新(必须用户明确指令触发)

bash ${CLAUDE_SKILL_DIR}/scripts/update.sh              # 检查并更新(需用户确认)
bash ${CLAUDE_SKILL_DIR}/scripts/update.sh --check       # 仅检查更新

示例

场景一:个人用户 - 日常文件浏览与上传

角色: 个人用户
任务: "帮我把本地的report.pdf上传到网盘的docs目录"

执行流程:
1. 前置检查(安装→登录)
2. 路径校验(docs/在合法范围内)
3. bdpan ls docs/ 检查是否已存在同名文件
4. 如已存在,询问用户是否覆盖(高风险确认)
5. 确认后执行 bdpan upload ./report.pdf docs/report.pdf
6. 展示结果:"已上传到:我的应用数据/bdpan/docs/report.pdf"

场景二:团队协作者 - 分享文件给同事

角色: 团队协作者
任务: "把网盘里的项目方案分享给同事,有效期7天"

执行流程:
1. 前置检查
2. bdpan ls 确认文件存在
3. 根据用户意图选择有效期(默认7天)
4. 执行 bdpan share docs/项目方案.pdf --period 7
5. 展示:链接+提取码+有效期(7天)
6. 提示用户:链接7天后过期,请及时分享

场景三:内容创作者 - 转存分享链接

角色: 内容创作者
任务: "朋友发给我一个分享链接,帮我转存到网盘的downloads目录"

执行流程:
1. 前置检查
2. 确认分享链接格式有效
3. 确认有提取码(链接中含 ?pwd= 或反问用户)
4. 确认目标目录(downloads/)
5. 执行 bdpan transfer "https://pan.baidu.com/s/1xxxxx" -p abcd -d downloads/
6. 展示:转存文件数量与目标目录

错误处理

常见问题

Q: 命令参数中的路径为什么不能用绝对路径? A: 所有操作限制在 /apps/bdpan/ 目录内,命令参数使用相对路径(相对于 /apps/bdpan/)。绝对路径会被拒绝,以确保路径安全。展示给用户时使用中文名(我的应用数据/bdpan/...)。

Q: 上传文件时提示远端路径错误? A: 单文件上传远端路径必须是文件名(如 docs/file.txt),禁止以 / 结尾(如 docs/)。文件夹上传使用 bdpan upload ./project/ project/ 格式。

Q: 如何选择分享有效期? A: 根据语义意图判断:用户表达"长期/永久/不过期"使用 --period 0(并提示安全风险);指定具体天数选择最接近的枚举值(1/7/30);未表达偏好默认 --period 7。永久链接无法自动过期,请注意文件安全。

Q: 分享链接转存和下载有什么区别? A: 转存(bdpan transfer)将分享文件保存到你的网盘,不下载到本地。下载分享链接(bdpan download "分享链接")先转存再下载到本地。如只需保存到网盘用transfer,如需本地文件用download。

Q: 删除文件后能恢复吗? A: bdpan的删除是永久删除,不可恢复。因此删除操作属于高风险,必须用户显式确认。建议删除前先 bdpan ls 确认文件,确认影响范围后再执行 bdpan rm。

Q: 免费版与专业版的核心差异? A: 免费版提供核心文件管理能力(上传/下载/转存/分享/搜索/移动/复制/重命名/创建/删除)。专业版额外解锁:Agent记忆备份与恢复、大文件后台下载(nohup+进度轮询)、批量操作模板、增量同步、完整性校验。

Q: 搜索文件时如何按类型过滤? A: 使用 --category 参数:0=全部,1=视频,2=音频,3=图片,4=文档,5=应用,6=其他,7=种子。--no-dir 和 --dir-only 互斥(分别表示仅文件、仅文件夹)。

故障排查

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux
• Shell: bash(脚本执行需要)

依赖详情

API Key 配置

• 通过百度网盘OAuth授权登录,无需手动配置API Key
• 授权码通过 bash ${CLAUDE_SKILL_DIR}/scripts/login.sh 流程获取
• 禁止读取或输出 ~/.config/bdpan/config.json 内容(含敏感凭据)

可用性分类

• 分类: MD+EXEC(纯Markdown指令,需要命令行执行能力运行bdpan CLI)
• 说明: 基于Markdown的AI Skill,通过自然语言指令驱动Agent使用bdpan CLI管理百度网盘文件。需要bdpan CLI和百度网盘账户。

免费版限制

本免费体验版限制以下高级功能:

• Agent记忆备份与恢复(backup/list/restore,跨设备同步记忆文件):免费版不提供,需通过 memory-backup.sh 脚本执行(专业版功能)
• 大文件后台下载(nohup+进度轮询,>50MB文件的后台下载模式):免费版仅支持直接下载(≤50MB),大文件可能因Bash超时中断
• 批量操作模板(批量上传/下载/增量同步):免费版仅支持单文件操作
• 完整性校验(下载后文件大小比对):免费版不提供
• 增量同步机制(仅上传变化文件):免费版不提供

解锁全部功能请使用专业版: pan-file-commander-pro

License与版权声明

本skill基于原始作品改进,保留原始版权声明:

• 原始作品: baidu-netdisk-skills (百度网盘)
• 原始license: MIT
• 改进作品: pan-file-commander-free
• 改进license: MIT

本改进作品在原始作品基础上进行了深度差异化改造,包括但不限于:

• 重新定位为"指挥官"视角(原始为通用文件管理)
• 新增快捷命令模板(浏览/搜索/单文件操作/分享/转存5类)
• 新增文件分类视图(按类型/大小/时间)
• 新增智能路径校验(路径补全与越界检测)
• 新增操作意图识别(歧义消除决策树)
• 新增分层确认规则(高/中/低风险+示例)
• 新增分级快速开始(30秒/60秒/120秒)
• 新增FAQ(7问)与故障排查表(9项)
• 新增3类真实场景示例(个人/团队/创作者)
• 重写description为五段结构,新增edition字段
• 保留原作者版权声明，去除非必要外部引用链接
• 兼容Agent平台适配(原私有环境名已通用化为兼容Agent/增强Agent/快速Agent/Agent平台)

原始MIT license允许修改与再分发,本改进作品在MIT license下发布,保留原始版权声明。

核心能力

安装

bash ${CLAUDE_SKILL_DIR}/scripts/install.sh [--yes]

安装器从百度 CDN(issuecdn.baidupcs.com)下载并执行。注意:install.sh 不执行本地 SHA256 校验,完整性依赖 HTTPS 传输保护。安全敏感场景建议先手动审查安装器内容或在沙箱中执行。

输入: 用户提供安装所需的指令和必要参数。 处理: 按照skill规范执行安装操作,遵循单一意图原则。 输出: 返回安装的执行结果,包含操作状态和输出数据。

登录 / 注销 / 卸载

bash ${CLAUDE_SKILL_DIR}/scripts/login.sh              # 登录(内置安全免责声明)
bdpan logout                                            # 注销
bash ${CLAUDE_SKILL_DIR}/scripts/uninstall.sh [--yes]   # 卸载

输入: 用户提供登录 / 注销 / 卸载所需的指令和必要参数。 处理: 按照skill规范执行登录 / 注销 / 卸载操作,遵循单一意图原则。 输出: 返回登录 / 注销 / 卸载的执行结果,包含操作状态和输出数据。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

更新(必须用户明确指令触发)

bash ${CLAUDE_SKILL_DIR}/scripts/update.sh              # 检查并更新(需用户确认)
bash ${CLAUDE_SKILL_DIR}/scripts/update.sh --check       # 仅检查更新

输入: 用户提供更新(必须用户明确指令触发)所需的指令和必要参数。 处理: 按照skill规范执行更新(必须用户明确指令触发)操作,遵循单一意图原则。 输出: 返回更新(必须用户明确指令触发)的执行结果,包含操作状态和输出数据。 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：命令式百度网盘文、件管理、快捷命令模板、分类视图、路径校验、确认规则、网盘指挥官免费版、是一个以、命令式高效操作、为核心视角的百度、网盘文件管理工具、所有操作限制在、apps、bdpan、目录内、针对网盘管理、命令记不住、操作不连贯、路径易出错、风险操作无确认、文件难分类、五大痛点、构建了快捷命令模、智能路径校验、分层确认规则和操、作意图识别五大基、础能力等。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

适用场景

场景一:个人用户 - 日常文件浏览与上传

角色: 个人用户
任务: "帮我把本地的report.pdf上传到网盘的docs目录"

执行流程:
1. 前置检查(安装→登录)
2. 路径校验(docs/在合法范围内)
3. bdpan ls docs/ 检查是否已存在同名文件
4. 如已存在,询问用户是否覆盖(高风险确认)
5. 确认后执行 bdpan upload ./report.pdf docs/report.pdf
6. 展示结果:"已上传到:我的应用数据/bdpan/docs/report.pdf"

场景二:团队协作者 - 分享文件给同事

角色: 团队协作者
任务: "把网盘里的项目方案分享给同事,有效期7天"

执行流程:
1. 前置检查
2. bdpan ls 确认文件存在
3. 根据用户意图选择有效期(默认7天)
4. 执行 bdpan share docs/项目方案.pdf --period 7
5. 展示:链接+提取码+有效期(7天)
6. 提示用户:链接7天后过期,请及时分享

场景三:内容创作者 - 转存分享链接

角色: 内容创作者
任务: "朋友发给我一个分享链接,帮我转存到网盘的downloads目录"

执行流程:
1. 前置检查
2. 确认分享链接格式有效
3. 确认有提取码(链接中含 ?pwd= 或反问用户)
4. 确认目标目录(downloads/)
5. 执行 bdpan transfer "https://pan.baidu.com/s/1xxxxx" -p abcd -d downloads/
6. 展示:转存文件数量与目标目录

不适用场景

以下场景网盘指挥官免费版不适合处理：

• 黑帽SEO手段
• 搜索引擎作弊
• 付费广告投放管理

触发条件

需要SEO优化、关键词分析、排名提升、搜索流量优化时使用。不适用于非本工具能力范围的需求。