飞书文档批量导出技能#

核心功能#

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

使用方法#

基本命令#

bash

# 导出单个文档
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个文档
• 大文档导出时间较长，请耐心等待