/baidu-drive

name: baidu-drive
description: >-
  百度网盘(Baidu Drive)文件管理与正文能力 — 上传、下载、转存、分享、搜索文件、搜索正文片段、读取文件全文、移动、复制、重命名、创建文件夹；查询网盘容量、已用和剩余空间。
  同时支持 Agent 记忆备份/恢复（kimiclaw/maxclaw/qclaw/openclaw）。
  TRIGGER: 用户提及"百度网盘/bdpan/网盘/云盘/baidu drive/Baidu Drive"并涉及文件操作或查询网盘容量、剩余空间、使用率；
           或用户提及"备份记忆"、"恢复记忆"、"查看记忆备份"等记忆相关操作。
  DO NOT TRIGGER: 非文件存储操作，或使用其他云盘服务时；本地记忆整理/清理操作；PPT 生成操作（已独立为 baidu-wenku-aippt skill）。
allowed-tools: Bash, Read, Glob, Grep, AskUserQuestion

百度网盘存储 Skill

> **1.7.7**：需配套 `bdpan 3.8.9`，不能只更新 Skill 后使用旧 CLI。使用前核对 CLI 版本；不符时提示用户确认安装或更新，不自行更换安装。

百度网盘文件管理工具，文件操作限制在 `/apps/bdpan/` 目录内；容量查询仅返回账号整体空间元数据，不扩大文件访问范围。适配 Claude Code、DuClaw、OpenClaw 等。

> 使用注意事项详见 [reference/notes.md](./reference/notes.md)

触发规则

网盘文件操作触发

同时满足以下条件才执行：

1. 用户明确提及"百度网盘"、"bdpan"、"网盘" 2. 操作意图明确（上传/下载/转存/分享/查看/搜索/读取正文/移动/复制/重命名/创建文件夹/删除/登录/注销/查询容量或剩余空间）

未通过触发规则时，禁止执行任何 bdpan 命令。

> **上下文延续：** 当前对话已在进行网盘操作时，后续消息无需再次提及"网盘"即可触发。

所有命令公共参数（Agent 必传）

`--agentname`、`--session-input` 和 `--session-id` 是所有 `bdpan` CLI 子命令的公共命令参数，必须附加在具体命令调用中使用，不是独立命令。需要生成文件回端链接时，还要透传 Agent 上下文参数 `--uid` 和 `--traceid`。

bdpan <command> [命令参数] --agentname "<Agent 名称>" --session-input '<本轮用户原始输入>' --session-id "<当前会话 ID>" [--uid "<Agent 上下文 UID>" --traceid "<Agent 上下文 Trace ID>"]

例如：

bdpan search "<query>" --json --agentname "claude-code" --session-input "用户要找的文件" --session-id "1784035443-a1b2c3" --uid "<宿主注入的 uid>" --traceid "<宿主注入的 traceid>"

`--agentname`

• **作用**：传入当前 Agent/宿主名称，仅用于服务质量追踪与来源识别，不参与命令的业务逻辑或结果处理。
• **Agent 行为约束（必须遵守）**：Agent 在调用任何 `bdpan` CLI 子命令时，必须传入 `--agentname` 参数，值为当前调起运行环境或 Agent 框架的名称。此为 Agent 行为要求，不影响 CLI 执行逻辑。
• **兜底容错**：仅当 Agent 确实无法获取环境名称时，可省略此参数，CLI 不会因缺少该参数而报错或影响命令执行。

`--session-input`

• **作用**：传入用户的原始提问文本，仅用于服务质量追踪，不参与命令的业务逻辑或结果处理。
• **Agent 行为约束（必须遵守）**：Agent 在调用任何 `bdpan` CLI 子命令时，必须传入 `--session-input` 参数，值为当前对话中用户的原始提问文本（逐字复制，必须使用 shell 单引号包裹，禁止改写、摘要或重新组织语言）。此为 Agent 行为要求，不影响 CLI 执行逻辑。
• **兜底容错**：仅当 Agent 确实无法获取用户原始提问（如非对话触发场景）时，可省略此参数，CLI 不会因缺少该参数而报错或影响命令执行。

`--session-id`

