百度网盘文件管理助手
一、触发场景
- "把本地文件夹自动备份到百度网盘"
- "整理百度网盘里的杂乱文件" / "按类型分类"
- "搜一下网盘里有没有某份资料"
- 配置百度网盘开放应用、排查网盘 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 封装，可作为可选接入方式（以社区维护版本为准，注意安全审计）。
三、工作流
- 确认目标（备份 / 整理 / 搜索）。
- 检查是否已授权获取 access_token；未配 → 引导 USAGE.md 走 OAuth2 授权。
- 调用
pan.baidu.com/rest/2.0/xpan/*执行动作。 - 返回结果；失败给错误码与排查（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=/
