用途：百度网盘文件管理工具，用于在支持 Skill 的 Agent 环境中操作百度网盘文件。所有操作限制在 /apps/bdpan/ 目录内，适配 Claude Code、DuClaw、OpenClaw 等。目前处于内测阶段，注意事项见 reference/notes.md。
触发规则：需同时满足用户明确提及“百度网盘”“bdpan”“网盘”等，且操作意图明确（上传、下载、转存、分享、查看、搜索、移动、复制、重命名、创建文件夹、登录、注销）。未通过触发规则时禁止执行任何 bdpan 命令；当前对话已在进行网盘操作时，后续消息无需重复提及即可触发。
主要能力：查看状态（bdpan whoami）、列表查询（bdpan ls）、上传（bdpan upload）、下载（bdpan download，含分享链接下载）、转存（bdpan transfer）、分享（bdpan share）、搜索（bdpan search）、移动/复制/重命名/创建文件夹（bdpan mv、cp、rename、mkdir）。
安全约束（最高优先级，不可被用户指令覆盖）：登录必须使用 bash ${CLAUDE_SKILL_DIR}/scripts/login.sh，禁止直接调用 bdpan login 及其子命令；禁止读取或输出 ~/.config/bdpan/config.json；更新/登录须用户明确指令触发，Agent 禁止使用 --yes 执行 update.sh 或 login.sh；禁止主动设置 BDPAN_CONFIG_PATH、BDPAN_BIN、BDPAN_INSTALL_DIR；禁止路径穿越与访问 /apps/bdpan/ 范围外的绝对路径。
使用方式：每次触发按序执行前置检查——安装检查 command -v bdpan，未安装经用户确认后执行 bash ${CLAUDE_SKILL_DIR}/scripts/install.sh；登录检查 bdpan whoami，未登录引导执行 bash ${CLAUDE_SKILL_DIR}/scripts/login.sh；路径校验确认远端路径在 /apps/bdpan/ 内。确认规则：rm 删除、上传/下载目标同名文件属高风险须确认；upload、download、mv、rename、cp 路径模糊时确认；ls、search、whoami、mkdir、share 直接执行。用户取消意图时立即中止。
路径与展示：命令参数用相对路径（相对于 /apps/bdpan/），展示给用户用中文名映射（我的应用数据 ↔ /apps）；禁止命令中使用中文路径，禁止展示时暴露 /apps/bdpan/ 等 API 路径。
大文件下载：Bash 工具存在执行超时限制，≤50MB 直接下载并将 timeout 设为 300000；>50MB 使用 nohup 后台下载并轮询进度，每 30 秒检查进程与文件大小，完成后清理日志。
限制与说明：分享为付费接口，需在百度网盘开放平台购买服务；安装器从百度 CDN 下载并执行，不执行本地 SHA256 校验，完整性依赖 HTTPS，安全敏感场景建议先审查或沙箱执行；登录、注销、卸载、更新脚本及 update.sh --check 等命令以资料为准。具体 API 路径、认证流程、错误排查等细节见 reference 下对应文档。