Skip to content

Releases: xhnbzdl/feishu-doc-export

0.0.4.1

08 Jul 06:19
Compare
Choose a tag to compare

修复issue��
#33
#32

命令行模式启动添加--quit参数即可在程序运行结束后自动退出,示例:

./feishu-doc-export.exe --appId=xxx --appSecret=xxx --exportPath=D:\temp --saveType=docx --quit

0.0.4

27 Sep 07:44
d7f6e34
Compare
Choose a tag to compare
  • 支持导出知识库内的文件类型文档,如:pdf、image等。

  • 支持个人空间云文档导出(需要指定文件夹的Token)

  • 优化了程序异常处理,保证下载尽可能不中断

  • 新增了命令行参数--type--folderToken,选择导出知识库或个人空间云文档,可选值:cloudDocwiki,为空则默认为wiki。当type=cloudDoc时,需要填写--folderToken参数,type=wiki或空,则不需要填写。使用方式如下:

    # win 导出个人空间文档 将文档保存为markdown文档
    ./feishu-doc-export.exe --appId=xxx --appSecret=xxx --saveType=md --exportPath=E:\temp\test --type=cloudDoc --folderToken=xxx
  • 如何导出个人空间的文档

    1. 将要导出的文件夹分享给自建应用,让自建应用拥有可导出文档的权限。

    image-20230927162804954

    1. 获取folderToken

    image-20230927161804968

    1. 执行命令:

      image-20230927163239528

  • 为什么不支持列举文件夹列表?

    因为飞书对于个人空间做了登录限制,未登录情况下个人空间相关的部分API无法直接调用。而要支持登录,飞书只提供了网页端和小程序的接入方案,因此该项目不支持。

0.0.3

15 Jul 11:42
Compare
Choose a tag to compare
  • 这个版本新增了两种格式的导出,可支持将飞书文档导出为markdownpdf,加上原有支持的docx一共是三种格式。

  • 新增了命令行参数--saveType,文档保存的格式类型,可选值有mdpdfdocx,如果参数不传,或值为空,或值为不存在的格式,则默认导出为docx。使用方式如下:

    # win 不指定知识库 将文档保存为markdown文档
    ./feishu-doc-export.exe --appId=xxx --appSecret=xxx --saveType=md --exportPath=E:\temp\test
    
    # mac 不指定知识库 将文档保存为pdf
    sudo ./feishu-doc-export --appId=xxx --appSecret=xxx  --exportPath=/home/feishu-document --saveType=pdf
    
    # linux 不指定知识库 将文档保存为docx
    sudo ./feishu-doc-export --appId=xxx --appSecret=xxx  --exportPath=/home/feishu-document 
    sudo ./feishu-doc-export --appId=xxx --appSecret=xxx  --exportPath=/home/feishu-document --saveType=
    sudo ./feishu-doc-export --appId=xxx --appSecret=xxx  --exportPath=/home/feishu-document --saveType=docx
    sudo ./feishu-doc-export --appId=xxx --appSecret=xxx  --exportPath=/home/feishu-document --saveType=abcdefg
  • 耗时测试

    • 导出为docx最快
    • 导出为markdowndocx的速度差不多
    • 导出为pdf速度最慢,因为pdf的图片是内嵌的
    • 实际速度与网速和飞书服务器响应,电脑磁盘写入速度都有关系
  • 注意事项:

    1. 文档导出为markdown时,存在文档格式丢失的问题,原因是因为我的实现方式是利用飞书自提供的接口先将文档下载为docx,然后再将docx转为markdown,文档下载为docx后就已经存在格式丢失的问题了,所以不能很好的转换为markdown。而上面提到的两个开源库都是自己做的处理,它们都是直接将飞书原始数据转换为markdown语法的。feishu-backup是作者自己对飞书原始数据做的转换(牛逼),feishu2md则是用了一个针对飞书数据转换的库。

    2. feishu-doc-export目前已发现docx转为markdown丢失的格式有:引用语法、表格、行内代码块

    3. 对于飞书文档中引用的其他文档,如果引用的文档是当前知识库的文档,则该文档下载到本地后会以相对路径引用另一个文档,因为另一个文档也会下载到本地。

      如果引用的文档是其他知识库或者是外链,则当前文档下载后还是以原文方式引用。

v0.0.2.1

06 Jul 04:40
Compare
Choose a tag to compare

版本说明

第一个正式发布版本,支持免安装使用

功能增强

  • 增加导出目录的校验

v0.0.2-test

30 Jun 13:14
9dfd578
Compare
Choose a tag to compare

新增的功能

  • 支持展示知识库,然后选择知识库,将知识库id改为非必填
  • 支持按原文档目录结构导出

耗时测试

677个文件导出到本地总耗时25分钟
image

使用图展示

输入飞书自建应用配置
feishuexport_1
导出
2
飞书原文档目录结构展示:
feishu_wiki

v0.0.1-test

30 Jun 01:22
Compare
Choose a tag to compare

1.操作图:
image
2.效果图:
image
3.导出的结果:
image