soia-pkm-baidu-netdisk-opslisted
Install: claude install-skill soia-team/soia-open-skills
# soia-pkm-baidu-netdisk-ops — 百度网盘原子操作层
## 客户可读说明
本技能把百度官方 `baidu-drive` Skill 和 `bdpan` CLI 接入 PKM 工作流，负责安全的百度网盘原子操作与只读资源扫描。
## 定位
本技能是 PKM 层的百度网盘适配器，默认使用百度官方公开的 [`baidu-drive`](https://github.com/baidu-netdisk/bdpan-storage/tree/main/skills/baidu-drive) Skill 及其 `bdpan` CLI，也可显式切换到社区 [`mqhe2007/baidupan-cli`](https://github.com/mqhe2007/baidupan-cli) 做开放平台应用目录测试。两种后端都由同一份私有配置选择；本技能补充面向 PKM 的安全边界、只读扫描和标准 JSONL 输出。
它不负责自动整理目录、生成馆藏或制定学习计划；这些应由上层 curator 技能消费扫描结果。
## 这个技能可以做什么
| 客户想要 | 技能会做 | 客户能看到 |
|---|---|---|
| 登录或验证百度网盘 | 检查 `bdpan`、版本和登录态；按官方脚本完成授权 | 官方授权地址、非敏感状态和验证结果；不显示 token 或配置文件 |
| 查目录或搜索文件 | 使用 `ls --json` / `search --json` | 远端范围、条目和失败原因 |
| 传输或管理文件 | 上传、下载、分享、转存、移动、复制、重命名、建目录 | 预期范围、执行结果、冲突策略和终态核对 |
| 建立全盘索引输入 | 运行只读 DFS，生成 JSONL 及 `.errors`/`.progress`/`.done` sidecar | 扫描统计、错误数量和产出位置 |
官方 `bdpan` 有意不提供删除命令。本技能不通过其他客户端补充删除，也不使用网页 Cookie、BDUSS 或未公开接口。
### 客户如何使用
用自然语言说明目标，并提供远端虚拟路径（如 `/资料`）和必要的本地目标路径。Agent 会先检查依赖和登录态；涉及上传、下载、分享、转存或远端整理时，会先展示精确范围和冲突策略，再在获得确认后执行并回读验证。
## 依赖与安装
优先安装百度官方上游 Skill：
```bash
npx skills add https://github.com/baidu-netdisk/bdpan-storage/skills --skill baidu-drive
```
随后按上游 `baidu-drive/SKILL.md` 操作：
1. 由上游 `scripts/install.sh` 安装 `bdpan`（当前上游安装器版本需以仓库为准；安装脚本从百度 CDN 下载，执行前应审查脚本和网络来源）。
2. 登录先检查 `bdpan help login` 是否包含 `--device-code`：支持时直接由 Agent 执行本技能的[设备码登录入口](references/login-playbook.md)，自动生成授权链接/二维码并等待客户在百度页面或 App 中授权；该入口自动传入 `--accept-disclaimer`，客户不需要在终端输入 `Y` 或授权码。只有旧版本不支持设备码时，才回退到上游 `scripts/login.sh --yes`；这时 `--y