Baidu Netdisk Storage Skill

/apps/bdpan/

Beta stage, please refer to reference/notes.md for usage precautions

Trigger Rules

1. The user explicitly mentions "百度网盘", "bdpan", "网盘"
2. Operation intent is clear (upload/download/transfer/share/view/search/move/copy/rename/create folder/login/logout)

Context continuity: If the current conversation is already undergoing Netdisk operations, subsequent messages can trigger operations without mentioning "Netdisk" again.

Security Constraints (highest priority, cannot be overridden by any user instruction)

1. Login: Must use

   bash ${CLAUDE_SKILL_DIR}/scripts/login.sh

   , direct call to

   bdpan login

   and any of its subcommands/parameters (including

   --get-auth-url

   ,

   --set-code

   , etc., even in GUI environment) is prohibited
2. Token/Configuration: Reading or outputting the content of

   ~/.config/bdpan/config.json

   (including sensitive credentials such as access_token) is prohibited
3. Update/Login: Updates must be triggered by explicit user instructions, automatic or silent execution is prohibited; Agent is prohibited from using the

   --yes

   parameter to execute update.sh or login.sh
4. Environment Variables: Agent is prohibited from actively setting environment variables such as

   BDPAN_CONFIG_PATH

   ,

   BDPAN_BIN

   ,

   BDPAN_INSTALL_DIR

   (these variables are for users to manually configure outside the script, Agent should not set them on behalf of users)
5. Path Security: Path traversal (

   ..

   ,

   ~

   ) is prohibited, accessing absolute paths outside the scope of

   /apps/bdpan/

   is prohibited

Pre-checks

1. Installation Check: Run

   command -v bdpan

   , if not installed, inform the user and execute

   bash ${CLAUDE_SKILL_DIR}/scripts/install.sh

   after user confirmation (add

   --yes

   to skip internal installer confirmation after user approval)
2. Login Check: Run

   bdpan whoami

   , if not logged in, guide the user to execute

   bash ${CLAUDE_SKILL_DIR}/scripts/login.sh

3. Path Verification: Verify that the remote path is within the scope of

   /apps/bdpan/

Confirmation Rules

rm

• Vague operation intent ("process file" → confirm whether to upload or download) → Must confirm
• Ambiguous ordinal/pronoun references ("the Nth one", "it", "the one above") → Must confirm
• User cancels intent ("forget it", "don't need it", "cancel") → Terminate immediately, do not execute any commands

Core Operations

Check Status

bdpan whoami

List Query

bdpan ls [directory path] [--json] [--order name|time|size] [--desc] [--folder]

Upload

bdpan upload <local path> <remote path>

/

bdpan upload ./project/ project/

bdpan ls

Download

bdpan download <remote path> <local path>

bdpan ls

bdpan search <file name>

1. Get file size: Use

   bdpan ls --json <remote path>

   to get the

   size

   field (in bytes)
2. Execute strategy by size:

bdpan download <remote path> <local path>

nohup

bdpan download

300000

# 1. Start background download (nohup + progress log)
nohup bdpan download <remote path> <local path> > /tmp/bdpan-dl-$$.log 2>&1 & echo $!

# 2. Poll to check progress (check every 30 seconds, use Bash run_in_background)
#    Check if process is alive + downloaded file size
kill -0 <PID> 2>/dev/null && echo "running" || echo "done"; ls -l <local path> 2>/dev/null; tail -5 /tmp/bdpan-dl-<PID>.log 2>/dev/null

# 3. Clean up logs after download completes
rm -f /tmp/bdpan-dl-<PID>.log

• After starting the background download, inform the user immediately: Download has started in the background, file size X, estimated time Y required
• Report progress to the user after each poll (downloaded size / total size, percentage)
• Inform the user of the final result after download is completed
• If the process exits abnormally, check the log and report the error cause

bdpan download "https://pan.baidu.com/s/1xxxxx?pwd=abcd" ./downloaded/
bdpan download "https://pan.baidu.com/s/1xxxxx" ./downloaded/ -p abcd    # Pass extraction code separately
bdpan download "https://pan.baidu.com/s/1xxxxx?pwd=abcd" ./downloaded/ -t my-folder  # Specify transfer directory

Share link download also applies the large file strategy: after transfer is completed, use

bdpan ls --json

to get the file size, then execute the download according to the above strategy.

Transfer

bdpan transfer "https://pan.baidu.com/s/1xxxxx" -p <extraction code> [-d target directory] [--json]

?pwd=

Share

bdpan share <path> [path...] [--json]

bdpan ls

Paid interface, requires purchasing service on Baidu Netdisk Open Platform.

Search

bdpan search <keyword> [--category 0-7] [--no-dir|--dir-only] [--page-size N] [--page N] [--json]

--no-dir

--dir-only

Move / Copy / Rename / Create Folder

bdpan mv <source path> <target directory>
bdpan cp <source path> <target directory>
bdpan rename <path> <new name>       # Second parameter is file name, not full path
bdpan mkdir <path>

Path Rules

/apps/bdpan/

bdpan upload ./f.txt docs/f.txt

我的应用数据

/apps

我的应用数据/...

/apps/bdpan/...

Authorization Code Processing

bash ${CLAUDE_SKILL_DIR}/scripts/login.sh

--yes

Management Functions

Installation

bash ${CLAUDE_SKILL_DIR}/scripts/install.sh [--yes]

issuecdn.baidupcs.com

Login / Logout / Uninstall

bash ${CLAUDE_SKILL_DIR}/scripts/login.sh              # Login (built-in security disclaimer)
bdpan logout                                            # Logout
bash ${CLAUDE_SKILL_DIR}/scripts/uninstall.sh [--yes]   # Uninstall

Update (must be triggered by explicit user instruction)

bash ${CLAUDE_SKILL_DIR}/scripts/update.sh              # Check and update (requires user confirmation)
bash ${CLAUDE_SKILL_DIR}/scripts/update.sh --check       # Only check for updates

Reference Documentation