中文 English

百度网盘别只会拖拽：BaiduPCS-Go CLI 和 Agent 自动化实战

发布时间: 2026-05-16
BaiduPCS-Go 百度网盘 CLI Agent 自动化 BDUSS STOKEN macOS Linux

先说结论

如果你只是偶尔从百度网盘下载一两个文件，网页和官方客户端当然够用。但只要你开始批量下载、服务器拉取、自动备份、远程归档、目录巡检，或者希望让 Codex、Claude、OpenClaw、HermesAgent 这类 Agent 帮你处理网盘任务，图形界面很快就会变成阻碍。BaiduPCS-Go 的价值不是“神奇提速”，而是把百度网盘变成一个可以被脚本、终端和 Agent 调度的文件系统入口。本文会从安装核验、BDUSS/STOKEN 登录、常用命令、配置策略、安全边界，一直讲到怎样把它交给 Agent 使用。

本文所有账号、Cookie、路径、任务描述和配置均为脱敏示例，不包含任何真实 BDUSS、STOKEN、Cookie、内网地址、私人目录或业务信息。请不要把自己的登录凭据写进公开仓库、博客、截图、聊天记录或 Agent 提示词正文。

BaiduPCS-Go 的使用路线：从人工 CLI 到 Agent 自动化

图 1：先把百度网盘变成可命令化的工具，再让 Agent 在受限边界内调用它。

1. 为什么还要折腾百度网盘 CLI

百度网盘的网页端和官方客户端更适合“人坐在电脑前操作”的场景：打开页面、搜索文件、点下载、选目录、等待完成。这个路径对普通用户没有问题，但对长期使用网盘做资料归档、服务器同步、跨设备中转、离线资料整理的人来说，交互式界面有几个天然短板。

第一，它很难重复。今天你下载 /资料/2026/项目A，明天你还要下载 /资料/2026/项目B，后天换成远程服务器，所有操作都要重新点一遍。命令行则可以把步骤固化下来：登录、列目录、搜索、下载、校验、保存到固定目录，形成可复用流程。第二，它很难交给无人值守环境。很多时候真正需要网盘文件的不是本地电脑，而是 VPS、NAS、CI 机器、家庭服务器、临时容器或远程开发环境。图形客户端不一定能装，装了也不一定能稳定登录；CLI 则只要有二进制和配置目录，就能在终端里完成任务。第三，它很难被 Agent 安全调用。Agent 擅长的是读日志、拆任务、执行命令、检查结果、循环修正。如果工具只有图形界面，Agent 要么操作浏览器，要么模拟点击，可靠性很差；如果工具本身提供稳定命令，Agent 就能用“先列计划、再执行、再验证”的方式工作。

所以本文推荐的姿势不是把 BaiduPCS-Go 当作下载加速器，也不是绕开百度网盘规则，而是把它当作一个自动化适配层：人负责授权和边界，CLI 负责执行，Agent 负责把多步操作组织起来。只要这三层分清楚，百度网盘就不再只是一个需要手工点击的网页，而是可以进入个人自动化体系的资料入口。

2. 先认识 BaiduPCS-Go

BaiduPCS-Go 是一个仿 Linux shell 文件处理命令的百度网盘命令行客户端。它的命令风格比较接近常见文件系统操作：ls 列目录，cd 切换网盘工作目录，pwd 看当前位置，download 或 d 下载，upload 或 u 上传，mkdir 建目录，rm 删除，cp 复制，mv 移动或重命名，search 搜索，quota 看容量，transfer 转存分享链接。

BaiduPCS-Go ls /
BaiduPCS-Go cd /我的资源
BaiduPCS-Go pwd
BaiduPCS-Go d /我的资源/示例文件.zip --saveto ./downloads
BaiduPCS-Go u ./report.pdf /文档

