360 Secure SkillHub
360 安全技能中心

Baidupan

该 Skill 通过 bash 脚本封装 bypy,操作百度网盘:列出网盘目录、下载文件或目录到本地、上传本地文件或目录到网盘、单向或双向同步目录、查询网盘配额。首次使用需运行授权脚本完成 OAuth 授权,授权信息保存在本机 bypy 目录。SKILL.md 提供命令示例、视频素材工作流和常见故障排查说明。

libin771018-sketch
libin771018-sketch
热度 57.38
最近更新 2026-05-11 17:37:34
分类:自动化依赖:读写文件 / 第三方 API / 代码执行应用场景:工作流 / 自动化脚本

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add baidupan
Metadata
name
baidupan
description
百度网盘自动化工具,支持上传、下载、列表、同步等操作。
homepage
https://github.com/houtianze/bypy
metadata
{"openclaw":{"emoji":"☁️","requires":{"bins":["bypy"]},"install":[{"id":"pip","kind":"pip","package":"bypy","label":"Install bypy (pip)"}]}}

BaiduPan(百度网盘)

百度网盘自动化工具,基于 bypy 实现。支持文件上传、下载、列表查看、同步等操作。

前置要求

首次使用需要授权登录:

# 运行授权命令
{baseDir}/scripts/auth.sh

# 按提示操作:
# 1. 复制显示的链接到浏览器打开
# 2. 登录百度账号并授权
# 3. 复制授权码
# 4. 粘贴回终端

授权一次,长期有效(直到百度token过期)。


核心功能

功能 命令 说明
查看网盘文件 list.sh 列出指定目录内容
下载文件 download.sh 从网盘下载到本地
上传文件 upload.sh 从本地上传到网盘
同步目录 sync.sh 双向或单向同步
查看配额 quota.sh 查看网盘空间使用情况

功能详解

1. 查看网盘文件 (list.sh)

# 列出根目录
{baseDir}/scripts/list.sh

# 列出指定目录
{baseDir}/scripts/list.sh /我的视频/项目

# 显示文件详情(含大小、修改时间)
{baseDir}/scripts/list.sh /我的视频 --detail

2. 下载文件 (download.sh)

# 下载单个文件到当前目录
{baseDir}/scripts/download.sh /我的视频/长城素材/video1.mp4

# 下载到指定目录
{baseDir}/scripts/download.sh /我的视频/长城素材/video1.mp4 --out ~/Downloads/

# 下载整个目录
{baseDir}/scripts/download.sh /我的视频/长城素材/ --out ~/Downloads/长城素材/

# 覆盖已存在文件
{baseDir}/scripts/download.sh /我的视频/video.mp4 --out ~/Downloads/ --force

3. 上传文件 (upload.sh)

# 上传单个文件到网盘根目录
{baseDir}/scripts/upload.sh ~/Downloads/video.mp4

# 上传到指定目录
{baseDir}/scripts/upload.sh ~/Downloads/video.mp4 --remote /我的视频/项目/

# 上传整个目录
{baseDir}/scripts/upload.sh ~/Downloads/长城素材/ --remote /我的视频/

# 覆盖网盘上已存在文件
{baseDir}/scripts/upload.sh ~/Downloads/video.mp4 --remote /我的视频/ --force

4. 同步目录 (sync.sh)

# 从网盘同步到本地(网盘为主)
{baseDir}/scripts/sync.sh down /我的视频/项目 ~/本地备份/项目/

# 从本地同步到网盘(本地为主)
{baseDir}/scripts/sync.sh up ~/本地项目/ /我的视频/项目/

# 双向同步(谨慎使用)
{baseDir}/scripts/sync.sh both ~/本地项目/ /我的视频/项目/

5. 查看配额 (quota.sh)

{baseDir}/scripts/quota.sh

输出示例:

网盘配额:2.0 TB
已使用:1.2 TB (60%)
剩余可用:800 GB

视频项目工作流

场景:从网盘下载素材进行剪辑

# 1. 查看网盘素材目录
{baseDir}/scripts/list.sh /视频素材/长城春晚/

# 2. 下载所有素材到本地
{baseDir}/scripts/download.sh /视频素材/长城春晚/ --out ~/龙虾项目/长城赞助春晚/raw/

# 3. 剪辑完成后,上传成品回网盘
{baseDir}/scripts/upload.sh ~/龙虾项目/长城赞助春晚/output/final.mp4 --remote /视频成品/

故障排查

问题 可能原因 解决方法
Not authorized 未授权或授权过期 运行 auth.sh 重新授权
Network error 网络问题 检查网络,稍后重试
File not found 路径错误 检查网盘路径,区分大小写
Quota exceeded 网盘空间不足 清理网盘或购买会员
Rate limited 请求过于频繁 等待几分钟后重试

注意事项

  1. 授权安全:授权信息保存在本地 ~/.bypy/ 目录,不要分享给他人
  2. 大文件传输:上传/下载大文件可能需要较长时间,请保持网络稳定
  3. 路径格式:网盘路径以 / 开头,如 /我的视频/项目/
  4. 免费额度:百度网盘对非会员有下载限速,大文件建议开通会员或使用百度云同步盘

相关链接