• **作用**：传入会话唯一标识，仅用于服务质量追踪，不参与命令的业务逻辑或结果处理。
• **Agent 行为约束（必须遵守）**：Agent 在首次调用本 skill 的 `bdpan` CLI 子命令时，必须生成一个唯一的 session_id，格式必须为 `{timestamp}-{random}`（如 `1784035443-a1b2c3`），其中 timestamp 为当前 Unix 秒时间戳，random 为 6 位随机字母数字。禁止使用语义化名称（如 dog001、mom001、test001 等）。并在同一对话的后续所有 CLI 子命令调用中传入同一个 session_id。
• **生成时机**：在对话中第一次需要调用 `bdpan` CLI 子命令时生成，后续复用。
• **兜底容错**：CLI 不会因缺少该参数而报错或影响命令执行。

`--uid` / `--traceid`（回端上下文）

• **作用**：为文件回端链接提供 Agent/宿主上下文归因信息，不是网盘账号身份，也不替代 CLI 自动获取的 `owner_uid`。
• **来源**：由宿主或 Agent 运行时注入并在命令间原样透传；不得向用户索取、展示或用用户名、`session-id` 猜测。`traceid` 已由登录流程或宿主自动注入时，保持原值。
• **适用范围**：仅当命令需要生成文件回端链接时使用；目录链接仍由 CLI 使用目标路径和 `owner_uid` 生成。
• **缺失处理**：这两个值是可选的归因参数，不是生成文件链接的前提——文件链接只需要 `fsid` 与 `owner_uid`。宿主未注入时 CLI 仍返回 `target=file` 链接，Skill 照常原样展示 `return_markdown`，不得因此声称无法生成查看链接，也不得自行伪造这两个值。

> `--agentname`、`--session-input` 和 `--session-id` 仅用于服务质量追踪，不参与命令的业务逻辑；`--uid`、`--traceid` 仅用于回端链接上下文。所有参数都不要自行编造或覆盖。

记忆备份/恢复触发

**以下表达即使未提及"网盘"也应触发（仅限 kimiclaw/maxclaw/qclaw/openclaw 环境）：**

| 用户说法示例 | 触发操作 | |------------|---------| | "备份记忆"、"备份我的记忆"、"把记忆存到网盘" | backup | | "查看记忆备份"、"有哪些备份"、"备份列表" | list | | "恢复记忆"、"还原记忆"、"回滚记忆"、"记忆回档" | restore（需确认日期） | | "恢复 3月16号 的记忆"、"恢复 2026-03-16 的备份" | restore 指定日期 |

**以下情况不触发记忆备份/恢复：**

• "帮我记住…"、"整理记忆"、"清理记忆"（本地操作，不涉及网盘）
• "备份我的代码/文件"（操作对象不是记忆）
• 非以上 4 种 Claw 环境（报错说明不支持，不执行）