这类设计的好处是学习成本低。你不需要记住一套完全陌生的 API，只要把“本地目录”换成“网盘目录”，很多习惯都能迁移过来。上游项目当前仍在维护。本文写作时我核对到本机安装版本为 BaiduPCS-Go version v4.0.1，上游更新说明里 v4.0.1 是 2026-03-26 发布的修复版本，主要修复 ls 等命令的 param error 问题。不同平台安装方式可能不同，实际使用前建议先确认版本：

BaiduPCS-Go --version
BaiduPCS-Go login --help
BaiduPCS-Go config set --help

注意，项目 README 也明确说过：本软件不提供超出官方客户端的下载提速。普通用户把并发调得过高，短时间可能看起来变快，但也更容易触发限速，后续在各客户端都接近 0 速。把它理解成“自动化工具”会比理解成“提速神器”更稳。

3. 安装与版本核验

安装方式取决于平台。macOS、Linux、Windows 都可以使用项目发布的预编译二进制；如果你的包管理器里已有版本，也可以先用包管理器安装，再确认版本是否足够新。核心原则只有三条：下载可信来源、确认平台架构、安装后用真实命令验证。

CLI 安装后的核验清单

图 2：安装不等于可用，至少要确认二进制路径、版本、配置目录和帮助输出。

macOS 上常见路径可能是：

which BaiduPCS-Go
BaiduPCS-Go --version

Linux 服务器上可以把二进制放到 /usr/local/bin 或当前用户的 ~/bin：

chmod +x BaiduPCS-Go
./BaiduPCS-Go --version
sudo install -m 0755 BaiduPCS-Go /usr/local/bin/BaiduPCS-Go
BaiduPCS-Go --version

如果你同时想给 Agent 使用，建议额外做两件事。第一，把命令路径固定下来，不要依赖某个交互 shell 才有的别名。第二，给 BaiduPCS-Go 单独指定配置目录，避免 Agent 误读或污染你个人日常使用的配置：

export BAIDUPCS_GO_CONFIG_DIR="$HOME/.config/baidupcs-agent"
mkdir -p "$BAIDUPCS_GO_CONFIG_DIR"
BaiduPCS-Go env

BaiduPCS-Go env 会显示当前配置目录。默认情况下，非 Windows 系统一般会使用 $HOME/.config/BaiduPCS-Go；但在自动化场景里，我更建议显式设置 BAIDUPCS_GO_CONFIG_DIR，这样你可以给“人用配置”和“Agent 用配置”分开管理。对于服务器来说，这个隔离尤其重要：同一台机器上可能有多个项目、多个系统用户、多个定时任务，配置目录混用会让排查变得很痛苦。

4. 为什么推荐 BDUSS + STOKEN 登录

BaiduPCS-Go 支持多种登录方式，包括交互式账号密码、BDUSS/STOKEN、完整 Cookies。项目帮助里也提示，常规交互式登录方式长期不维护，因此更实际的方式是使用浏览器里已经登录成功后的凭据。

本文建议优先使用 BDUSS + STOKEN：

BaiduPCS-Go login -bduss=<BDUSS> -stoken=<STOKEN>

原因有三个。第一，这比在命令行里输入账号密码更少触碰账号主密码，也避免把密码暴露给 shell 历史、终端录屏或远程会话日志。第二，BDUSS 和 STOKEN 是 BaiduPCS-Go 明确支持的登录参数，尤其涉及转存等功能时，STOKEN 很关键。第三，相比复制整段 Cookie，单独取出两个字段更容易审查，也更容易做脱敏。

但这里必须强调：BDUSS 和 STOKEN 不是普通配置项，而是登录凭据。拿到它们的人，在有效期内可能可以代表你访问账号相关资源。你应该把它们当作密码或 Token 处理：只在自己的设备上获取，只放在受控配置里，不截图、不发群、不提交 Git、不贴给不可信 Agent。如果你更愿意使用完整 Cookie，命令也支持：

BaiduPCS-Go login -cookies="BDUSS=<BDUSS>; STOKEN=<STOKEN>; BAIDUID=<BAIDUID>; ..."

不过完整 Cookie 通常包含更多字段，泄露面也更大。对教学和自动化来说，BDUSS/STOKEN 更清晰。

