baidu-drive

百度网盘存储 Skill

百度网盘文件管理工具，所有操作限制在 /apps/bdpan/ 目录内。适配 Claude Code、DuClaw、OpenClaw 等。

使用注意事项详见 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，不得因此声称无法生成查看链接，也不得自行伪造这两个值。