尧图建网站 尧图建网站 YAOTU WEB BUILD 免费咨询
ARTICLE DETAIL

资讯详情

深耕网站建设与建站编程的一线实战洞察。

飞书文档批量导出怎么做:一条命令25分钟同步700个知识库文档(完整指南)

飞书文档批量导出怎么做:一条命令25分钟同步700个知识库文档(完整指南) 飞书文档批量导出怎么做一条命令25分钟同步700个知识库文档完整指南【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export想把飞书文档批量导出到本地一条命令就够了开源项目 feishu-doc-export 把整个知识库逐篇拉到你的磁盘上700 多个文档实测约 25 分钟跑完。它是个跨 Windows、macOS、Linux 的命令行工具输出 docx、md、pdf 三种格式表格和多维表格自动落成 xlsx。整篇文章按拿凭证 → 跑通第一条命令 → 扩展用法的顺序讲你跟着做完自己就能把这个工具跑起来。环节做什么大致耗时建应用开发者后台创建自建应用、开通云文档权限5~8 分钟授权知识库机器人进群、群加为知识库管理员3~5 分钟下载程序按系统选对应压缩包并解压1 分钟执行导出一条命令看文档量700 文档约 25 分钟飞书知识库导出工具适合谁做迁移的团队公司换办公平台知识库要限期整体搬走。手动下载平铺在文件夹里层级和表格排版全得靠手工救这个工具导出的目录与飞书一一对应。要定期备份的人希望每月自动把知识库或个人空间文件夹备一份按时间归档不用人盯。技术团队想把导出的 Markdown 放进 Git 仓库让每次文档大改版都有本地快照可回溯。顺带说下它的来历作者的 700 多份文档要迁出飞书试过的现成工具要么网页版打包下载量大就慢到像卡死要么一次只能导一篇于是自己写了个工具解决这个实际需求不是演示项目。准备工作先拿凭证再下载工具整个准备流程约 15 分钟按编号做就行创建企业自建应用约 5 分钟进入飞书开发者后台新建应用基础信息随意填。开通云文档权限约 2 分钟在权限管理里开启查看新版文档、导出云文档、查看编辑知识库、查看导出电子表格与多维表格等权限。权限列表是分页的翻页确认别漏项。添加机器人并发布版本约 2 分钟应用能力里添加机器人再到版本管理与发布创建版本、申请上线等企业管理员审核。只想快速验证的话建测试企业、绑定应用、切到测试版本即可。给机器人知识库权限约 3 分钟在飞书客户端把自建应用作为群机器人拉进一个群然后打开目标知识库知识空间设置 → 成员管理 → 添加管理员选中这个群。机器人从此能访问该知识库。复制凭证1 分钟回开发者后台凭证与基础信息复制 App ID 和 App Secret对应后面命令里的--appId和--appSecret。下载程序约 1 分钟Release 页按系统选包。Windows 选feishu-doc-export-win-x64.zip解压后是可执行文件feishu-doc-export.exemacOS 选feishu-doc-export-mac-osx-x64.zipLinux 选feishu-doc-export-linux-x64.zip后两者无后缀。想自己编译源码的话克隆仓库# 可选克隆源码自行编译 git clone https://gitcode.com/gh_mirrors/fe/feishu-doc-export要导**个人空间云文档**的授权方式不同把目标文件夹分享给自建应用再从分享链接里提取folderToken备用。安全方面说三句全程 API 通信走 HTTPSAppSecret 只在内存里换令牌、不落盘工具只读和导出不改动飞书里的任何内容按最小权限原则只开导出必需的权限并确认自己拥有对应知识库或文件夹的访问权。一条命令批量导出实操Linux / macOS 首次使用必须先给执行权限否则会报权限错误# Linux / macOS 首次使用授予执行权限 sudo chmod x ./feishu-doc-export接着跑最小命令——导出所有你有权限的知识库默认 docx 格式# 最小示例导出全部知识库为 docx ./feishu-doc-export --appId你的AppId --appSecret你的AppSecret --exportPath/home/backup/feishu运行后程序会列出你有权限的知识库清单输入序号回车就开始逐篇下载每篇都打印一条进度。Windows 用户把路径换成E:\backup\feishu这种盘符路径即可。去哪看结果打开--exportPath指向的目录子目录层级和飞书知识库的目录树一致表格、多维表格是 xlsx知识库里的 PDF、图片等文件也一并下了。什么算成功结尾终端打印文档已全部导出导出目录结构和知识库左侧大纲能对上。个别没导出来的文档会列在结尾清单里手动补下即可。它为什么快三点直接走飞书开放平台 API 拿文档清单和下载地址没有浏览器操作先取全量节点再按父子关系递归生成每篇的落盘路径token、导出任务、轮询、下载这条调用链封装在src/feishu-doc-export/HttpApi/里单篇失败单独捕获记入清单、不中断整批Markdown 则是先下 docx 再用 Aspose.Words 转换。进阶用法三种省事的备份姿势配成定时任务让它自己跑用 cron 每月自动备一份、按月份归档适合对文档安全敏感的团队。关键是--quit参数导出完自动退出不会停在按任意键退出那行脚本调用必须带上。# 每月自动备份按年月建归档目录导出为 pdf BACKUP_DIR/backup/feishu/$(date %Y-%m) ./feishu-doc-export --appId$APP_ID --appSecret$APP_SECRET \ --exportPath$BACKUP_DIR --saveTypepdf --quit把飞书文档纳入 Git 版本管理导出 Markdown 提交进仓库飞书里每次大改版本地都有历史版本可查# 导出到仓库 docs 目录然后提交 ./feishu-doc-export --appId$APP_ID --appSecret$APP_SECRET \ --saveTypemd --exportPath./docs git add . git commit -m docs: 同步飞书文档备份格式怎么选三种格式速度和用途不同对号入座保存格式导出速度适合场景docx最快归档、再编辑、迁移到其他办公平台md与 docx 接近进 Git 仓库、二次加工、技术文档pdf最慢图片内嵌、写入量大需要固定版式的存档、对外分发# 指定知识库做迁移导出保存为 Markdown ./feishu-doc-export --appIdxxx --appSecretxxx \ --spaceId知识库ID --saveTypemd --exportPath/data/migrate/wiki参数速查表与性能建议全部命令行参数一览参数作用必填 / 备注--appId/--appSecret飞书自建应用凭证必填--exportPath导出目录必填目录需已存在--spaceId知识库 ID可空不填则列出全部知识库供选择--type导出对象wiki默认或cloudDoc--folderToken个人空间文件夹 Token--typecloudDoc时必填--saveType保存格式docx/md/pdf默认 docx--quit导出结束后自动退出脚本、定时任务用--apiEndpoint指定 API 地址Lark 国际版环境配置性能建议三条速度排序 docx md pdfpdf 因图片内嵌最慢实际速度还受网速、飞书服务器响应和磁盘写入影响。导出目录放 SSD几百个文件写入时和普通硬盘的差距明显。超大知识库按子知识库分批导出方便逐批核对遗漏。常见问题速查1. 导出报权限错误原因应用权限没开全、机器人所在的群没加进知识库管理员组或版本未发布上线。 解决按准备工作第 2、4 步逐项核对确认版本已审核通过测试环境记得切到测试版本。2. Markdown 导出有格式丢失原因工具先把文档下成 docx 再转 md引用块、表格、行内代码等语法转换中会失真转换逻辑在src/feishu-doc-export/Helper/DocxToMdFormatHelper.cs。 解决对格式要求高的文档直接用 docx 或 pdf 导出。3. 有文档没导出来原因文件名超过 64 个字符会因系统命名限制被跳过个别文件类型不受支持。 解决把超长文件名改短后重跑不支持的类型在运行结尾的无法导出清单里列着手动下载补齐。4. Linux / mac 提示无法创建目录原因当前用户对导出目录没有写权限。 解决用sudo运行命令或确保导出目录对当前用户可写。5. 找不到 spaceId 或 folderToken原因这两个值不在应用界面里而是藏在 URL 中。 解决知识库 ID 在飞书知识库地址的space/之后个人空间文件夹 Token 在文件夹分享链接的folderToken参数里。写在最后回到开头的数字700 多个文档、约 25 分钟本地目录和飞书知识库一一对应全程不用手工搬运。如果你的飞书里也存着大量重要文档从最小命令开始——先把自己能看到的知识库按 docx 导一遍看看效果再按需要接上格式切换、定时备份或版本管理。【免费下载链接】feishu-doc-export飞书文档导出服务项目地址: https://gitcode.com/gh_mirrors/fe/feishu-doc-export创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表