5. 如何获取 BDUSS 和 STOKEN

下面以 Chrome / Edge 这类 Chromium 浏览器为例。Firefox 的入口名称略有不同，但思路一样：登录百度网盘页面，打开开发者工具，在网络请求里查看请求 Cookie，复制 BDUSS 和 STOKEN 两个字段。

从浏览器开发者工具获取 BDUSS 和 STOKEN 的流程

图 3：只复制需要的字段，并在复制后立刻放入安全位置。

步骤如下：

  1. 打开浏览器，访问 https://pan.baidu.com/，用自己的百度账号正常登录百度网盘。
  2. 登录完成后进入网盘文件页面，确认页面能看到自己的网盘内容。
  3. 按 F12 或 Command + Option + I 打开开发者工具。
  4. 切换到 Network / 网络 标签页。
  5. 勾选 Preserve log / 保留日志，避免刷新后请求记录丢失。
  6. 刷新百度网盘页面。
  7. 在请求列表里选择一个发往 pan.baidu.com 的主文档或接口请求。通常可以先点最上方的文档请求，也可以在过滤框里输入 pan.baidu.com 缩小范围。
  8. 在右侧 Headers / 标头 中找到 Request Headers / 请求标头。
  9. 找到 Cookie: 这一行，在里面搜索 BDUSS= 和 STOKEN=。
  10. 分别复制 BDUSS 与 STOKEN 的值，不要包含字段名，也不要包含末尾分号。

Cookie 通常长这样，下面是完全虚构的格式示例：

BAIDUID=<BAIDUID>; BDUSS=<BDUSS>; STOKEN=<STOKEN>; PANWEB=1; ...

你需要的是：BDUSS 从 BDUSS= 后面开始，到下一个分号之前结束；STOKEN 从 STOKEN= 后面开始，到下一个分号之前结束。几个坑要特别注意。第一，STOKEN 必须从百度网盘页面相关 Cookie 中获取，不要在不相关的百度页面随便找一个同名或相似字段。项目 README 里也提醒过：STOKEN 必须在百度网盘页面获取，否则可能无效。第二，STOKEN 不是 bdstoken。bdstoken 是另一类页面参数，不是这里要传给 -stoken 的值。如果你拿到的所谓 STOKEN 看起来很短、全是小写或更像页面临时参数，多半拿错了。第三，不要把整段 Cookie 粘到在线工具里“格式化”。Cookie 本身就是敏感信息，任何在线格式化、截图识别、云剪贴板同步都可能扩大泄露面。

6. 第一次登录与基本验证

拿到 BDUSS 和 STOKEN 后，不要急着执行下载或删除操作。先在一个独立配置目录里登录，然后只做只读验证：

export BAIDUPCS_GO_CONFIG_DIR="$HOME/.config/baidupcs-demo"
mkdir -p "$BAIDUPCS_GO_CONFIG_DIR"
BaiduPCS-Go login -bduss='<BDUSS>' -stoken='<STOKEN>'
BaiduPCS-Go who
BaiduPCS-Go quota
BaiduPCS-Go ls /

如果登录成功，who 会显示当前账号信息，quota 会显示网盘容量，ls / 会列出根目录。到这一步，才说明凭据、配置目录和网络访问基本可用。如果失败，先别反复重试。常见原因包括：BDUSS 复制不完整，漏了字符或多复制了分号；STOKEN 不是从百度网盘页面 Cookie 里取的；浏览器里账号已退出，Cookie 已过期；当前网络访问百度网盘接口不稳定；配置目录里已有旧账号，导致你误以为切换成功。

可以用这些命令确认状态：

BaiduPCS-Go loglist
BaiduPCS-Go who
BaiduPCS-Go logout

如果你有多个百度账号，建议为不同账号使用不同配置目录。不要把私人账号、工作账号、Agent 专用账号混在同一个配置里；否则 Agent 执行 download / 或 rm 这类命令时，你很难一眼判断它操作的是哪个账号。

7. 像操作文件系统一样操作网盘

