baidupan-cli

百度网盘命令行工具（交互式 shell，基于 grumble）。

特性

🚀 核心特性

• 交互式 Shell：基于 grumble 的友好交互式命令行界面，支持命令补全和历史记录
• 扫码授权登录：支持自动打开浏览器扫码授权，无需手动输入密码
• Token 持久化：授权后自动保存 token，支持自动刷新，免除重复登录困扰
• 当前目录管理：支持 cd 命令切换当前工作目录，类似本地文件系统操作

💪 强大的文件操作

• 灵活的文件列表：支持递归列表、按类型/名称/时间排序、仅目录/仅文件筛选、表格化展示
• 智能文件搜索：支持关键字搜索，可递归或非递归，支持限制返回数量
• 批量重命名：
  • 支持 sed 替换模式（纯文本/正则）
  • 支持 正则表达式模式（pattern/replace）
  • 支持仅重命名文件/目录/全部
  • 智能排序避免父目录改名导致子路径失效
• 文件管理：复制（cp）、移动（mv）、删除（rm），支持：
  • Linux 风格命令：cp SRC DEST 或 cp SRC1 SRC2... DESTDIR
  • 干运行模式：默认预览，加 -a/--apply 才真正执行
  • 批量操作：支持分块处理大量文件
  • 异步任务：支持异步提交任务
  • 错误处理：支持出错继续、忽略错误返回码

🛡️ 安全与可靠

• 干运行（Dry-run）：所有修改类操作默认仅预览，避免误操作
• 进度显示：批量操作自动显示进度条和转圈动画
• 出错继续：批量操作支持遇到错误继续处理后续项
• 分块处理：大数据量操作支持自定义每批处理数量，避免超时

功能清单

• 扫码登录授权（auth，默认自动打开浏览器扫码）
• Token 持久化与自动刷新（token.json）
• 获取用户信息（userinfo）
• 获取网盘容量（cap）
• 当前目录切换（cd）
• 查询目录下文件列表（ls/list，支持递归/排序/筛选/表格）
• 文件搜索（search/find）
• 文件/目录重命名（rename/rn）
• 目录下批量重命名（rename-batch/rb，sed 替换模式 + 正则模式 + 进度 + 出错继续）
• 文件复制/移动/删除（cp/copy、mv/move、rm/del/delete）
• 上传/下载
• 创建文件夹
• 分享

快速开始

配置文件

项目根目录准备一个配置文件（示例：config.yaml）：

baidu-pan:
  app-id:
  app-key:
  secret-key:
  sign-key:

运行

• 运行二进制（推荐，token 默认保存到二进制同目录）：

go build -o baidupan-cli .
./baidupan-cli -c config.yaml

• go run（会生成临时可执行文件，建议指定 token 固定目录）：

export BAIDUPAN_CLI_TOKEN_DIR="$PWD/.debug"
go run . -c config.yaml

授权

在交互 shell 里执行：

auth

• 默认会 打开浏览器 进行扫码授权；如果你不想打开浏览器：

auth --open-browser=false

Token 持久化（免重复授权）

授权成功后会写入 token.json，并在启动时自动读取/过期自动刷新。

• 默认位置：可执行文件同目录的 token.json
• 覆盖位置（两者选一）：
  • BAIDUPAN_CLI_TOKEN_FILE：直接指定 token 文件路径
  • BAIDUPAN_CLI_TOKEN_DIR：指定目录，文件名固定 token.json

常用命令

文件列表（ls / list）

# 使用位置参数（简洁）
ls "/我的文档"
ls "/我的文档" -r -v

# 使用 --dir 参数
ls --dir "/我的文档" --only-folder -v
ls --dir "/我的文档" --recurse --limit 200 -v

文件搜索（search / find）

按关键字在目录内搜索（默认递归）：

search --key "设计图" --dir "/我的文档" --limit 50 -v

只搜当前目录（不递归）：

find --key "UML" --dir "/我的文档" --recurse=false --limit 100

单个重命名（rename / rn）

注意：文件/目录路径必须以 / 开头（绝对路径）。

rename --path "/我的文档/uml设计图" --newname "UML设计图"          # 默认预览
rename -a --path "/我的文档/uml设计图" --newname "UML设计图"       # 真正执行
# 也可以使用别名 rn
rn -a --path "/我的文档/uml设计图" --newname "UML设计图"

复制（cp / copy）

支持 Linux 风格（只保留位置参数模式）：

• cp SRC DEST
• cp SRC1 SRC2... DESTDIR

注意：由于无法像本地文件系统那样判断“DEST 是否存在且为目录”，本工具用一个简单规则：

