--- slug: "baidu-netdisk-skills-free" name: "baidu-netdisk-skills-free" version: "2.0.0" displayName: "百度网盘 Free" summary: "百度网盘基础文件管理，限 /apps/bdpan/，支持查看列表与上传下载。。百度网盘 Free 是百度网盘技能的免费精简版，通过 bdpan 命令行工具对百度网盘进行基础文件操作， 所有操" summary_zh: "百度网盘基础文件管理，限 /apps/bdpan/，支持查看列表与上传下载。。百度网盘 Free 是百度网盘技能的免费精简版，通过 bdpan 命令行工具对百度网盘进行基础文件操作， 所有操" license: "MIT" description: |- 百度网盘 Free 是百度网盘技能的免费精简版，通过 bdpan 命令行工具对百度网盘进行基础文件操作， 所有操作限制在 /apps/bdpan/ 目录范围内。支持基本的查看、列表、上传与下载能力， 不包含大文件后台下载策略、转存、分享、记忆备份恢复等高级功能. 核心能力： - 基础查询：查看登录状态、列出文件目录 - 基础上传：上传单文件或文件夹到网盘 - 基础下载：下载网盘文件到本地（仅小文件 ≤50MB） - 安全机制：写操作需用户确认、路径范围限制 适用场景： - 查看网盘 /apps/bdpan/ 目录内的文件列表 - 上传小文件到网盘备份 - 下载网盘内的小文件到本地 限制：不支持大文件后台下载、转存、分享、搜索、记忆备份恢复. 如需完整能力，请升级至付费版 baidu-netdisk-skills 技能. tags: - Agents - Storage - Baidu - 工具 - 效率 - 自动化 - 知识 - 文档 - 工作流 - 研究 - bdpan - bash - docs - apps - notes tools: - read - exec - write homepage: "" category: "Automation" --- # 百度网盘 Free 百度网盘基础文件管理工具，所有操作限制在 `/apps/bdpan/` 目录内。本免费版仅支持查看、列表、上传与下载小文件. ## 输入格式 | 参数名 | 类型 | 必填 | 说明 | |---|---|---|---| | input | string | 是 | 百度网盘 Free处理的输入数据或指令 | | options | object | 否 | 附加配置选项,如模式选择、格式偏好等 | | callback_url | string | 否 | 异步处理完成后的回调通知URL | ## 触发规则 用户消息中包含**明确指向百度网盘**的关键词（`百度网盘`、`百度云盘`、`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/` 范围内 ## 确认规则 | 风险等级 | 操作 | 策略 | |:-----|:-----|:-----| | **高（必须确认）** | 上传/下载目标已存在同名文件 | 列出影响范围，等待用户确认 | | **中（路径模糊时确认）** | 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}/（请参考skill目录中的脚本文件）` | | `未登录` / `whoami 失败` | Token 过期或未登录 | 引导执行 `bash ${CLAUDE_SKILL_DIR}/（请参考skill目录中的脚本文件）` 重新登录 | | 路径穿越被拦截 | 路径含 `..`、`~` 或绝对路径越界 | 拒绝执行，提示操作仅限 `/apps/bdpan/` 范围内相对路径 | | 远端文件不存在 | `bdpan ls` 返回空 | 检查路径拼写，用 `bdpan ls` 确认目录内容 | | 文件超过 50MB | 本免费版不支持大文件后台下载 | 提示用户升级至付费版 baidu-netdisk-skills 技能 | | 同名文件已存在 | 上传/下载目标路径已有同名文件 | 列出现有文件，询问覆盖还是重命名，确认后执行 | | 直接调用 bdpan login 被拦截 | Agent 误用裸 `bdpan login` 命令 | 禁止该调用，必须通过 `（请参考skill目录中的脚本文件）` 执行登录 | ## 常见问题 ### 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 ### 依赖项 | 依赖项 | 类型 | 是否必需 | 获取方式 | |:------|------:|:------|:------| | LLM API | API | 必需 | 由Agent内置LLM提供 | ### API Key 配置 需要配置对应API Key，详见上文环境配置章节 ### 可用性分类 - **分类**: MD+EXEC（） **API Key配置方式**: ```bash 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. **路径校验**：验证远 **输入**: 用户提供前置检查相关的配置参数、输入数据和处理选项. **输出**: 返回前置检查的处理结果,包含执行状态码、结果数据和执行日志. ### 确认规则(补充) | 风险等级(续)| 操作 | 策略 | |----:|:----|----:| | **高（必须确认）** | 上传/下载目标已存在同名文件 | 列出影响范围，等待用户确认 | **输入**: 用户提供确认规则相关的配置参数、输入数据和处理选项. **输出**: 返回确认规则的处理结果,包含执行状态码、结果数据和执行日志. ### 基础操作(补充) **输入**: 用户提供基础操作所需的指令和必要参数. **解析**: 解析基础任务的输入参数,完成核心解析逻辑,返回结构化响应和完成状态. **输出**: 返回基础的处理结果,包含执行状态码、结果数据和执行日志。- 验证返回数据的完整性和格式正确性 - 参考`基础操作`的配置文档进行参数调优 ### 查看状态与列表(补充) ```bash bdpan whoami # 查看登录状态 bdpan ls [目录路径] [--json] [--order name|time|size] [--desc] [--folder] ``` **输入**: 用户提供查看状态与列表所需的指令和必要参数. **处理**: 解析查看状态与列表的输入参数,执行核心处理逻辑,返回结构化结果和执行状态. **输出**: 返回查看状态与列表的处理结果,包含执行状态码、结果数据和执行日志. ### 上传(补充) ```bash 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. 确认运行环境满足依赖说明中的要求 2. 在AI Agent对话中调用本技能,提供必要的输入参数 3. 检查输出结果,根据需要进行后续处理 > 详细的输入输出格式请参考下方章节说明。 ## 使用流程 # ... 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 } ``` # ...