登录完成后，可以从最安全的只读命令开始：

BaiduPCS-Go pwd
BaiduPCS-Go ls /
BaiduPCS-Go ls /我的资源
BaiduPCS-Go tree /我的资源
BaiduPCS-Go meta /我的资源/示例文件.zip
BaiduPCS-Go search -path=/ -r 关键词

这些命令适合让你熟悉目录结构，也适合让 Agent 先做任务侦察。例如你可以要求 Agent：“先列出 /资料 下一级目录，不要下载，不要删除，给出建议操作计划。”这比直接让它“整理我的网盘”安全得多。切换目录也很像 Linux shell：

BaiduPCS-Go cd /我的资源
BaiduPCS-Go cd ..
BaiduPCS-Go cd /
BaiduPCS-Go cd -l /我的资源

不过要记住，BaiduPCS-Go 的“当前目录”是它配置里的网盘工作目录，不是你的本地 shell 当前目录。你在终端里 cd ~/Downloads，不会自动改变 BaiduPCS-Go 的网盘工作目录；你在 BaiduPCS-Go 里 cd /文档，也不会改变本地终端目录。理解这点，可以避免“我明明在这个目录，为什么下载到别处了”的困惑。

8. 下载：先定保存目录，再谈并发

下载是最常用的功能：

BaiduPCS-Go d /我的资源/示例文件.zip
BaiduPCS-Go d /我的资源/资料包 --saveto ./downloads
BaiduPCS-Go d /我的资源/资料包 --fullpath --saveto ./downloads

下载任务建议先控制保存目录和并发

图 4：下载、上传、转存、分享和离线下载都可以命令化，但默认策略应该偏稳。

默认保存目录可以通过配置设置：

BaiduPCS-Go config set -savedir "$HOME/Downloads/BaiduPCS"
BaiduPCS-Go config

下载参数里常用的有：--saveto 保存到指定本地目录，--ow 覆盖已存在文件，--test 测试下载但不保存文件，--status 输出线程状态，--mode 指定下载模式，-p 指定下载线程数，-l 指定同时下载文件数量，--retry 指定失败重试次数，--nocheck 跳过下载后校验，--mtime 保留服务器上的修改时间，--fullpath 按网盘完整路径保存到本地。

这里最容易踩坑的是并发。很多教程会让你一上来把 max_parallel 调很大，但项目配置说明里已经写得很清楚：普通用户不建议把下载并发调高，非 SVIP 不应大于 1；SVIP 用户可以根据实际带宽调到 10 以上，但也不建议超过 20。务实配置可以这样：

# 普通账号，保守稳定
BaiduPCS-Go config set -max_parallel 1 -max_download_load 1

# SVIP 账号，按线路和带宽慢慢测试，不要盲目拉满
BaiduPCS-Go config set -max_parallel 10 -max_download_load 1

对 Agent 来说，我更建议默认使用保守并发。Agent 的价值是帮你分批、重试、记录结果，而不是把并发拉满之后触发限速。一个稳定跑完的夜间任务，比一个开头很快、十分钟后全部失败的任务更有用。

9. 上传：把同名策略说清楚

上传命令格式是：

BaiduPCS-Go u <本地文件或目录> <网盘目标目录>

例如：

BaiduPCS-Go mkdir /AgentDrop
BaiduPCS-Go u ./report.pdf /AgentDrop
BaiduPCS-Go u ./archive /AgentDrop
BaiduPCS-Go u ./report.pdf /AgentDrop --policy overwrite
BaiduPCS-Go u ./archive /AgentDrop --policy rsync

上传最重要的是同名策略。当前帮助里 --policy 支持 skip、overwrite、rsync。skip 是默认策略，遇到同名文件跳过；overwrite 会覆盖同名文件；rsync 只跳过大小未变化的文件，其余覆盖。如果你让 Agent 上传文件，一定要在提示词里明确写清楚同名策略。

请把 ./exported-reports 目录上传到百度网盘 /AgentDrop/reports。
遇到同名文件使用 skip，不要覆盖已有文件。
上传前先列出本地文件数量和总大小，上传后用 BaiduPCS-Go ls 验证远端目录。