• 如果 DEST 以 / 结尾：按“目录”处理
• 否则：按“文件路径”处理（会把最后一段当作新文件名）

默认仅预览，真正执行需 -a/--apply。

复制到目标目录（支持多源路径）：

cp "/我的文档/a.txt" "/目标目录/"
cp "/我的文档/b.txt" "/目标目录/"
cp "/我的文档/一个文件夹" "/目标目录/"
cp "/我的文档/a.txt" "/目标目录/"          # 目录模式（末尾带 /）
cp "/我的文档/a.txt" "/目标目录/c.txt"     # 文件路径模式（重命名）

真正执行：

cp -a "/我的文档/a.txt" "/目标目录/"

移动（mv / move）

mv "/我的文档/a.txt" "/目标目录/"
mv "/我的文档/一个文件夹" "/目标目录/"
mv -a "/我的文档/a.txt" "/目标目录/"
mv "/我的文档/a.txt" "/目标目录/"          # 目录模式（末尾带 /）
mv "/我的文档/a.txt" "/目标目录/c.txt"     # 文件路径模式（重命名）

删除（rm / del / delete）

默认仅预览（安全起见不会直接删），真正执行需 -a/--apply：

rm "/我的文档/a.txt" "/我的文档/一个文件夹"

真正执行删除：

rm -a "/我的文档/a.txt" "/我的文档/一个文件夹"

批量重命名（rename-batch / rb）

rb 默认是 sed 替换模式：给两个位置参数 FIND TO，对名称做“包含替换”。

示例 1：替换模式（默认）

把目录名 UML设计图 中的 设计 替换为 分析：

rb --dir "/我的文档" --target dirs 设计 分析
rb --dir "/我的文档" --target dirs 设计 分析 -a

如需把 FIND 当作正则（而不是纯文本），加 --find-regex：

rb --dir "/我的文档" --target dirs --find-regex '设.' 分析 -a

示例 2：正则模式（--pattern/--replace）

把 xxx.mp4 改名为 xxx_1080p.mp4：

# 只是预览，不会执行
rb --dir "/video" --pattern '^(.*)\.mp4$' --replace '${1}_1080p.mp4'
# 真正执行
rb --dir "/video" --pattern '^(.*)\.mp4$' --replace '${1}_1080p.mp4' -a

示例 3：去掉中文【】里的内容

把 xxx【xxx】xxx 变成 xxxxxx：

rb --dir "/xxx" --target dirs --pattern '^(.*)【[^】]*】(.*)$' --replace '${1}${2}' -a

示例 4：去掉前导 0（012xxx -> 12xxx）

rb --dir "/xxx" --target dirs --pattern '^0+([0-9]+.*)$' --replace '${1}' -a

批量执行与大数据量建议

当目录下条目很多时，单次请求可能慢/超时：

• 调小每次请求包含的条目数：-s/--size
• 或使用异步任务：--async
• 默认会显示进度与转圈：-p/--progress

示例：

rb --dir "/xxx" --target dirs 设计 分析 --apply -s 50
rb --dir "/xxx" --target dirs 设计 分析 --apply --async
cp -a "/a/1.txt" "/a/2.txt" "/dst/" -s 50
mv -a "/a/1.txt" "/a/2.txt" "/dst/" --async
rm "/a/1.txt" "/a/2.txt" --apply -s 50

出错继续（跳过失败项）

批量执行时如果希望“出错也继续处理后续”：

rb --dir "/xxx" --target dirs 设计 分析 --apply -c
cp -a "/a/1.txt" "/a/2.txt" "/dst/" -c
mv -a "/a/1.txt" "/a/2.txt" "/dst/" -c
rm "/a/1.txt" "/a/2.txt" --apply -c

如果希望即使有失败也返回成功退出码（适合脚本流水线）：

rb --dir "/xxx" --target dirs 设计 分析 --apply -c -i
cp -a "/a/1.txt" "/a/2.txt" "/dst/" -c -i
mv -a "/a/1.txt" "/a/2.txt" "/dst/" -c -i
rm "/a/1.txt" "/a/2.txt" --apply -c -i

常见错误排查

• errno=-6：常见是参数/路径问题（路径必须以 / 开头、目录不存在等）
• errno=12 + info[].errno=-8：批量部分失败，通常是重名冲突（替换后目标名称已存在）。建议先 dry-run 看计划，或保留部分信息避免撞名。

批量重命名执行顺序说明（包含目录时）

当 --target dirs 或 --target all 且在递归目录下批量重命名时，为避免“先改父目录导致子路径失效”，程序会按以下顺序提交：

• 先重命名 文件
• 再重命名 目录（按路径深度从深到浅）