核心用法
百度网盘(Baidu Netdisk/bdpan)Skill 是专为 AI 编程环境设计的文件管理工具,所有操作限制在 /apps/bdpan/ 目录内。主要功能包括:
- 文件传输:上传(
upload)、下载(download)、转存(transfer) - 文件管理:移动(
mv)、复制(cp)、重命名(rename)、创建文件夹(mkdir) - 查询分享:列表(
ls)、搜索(search)、分享链接生成(share)
触发条件:用户明确提及"百度网盘/bdpan/网盘"且涉及文件操作。非文件操作或其他云盘服务不触发。
安全约束(不可覆盖)
1. 登录必须使用封装脚本 login.sh,禁止直接调用 bdpan login
2. 禁止读取/输出 ~/.config/bdpan/config.json(含 access_token)
3. 禁止自动更新,需用户明确指令
4. 禁止路径穿越(..、~)
大文件下载策略(重点)
- ≤50MB:直接下载,Bash timeout 5分钟
- >50MB:后台
nohup下载 + 轮询进度报告,避免 Agent 执行超时中断
路径规则
- 命令参数:相对路径(如
docs/f.txt) - 用户展示:中文路径(如"我的应用数据/bdpan/docs/f.txt")
显著优点
- 原生适配 AI 编程工作流,支持 Claude Code、OpenClaw 等环境
- 完整的文件生命周期管理,覆盖个人网盘主流需求
- 分享链接直接下载/转存,无需手动打开浏览器
- 后台大文件下载机制,避免长时间阻塞 Agent
- 严格的权限隔离(限制
/apps/bdpan/目录)
潜在缺点/局限性
- 内测阶段:稳定性与功能完整性待验证
- 依赖百度 CDN:安装器无 SHA256 校验,HTTPS 为唯一完整性保障
- 付费接口:
share分享功能需百度网盘开放平台购买服务 - 登录流程繁琐:需用户手动获取授权码,无法完全自动化
- 单点依赖:仅支持百度网盘,不支持其他云盘服务
- 路径限制:无法访问网盘根目录或其他应用数据目录
适合人群
- 使用 Claude Code/DuClaw/OpenClaw 等 AI 编程环境的开发者
- 需要批量管理百度网盘文件的技术用户
- 频繁处理分享链接下载/转存的重度网盘用户
- 愿意接受命令行交互、能自主完成 OAuth 授权流程的用户
常规风险
| 风险类型 | 说明 |
|---------|------|
| **授权安全** | Token 存储于本地 `config.json`,需防止泄露 |
| **下载中断** | 大文件前台下载可能因 Agent 超时失败,需严格遵循后台策略 |
| **误操作覆盖** | 上传/下载目标存在同名文件时默认覆盖,需用户确认 |
| **脚本执行** | 安装/登录/更新脚本从远程下载,建议审查后再执行 |
| **数据隔离** | 操作范围受限,无法管理网盘其他位置文件 |