不要给 Agent 一个含糊目标：“同步一下这个目录”。同步可能意味着上传新增、覆盖变化、删除远端多余文件，也可能只是备份一份。对网盘这种弱事务系统来说，删除尤其危险。除非你非常明确并且有回收站/备份策略，否则不要让 Agent 自动执行 rm。

10. 转存、分享和离线下载

transfer 可以把百度网盘分享链接转存到当前网盘目录：

BaiduPCS-Go cd /转存
BaiduPCS-Go transfer 'https://pan.baidu.com/s/<SHARE_ID>' '<提取码>'
BaiduPCS-Go transfer 'https://pan.baidu.com/s/<SHARE_ID>?pwd=<提取码>'

注意：转存保存到当前网盘目录，不支持随命令指定目标目录。因此执行前要先 cd 到目标目录，或者让 Agent 先显示当前目录再操作。分享命令包括创建分享、列出分享和取消分享：

BaiduPCS-Go share set /AgentDrop/report.pdf
BaiduPCS-Go share list
BaiduPCS-Go share cancel <shareid>

分享是高风险操作，因为它会把网盘文件暴露给外部链接。建议 Agent 默认不要创建公开分享，除非任务里明确要求、明确文件路径、明确有效期和提取码策略。离线下载命令是：

BaiduPCS-Go offlinedl add -path=/离线下载 'https://example.com/file.iso'
BaiduPCS-Go offlinedl list
BaiduPCS-Go offlinedl query <任务ID>
BaiduPCS-Go offlinedl cancel <任务ID>
BaiduPCS-Go offlinedl delete <任务ID>

离线下载适合把公开 HTTP/HTTPS/FTP/电驴/磁力资源加入百度网盘任务，但它受百度网盘服务端能力、账号状态、资源可用性和任务数量限制影响。Agent 可以帮你批量添加和查询，但不应该把来源不明的链接一股脑提交进去。

11. 配置策略：稳定比激进更重要

BaiduPCS-Go config 会显示当前配置。几个常用项值得理解：savedir 是下载保存目录，max_parallel 是下载总最大并发量，max_download_load 是同时下载文件数量，max_upload_parallel 是上传单文件最大并发量，max_upload_load 是同时上传文件数量，upload_policy 是上传同名文件策略，proxy 和 proxy_hostnames 用于代理链路。

对个人日常使用，可以准备一个偏稳配置：

BaiduPCS-Go config set   -savedir "$HOME/Downloads/BaiduPCS"   -max_parallel 1   -max_download_load 1   -max_upload_parallel 4   -max_upload_load 2   -upload_policy skip

如果你在国外 VPS 上使用，上传到 pan.baidu.com 时可能遇到链路问题。上游 v4.0.0 更新说明提到新增 proxy_hostnames，国外 VPS 遇到上传问题可尝试为 pan.baidu.com 配置回国代理。这个场景可以这样表达：

BaiduPCS-Go config set -proxy 'http://127.0.0.1:7890' -proxy_hostnames 'pan.baidu.com'

这里的代理地址只是本机示例。不要把真实代理、认证信息或内网网关写进公开文章和仓库。Agent 使用代理时也要先读配置、再测试连通性，不要凭空改全局代理。

12. 让 Agent 集成 BaiduPCS-Go 的正确姿势

把 BaiduPCS-Go 交给 Agent，不是把 BDUSS/STOKEN 直接贴给 Agent，而是给它一个已经登录、权限边界清楚、配置目录隔离的执行环境。

Agent 集成 BaiduPCS-Go 的安全边界

图 5：凭据由环境和配置管理，Agent 只拿到任务边界、命令权限和验证要求。

推荐结构如下：

export BAIDUPCS_GO_CONFIG_DIR="$HOME/.config/baidupcs-agent"
mkdir -p "$BAIDUPCS_GO_CONFIG_DIR"
BaiduPCS-Go login -bduss='<BDUSS>' -stoken='<STOKEN>'
BaiduPCS-Go config set -savedir "$HOME/agent-downloads/baidupcs" -max_parallel 1 -max_download_load 1
BaiduPCS-Go who
BaiduPCS-Go quota

