使用“yuque-dl”迁移语雀文档
内容提要
自从语雀故障后，又补偿了一年会员，但访问速度变慢。找到了yuque-dl工具，可以无需申请官方token下载迁移到本地。安装和使用教程见项目文档。
延伸解读
迁移工具选择：yuque-dl 与 yuque2book 的差异
文章提到，yuque2book 需要会员 token 才能使用，而 token 申请本身有会员门槛，导致迁移成本较高。yuque-dl 则无需申请官方 token，直接通过 Cookie 即可下载私有文档，降低了迁移门槛。对于非会员或不愿额外申请 token 的用户，yuque-dl 是更轻量的替代方案。
使用前的环境与网络准备
yuque-dl 要求本地具备 Node 环境，最低版本为 14.16.0，理论上 14.16 及以上版本均可支持。若安装或执行过程中出错，文章建议配置国内镜像，例如将 npm 源指向 npmmirror，并设置 sass 二进制站点，必要时还可安装 cnpm 后重试。这些准备能减少因网络问题导致的安装失败。
私有文档下载的关键：Cookie 与 token 参数
下载私有文档前，需要从浏览器中获取 Cookie。以 Chrome 为例，登录语雀后打开开发者工具，在 Application 的 Cookies 中找到 _yuque_session 并复制其值。执行下载命令时，通过 -t 参数携带该值，文章建议始终携带，否则可能出现部分文章下载失败。若下载失败，重新运行即可，已下载进度不会受影响。
Q&A
如何使用yuque-dl工具迁移语雀文档？
使用yuque-dl工具前，确保本地有Node环境（最低版本14.16.0）。安装命令为npm i -g yuque-dl，下载文档时需获取Cookie并使用命令格式yuque-dl '文档链接' -t 'token'。
为什么选择yuque-dl而不是yuque2book？
yuque-dl无需申请官方token，迁移成本较低，而yuque2book需要会员token，成本较高。
在安装yuque-dl时遇到错误该怎么办？
如果安装出错，建议配置国内镜像并安装cnpm，使用命令npm i -g cnpm和npm config set registry https://registry.npmmirror.com。
如何获取下载私有文档所需的Cookie？
登录语雀后，使用浏览器的开发者工具，找到Cookies中的_yuque_session，复制其值。
使用yuque-dl下载文档时需要注意什么？
建议在下载文档时携带token，以避免下载失败，若出现失败可重新运行命令，已下载的进度不会受到影响。
yuque-dl的项目文档在哪里可以找到？
更多使用方法和项目文档可以在GitHub上找到，具体地址在文章中提到。
