百度网盘 Free

百度网盘基础文件管理工具，所有操作限制在 /apps/bdpan/ 目录内。本免费版仅支持查看、列表、上传与下载小文件.

输入格式

触发规则

用户消息中包含明确指向百度网盘的关键词（百度网盘、百度云盘、bdpan、baidu netdisk、baidu pan、baidu drive、pan.baidu.com），且操作意图属于本免费版支持范围（查看/列表/上传/下载）时触发. 用户仅说"网盘""云盘"等泛指词时，需反问"您指的是百度网盘（pan.baidu.com）吗？"再决定. 写操作（上传、下载覆盖）必须先列出"将要执行的操作 + 影响范围"并取得用户显式确认（y）后再执行.

已知限制

1. 登录：必须使用 bash ${CLAUDE_SKILL_DIR}/（请参考skill目录中的脚本文件），禁止直接调用 bdpan login
2. Token/配置：禁止读取或输出 ~/.config/bdpan/config.json 内容
3. 路径安全：禁止路径穿越（..、~）、禁止访问 /apps/bdpan/ 范围外的绝对路径
4. 文件大小：本免费版仅支持 ≤50MB 的小文件下载，不支持 nohup 后台下载策略

前置检查

每次触发时按顺序执行：

1. 安装检查：command -v bdpan，未安装则告知用户并确认后执行 bash ${CLAUDE_SKILL_DIR}/（请参考skill目录中的脚本文件）
2. 登录检查：bdpan whoami，未登录则引导执行 bash ${CLAUDE_SKILL_DIR}/（请参考skill目录中的脚本文件）
3. 路径校验：验证远端路径在 /apps/bdpan/ 范围内

确认规则

基础操作

查看状态与列表

bdpan whoami                                          # 查看登录状态
bdpan ls [目录路径] [--json] [--order name|time|size] [--desc] [--folder]

上传

bdpan upload <本地路径> <远端路径>

关键约束： 单文件上传远端路径必须是文件名，禁止以 / 结尾。文件夹上传：bdpan upload ./project/ project/. 步骤：确认本地路径存在 → 确认远端路径 → bdpan ls 检查远端是否已存在 → 执行.

下载（仅小文件 ≤50MB）

bdpan download <远端路径> <本地路径>

步骤：bdpan ls 确认云端存在 → 用 bdpan ls --json 获取文件大小 → 确认 ≤50MB → 检查本地是否已存在 → 执行。Bash 工具 timeout 设为 300000（5 分钟）.

超过 50MB 的大文件下载需使用 nohup 后台策略，该功能仅在付费版中提供.

路径规则

映射关系：我的应用数据 ↔ /apps。禁止： 命令中使用中文路径、展示时暴露 API 路径.

工作流程

1. 触发判定：检查关键词与操作意图是否满足触发规则且属于本免费版支持范围.
2. 前置检查：bdpan 安装 → 登录状态 → 路径校验.
3. 风险分级：按确认规则判断操作风险等级.
4. 确认执行：高风险操作展示影响范围等待确认；低风险直接执行.
5. 结果呈现：展示操作结果，路径用中文名呈现.

案例展示

案例 1：查看网盘文件并下载小文件

用户请求：帮我看下百度网盘里 docs 目录有哪些文件，然后把 report.pdf 下载到本地. 执行流程：

# 1. 前置检查
bdpan whoami
# ...
# 2. 列出 docs 目录（只读）
bdpan ls docs/
# ...
# 3. 确认文件存在与大小
bdpan ls --json docs/report.pdf
# ...
# 4. 确认 ≤50MB 后下载（写操作，需确认）
# 向用户展示：将下载 docs/report.pdf 到 ./report.pdf，确认后执行
bdpan download docs/report.pdf ./report.pdf

输出说明：先列出 docs 目录文件清单，确认 report.pdf 存在且为小文件后下载。若文件超过 50MB，提示该功能需升级付费版.

案例 2：上传文件到网盘备份

用户请求：把本地的 notes.md 上传到百度网盘的 backup 目录. 执行流程：

# 1. 前置检查
bdpan whoami
# ...
# 2. 确认本地文件存在
ls -l ./notes.md
# ...
# 3. 检查远端是否已存在同名文件
bdpan ls backup/notes.md
# ...
# 4. 上传（写操作，需确认）
# 向用户展示：将上传 ./notes.md 到 backup/notes.md，确认后执行
bdpan upload ./notes.md backup/notes.md

输出说明：上传前检查远端是否已有同名文件，确认后执行。展示时用中文名"我的应用数据/bdpan/backup/notes.md".

错误处理

常见问题

Q1：怎么查看网盘里有哪些文件？

A：先 bdpan whoami 确认登录状态，再 bdpan ls [目录路径] 列出文件。支持 --order name|time|size 排序、--folder 只看文件夹。展示时路径映射为中文名（我的应用数据/bdpan/...）.

Q2：上传时远端路径怎么填？

A：单文件上传远端路径必须是文件名（如 docs/notes.md），禁止以 / 结尾。文件夹上传用 bdpan upload ./project/ project/。上传前用 bdpan ls 检查远端是否已存在同名文件.

Q3：能下载大文件或从分享链接下载吗？

A：本免费版仅支持 ≤50MB 的小文件直接下载。超过 50MB 的大文件后台下载、分享链接转存下载、nohup 后台策略等高级功能需升级至付费版 baidu-netdisk-skills 技能.

Q4：为什么不能访问 /apps/bdpan/ 以外的路径？

A：安全限制。所有操作限定在 /apps/bdpan/ 范围内，禁止路径穿越（..、~）和越界绝对路径，防止误操作系统其他目录.

补充限制说明

