360 Secure SkillHub
360 安全技能中心

Feishu Doc Batch Export

通过 Python 脚本调用飞书开放平台接口,把指定的飞书 docx 文档或文件夹批量导出为本地 Markdown,保留标题、列表、表格、粗体、斜体与链接格式,自动下载文中图片并替换引用路径,失败自动重试三次;仅支持 docx 格式,导出速度受接口频率限制,使用前需配置飞书应用凭据。

technologyliu
technologyliu
热度 32.21
最近更新 2026-05-11 17:39:30
分类:效率依赖:代码执行 / 读写文件 / 第三方 API应用场景:文件转换 / 自动化脚本 / 数据处理

安装技能

复制下面的话术发给你的 Agent,它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill: npx secure-skills-cli add feishu-doc-batch-export
Metadata
name
feishu-doc-batch-export
description
批量导出飞书文档(docx)到本地Markdown格式,支持保留文档格式、图片、链接,支持指定文件夹/文档链接批量导出。触发场景:当用户需要导出飞书文档、批量下载飞书文档、飞书文档转Markdown时使用。

飞书文档批量导出技能

核心功能

  1. 支持单个文档导出:输入飞书文档链接,直接导出为Markdown文件
  2. 支持文件夹批量导出:输入飞书文件夹链接,导出文件夹下所有docx文档
  3. 自动保留格式:标题、列表、表格、粗体、斜体、链接格式完全保留
  4. 自动下载图片:文档内图片自动下载到本地assets目录,Markdown内路径自动替换
  5. 错误重试:导出失败自动重试3次,支持导出日志输出

使用方法

基本命令

# 导出单个文档
python scripts/export.py --url <飞书文档链接> --output <本地输出目录>

# 导出文件夹下所有文档
python scripts/export.py --url <飞书文件夹链接> --output <本地输出目录> --recursive

参数说明

  • --url: 飞书文档/文件夹的公开链接或有权限访问的链接
  • --output: 本地导出目录,默认当前目录下的feishu_export文件夹
  • --recursive: 是否递归导出子文件夹内容,默认false
  • --keep-html: 是否同时保留原始HTML文件,默认false

依赖要求

提前配置飞书应用权限:

  1. 飞书自建应用需要开通docx:readonly、drive:readonly权限
  2. 环境变量配置FEISHU_APP_ID和FEISHU_APP_SECRET

注意事项

  • 仅支持docx格式的飞书文档,不支持表格、思维笔记、幻灯片等其他格式
  • 导出速度受飞书API限制,每分钟最多导出10个文档
  • 大文档导出时间较长,请耐心等待