摘要
太长不看版:可以直接在这里下载。遇到不安全警告是因为我没有签名,可以在系统设置「隐私与安全性」中主动放行。在这里阅读项目说明,遇到问题可以在 Issues 里面反馈或者直接在文章中留言。我之前把飞书文档批量转为 Markdown 文件保存到本地时,使用了 Wsine 开发的一个 Feishu2MD 的 CLI 工具。它是用 Go 实现的,支持单文档、文件夹以及知识库下载。因为真的很好用,我就想着给它做一个 GUI Wrapper。后来我发现飞书官方也有自己的 Lark CLI,功能更全支持更多的 API,但我其实还没用过。官方这个 CLI 似乎只能导出单个文件,而不支持批量导出文件夹/知识库。虽然说官方 CLI 能更好地与 AI Agent 集成,不过单纯批量导出 Markdown 这个任务已经有 Feishu2MD 了,直接用它就很好。另外,像图片本地化和链接替换这些功能,我也不确定官方 CLI 有没有实现。但是这些都是后话,因为我一开始的目的,其实就是给 Feishu2MD CLI 做一个 Wrapper🤣。在此基础上也追加了一些我自己会用到的功能。虽然飞书以后可能会更新文档结构或者接口权限,这个工具以后可能会不适用,但目前用起来还蛮好的。追加优化的点它和原版的 Feishu2MD CLI 主要区别在于——当然了,一个是命令行工具,一个是图形界面嘛。不习惯使用 CLI 的朋友可能会更喜欢用它。那么接下来介绍一些追加的特性:文档链接的智能识别原本 CLI 需要用不同的命令去下载单个文档、文件夹或知识库,现在我统一成了一个链接输入框,所有的链接都能直接放进去,会自动帮你路由。也追加支持了知识库分享 wiki/space 格式链接。这个链接可以通过点击「分享知识库」按钮得到。原本的 CLI 如果要下载知识库,只能填写知识库设置页面的链接(即 wiki/settings),但我觉得使用分享链接更符合直觉。现在两种链接都可以识别,我在底层做了一层替换。文件名作为 H1 处理可以选择是否将飞书文档的文件名作为一级标题插入正文顶部。默认是开启的,考虑到大家可能已经在正文添加了一个 H1 Heading,取消勾选此项可以避免导出后标题重复。文件重命名原本 CLI 下载的文件名通常是一串从 URL 获取的文档 Token,这样子下载到本地以后,就不能一眼知道是什么内容。所以追加
摘要可能不完整,可查看原文