• 所有操作限制在 /apps/bdpan/ 目录范围内.
• 仅支持 ≤50MB 小文件下载，不支持大文件后台下载策略.
• 不支持转存、分享、搜索、移动、复制、重命名、删除等操作.
• 不支持 Agent 记忆备份与恢复功能.
• 登录必须通过 （请参考skill目录中的脚本文件），禁止直接调用 bdpan login.
• 禁止读取或输出 ~/.config/bdpan/config.json 等敏感凭据配置.

升级提示

本免费版仅提供基础查看、列表、上传与小文件下载能力。如需完整功能（大文件后台下载、转存、分享、搜索、文件整理、记忆备份恢复），请升级至付费版 baidu-netdisk-skills 技能.

触发条件

• 用户明确提及百度网盘/bdpan/baidu drive 等关键词且仅需查看/列表/上传/下载时激活.
• 用户请求转存、分享、搜索、记忆备份等高级功能时，提示需升级付费版.
• 用户仅提及泛指词（"网盘""云盘"）时需反问确认后再决定是否触发.

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux

依赖项

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

• 分类: MD+EXEC（）

API Key配置方式:

export API_KEY="your_api_key_here"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.

核心能力

触发规则(补充)

写操作

输入: 用户提供触发规则相关的配置参数、输入数据和处理选项. 输出: 返回触发规则的处理结果,包含执行状态码、结果数据和执行日志.

前置检查(补充)

1. 安装检查：command -v bdpan，未安装则告知用户并确认后执行 bash ${CLAUDE_SKILL_DIR}/（请参考skill目录中的脚本文件）
2. 登录检查：bdpan whoami，未登录则引导执行 bash ${CLAUDE_SKILL_DIR}/（请参考skill目录中的脚本文件）
3. 路径校验：验证远

输入: 用户提供前置检查相关的配置参数、输入数据和处理选项. 输出: 返回前置检查的处理结果,包含执行状态码、结果数据和执行日志.

确认规则(补充)

输入: 用户提供确认规则相关的配置参数、输入数据和处理选项. 输出: 返回确认规则的处理结果,包含执行状态码、结果数据和执行日志.

基础操作(补充)

输入: 用户提供基础操作所需的指令和必要参数. 解析: 解析基础任务的输入参数,完成核心解析逻辑,返回结构化响应和完成状态. 输出: 返回基础的处理结果,包含执行状态码、结果数据和执行日志。- 验证返回数据的完整性和格式正确性

• 参考基础操作的配置文档进行参数调优

查看状态与列表(补充)

bdpan whoami                                          # 查看登录状态
bdpan ls [目录路径] [--json] [--order name|time|size] [--desc] [--folder]

输入: 用户提供查看状态与列表所需的指令和必要参数. 处理: 解析查看状态与列表的输入参数,执行核心处理逻辑,返回结构化结果和执行状态. 输出: 返回查看状态与列表的处理结果,包含执行状态码、结果数据和执行日志.

上传(补充)

bdpan upload <本地路径> <远端路径
# ...
**输入**: 用户提供基础操作相关的配置参数、输入数据和处理选项.
**解析**: 解析基础任务的输入参数,完成核心解析逻辑,返回结构化响应和完成状态.
**输出**: 返回基础的处理结果,包含执行状态码、结果数据和执行日志.
# ...
### 路径规则(补充)
# ...
| 场景(续)| 格式 | 示例 |
|:-------:|---------|:--------|
| **命令参数** | 相对路径（相对于 `/apps/bdpan/`） | `bdpan upload ./f.txt docs/f.txt` |
| **展示给用户** | 中文名 | "已上传到：我的应用数据/bdpan/docs/f.txt" |
# ...
映射关系：`我的应用数据` ↔ `/apps`。**禁止：** 命
# ...
**处理**: 解析路径规则的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
**输出**: 返回路径规则的处理结果,包含执行状态码、结果数据和执行日志.
# ...
### 工作流程(补充)
# ...
1. **触发判定**：检查关键词与操作意图是否满足触发规则且属于本免费版支持范围.
2. **前置检查**：bdpan 安装 → 登录状态 → 路径校验.
3. **风险分级**：按确认规则判断操作风险等级.
4. **确认执行**：高风险操作展示影响范围等待确认；低风险直接执行.
5. **结果呈现**：展示操作结果，路径用中文名呈现.
# ...
**输入**: 用户提供工作流程相关的配置参数、输入数据和处理选项.
# ...
### 触发条件(补充)
# ...
- 用户明确提及百度网盘/bdpan/baidu drive 等关键词且仅需查看/列表/上传/下载时激活.
- 用户请求转存、分享、搜索、记忆备份等高级功能时，提示需升级付费版.
- 用户仅提及泛指词（"网盘""云盘"）时需反问确认后再决定是否触发.
# ...
**处理**: 解析触发条件的输入参数,执行核心处理逻辑,返回结构化结果和执行状态.
**输出**: 返回触发条件的处理结果,包含执行状态码、结果数据和执行日志.
# ...
#
## 使用流程
# ...
1. **环境确认**: 确认Agent平台已加载本skill，检查依赖说明中的环境要求
2. **指令输入**: 向Agent描述需要执行的任务，引用`baidu-netdisk-skills-free`的相关能力
3. **执行处理**: Agent按照核心能力章节的指令执行任务
4. **结果验证**: 检查输出结果是否符合预期，参考错误处理章节处理异常
# ...
## 输出格式
# ...
```json
{
  "success": true,
  "data": {
    "result": "百度网盘 Free处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "baidu-netdisk-skills"
    }
  },
  "execution_log": [
    "解析输入参数",
    "执行核心处理",
    "格式化输出结果"
  ],
  "error": null
}

...