baidu-netdisk/bdpan-storage / skills/baidu-drive
baidu-drive
Verified百度网盘(Baidu Drive)文件管理与正文能力 — 上传、下载、转存、分享、搜索文件、搜索正文片段、读取文件全文、移动、复制、重命名、创建文件夹;查询网盘容量、已用和剩余空间。 同时支持 Agent 记忆备份/恢复(kimiclaw/maxclaw/qclaw/openclaw)。 TRIGGER: 用户提及"百度网盘/bdpan/网盘/云盘/baidu drive/Baidu Drive"并涉及文件操作或查询网盘容量、剩余空间、使用率; 或用户提及"备份记忆"、"恢复记忆"、"查看记忆备份"等记忆相关操作。 DO NOT TRIGGER: 非文件存储操作,或使用其他云盘服务时;本地记忆整理/清理操作;PPT 生成操作(已独立为 baidu-wenku-aippt skill)。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 46.2 KB |
| VERSION | other | 6 B |
| reference/authentication.md | markdown | 4.0 KB |
| reference/bdpan-commands.md | markdown | 49.4 KB |
| reference/examples.md | markdown | 10.7 KB |
| reference/notes.md | markdown | 986 B |
| reference/troubleshooting.md | markdown | 11.0 KB |
| scripts/install.shexecutable | script | 10.6 KB |
| scripts/login.shexecutable | script | 10.2 KB |
| scripts/memory-backup.shexecutable | script | 24.8 KB |
| scripts/uninstall.shexecutable | script | 4.2 KB |
| scripts/update.shexecutable | script | 8.8 KB |
reference/authentication.md
View on GitHub# 认证指南
本指南详细介绍 bdpan CLI 的登录认证流程。
---
## 登录方式
> **安全约束:** 登录方式的安全限制详见 [SKILL.md](../SKILL.md) 的「安全约束」章节。Agent 必须且只能通过 login.sh 脚本执行登录。
```bash
bash ${CLAUDE_SKILL_DIR}/scripts/login.sh
```
脚本会自动处理完整的登录流程(免责声明 → 用户确认 → 获取授权链接 → 校验授权码 → 完成登录)。用户主动发起登录时,新授权成功会展示场景化欢迎语;如果本地已经有有效登录态,会提示“你已登录百度网盘,无需重复授权”并展示同一组可直接使用的自然语言示例。此时不要把 `bdpan whoami` 的原始状态字段当作欢迎语。若登录只是某个文件任务的前置步骤,使用:
```bash
bash ${CLAUDE_SKILL_DIR}/scripts/login.sh --continue-task
```
该模式登录成功后不输出欢迎语,调用方应立即继续原任务。
用户主动请求登录、但当前已经登录时,预期提示为:
```
你已登录百度网盘,无需重复授权。
现在可以直接说:
- 帮我找一份周末京津冀旅行攻略,整理好后存到网盘
- 把刚生成的简历和作品集上传到网盘
- 把朋友分享的照片转存到我的网盘
- 找出网盘里去年的体检报告
- 备份我的 Agent 记忆,方便以后恢复
```
只有用户明确要求查看登录状态时,才单独执行 `bdpan whoami` 并展示用户名或 Token 有效期。
---
## 验证登录状态
```bash
bdpan whoami
```
**已登录时输出:**
```
认证状态: 已登录
Token 有效期至: 2026-03-10 10:30:00
```
**未登录时输出:**
```
认证状态: 未登录
请执行 bash ${CLAUDE_SKILL_DIR}/scripts/login.sh 进行登录
```
---
## 注销登录
```bash
bdpan logout
```
清除本地存储的认证信息(`~/.config/bdpan/config.json`)。
---
## 常见问题
### 登录后提示 Token 已过期
**症状:**
```
错误: Token 过期
Error: Token expired
```
**解决方案:**
```bash
bdpan logout
bash ${CLAUDE_SKILL_DIR}/scripts/login.sh
```
### 授权链接无效
**症状:** 浏览器打开链接后提示链接无效
**解决方案:**
1. 重新执行登录脚本获取新的授权链接
2. 确保在链接有效期内完成授权(通常 10 分钟)
### 授权码输入后报错
**症状:** 输入授权码后提示错误
**解决方案:**
1. 确保授权码复制完整,没有多余空格
2. 检查浏览器中显示的授权码是否与输入的一致
3. 如多次失败,重新执行登录脚本获取新授权码
### 登录失败时的处理顺序
无论是获取授权链接、提交授权码还是登录状态校验失败,先向用户展示 CLI 返回的实际失败原因(包括错误码或服务端消息,但不得展示授权码、Token 或配置内容),再给出手动授权入口:
```bash
bash ${CLAUDE_SKILL_DIR}/scripts/login.sh
```
不得只回复“登录失败,请重试”,也不要在未说明原因前直接要求用户重新授权。完成手动授权后,再重试原文件操作。
---
## 配置文件位置
```
~/.config/bdpan/config.json
```
**环境变量:**
| 环境变量 | 说明 | 默认值 |
|---------|------|--------|
| `BDPAN_CONFIG_DIR` | 配置文件目录 | `~/.config/bdpan` |
---
## 安全说明
- **OAuth 2.0**:使用授权码模式,不存储用户密码
- **Token 存储**:Token 加密存储在本地配置文件
- **自动续期**:Token 快过期时工具会自动刷新
---
## 自动登录失败场景
以下场景会自动切换到 OOB 模式:
| 场景 | 说明 |
|------|------|
| SSH 远程登录 | 无图形界面 |
| WSL 环境 | WebView 支持受限 |
| 桌面环境锁定 | WebView 无法弹出 |
| 浏览器未安装 | 无法打开 WebView |
切换到 OOB 模式时,先说明自动登录失败的实际原因,再提示用户按手动授权流程完成登录。若 OOB 登录由原文件任务触发,登录成功后继续原任务,不重复展示独立登录欢迎语。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 470k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |