核心功能
Feishu Document Exporter 是一款面向飞书用户的文档批量导出工具，支持将飞书文档（docx）转换为 Markdown 或 PDF 格式。其主要功能包括：单文档导出、整文件夹递归导出、图片本地化保存、自动生成目录索引，以及增量导出能力，避免重复下载。
显著优点
1. 格式兼容性强：原生支持 Markdown，便于后续导入 Notion、GitHub、Hexo 等主流知识管理平台
2. 结构完整性：保留原文档的标题层级、列表、表格等格式，支持嵌套文件夹层级还原
3. 离线可用性：将图片下载为本地文件，确保导出内容在无网络环境下仍可完整阅读
4. 自动化能力：支持命令行批量操作，可集成到 CI/CD 流程或定时备份脚本中
5. 增量更新：仅导出有变更的内容，节省 API 调用次数和时间成本
潜在局限与风险
1. API 权限依赖：需申请 doc:document:read、drive:folder:read、drive:file:read 三项权限，企业管理员可能因安全策略拒绝授权
2. 飞书生态锁定：仅支持飞书文档，无法通用于其他协作平台（如钉钉、企业微信文档）
3. 复杂格式兼容性：部分飞书特有组件（如嵌入的智能表格、多维表格、第三方应用卡片）可能无法完美转换
4. Token 安全风险：配置文件中需存储 Feishu API Token，若保管不当存在泄露风险
5. 速率限制：大规模导出可能触发飞书 API 频率限制
适用人群
- 需将飞书知识库迁移至其他平台的团队或个人
- 追求本地备份、版本控制（Git 管理 Markdown）的技术团队
- 内容创作者需离线编辑或发布至静态网站（如 Hexo/Hugo/VitePress）
- 企业合规部门需定期归档文档资产
常规风险提示
- 数据隐私：导出内容可能包含敏感商业信息，输出目录需设置适当访问权限
- API Token 管理：建议使用环境变量或密钥管理服务注入，避免硬编码
- 版权合规：批量导出前确认拥有文档访问权限及内容使用授权