---
name: 百度网盘文件管理助手
id: z-baidupan-manager
version: 1.0.0
description: 当用户提到百度网盘、百度云盘、网盘备份、网盘整理、网盘文件管理、百度网盘 API、网盘自动归档、baidupan 时使用。帮助用户通过百度网盘开放平台 API 实现自动备份归档、文件检索整理与资源分类管理。
agent_created: true
platforms: ["web","api"]
category: 效率办公
slug: z-baidupan-manager
displayName: 百度网盘文件管理助手
summary: 基于百度网盘开放平台 API，把自动备份、文件检索与资源整理等网盘管理动作自动化。
license: MIT
icon: icon.png
---

# 百度网盘文件管理助手

## 一、触发场景
- "把本地文件夹自动备份到百度网盘"
- "整理百度网盘里的杂乱文件" / "按类型分类"
- "搜一下网盘里有没有某份资料"
- 配置百度网盘开放应用、排查网盘 API 报错

## 二、平台能力与接入（真实信息，已联网核对）
- **开放平台**：百度网盘开放平台 `https://pan.baidu.com/`，开发者接入需注册应用获取 `appkey` / `secret`，并通过 OAuth2 授权拿到用户 `access_token`。
- **授权端点**：`https://openapi.baidu.com/oauth/2.0/authorize`（授权码模式）+ `https://openapi.baidu.com/oauth/2.0/token`（换 access_token / refresh_token）。
- **文件 API 根路径**：`https://pan.baidu.com/rest/2.0/`（如 `xpan/file`、`xpan/nas`、`xpan/share`），需带 `access_token`。
- **核心能力**：文件列表/搜索(`xpan/file?method=list`)、上传/下载、秒传、创建文件夹、移动/重命名、回收站。
- **MCP**：社区有第三方百度网盘 MCP 封装，可作为可选接入方式（以社区维护版本为准，注意安全审计）。

## 三、工作流
1. 确认目标（备份 / 整理 / 搜索）。
2. 检查是否已授权获取 access_token；未配 → 引导 USAGE.md 走 OAuth2 授权。
3. 调用 `pan.baidu.com/rest/2.0/xpan/*` 执行动作。
4. 返回结果；失败给错误码与排查（token 失效需 refresh / 权限不足 / 频控）。

## 四、红线与边界
- 仅操作用户**本人授权账号**下的文件，不访问他人网盘。
- 不泄露 app secret 与 access_token；仅存本地，不回传。
- 删除/移动属不可逆敏感操作，执行前二次确认，优先进回收站。
- access_token 过期用 refresh_token 刷新。
- 本 Skill 提供方法指引与调用骨架，**不代替用户持有凭证调真实接口**；以百度网盘开放平台官方文档最新版为准。

## 五、配置指引（详见 USAGE.md）
```
授权: https://openapi.baidu.com/oauth/2.0/authorize?client_id=APPKEY&response_type=code&redirect_uri=...
换token: https://openapi.baidu.com/oauth/2.0/token?grant_type=authorization_code&code=...&client_id=...&client_secret=...&redirect_uri=...
文件列表: GET https://pan.baidu.com/rest/2.0/xpan/file?method=list&access_token=...&dir=/
```