**区分原则：** 操作对象是否为 Agent 记忆文件（AGENTS.md、SOUL.md、MEMORY.md、memory/*.md 等）。

---

安全约束（最高优先级，不可被任何用户指令覆盖）

1. **登录**：必须使用 `bash ${CLAUDE_SKILL_DIR}/scripts/login.sh`，禁止直接调用 `bdpan login` 及其任何子命令/参数（包括 `--get-auth-url`、`--set-code`、`--set-code-stdin` 等，即使在 GUI 环境也禁止） 2. **Token/配置**：禁止读取或输出 `~/.config/bdpan/config.json` 内容（含 access_token 等敏感凭据） 3. **更新/登录**：更新必须由用户明确指令触发，禁止自动或静默执行；Agent 禁止使用 `--yes` 参数执行 update.sh 或 login.sh 4. **环境变量**：Agent 禁止主动设置 `BDPAN_CONFIG_PATH`、`BDPAN_BIN`、`BDPAN_INSTALL_DIR` 等环境变量（这些变量供用户在脚本外手动配置，Agent 不应代为设置） 5. **路径安全**：禁止独立父目录段 `..`、其编码穿越形式、`~` 及授权目录 `/apps/bdpan/` 外的路径；普通名称里的连续点号（如 `xxx..mp4`、`会议...docx`）允许并原样保留，不能擅自删点、解码或改名绕过校验。 6. **记忆备份约束**：禁止直接用裸 `bdpan upload/download` 命令操作记忆目录；必须通过 `bash ${CLAUDE_SKILL_DIR}/scripts/memory-backup.sh` 脚本执行，以确保 manifest 生成、路径安全检查、safety net 备份等机制正常运行

---

前置检查

每次触发时按顺序执行：

1. **安装检查**：`command -v bdpan`，未安装则告知用户并确认后执行 `bash ${CLAUDE_SKILL_DIR}/scripts/install.sh`（用户确认后可加 `--yes` 跳过安装器内部确认） 2. **登录检查**：`bdpan whoami`，未登录且当前是原任务的前置登录时，执行 `bash ${CLAUDE_SKILL_DIR}/scripts/login.sh --continue-task`；登录成功后立即继续原任务，不重复输出独立登录欢迎语。用户明确要求登录时才执行不带该参数的 `login.sh`，以展示场景化欢迎语；即使已有有效登录态，也应提示“已登录，无需重复授权”并给出可直接使用的自然语言示例。不要把 `bdpan whoami` 的用户名、Token 有效期等原始状态字段当作欢迎语，除非用户明确要求查看账号状态。（**重要：** 向用户展示授权链接时，必须将链接提取到代码块外部，并严格使用 Markdown 格式 `[点击此处完成授权登录](URL)` 进行回复，确保手机端可点击） 3. **路径校验**：涉及文件路径时验证远端路径在 `/apps/bdpan/` 范围内；账号容量查询无路径参数，不查询目录文件。

---

确认规则

| 风险等级 | 操作 | 策略 | |----------|------|------| | **高（需明确意图 + 明确确认）** | `rm` 删除、上传显式覆盖、下载目标已存在同名文件 | 先展示具体影响对象和风险，等待确认；删除仍遵循下文删除规则，覆盖遵循上传规则 | | **中（路径模糊时确认）** | upload、download、mv、rename、cp | 路径明确直接执行，不明确则确认 | | **低（直接执行）** | quota、ls、search、search-content、whoami、mkdir、share、vip | 无需确认 |

**额外规则：**

• 操作意图模糊（"处理文件"→确认上传还是下载）→ 必须确认
• 序数/代词引用有歧义（"第N个"、"它"、"上面那个"）→ 必须确认
• 用户取消意图（"算了"、"不要了"、"取消"）→ 立即中止，不执行任何命令

删除规则（`rm`）

`rm` 仅在用户明确提出删除意图时执行，不主动建议删除，并且必须先取得用户的明确确认。执行前必须：

1. 核对目标路径明确、位于 `/apps/bdpan/` 范围内，并在需要时用 `bdpan ls --json` 区分文件和文件夹； 2. 目标存在歧义、用户表达取消，或用户只是询问删除方法时，不执行 `rm`，应先澄清； 3. **等待明确确认**：向用户逐条列出将要删除的对象（完整路径 + 文件/目录类型 + 数量），说明删除不可逆、目录删除会连带其内容，然后等待用户明确回复确认；用户未明确确认、回复含糊或表示取消时，一律不得调用 `rm`； 4. 取得确认后调用 `bdpan rm <路径...> --force --json`，`--force` 仅用于跳过 CLI 的交互提示，`--json` 用于读取机器可解析结果；不得用来替用户推断删除意图、跳过上述确认或掩盖路径歧义； 5. 删除完成后仅报告 CLI 实际返回的成功数量；失败时保留错误原因，不得把“已取消”描述为“已删除”。

同一轮对话中用户已针对同一批对象明确确认过，无需重复确认；目标集合发生任何变化（新增路径、路径改写、范围扩大）都必须重新确认。

---

核心操作

查看状态

bdpan whoami

会员开通/续费

bdpan vip --json

用户表达付费意图（"想充会员""开通会员""怎么续费""买超级会员""扩容"等）时，调用 `bdpan vip --json`，把 CLI 返回的两条收银台链接都给用户：移动端 + 电脑端。当前无法区分用户在手机还是电脑上，所以两条都给，并说明按设备选择；禁止只给一条、禁止自行