用途:feishu-cli drive 是飞书云盘的增强命令组,提供与老 file/media/comment 命令并存的云盘操作能力,涵盖文件上传下载、文档导入导出、移动、评论、本地镜像与搜索。
主要能力:上传超过 20MB 自动走三段式分块并逐片重试,下载支持流式、大文件 Range 分片兜底与 --overwrite/--timeout;export 支持 doc→docx/sheet/bitable 导出为 docx/pdf/xlsx/csv/markdown,docx 转 markdown 走快捷路径立即返回,其余走异步有界轮询,超时输出 next_command 可用 task-result 接力,再以 export-download 取产物;import 走临时媒体端点导入 docx/sheet/bitable,不留中间文件;move 对文件夹自动轮询;add-comment 支持 text/mention_user/link 富文本、docx block 局部评论与 wiki/URL 自动解析;pull/push/status 做云盘文件夹与本地目录单向镜像,含 SHA-256 比对与 --delete-* 双确认;search 走 v2 端点支持类型过滤、排序、范围与创建人过滤、只匹配标题。
使用方式:需先在 riba2534/feishu-cli 安装,多数命令要求 User Token,先执行 feishu-cli auth login;可用 feishu-cli auth check --scope "drive:file:upload" 验证 scope。
限制:部分命令需要特定 scope;import 中 docx/sheet 上限 20MB、bitable 上限 100MB,超限不绕过;导出/导入/文件夹移动的轮询超时后需手动接力;局部评论仅 docx 支持;wiki 评论解析仅支持 docx 或 doc 节点;pull/push 只镜像 type=file 条目,在线文档不参与;下载有 SSRF 防护与重定向限制。其余未提供。