Baidu Netdisk Skills Free

百度网盘 Free 是百度网盘技能的免费精简版，通过 bdpan 命令行工具对百度网盘进行基础文件操作， 所有操作限制在 /apps/bdpan/ 目录范围内。支持基本的查看、列表、上传与下载能力， 不包含大文件后台下载策略、转存、分享、记忆备份恢复等高级功能。 核心能力： - 基础查询：查看登录状态、列出文件目录 - 基础上传：上传单文件或文件夹到网盘 - 基础下载：下载网盘文件到本地（仅小文件 ≤50MB） - 安全机制：写操作需用户确认、路径范围限制 适用场景： - 查看网盘 /apps/bdpan/ 目录内的文件列表 - 上传小文件到网盘备份 - 下载网盘内的小文件到本地 限制：不支持大文件后台下载、转存、分享、搜索、记忆备份恢复。 如需完整能力，请升级至付费版 baidu-netdisk-skills 技能。

百度网盘 Free

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

触发规则

用户消息中包含明确指向百度网盘的关键词（百度网盘、百度云盘、bdpan、baidu netdisk、baidu pan、baidu drive、pan.baidu.com），且操作意图属于本免费版支持范围（查看/列表/上传/下载）时触发。

用户仅说"网盘""云盘"等泛指词时，需反问"您指的是百度网盘（pan.baidu.com）吗？"再决定。

写操作（上传、下载覆盖）必须先列出"将要执行的操作 + 影响范围"并取得用户显式确认（y）后再执行。

已知限制

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

前置检查

每次触发时按顺序执行：

1. 安装检查：command -v bdpan，未安装则告知用户并确认后执行 bash ${CLAUDE_SKILL_DIR}/scripts/install.sh
2. 登录检查：bdpan whoami，未登录则引导执行 bash ${CLAUDE_SKILL_DIR}/scripts/login.sh
3. 路径校验：验证远端路径在 /apps/bdpan/ 范围内

确认规则

风险等级	操作	策略
高（必须确认）	上传/下载目标已存在同名文件	列出影响范围，等待用户确认
中（路径模糊时确认）	upload、download	路径明确直接执行，不明确则确认
低（直接执行）	ls、whoami	无需确认

基础操作

查看状态与列表

bash

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

上传

bash

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

关键约束： 单文件上传远端路径必须是文件名，禁止以 / 结尾。文件夹上传：bdpan upload ./project/ project/。

步骤：确认本地路径存在 → 确认远端路径 → bdpan ls 检查远端是否已存在 → 执行。

下载（仅小文件 ≤50MB）

bash

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

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

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

路径规则

场景	格式	示例
命令参数	相对路径（相对于 /apps/bdpan/）	bdpan upload ./f.txt docs/f.txt
展示给用户	中文名	"已上传到：我的应用数据/bdpan/docs/f.txt"

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

工作流程

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

案例展示

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

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

执行流程：

bash

# 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 目录。

执行流程：

bash

# 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"。

错误处理

错误场景	原因	处理方式
bdpan: command not found	未安装 bdpan 工具	引导用户确认后执行 bash ${CLAUDE_SKILL_DIR}/scripts/install.sh
未登录 / whoami 失败	Token 过期或未登录	引导执行 bash ${CLAUDE_SKILL_DIR}/scripts/login.sh 重新登录
路径穿越被拦截	路径含 ..、~ 或绝对路径越界	拒绝执行，提示操作仅限 /apps/bdpan/ 范围内相对路径
远端文件不存在	bdpan ls 返回空	检查路径拼写，用 bdpan ls 确认目录内容
文件超过 50MB	本免费版不支持大文件后台下载	提示用户升级至付费版 baidu-netdisk-skills 技能
同名文件已存在	上传/下载目标路径已有同名文件	列出现有文件，询问覆盖还是重命名，确认后执行
直接调用 bdpan login 被拦截	Agent 误用裸 bdpan login 命令	禁止该调用，必须通过 scripts/login.sh 执行登录

常见问题

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 记忆备份与恢复功能。
• 登录必须通过 scripts/login.sh，禁止直接调用 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

依赖项

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

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

可用性分类

• 分类: MD+EXEC（）

API Key配置方式:

bash

export API_KEY="your_api_key_here"

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

核心能力

触发规则

用户消息中包含明确指向百度网盘的关键词（百度网盘、百度云盘、bdpan、baidu netdisk、baidu pan、baidu drive、pan.baidu.com），且操作意图属于本免费版支持范围（查看/列表/上传/下载）时触发。

用户仅说"网盘""云盘"等泛指词时，需反问"您指的是百度网盘（pan.baidu.com）吗？"再决定。

写操作

输入: 用户提供触发规则所需的参数和指令。 输出: 返回触发规则的执行结果,包含操作状态和输出数据。

前置检查

每次触发时按顺序执行：

1. 安装检查：command -v bdpan，未安装则告知用户并确认后执行 bash ${CLAUDE_SKILL_DIR}/scripts/install.sh
2. 登录检查：bdpan whoami，未登录则引导执行 bash ${CLAUDE_SKILL_DIR}/scripts/login.sh
3. 路径校验：验证远

输入: 用户提供前置检查所需的参数和指令。 输出: 返回前置检查的执行结果,包含操作状态和输出数据。

确认规则

风险等级	操作	策略
高（必须确认）	上传/下载目标已存在同名文件	列出影响范围，等待用户确认
中（路径模糊时确认）	upload、download	路径明确直接执行，不明确则确认
低（直接执行）	ls、whoami	无需确认

输入: 用户提供确认规则所需的参数和指令。 输出: 返回确认规则的执行结果,包含操作状态和输出数据。

基础操作

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

• 执行基础操作操作，处理输入数据并返回结果
• 验证执行结果，确认输出符合预期格式
• 参考基础操作相关配置参数进行设置

查看状态与列表

bash

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

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

上传

bash

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

**输入**: 用户提供基础操作所需的参数和指令。
**处理**: 按照skill规范执行基础操作操作。
**输出**: 返回基础操作的执行结果,包含操作状态和输出数据。

### 路径规则

| 场景 | 格式 | 示例 |
| --- | --- | --- |
| **命令参数** | 相对路径（相对于 `/apps/bdpan/`） | `bdpan upload ./f.txt docs/f.txt` |
| **展示给用户** | 中文名 | "已上传到：我的应用数据/bdpan/docs/f.txt" |

映射关系：`我的应用数据` ↔ `/apps`。**禁止：** 命

**处理**: 按照skill规范执行路径规则操作。
**输出**: 返回路径规则的执行结果,包含操作状态和输出数据。

### 工作流程

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

**输入**: 用户提供工作流程所需的参数和指令。

### 触发条件

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

**处理**: 按照skill规范执行触发条件操作。
**输出**: 返回触发条件的执行结果,包含操作状态和输出数据。

### 能力覆盖范围

本skill还覆盖以下能力场景: 百度网盘基础文件、支持查看列表与上、传下载、Free、是百度网盘技能的、免费精简版、命令行工具对百度、网盘进行基础文件、所有操作限制在、目录范围内、支持基本的查看、上传与下载能力、不包含大文件后台、下载策略、记忆备份恢复等高。这些能力在上述核心功能中均有对应处理逻辑。
## 使用流程

1. **环境确认**: 确认Agent平台已加载本skill，检查依赖说明中的环境要求
2. **指令输入**: 向Agent描述需要执行的任务，引用`baidu-netdisk-skills-free`的相关能力
3. **执行处理**: Agent按照核心能力章节的指令执行任务
4. **结果验证**: 检查输出结果是否符合预期，参考错误处理章节处理异常