Baidu Netdisk Storage Skill

Baidu Netdisk file management tool that supports upload, download, transfer, sharing, and list query. All operations are restricted to the

/apps/bdpan/

directory.

Compatible products: OpenClaw, Claude Code, DuClaw, KimiClaw, Manus, etc.

In beta testing phase, please refer to reference/notes.md for usage precautions

Trigger Rules

Execution is only triggered when both of the following conditions are met:

User explicitly mentions Baidu Netdisk — The message contains keywords such as "百度网盘", "bdpan", "网盘" (cloud disk)
Clear operation intent — Can confirm it is one of the following operations: upload, download, transfer, sharing, list query, login, logout

No bdpan commands will be executed if the conditions are not met.

Confirmation Rules

Must confirm with the user first in the following scenarios, do not execute directly:

Scenario	Description
Unclear path	User does not specify the specific file path or target path
Remote path already exists	There is a file with the same name at the upload target location, ask: Overwrite/Rename/Cancel
Local path already exists	There is a file with the same name at the download target location, ask: Overwrite/Rename/Cancel
Ambiguous operation intent	"Process file" → Confirm upload or download; "Sync" → Confirm direction; "Backup" → Confirm direction

Use the following format for confirmation:

Operation Type: [Upload/Download/Share/List]
Source Path: [Path]
Target Path: [Path]
Please confirm execution?

Pre-checks

Before executing any bdpan command:

Use
```
bdpan whoami
```
to check login status; if not logged in, guide the user to execute
```
@skills/bdpan-storage/scripts/login.sh
```
Verify path validity (prohibit
```
../
```
, prohibit absolute paths outside
```
/apps/bdpan
```
)

Core Features

Upload

bash

bdpan upload <local path> <remote path>
bdpan upload ./project/ project/          # Add / for folders

Steps: Confirm local path exists → Confirm remote path → Check if remote path exists using

bdpan ls

→ Execute upload

Download

bash

bdpan download <remote path> <local path>
bdpan download report.pdf ./report.pdf
bdpan download backup/ ./backup/          # Add / for folders

Steps: Confirm cloud path exists using

bdpan ls

→ Confirm local path → Check if local path exists → Execute download

Transfer (Only transfer to Netdisk, no local download)

bash

# Basic usage - Transfer to app root directory /apps/bdpan/
bdpan transfer <share link> -p <extraction code>

# Extraction code included in the link
bdpan transfer "https://pan.baidu.com/s/1xxxxx?pwd=abcd"

# Specify target directory
bdpan transfer <share link> -p <extraction code> -d my-folder/

# JSON output
bdpan transfer <share link> -p <extraction code> --json

Steps: Verify link format → Confirm extraction code is provided → Confirm target directory → Execute transfer

Share Link Download

bash

# Extraction code included in the link
bdpan download "https://pan.baidu.com/s/1xxxxx?pwd=abcd" <local path>
# Pass extraction code separately
bdpan download "https://pan.baidu.com/s/1xxxxx" <local path> -p <extraction code>
# Specify transfer directory
bdpan download "<link>" <local path> -t <transfer directory>

Steps: Verify link format → Confirm extraction code is provided → Confirm local save path → Execute download

Sharing

bash

bdpan share <remote path>
bdpan share <path1> <path2>               # Share multiple files

List Query

bash

bdpan ls                                  # Root directory
bdpan ls <directory path>                        # Specified directory
bdpan ls --json                           # JSON output

Login

Must use the login script for login:

bash

bash scripts/login.sh

Mandatory Requirements:

✅ Must use the
```
@skills/bdpan-storage/scripts/login.sh
```
script
❌ Prohibit direct use of
```
bdpan login
```
(even in GUI environments)

❌ Prohibit direct calls to

bdpan login --get-auth-url

bdpan login --set-code

The login script includes a complete security disclaimer and authorization process to ensure user informed consent.

Logout

bash

bdpan logout

Version Management

bash

bdpan update check                        # Check for updates
bdpan update                              # Execute update (requires user confirmation)
bdpan update rollback                     # Rollback (requires user confirmation)

Path Rules

All remote paths are relative to

/apps/bdpan/

. There are two mapping rules:

Scenario	Rule	Example
In commands	Use API paths	`bdpan upload ./f.txt docs/f.txt`
Displayed to users	Use Chinese names	"Uploaded to: My App Data/bdpan/docs/f.txt"

Mapping relationship:

My App Data

↔

/apps

Prohibited:

Using Chinese paths in commands (
```
我的应用数据/bdpan/...
```
)
Exposing API paths when displaying (
```
/apps/bdpan/...
```
)
Paths containing
```
..
```
or
```
~
```
Absolute paths outside
```
/apps/bdpan
```

Authorization Code Handling

When the user sends a 32-bit hexadecimal string in the conversation and the context is related to Baidu Netdisk login, treat it as an authorization code and execute

bash scripts/login.sh --yes

If the context is unclear, first confirm with the user: "Is this the Baidu Netdisk authorization code?"

Reference Documents

For detailed information, refer to the reference directory (consult when encountering corresponding issues):

Document	When to consult
bdpan-commands.md	Need complete command parameters, options, JSON output format
authentication.md	Details of login authentication process, configuration file location, Token management
examples.md	Need more usage examples (batch upload, automatic backup scripts, etc.)
troubleshooting.md	Need to troubleshoot errors

bdpan-storage

NPX Install

Tags

SKILL.md Content (Chinese)

Baidu Netdisk Storage Skill

Trigger Rules

Confirmation Rules

Pre-checks

Core Features

Upload

Download

Transfer (Only transfer to Netdisk, no local download)

Share Link Download

Sharing

List Query

Login

Logout

Version Management

Path Rules

Authorization Code Handling

Reference Documents