飞书知识库导出

技能简介

该技能用于管理和导出飞书（Lark Suite）Wiki/知识库文档，支持递归读取子文档、增量同步更新，并将内容转换为本地Markdown文件保存。

业务背景

企业知识分散在飞书Wiki中，离职交接或合规审计时常面临文档缺失风险。该技能支持批量导出完整知识库为本地Markdown，保留层级结构并记录同步状态，确保知识资产可控可迁移，降低平台依赖带来的信息孤岛隐患。

落地案例：某科技公司产品部门需将三年积累的飞书Wiki迁移至新文档系统。通过配置飞书应用凭证，一键递归导出2000+篇嵌套文档，生成对应文件夹结构与状态记录文件。后续每周增量同步更新内容，新旧系统并行期间保证资料一致性。

能做什么

• 列出所有Wiki空间
• 读取单篇文档及子文档链接
• 批量导出整个知识库为Markdown
• 递归导出所有嵌套子文档
• 增量同步，仅导出变更内容
• 保留原始目录层级结构

使用说明

1. 安装与配置

需先创建飞书应用并获取凭证：

1. 访问 飞书开放平台 创建应用
2. 开启权限：docs:doc:read、drive:drive:read、wiki:wiki:read
3. 发布应用并授权访问目标Wiki
4. 设置环境变量：

   export LARK_APP_ID="cli_xxxxxxxx"
   export LARK_SECRET="xxxxxxxx"

2. 常用命令

# 列出Wiki空间
larksuite-wiki spaces

# 读取文档（含子文档链接）
larksuite-wiki read <doc_id_or_url>

# 导出单篇文档
larksuite-wiki export <doc_id_or_url> --output ./docs/

# 显示文档树结构
larksuite-wiki tree <doc_id_or_url>

# 首次完整同步
larksuite-wiki sync <doc_id_or_url> --output ./lark-wiki/

# 增量同步（仅变更文档）
larksuite-wiki sync <doc_id_or_url> --output ./lark-wiki/

# 强制重新导出全部
larksuite-wiki sync <doc_id_or_url> --output ./lark-wiki/ --force

3. 输出结构

按原Wiki层级生成编号文件夹，每篇文档独立文件夹，包含主Markdown文件及子文档子文件夹。

输入与输出

见下方输入与输出表格。

风险提示

• 文档需显式分享给应用方可访问
• 部分富文本块类型可能无法完整转换为Markdown
• 大型知识库首次同步耗时较长
• 同步状态保存在本地.lark-sync-state.json，勿随意删除
• API调用受飞书平台速率限制

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/ryanhong666/larksuite-wiki/SKILL.md
来源类型：GitHub仓库