用途:把百度网盘接入 PKM 工作流,负责安全的原子操作与只读资源扫描,不负责自动整理目录或生成馆藏,这些交给上层 curator 技能消费扫描结果。
主要能力:检查 bdpan 版本与登录态并授权;用 ls --json / search --json 浏览与搜索;上传、下载、分享、转存、移动、复制、重命名、建目录;执行只读 DFS 生成 JSONL 及 .errors/.progress/.done sidecar。官方 bdpan 不提供删除命令,也不使用网页 Cookie、BDUSS 或未公开接口。
使用方式:先安装本技能,再安装百度官方上游 baidu-drive Skill;按上游 SKILL.md 由 scripts/install.sh 安装 bdpan,安装源为百度 CDN,执行前应审查脚本。登录优先用设备码入口(自动带 --accept-disclaimer 并生成授权链接/二维码,用 decode_qr.py 解出地址),旧版本回退 scripts/login.sh --yes;之后用 whoami 验证。命令经 scripts/run_with_env.py 包装,按私有配置选择 bdpan 或 baidupan-cli。写操作前先 ls 检查源与目标父目录并确认范围与冲突策略,执行后回读核对。扫描示例:run 包装 scan_drive.py --root / --out 输出.jsonl --workers 4 --resume。
限制:社区模式需 AppKey、SecretKey 和 App 名称,官方模式不需要;私有配置默认在 ~/.config/soia-skills/soia-pkm-baidu-netdisk-ops/config.yml,可被环境变量覆盖。Agent 不读取或打印 bdpan 配置及秘密值。禁止含 .. 或 ~ 的远端路径,不得把本地绝对路径当远端路径。分享可能收费,须单独确认。上传返回业务错误(尤其 errno=-10)时停止重试并回读目标。终端超时不等同传输失败。存在扫描错误时只交付部分扫描。记忆备份/恢复仅在 KimiClaw、MaxClaw、QClaw、OpenClaw 环境按上游脚本执行,其他环境明确不支持。真实账号的端到端上传、分享、转存测试暂未提供。