用途:把百度官方 baidu-drive Skill 与 bdpan CLI 接入 PKM 工作流,负责百度网盘的原子操作与只读资源扫描,不负责自动整理目录或生成馆藏,这些交由上层 curator 技能消费扫描结果。
主要能力:登录与登录态验证;用 ls --json / search --json 浏览与搜索;上传、下载、分享、转存、移动、复制、重命名、建目录;只读 DFS 扫描生成 JSONL 及 .errors/.progress/.done sidecar。官方 bdpan 不提供删除命令,本技能不补充删除,也不使用网页 Cookie、BDUSS 或未公开接口。
使用方式:优先安装上游 Skill:npx skills add https://github.com/baidu-netdisk/bdpan-storage/skills --skill baidu-drive,再按上游 SKILL.md 安装 bdpan 并登录。用自然语言说明目标并提供远端虚拟路径(如 /资料)和本地路径;Agent 先检查依赖与登录态,写操作前展示精确范围与冲突策略,确认后执行并回读验证。常用命令:python3 <skill-path>/scripts/run_with_env.py -- version / whoami / --json ls / --json search "关键词";扫描:python3 <skill-path>/scripts/scan_drive.py --root / --out <dir>/baidupan-scan.jsonl --workers 4 --resume。
配置:私有配置默认在 ~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-baidu-netdisk-ops/config.yml,可用 SOIA_PKM_BAIDU_NETDISK_OPS_CONFIG_FILE 覆盖;选项为 provider: official|community 和可选 binary。官方模式配置由 bdpan 自管,Agent 不读取或打印;社区模式需 AppKey、SecretKey、应用名称。
适用场景:PKM 中的网盘文件管理与索引输入。限制:安装、登录、更新需用户明确意图;share 可能收费须单独确认;上传遇 errno=-10 须停止重试并回读;扫描有错误时只能交付部分扫描;记忆备份/恢复仅限 KimiClaw、MaxClaw、QClaw、OpenClaw 环境,且须调用上游脚本。未提供真实账号端到端测试。