用途:管理飞书云文档中的素材(图片、文件等),支持上传与下载。
主要能力:上传本地文件到飞书云空间,用于文档图片或附件;从云空间下载文件或图片;支持指定文件名、输出格式与输出路径。
使用方式:技能命令为 /feishu-media upload <file> --parent-node <doc_id> 与 /feishu-media download <file_token> [--output path]。CLI 命令为 feishu-cli media upload 与 feishu-cli media download。上传需指定 --parent-type 与 --parent-node,可选 --name、--output json;parent-type 支持 docx_image(推荐默认)、docx_file、sheet_image、comment_image,doc_image/doc_file 为旧版不推荐。下载可指定 --output 或 -o,默认当前目录,可用原文件名或自动命名。
典型工作流:上传图片后以 file_token 在 Markdown 中引用;用 doc export --download-images --assets-dir 批量下载文档图片;手动逐个下载;以及先下载旧文档图片再上传到新文档完成迁移。
适用场景:飞书文档图片上传、文档素材下载、文档图片批量导出与迁移。
限制:图片限制 20 MB,文件限制 512 MB;下载需 drive:drive:readonly 权限,上传需 drive:drive 权限;API 图片链接有时效性(通常 24 小时);飞书可能对上传图片进行格式转换和压缩;v1.4.1 起 --parent-type 默认值由 doc_image 改为 docx_image,旧值在 DocX 文档中会失败。支持格式包括 PNG、JPG、JPEG、GIF、BMP、SVG、WEBP 及 PDF、DOC、DOCX、XLS、XLSX、PPT、PPTX、ZIP、RAR、7Z、TXT、MD、CSV 等。