首页 / 博客 / 团队空间导出支持

YuqueOut 新功能:语雀团队空间知识库完整导出支持

语雀团队空间导出

语雀的「团队空间」是企业用户最常使用的协作场景:多个团队、多个分组、每个分组下若干知识库。此前 YuqueOut 已支持个人知识库和协作库的批量导出。从 v1.2 开始,团队空间被完整纳入支持范围。

Key Takeaways
  • 完整覆盖团队空间所有内容类型:团队库、空间收藏、公共区
  • 目录自动按「团队名/分组名/知识库名」归类,保留组织结构
  • 无导出权限的团队文档自动切换本地引擎导出
  • 支持多个团队空间同时选择、一次性导出

这次更新了什么?

v1.2 之前,YuqueOut 的知识库列表主要来自个人空间(/api/mine/book_stacks)和协作库(/api/mine/raw_collab_books)。团队空间的知识库虽然也能通过协作库接口拿到部分数据,但存在以下问题:

  • 空间收藏无法获取
  • 公共区(Wiki)文档归属不清
  • 导出目录是扁平的,看不出团队/分组层级

v1.2 通过调用团队组织 API(/api/mine/user_books?user_type=Group + /api/modules/org_wiki/),补全了上述缺失。现在知识库列表中会完整展示你所在的每个团队空间下的所有可访问知识库。

团队空间的目录结构

导出后的文件结构清晰反映了语雀团队空间的组织层级:

语雀备份/
├── 我的公司/                    ← 团队(组织)名
│   ├── 前端组/                  ← 分组名
│   │   ├── 前端技术文档/        ← 知识库名
│   │   │   ├── React 入门.md
│   │   │   └── assets/
│   │   └── 组件设计规范/
│   ├── 公共区/                  ← 公共区(Wiki)
│   │   └── 公司制度文档/
│   └── 收藏/                    ← 空间收藏
│       ├── 产品需求文档库/
│       └── 单篇收藏文档.md
├── 另一个团队/
│   └── ...
└── 个人空间/
    └── ...

这个结构的好处在于:即使你同时选择了多个团队空间的知识库,导出文件也不会混在一起。每个团队、每个分组都有独立的文件夹层级。

空间收藏导出

语雀团队空间有独立的「收藏」功能(区别于个人收藏)。空间收藏的内容可能来自团队内部的不同知识库,也可能是外部链接。

YuqueOut 现在会将每个团队空间的收藏作为独立选项展示在知识库列表中,标记为「XX空间 收藏」。勾选后,收藏中的文档和知识库都会被完整导出。

空间收藏导出时的规则与个人收藏一致:

  • 收藏的单篇文档 → 按来源知识库名归类
  • 收藏的整个知识库 → 获取该库全部文档并导出
  • 加密内容 → 提示输入密码或跳过

公共区(Wiki)文档

语雀团队空间中的「公共区」是一种特殊的知识库类型(type: wiki),通常用于存放全员可见的制度文档、入职指南等。在 YuqueOut 中,公共区知识库会被归入「团队名/公共区/知识库名」路径下导出。

由于公共区文档通常不授予成员导出权限,YuqueOut 会自动检测权限并切换到本地 Markdown 转换引擎。不需要手动操作,导出结果包含完整文本、图片和表格。

无权限文档的处理

团队空间中的文档权限管理比个人空间复杂得多。管理员可能对知识库设置了「禁止导出」,但成员仍然可以正常阅读。

YuqueOut 的处理逻辑:

  1. 先尝试调用官方导出 API
  2. 如果返回 403(无权限),自动切换到本地转换引擎
  3. 本地引擎直接解析文档内容,不依赖导出权限
  4. 最终输出 Markdown 格式(图片自动本地化)

这意味着:只要你能在浏览器中打开并阅读一篇文档,YuqueOut 就能将其导出到本地。这是 YuqueOut「所见即所得」理念的核心。

使用方法

操作流程与之前完全一致,无需额外配置:

  1. 确保已在浏览器中登录语雀,且已加入目标团队空间
  2. 点击 YuqueOut 扩展图标打开 Popup
  3. 在知识库列表中找到团队空间对应的库(列表会按团队分组展示)
  4. 勾选需要导出的知识库,点击「获取文件信息」
  5. 确认文件列表后,点击「开始导出」

导出完成后,文件会自动保存到浏览器下载目录的子文件夹中(默认「语雀备份」),按上文所述的层级结构组织。

常见问题

Q: 为什么列表中看不到某个团队空间的知识库?

确认你已经加入该团队空间。YuqueOut 只能获取你有浏览权限的知识库。如果你是空间外部人员(非成员),无法获取到该空间的任何内容。

Q: 团队空间的「个人知识库」也能导出吗?

团队空间中每个成员的「个人知识库」(org-personal 类型)也在支持范围内。如果你能在语雀中访问自己在空间内的个人库,YuqueOut 就能将其导出。

Q: 导出速度和个人库有区别吗?

没有明显区别。团队空间文档的获取和转换走相同的引擎,速度取决于文档数量和网络状况。1000 篇团队文档大约需要 30-45 分钟(含图片本地化)。