之后给 Agent 的提示词不要写凭据，只写边界：

你可以使用 BaiduPCS-Go 操作百度网盘，但必须遵守以下边界：
1. 使用当前 shell 的 BAIDUPCS_GO_CONFIG_DIR，不要读取或打印配置文件中的 BDUSS/STOKEN/Cookie。
2. 默认只允许执行 who、quota、pwd、ls、tree、meta、search、download、upload、mkdir。
3. 禁止执行 rm、share set、share cancel、logout，除非我在本轮明确授权。
4. 下载只允许保存到 $HOME/agent-downloads/baidupcs。
5. 上传只允许写入 /AgentDrop 或我明确指定的网盘目录。
6. 所有写操作前先列计划，执行后用 ls/meta/quota 验证。
7. 输出报告时只写文件名、路径、大小、数量和状态，不输出任何 Cookie、BDUSS、STOKEN、真实账号标识。

如果你的 Agent 支持工具白名单，可以进一步只开放一个包装脚本，而不是直接开放完整 BaiduPCS-Go。例如创建 baidupcs-agent.sh，只允许有限子命令：

#!/usr/bin/env bash
set -euo pipefail
export BAIDUPCS_GO_CONFIG_DIR="${BAIDUPCS_GO_CONFIG_DIR:-$HOME/.config/baidupcs-agent}"
cmd="${1:-}"
shift || true
case "$cmd" in
  who|quota|pwd|ls|tree|meta|search|download|d|upload|u|mkdir)
    exec BaiduPCS-Go "$cmd" "$@"
    ;;
  *)
    echo "blocked command: $cmd" >&2
    exit 2
    ;;
esac

然后让 Agent 只能调用这个脚本。这样即使提示词被写得太宽，脚本层也会拦住删除、分享、退出登录等高风险操作。

13. 三个 Agent 任务模板

模板一：只读巡检。

请使用 baidupcs-agent.sh 对百度网盘 /资料 目录做只读巡检。
要求：
1. 先执行 who、quota、pwd。
2. 列出 /资料 下一级目录，不递归下载。
3. 搜索文件名包含 “发票” 的文件，只输出路径和大小。
4. 不执行上传、下载、删除、分享。
5. 最后给出可执行建议，不要直接修改网盘。

模板二：受控下载。

请把百度网盘 /资料/公开素材 下载到本地 $HOME/agent-downloads/baidupcs/materials。
要求：
1. 下载前先 ls /资料/公开素材，并估算文件数量。
2. 使用保守并发，不要修改 max_parallel。
3. 下载命令使用 --fullpath 和 --mtime。
4. 下载后统计本地文件数量和总大小。
5. 不删除网盘文件，不创建分享链接。

模板三：受控上传。

请把本地 ./export 目录上传到百度网盘 /AgentDrop/export。
要求：
1. 上传前统计本地文件数量和总大小。
2. 如目标目录不存在，可以 mkdir 创建。
3. 上传使用 --policy skip，不覆盖已有文件。
4. 上传后执行 ls /AgentDrop/export 验证。
5. 不执行 rm，不执行 share，不打印任何凭据。

这些模板的共同点是：先验证身份和状态，再限制路径，再限制动作，最后要求证据。Agent 并不怕任务复杂，怕的是边界含糊。

14. 日志、历史和凭据清理

使用 BDUSS/STOKEN 最大的风险不是命令本身，而是凭据散落在各处。下面这些位置都要注意：Shell 历史可能记录 -bduss 和 -stoken；终端录屏和截图可能直接暴露 Cookie；Agent 日志可能保存完整命令；Git 仓库可能误提交配置目录或 .env；剪贴板同步和输入法也可能保留敏感内容。

更安全的登录方式是临时关闭命令回显，或从受保护文件读取变量：

