- name
- feishu-doc-batch-export
- description
- 批量导出飞书文档（docx）到本地Markdown格式，支持保留文档格式、图片、链接，支持指定文件夹/文档链接批量导出。触发场景：当用户需要导出飞书文档、批量下载飞书文档、飞书文档转Markdown时使用。
飞书文档批量导出技能
核心功能
- 支持单个文档导出：输入飞书文档链接，直接导出为Markdown文件
- 支持文件夹批量导出：输入飞书文件夹链接，导出文件夹下所有docx文档
- 自动保留格式：标题、列表、表格、粗体、斜体、链接格式完全保留
- 自动下载图片：文档内图片自动下载到本地assets目录，Markdown内路径自动替换
- 错误重试：导出失败自动重试3次，支持导出日志输出
使用方法
基本命令
# 导出单个文档
python scripts/export.py --url <飞书文档链接> --output <本地输出目录>
# 导出文件夹下所有文档
python scripts/export.py --url <飞书文件夹链接> --output <本地输出目录> --recursive参数说明
--url: 飞书文档/文件夹的公开链接或有权限访问的链接--output: 本地导出目录，默认当前目录下的feishu_export文件夹--recursive: 是否递归导出子文件夹内容，默认false--keep-html: 是否同时保留原始HTML文件，默认false
依赖要求
提前配置飞书应用权限：
- 飞书自建应用需要开通
docx:readonly、drive:readonly权限 - 环境变量配置
FEISHU_APP_ID和FEISHU_APP_SECRET
注意事项
- 仅支持docx格式的飞书文档，不支持表格、思维笔记、幻灯片等其他格式
- 导出速度受飞书API限制，每分钟最多导出10个文档
- 大文档导出时间较长，请耐心等待