语雀文档采集小方法

找了很多方法，游览器插件、油猴脚本、采集软件等等，一顿操作下来，并没有好用的，甚至要收费。在github找到一个yuque-dl项目，测试了下，发现非常好用，可以将语雀文档包括图片全部能下载下来，文档保存的是markdown格式。

file

以下是具体操作步骤（看上去很复杂，实际上很简单）：

1. 安装 Node.js

Node.js 是一个开源的、跨平台的 JavaScript 运行环境，用于在服务器端运行 JavaScript 代码。以下是安装步骤：

步骤 1：下载 Node.js

  1. 访问 Node.js 官方网站。
  2. 在首页上，你会看到两个版本：LTS（长期支持版） 和 Current（最新版）。对于大多数用户，建议安装 LTS 版本，因为它更稳定。
  3. 点击下载按钮，选择适合 Windows 的安装包（通常是 <code>.msi</code> 文件）。

步骤 2：安装 Node.js

  1. 下载完成后，双击 <code>.msi</code> 文件开始安装。
  2. 在安装向导中，接受许可协议，然后选择安装路径（建议使用默认路径）。
  3. 勾选“Add to PATH”选项，这样可以在命令行中直接使用 Node.js。
  4. 点击“Next”并完成安装。

步骤 3：验证安装

安装完成后，打开命令提示符（CMD）或 PowerShell，输入以下命令：

node -v
npm -v

如果安装成功，你会看到 Node.js 和 npm（Node.js 的包管理器）的版本号。

2. 安装 <code>yuque-dl</code> 工具

<code>yuque-dl</code> 是一个基于 Node.js 的工具，用于下载语雀知识库的内容。以下是安装和使用步骤：

步骤 1：安装 <code>yuque-dl</code>

在命令提示符或 PowerShell 中，运行以下命令：

npm install -g yuque-dl
  • <code>-g</code> 表示全局安装，这样可以在任何目录下使用 <code>yuque-dl</code> 命令。

这一步我遇到一些问题，镜像切换到华为云就行了，每个人的情况可能不同，如果有问题，可以问AI，deepseek、kimi都很好用。如果deepseek速度慢或者无响应，推荐使用硅基流动（→ 硅基流动官网），这里同样可以免费使用deepseek，当然也可以选其他多种AI模型。
接下来，你大概率会看到版本低的问题，不用管，不影响后面运行。

步骤 2：检查安装

安装完成后，运行以下命令检查是否安装成功：

yuque-dl --help

如果安装成功，你会看到 <code>yuque-dl</code> 的帮助信息。

3. 使用 <code>yuque-dl</code> 下载语雀知识库

以下是使用 <code>yuque-dl</code> 的基本步骤：

步骤 1：获取语雀知识库的 URL

你需要一个语雀知识库的 URL，例如：

https://www.yuque.com/yuque/thyzgp

步骤 2：运行 <code>yuque-dl</code>

在命令提示符或 PowerShell 中，运行以下命令：

yuque-dl &quot;https://www.yuque.com/yuque/thyzgp&quot;
  • 如果是私有知识库，需要提供 token： 
    yuque-dl "https://www.yuque.com/yuque/thyzgp" -t "your_token_value"
  • 如果是企业私有服务，还需要指定 token 的 key： 
    yuque-dl "https://www.yuque.com/yuque/thyzgp" -k "your_token_key" -t "your_token_value"

步骤 3：查看下载结果

默认情况下，下载的内容会保存在当前目录下的 <code>download</code> 文件夹中。你可以指定其他目录：

yuque-dl &quot;https://www.yuque.com/yuque/thyzgp&quot; -d &quot;C:\MyDownloads\Yuque&quot;

4. 启动内置 Web 服务预览下载内容

<code>yuque-dl</code> 提供了一个内置的 Web 服务，用于快速预览下载的内容。运行以下命令：

yuque-dl server ./download/知识库/
  • 打开浏览器，访问 <code>http://localhost:5173/</code>，即可查看下载的知识库内容。

注意事项

  1. Node.js 版本要求：根据 <code>yuque-dl</code> 的文档，需要 Node.js 18.4 或更高版本。如果安装的版本较低，可能会出现兼容性问题。
  2. Token 获取：如果需要访问私有知识库或企业服务，需要从浏览器的开发者工具中获取 <code>cookie</code> 的值。
  3. 网络问题：如果下载过程中出现网络问题，可以重新运行命令，已下载的内容会继续下载，不会重复下载。

通过以上步骤，你可以在 Windows 11 上成功安装 Node.js 并使用 <code>yuque-dl</code> 工具下载语雀知识库的内容。

本文多数文字通过AI生成。