语雀加密文档怎么导出？密码验证与本地备份完整指南

语雀里的加密内容通常出现在两个场景：个人或团队知识库设置了访问密码，或者某些收藏文档本身需要密码验证。平时在线阅读时，你只需要输入一次密码；但当你做批量备份时，加密项会变成流程里的特殊节点。

很多导出工具会在这里失败：要么直接跳过，要么报错中断，要么要求你先手动逐个打开验证。YuqueOut 的目标不是绕过加密，而是把「合法输入密码后继续导出」这件事放进批量流程里。

什么时候会遇到加密文档？

常见的加密内容包括：

• 加密知识库：进入知识库前需要输入访问密码。
• 加密单篇文档：文档单独设置了密码保护。
• 收藏中的加密内容：你收藏了某个需要密码的文档或知识库。
• 团队空间中的敏感资料：团队文档可见范围有限，并叠加密码验证。

如果你只导出自己的普通知识库，可能完全不会遇到密码弹窗。但在收藏导出、团队空间导出、长期备份场景中，加密内容出现的概率会明显提高。

加密内容导出的边界

加密文档导出的前提是你知道密码并完成验证。这点必须讲清楚：任何负责任的工具都不应该绕过用户设置的密码保护。

YuqueOut 做的是流程自动化，而不是安全绕过：

1. 扫描文档或收藏列表时识别哪些内容需要密码。
2. 把这些内容放入待验证队列。
3. 向用户弹出密码输入框。
4. 验证成功后，继续获取文档并导出。
5. 验证失败或用户跳过时，不导出该加密项。

如果你的目标是导出没有访问权的内容，YuqueOut 不适用。它只帮助你备份自己已经有权访问、且能完成验证的文档。

YuqueOut 的密码验证流程

在技术上，YuqueOut 使用浏览器已有登录态访问语雀，并按语雀的密码验证方式提交验证请求。项目中使用 RSA 加密处理密码验证参数，验证通过后再继续导出。

用户侧看到的是一个简单流程：

1. 开始批量导出或扫描收藏列表。

2. YuqueOut 发现加密文档或加密知识库，先处理可直接导出的内容。

3. 弹出「文档需要密码」或「知识库需要密码」窗口。

4. 输入密码并点击确认。

5. 验证成功后，该文档或知识库中的文档会加入下载队列。

如果密码错误，界面会提示失败，你可以重新输入，也可以选择跳过当前加密项。

批量导出时怎么处理多个加密项？

批量导出最麻烦的不是一个加密文档，而是多个加密项混在普通文档中。YuqueOut 会把它们排成队列逐个处理。

举个例子：

收藏导出队列：
├── 120 篇普通文档
├── 2 个加密知识库
└── 5 篇加密文档

YuqueOut 会先导出普通文档，避免流程被加密项卡住。剩余加密项会逐个提示输入密码。你可以全部验证，也可以只验证重要的，其他选择跳过。

这种设计适合真实备份场景：你不需要在导出前把所有密码都准备好，也不需要因为一个加密文档中断整个任务。

密码和文档内容安全吗？

YuqueOut 的隐私原则和其他导出流程一致：所有转换在本地浏览器完成，文档内容不上传到第三方服务器。密码只用于向语雀完成当前验证。

项目	处理方式
文档内容	在浏览器本地解析和转换，不上传第三方服务器
语雀登录状态	复用浏览器 Cookie，不要求你手动配置 API Token
密码	仅用于当前验证请求，不作为明文保存

更完整的隐私说明可以查看 YuqueOut 隐私政策。

什么时候建议跳过加密内容？

设置页中有一个「跳过加密内容」选项。它适合以下情况：

• 你在导出大量收藏，只想先备份公开可读内容。
• 团队资料里有很多历史加密文档，密码不在你手里。
• 你不希望导出流程中频繁弹出密码输入框。
• 本次备份只是临时迁移，不需要处理敏感内容。

如果是正式迁移或离职交接，建议不要直接跳过。先导出普通文档，再集中处理加密项，最终备份结果会更完整。

常见问题

Q: 密码验证成功后，导出格式会改变吗？

不会。验证只是让 YuqueOut 获取加密内容，后续导出仍然遵循你在设置页选择的格式、图片本地化和转换引擎配置。

Q: 加密知识库会导出整个知识库吗？

验证成功后，YuqueOut 会继续获取该知识库的文档列表，并按可访问范围导出其中的文档。目录结构会尽量保持原样。

Q: 密码输错会锁定吗？

语雀侧可能对连续错误验证做限制。建议确认密码后再提交，多次失败时暂停一会儿再试。