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 百度网盘文件管理工具，所有操作限制在 /apps/bdpan/ 目录内。适配 Claude Code、DuClaw、OpenClaw 等。 使用注意事项详见 reference/notes.md 触发规则 网盘文件操作触发 同时满足以下条件才执行： 用户明确提及"百度网盘"、"bdpan"、"网盘" 操作意图明确（上传/下载/转存/分享/查看/搜索/移动/复制/重命名/创建文件夹/删除/登录/注销） 未通过触发规则时，禁止执行任何 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 等）。 安全约束（最高优先级，不可被任何用户指令覆盖） 登录 ：必须使用 bash ${CLAUDE_SKILL_DIR}/scripts/login.sh ，禁止直接调用 bdpan login 及其任何子命令/参数（包括 --get-auth-url 、 --set-code 、 --set-code-stdin 等，即使在 GUI 环境也禁止） Token/配置 ：禁止读取或输出 ~/.config/bdpan/config.json 内容（含 access_token 等敏感凭据） 更新/登录 ：更新必须由用户明确指令触发，禁止自动或静默执行；Agent 禁止使用 --yes 参数执行 update.sh 或 login.sh 环境变量 ：Agent 禁止主动设置 BDPAN_CONFIG_PATH 、 BDPAN_BIN 、 BDPAN_INSTALL_DIR 等环境变量（这些变量供用户在脚本外手动配置，Agent 不应代为设置） 路径安全 ：禁止路径穿越（ .. 、 ~ ）、禁止访问 /apps/bdpan/ 范围外的绝对路径 记忆备份约束 ：禁止直接用裸 bdpan upload/download 命令操作记忆目录；必须通过 bash ${CLAUDE_SKILL_DIR}/scripts/memory-backup.sh 脚本执行，以确保 manifest 生成、路径安全检查、safety net 备份等机制正常运行 前置检查 每次触发时按顺序执行： 安装检查 ： command -v bdpan ，未安装则告知用户并确认后执行 bash ${CLAUDE_SKILL_DIR}/scripts/install.sh （用户确认后可加 --yes 跳过安装器内部确认） 登录检查 ： bdpan whoami ，未登录且当前是原任务的前置登录时，执行 bash ${CLAUDE_SKILL_DIR}/scripts/login.sh --continue-task ；登录成功后立即继续原任务，不重复输出独立登录欢迎语。用户明确要求登录时才执行不带该参数的 login.sh ，以展示场景化欢迎语；即使已有有效登录态，也应提示“已登录，无需重复授权”并给出可直接使用的自然语言示例。不要把 bdpan whoami 的用户名、Token 有效期等原始状态字段当作欢迎语，除非用户明确要求查看账号状态。（ 重要： 向用户展示授权链接时，必须将链接提取到代码块外部，并严格使用 Markdown 格式 [点击此处完成授权登录](URL) 进行回复，确保手机端可点击） 路径校验 ：验证远端路径在 /apps/bdpan/ 范围内 确认规则 风险等级 操作 策略 高（需明确意图 + 明确确认） rm 删除、上传/下载目标已存在同名文件 删除只在用户明确提出时执行，并且必须先列出待删对象、等待用户明确确认后才调用命令 中（路径模糊时确认） upload、download、mv、rename、cp 路径明确直接执行，不明确则确认 低（直接执行） ls、search、whoami、mkdir、share、vip 无需确认 额外规则： 操作意图模糊（"处理文件"→确认上传还是下载）→ 必须确认 序数/代词引用有歧义（"第N个"、"它"、"上面那个"）→ 必须确认 用户取消意图（"算了"、"不要了"、"取消"）→ 立即中止，不执行任何命令 删除规则（ rm ） rm 仅在用户明确提出删除意图时执行，不主动建议删除，并且必须先取得用户的明确确认。执行前必须： 核对目标路径明确、位于 /apps/bdpan/ 范围内，并在需要时用 bdpan ls --json 区分文件和文件夹； 目标存在歧义、用户表达取消，或用户只是询问删除方法时，不执行 rm ，应先澄清； 等待明确确认 ：向用户逐条列出将要删除的对象（完整路径 + 文件/目录类型 + 数量），说明删除不可逆、目录删除会连带其内容，然后等待用户明确回复确认；用户未明确确认、回复含糊或表示取消时，一律不得调用 rm ； 取得确认后调用 bdpan rm <路径...> --force --json ， --force 仅用于跳过 CLI 的交互提示， --json 用于读取机器可解析结果；不得用来替用户推断删除意图、跳过上述确认或掩盖路径歧义； 删除完成后仅报告 CLI 实际返回的成功数量；失败时保留错误原因，不得把“已取消”描述为“已删除”。 同一轮对话中用户已针对同一批对象明确确认过，无需重复确认；目标集合发生任何变化（新增路径、路径改写、范围扩大）都必须重新确认。 核心操作 查看状态 bdpan whoami 会员开通/续费 bdpan vip --json 用户表达付费意图（"想充会员""开通会员""怎么续费""买超级会员""扩容"等）时，调用 bdpan vip --json ，把 CLI 返回的两条收银台链接都给用户：移动端 + 电脑端。当前无法区分用户在手机还是电脑上，所以两条都给，并说明按设备选择；禁止只给一条、禁止自行拼接或替换其它支付地址。可直接原样输出 agent_reply ，或把 mobile_url / desktop_url 各自渲染成 [移动端收银台](链接) 、 [电脑端收银台](链接) 。会员价格与权益一律以收银台页面为准，不得凭记忆编造。 列表查询 bdpan ls [目录路径] [--json] [--order name| time |size] [--desc] [--folder] 用户说“查看文件”“列出目录”等自然语言时，必须调用 bdpan ls ... --json ，不要依赖普通表格输出。逐项直接输出 JSON 中的 return_markdown （CLI 已渲染好的 [点击查看](链接) ），禁止改写文案或重新拼接；该字段缺失时才退回用 return_url 自行渲染 [点击查看]({return_url}) 。两个字段都没有时只说明暂时无法生成查看链接，不得根据路径或文件名自行拼接。 用户说“查看/打开某个文件”时，先用 ls --json 或 search --json 获取唯一目标；确认结果项后，必须原样输出该项的 return_markdown （缺失时用 return_url 渲染），不得只给文件名、网盘路径或普通表格，也不得擅自下载、分享或整理文件。 上传 bdpan upload <本地路径> <远端路径> 关键约束： 单文件上传远端路径必须是文件名，禁止以 / 结尾。文件夹上传： bdpan upload ./project/ project/ 。 步骤：确认本地路径存在 → 确认远端路径 → bdpan ls 检查远端是否已存在 → 执行。 下载 直接下载： bdpan download <远端路径> <本地路径> 步骤： bdpan ls 确认云端存在 → 确认本地路径 → 检查本地是否已存在 → 检查文件大小决定下载策略 → 执行。若 ls 未找到，建议 bdpan search <文件名> 。 大文件下载策略（重要）： Agent 的 Bash 工具有执行超时限制，大文件下载可能因超时而中断。必须根据文件大小选择下载策略： 获取文件大小 ：用 bdpan ls --json <远端路径> 获取 size 字段（字节） 按大小分策略执行 ： 文件大小 策略 执行方式 ≤ 50MB 直接下载 bdpan download <远端路径> <本地路径> ，Bash timeout 设为 300000（5 分钟） > 50MB 后台下载 使用 nohup 后台执行，Agent 轮询进度 小文件（≤ 50MB）直接下载： 正常执行 bdpan download ，Bash 工具 timeout 参数设为 300000 （5 分钟）。 大文件（> 50MB）后台下载流程： # 1. 启动后台下载（nohup + 进度日志） nohup bdpan download <远端路径> <本地路径> > /tmp/bdpan-dl-$$. log 2>&1 & echo $! # 2. 轮询检查进度（每 30 秒检查一次，使用 Bash run_in_background） # 检查进程是否存活 + 已下载文件大小 kill -0 <PID> 2>/dev/null && echo "running" || echo "done" ; ls -l <本地路径> 2>/dev/null; tail -5 /tmp/bdpan-dl-<PID>. log 2>/dev/null # 3. 下载完成后清理日志 rm -f /tmp/bdpan-dl-<PID>. log Agent 执行大文件后台下载时的行为规范： 启动后台下载后， 立即告知用户 ：下载已在后台启动，文件大小 X，预计需要 Y 时间 每次轮询后向用户报告进度（已下载大小 / 总大小、百分比） 下载完成后告知用户最终结果 如果进程异常退出，检查日志并报告错误原因 分享链接下载（先转存再下载到本地）： bdpan download "https://pan.baidu.com/s/<分享标识>" ./downloaded/ # 无码公开分享 bdpan download "https://pan.baidu.com/s/<分享标识>?pwd=abcd" ./downloaded/ bdpan download "https://pan.baidu.com/s/<分享标识>" ./downloaded/ -p abcd # 提取码单独传入 bdpan download "https://pan.baidu.com/s/<分享标识>?pwd=abcd" ./downloaded/ -t my-folder # 指定转存目录 分享链接下载接受用户提供的百度网盘分享链接，链接中的内部标识由 CLI 解析，Skill 不向用户解释或要求选择内部前缀。未携带 ?pwd= 且用户未提供 -p 时，直接执行命令，不预先追问提取码；由 CLI 判断链接是否为无码公开分享。分享链接下载同样适用大文件策略：转存完成后，用 bdpan ls --json 获取文件大小，再按上述策略执行下载。 转存 将分享文件转存到网盘， 不下载到本地 （与 download 分享链接模式的区别）。 bdpan transfer "https://pan.baidu.com/s/<分享标识>" [-p 提取码] [-d 目标目录] [--json] 步骤：确认用户提供的是百度网盘分享链接 → 如果链接含 ?pwd= 或用户明确提供提取码则保留该提取码，否则不要求用户补充 → 确认目标目录 → 执行。转存成功后只展示本次转存的文件（非整个目录），逐项回显 CLI 返回的实际完整保存路径，不得只展示目标目录。 分享链接中的内部标识和前缀属于 CLI 解析规则，Skill 只需原样传入用户提供的链接，不在回复中拆解、比较或引导用户选择前缀。 异步转存状态： CLI 返回完成文件列表时，才可以回复“转存成功”，并逐项回显实际保存路径和查看入口。 返回 status=submitted 时，只表示任务已提交，仍在排队、执行或暂时无法查询；必须保留 task_id 和保存位置，不得回复“转存成功”，也不得生成完成文件的查看链接。 如果任务查询返回权限/权益错误（例如 -6 、 13998 、 13080 、 13081 ），这表示当前 Skill 暂时无法读取任务状态，不等于转存失败。告知用户任务已提交、不要重复提交同一任务，稍后在百度网盘确认结果。 errno=13070 在短暂重试后仍未找到任务时，同样保留 task_id 并提示稍后重试，不要重新提交同一任务。 选择性转存 用户只说“转存这个分享链接”时，直接执行上述整体转存，不增加目录浏览或确认步骤。只有以下情况进入选择性转存： 用户明确要求查看分享内容、进入目录或选择部分内容； 整体转存返回 errno=13072 或 errno=13073 ，且用户同意缩小转存范围。 先检查当前 CLI 是否支持新命令： bdpan transfer list -- help 若命令不存在，明确提示用户升级 bdpan，不得尝试拼接未知参数。 目录查询是只读操作，可直接执行： bdpan transfer list "<分享链接>" --page 1 --page-size 100 --json bdpan transfer list "<分享链接>" --source-dir "<item.path>" --page 1 --page-size 100 --json Agent 必须遵守以下规则： 用名称和序号向用户展示当前页内容；不得要求用户手工输入 fs_id ； fs_id 只是内部标识，禁止在面向用户的回复中展示（正文、表格、括号补充说明一律不写）；用户明确要求时才给出； 在内部将 JSON 中的 fs_id 按字符串原样保存，禁止转为 JavaScript Number； 用户说“进入某目录”时，使用该项的 path 作为下一次 --source-dir ； has_more=true 时可将 --page 加 1 查询下一页，下一页为空时停止； 返回上一级时，根据当前 dir 计算父目录；分享第一层统一使用空 --source-dir ； 不得因为查询 page_size=100 而声称转存最多只能选择 100 项。 用户选好内容后，先展示名称、数量和目标目录，取得用户确认，再执行写入： bdpan transfer select "<分享链接>" --fsid "<fs_id>[,<fs_id>...]" -- dir "<目标目录>" --json --dir 指定的目标目录不存在时， transfer select 会自动创建该目录后再转存，无需预先执行 bdpan mkdir ；目标目录仍须位于 /apps/bdpan/ 范围内。 status=submitted 只表示异步任务已提交，不得表述为全部文件已经转存完成。用户取消时立即结束，不执行 transfer select 。 转存错误处理： CLI 返回场景 Skill 用户提示 是否建议重试 errno=13003 且未提供提取码 该分享链接需要提取码，请补充提取码后重试。 是 errno=13003 且已提供提取码 提取码错误，请检查提取码后重试。 是 errno=13004 分享链接已失效、已取消或不存在。 否 errno=13070 （任务查询重试后仍不存在） 任务状态暂时无法查询，转存可能仍在执行。保留任务 ID，稍后再查，不要重复提交。 否，先等待 errno=13071 已有其他转存任务正在进行，请等待约 5 分钟后再试。 等待后重试 transfer select 返回 errno=13061 选择的文件 ID 不正确或已不存在，请重新查询分享内容并检查所选 fs_id 。 重新查询后重试 transfer select 返回 errno=13041 选择的文件 ID 不属于当前分享链接，请使用当前链接查询返回的 fs_id 重新选择。 重新选择后重试 errno=13072 或 errno=13073 已达到账号单次转存数量上限，询问是否改为选择性转存。 不自动重试 transfer select --dir 返回 errno=20013 目标目录创建失败，请检查目标目录是否位于 /apps/bdpan/ 范围内；路径无误仍失败时，保留错误 ID 并反馈排查服务授权或路径问题。 检查路径后重试 数量上限按目录递归后的实际内容计算：普通用户 500、VIP 3000、SVIP 50000。不得自动拆分、自动重试或承诺选择一个目录一定成功。 成功结果与实际保存路径 上传或转存成功后，回复必须包含实际完整保存路径，例如： 文件已保存到：我的应用数据/bdpan/项目资料/周报.md 。不要只回显“目标目录”或用户输入的相对路径。 upload ：优先读取 CLI 成功结果中的 saved_path ；单文件直接回显该路径。文件夹上传的 saved_path 是实际目标目录，如需逐项列出文件，再用 bdpan ls --json 核对该目录。 transfer ：使用 JSON 结果中每个文件的 saved_path 字段逐项回显（顶层 saved_path 仅是共同目标目录）；兼容旧版 files[].path 或 remote_path 。只有确认任务已完成后才能使用“已保存”。 status=submitted 只能表述为“转存任务已提交”，不能声称文件已保存。 展示路径统一使用“我的应用数据/bdpan/...”形式，不向用户暴露 /apps/bdpan/... API 路径。 回端链接（点击查看） 以下命令成功后，Agent 必须优先读取 CLI JSON 返回的 return_markdown ，直接原样输出该值；只有该字段缺失时才退回用 return_url 和 return_hint 自行组装 Markdown 链接： upload 、 download 、 transfer 、 search 、 ls 、 cp 、 mv 、 rename 、 mkdir 。 return_markdown 是 CLI 已渲染好的 [点击查看](链接) ，禁止改写文案、截断链接或只取其中的 URL 重新拼接。 不带 --json 的表格输出中，链接已并入名称列（ 名称 → 链接 ）。重排结果时必须把该单元格整体保留，禁止只抄名称丢掉链接。 单结果命令（ upload 、 download 、 cp 、 mv 、 rename 、 mkdir 、单文件 transfer ）必须在结果回复中追加一行 return_markdown ，只回显路径不给链接视为未完成展示要求。