乐于分享
好东西不私藏

如何把语雀知识库笔记下载到本地:借助claudecode类agent辅助分析

如何把语雀知识库笔记下载到本地:借助claudecode类agent辅助分析

众所周知,语雀是阿里的一款知识库产品,在 2021 年左右基本上就已经推出了。它主要是一款知识库工具,可以写文档,也有一些自己的特色。

但我一直觉得它的 AI 功能非常烂。相比于其他知识库(比如 ima),同样作为知识库产品,语雀的 AI 功能痛点在于:你只能针对当前文档去问一些问题,不能根据整个知识库进行搜索和提问。相比之下,其他产品在这方面做得更好。

但是语雀也有它的亮点,我之所以没有放弃它,主要是因为它的文件切换和管理功能非常出色:

  1. 文件夹与笔记的切换功能
    你只需要在左侧边栏点击一下即可查看具体内容。而且直接拖拽就可以设置文件和文件夹的层次结构,以及自定义显示的顺序(置顶或置底),点击一下就能看到实时效果。

  2. 结构显示的便捷性
    在某些笔记软件中,你需要点击笔记后打开一个新窗口才能查看,非常不方便。而且它们的文件夹结构看不到完整内容,如果是文件夹,你必须点击一层进入内部,再点击一层打开新窗口才能看到笔记具体内容。

相较之下,语雀的文件管理和内容查看就显得非常便捷,只需要点击一下就能看笔记,稍微拖拽就能自定义顺序,用起来非常方便。

针对语雀的痛点,主要就是它的 AI 功能。

我就在想,有没有工具能把语雀的笔记下载到本地,然后在本地使用 Claude Code 这种 Agent 去针对知识库的内容进行问答呢?

因为语雀整体写文档以及文件夹、文件层级的结构切换都很方便,主要是它这个 AI 功能很烂(当然这是我个人的痛点)。所以我一直在想:

  1. 有没有一个工具可以把语雀内容下载下来?
  2. 结合 Claude Code 这样的 Agent,针对笔记库里的内容进行问答。

其实我主要也是想解决它 AI 功能的问题,这一直以来都是我的痛点。

之前我一直觉得,像这种云端存储的内容,如果要能下载到本地,感觉是不太可能的。

但我搜了一下,果然是有解决方案的。下面这个就是我搜索到的文章,里面推荐了一个开源项目,挺不错的。

https://www.cnblogs.com/PeterJXL/p/18965762

下面这个是 GitHub 仓库的具体地址,它是一个拥有 1900+ star 的开源项目,主要通过命令行进行操作。

使用的条件也非常简单:

  1. 安装 Node.js:你只需要安装一下 Node 就可以了。
  2. 运行命令:使用一条简单的命令就可以完成下载。

关于权限说明:

  1. 私有知识库:你需要配置一下 token 才能下载。
  2. 付费知识库:如果是别人的付费内容,目前是没法下载的,毕竟这属于付费服务。

我主要也是为了梳理我自己的笔记和知识库内容,所以这个开源项目非常适合。

至于 token 的获取:
你可以通过浏览器打开开发者模式来获取。如果你不熟悉具体操作,可以搜索一下,网上有很多相关的教程,基本上很多地方都会用到这个方法。

https://github.com/gxr404/yuque-dl?tab=readme-ov-file

我使用自己的一个知识库去尝试了一下,发现它现在确实可以下载下来。

针对图片的处理,它目前还没有办法直接处理,而是专门为图片创建了一个文件夹,使用相对路径的方式进行引用。在文章或笔记中涉及到图片的地方,都是引用该相对路径下文件的具体地址,而不是采用图床的方式。

大概就是这种情况,但整体上已经可以实现预期的效果了。你把语雀的笔记下载下来之后,搭配上 Claude Code 这种类似的 Agent 工具,可以更好地帮你获取知识库里的内容,这也是我目前比较想实现的功能。

其实 ima 也可以实现这样的功能,但主要是 ima 的文件管理功能太弱了,而且它的笔记编辑器用起来也不太顺手,这是我不大喜欢的地方,所以两者各有利弊吧。

如果你也和我一样喜欢语雀,但觉得它的官方功能不够好,可以去关注一下这个项目,我用下来感觉还是很不错的。