read -rsp 'BDUSS: ' BAIDU_BDUSS; echo
read -rsp 'STOKEN: ' BAIDU_STOKEN; echo
BaiduPCS-Go login -bduss="$BAIDU_BDUSS" -stoken="$BAIDU_STOKEN"
unset BAIDU_BDUSS BAIDU_STOKEN

登录完成后，凭据会进入 BaiduPCS-Go 配置目录。这个目录本身也要保护：

chmod 700 "$BAIDUPCS_GO_CONFIG_DIR"

如果你怀疑凭据泄露，最稳妥的处理不是“删掉本地配置就算了”，而是到百度账号安全设置里退出可疑登录、修改密码或让旧 Cookie 失效，然后重新获取新的 BDUSS/STOKEN。

15. 常见问题排查

登录成功但转存失败。 先确认 STOKEN 是否真的从百度网盘页面获取，而不是其他百度页面。项目历史说明里多次提到转存与 STOKEN 相关，BDUSS-only 登录在部分功能上可能不够。

下载很慢。 先承认一个现实：BaiduPCS-Go 不保证突破官方限速。普通账号不要盲目调高并发。先用 --test、--mode pcs 或 --mode stream 做对比，再决定是否调整配置。

上传失败。 确认文件名是否合法、目标目录存在、网络可达、账号容量足够。如果在国外 VPS 上上传，可以考虑 proxy 与 proxy_hostnames，但不要把代理配置写进公开材料。

Agent 下载到了奇怪目录。 检查 savedir、--saveto、本地 shell 工作目录，以及是否设置了 BAIDUPCS_GO_CONFIG_DIR。建议 Agent 任务里强制指定 --saveto。

误删文件怎么办。 BaiduPCS-Go 的删除会进入百度网盘回收站，能否恢复取决于账号和回收站状态。不要让 Agent 默认拥有删除权限，确实需要删除时，先列出目标路径、fs_id、数量和确认文本。

16. 我自己的推荐工作流

如果让我从零搭一套给 Agent 使用的 BaiduPCS-Go 环境，我会这样做：先安装 BaiduPCS-Go v4.0.1 或更新稳定版本；创建专用配置目录 $HOME/.config/baidupcs-agent；用浏览器在 pan.baidu.com 获取 BDUSS/STOKEN，只在受控终端里登录一次；设置保守下载目录和并发；建一个网盘目录 /AgentDrop，只允许 Agent 在这里上传和整理；用包装脚本限制命令，默认屏蔽 rm、share、logout 等高风险动作；给 Agent 的提示词永远包含先计划、再执行、后验证、不打印凭据；定期检查配置目录权限、Agent 日志和网盘分享列表。

这样做的结果是：你仍然掌握账号和安全边界，但繁琐的列目录、批量下载、文件上传、结果核验可以交给 Agent。工具不需要神化，只要可靠、可审计、可回滚，就已经很有价值。

17. 结语

BaiduPCS-Go 最适合的定位，是把百度网盘从“只能点点点的网页/客户端”变成“可以被命令行和自动化系统调用的文件入口”。它不会替你解决所有限速问题，也不应该被用来绕开账号和平台规则；但它可以让重复文件操作变得可脚本化，让远程服务器使用网盘变得更自然，让 Agent 真正有能力帮你完成可验证的网盘任务。

真正重要的不是某一条命令，而是一套边界清楚的工作流：用 BDUSS/STOKEN 登录，但不泄露凭据；用配置目录隔离，但不混用账号；用 CLI 执行任务，但先做只读侦察；用 Agent 自动化，但把删除、分享、覆盖这些动作锁起来。做到这些之后，百度网盘就不再只是一个大容量网盘，而是可以接入个人自动化体系的资料中转站。

来源与参考

  1. BaiduPCS-Go 开源项目：https://github.com/qjfoidnh/BaiduPCS-Go
  2. 本文命令核验环境：BaiduPCS-Go version v4.0.1
  3. 本文示例均为脱敏占位符，不包含真实账号、Cookie、Token、内网地址或私人路径。