使用 “yuque-dl” 迁移语雀文档

小莫分享字数: 2765 阅读耗时: 6 分钟 2024/09/25 博客独享热度: 14 评论: 0

自从语雀故障后，又补偿了一年会员，且后面总感觉语雀访问速度没有那么快了。

最近自建云文档了，想着把语雀上的资料迁移一下，手动弄太慢了，后面发现一款 yuque2book 迁移工具，但是需要 token，这个 token 又得是会员才能申请，这样迁移成本有点高。

又翻阅资料，找到了 yuque-dl ，无需申请官方 token 即可下载迁移到本地。

使用教程

首先环境要求必须存在 Node 环境，我本地使用的是 Nvm 管理 Node 环境，最低版本为 14.16.0 ，理论 14.16+ 都支持，所以这里不做太低版本验证。

如果执行过程中出错，建议配置国内镜像

npm config set registry https://registry.npmmirror.com
npm config set sass_binary_site https://npmmirror.com/mirrors/node-sass/

安装 yuque-dl

npm i -g yuque-dl

如果安装出错，建议配置国内镜像且安装 cnpm

npm i -g cnpm
npm config set registry https://registry.npmmirror.com
npm config set sass_binary_site https://npmmirror.com/mirrors/node-sass/
npm i -g yuque-dl

下载私有文档前，请获取 Cookie 。

以 chrome 为例其他浏览器也类似

登录语雀，浏览器右击菜单 "检查" 或点击快捷键 F12
退出控制台后点击 Application 或者 应用程序
点击左侧 Cookies 下的 https://www.yuque.com
右侧列表中找到 Name 为 _yuque_session 双击 Value 列复制 Value 的值 (也就是下面图片中圈选部分)

Cookie获取方法

下载文档，执行命令如下：

yuque-dl "https://www.yuque.com/yuque/thyzgp" -t "abcd..."

上述命令 -t 后跟着 token 数据即可，建议下载文档时携带，否则可能会出现部分文章下载失败情况，下载失败的，重新运行即可，已下载的进度不会受到影响。

更多使用方法，请查看项目文档

项目地址

GitHub