SuperAPI AI 工具集

soia-pkm-baidupan

通用与其它

查看项目

更新于 10-16 09:29

技能介绍

本技能是 PKM 层的百度网盘适配器,默认使用百度官方 baidu-drive Skill 及 bdpan CLI,也可显式切换到社区 baidupan-cli 做开放平台应用目录测试;两种后端由同一份私有配置选择。它负责安全的原子操作与只读扫描,补上 PKM 安全边界和标准 JSONL 输出;不自动整理目录、生成馆藏或制定学习计划,这些交由上层 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 用 scripts/install.sh 安装 bdpan、用 scripts/login.sh 登录,运行 bdpan whoami 验证。操作经包装器执行,如 python3 <skill-path>/scripts/run_with_env.py -- whoami、-- --json ls 资料、mkdir 资料/新目录。写操作前先 ls --json 检查源和目标父目录,确认精确范围与冲突策略后执行并回读核对;share 可能收费需单独确认。扫描示例:python3 <skill-path>/scripts/scan_drive.py --root / --out <user-output-dir>/baidupan-scan.jsonl --workers 4 --resume。

配置默认放 ~/.config/soia-skills/soia-open-skills/soia-pkm/soia-pkm-baidupan/config.yml,可用 SOIA_PKM_BAIDUPAN_CONFIG_FILE 覆盖;仅 provider 与可选 binary 两项。官方凭据由 bdpan 自管,Agent 不读取不打印;社区模式从私有配置 env 读取 AppKey/Secret 等,不回显。禁止路径含 .. 或 ~。

限制:依赖真实百度账号的端到端上传、分享、转存测试暂未提供;终端超时不等于传输失败;扫描有 LIST_FAIL 时只能交付部分扫描;记忆备份/恢复只在 KimiClaw、MaxClaw、QClaw、OpenClaw 环境按上游脚本处理,其他环境明确不支持。