飞书知识库操作技能

操作飞书知识库（Wiki），包括获取节点信息、导出文档、列出空间和节点。

核心概念

Markdown 作为中间态：知识库文档与本地文件之间通过 Markdown 格式进行转换，中间文件存储在 /tmp 目录中。

使用方法

/feishu-wiki get <node_token|url> # 获取节点信息 /feishu-wiki export <node_token|url> # 导出为 Markdown /feishu-wiki spaces # 列出知识空间 /feishu-wiki nodes <space_id> # 列出空间下的节点

CLI 命令详解

1. 获取知识库节点信息

通过 Token 获取

feishu-cli wiki get <node_token>

通过 URL 获取（自动解析）

feishu-cli wiki get https://xxx.feishu.cn/wiki/&#x3C;node_token> feishu-cli wiki get https://xxx.larkoffice.com/wiki/&#x3C;node_token>

输出示例：

知识库节点信息: 空间 ID: <space_id> 节点 Token: <node_token> 文档 Token: <document_token> 文档类型: docx 节点类型: origin 标题: 示例文档标题 有子节点: true 创建者: ou_xxx 所有者: ou_xxx

2. 导出知识库文档为 Markdown

基本导出（输出到 stdout）

feishu-cli wiki export <node_token>

导出到文件

feishu-cli wiki export <node_token> --output /tmp/wiki_doc.md

通过 URL 导出

feishu-cli wiki export https://xxx.larkoffice.com/wiki/&#x3C;token> -o doc.md

下载图片到本地

feishu-cli wiki export <node_token> -o doc.md --download-images --assets-dir ./images

参数说明：

参数 说明 默认值

--output, -o

输出文件路径 stdout

--download-images

下载图片到本地 false

--assets-dir

图片保存目录 ./assets

3. 列出知识空间

feishu-cli wiki spaces

指定每页数量

feishu-cli wiki spaces --page-size 20

参数说明：

参数 说明 默认值

--page-size

每页数量 50

输出示例：

知识空间列表:

1. 空间ID: <space_id> 名称: 技术文档 类型: team

2. 空间ID: 7123456789012345678 名称: 个人笔记 类型: personal

3. 列出空间下的节点

列出根节点

feishu-cli wiki nodes <space_id>

列出指定父节点下的子节点

feishu-cli wiki nodes <space_id> --parent <node_token>

指定每页数量

feishu-cli wiki nodes <space_id> --page-size 20

参数说明：

参数 说明 默认值

--parent

父节点 Token（不指定则列出根节点） 根节点

--page-size

每页数量 50

输出示例：

节点列表（空间: <space_id>）:

1. <node_token_1> 标题: 示例文档 1 类型: docx

2. <node_token_2> 标题: API Reference 类型: docx

URL 格式支持

URL 格式 说明

https://xxx.feishu.cn/wiki/&#x3C;token>

飞书国内版

https://xxx.larkoffice.com/wiki/&#x3C;token>

飞书国际版/内部版

https://xxx.larksuite.com/wiki/&#x3C;token>

Lark 国际版

典型工作流

导出知识库文档进行分析

1. 获取节点信息

feishu-cli wiki get https://xxx.feishu.cn/wiki/&#x3C;node_token>

2. 导出为 Markdown

feishu-cli wiki export <node_token> -o /tmp/wiki_doc.md

3. 分析文档内容

cat /tmp/wiki_doc.md

批量导出空间文档

1. 列出空间

feishu-cli wiki spaces

2. 列出节点

feishu-cli wiki nodes <space_id>

3. 逐个导出

feishu-cli wiki export <token1> -o /tmp/doc1.md feishu-cli wiki export <token2> -o /tmp/doc2.md

识别目录节点

知识库文档可能是目录节点（包含子节点），通过以下方式识别：

1. 使用 wiki get 查看节点信息

feishu-cli wiki get <node_token>

输出中的 has_child 字段表示是否有子节点：

知识库节点信息: 空间 ID: xxx 节点 Token: xxx 文档 Token: xxx 文档类型: docx 节点类型: origin 标题: 目录节点示例 有子节点: true <-- 表示这是目录节点

2. 导出时识别目录节点

当导出目录节点时，如果文档内容显示为：

[Wiki 目录 - 使用 'wiki nodes <space_id> --parent <node_token>' 获取子节点列表]

说明这是一个Wiki 目录块（block_type=42），表示该节点是知识库目录，子文档列表存储在知识库元数据中，而非文档内容中。

3. 获取子节点列表

对于目录节点，使用以下命令获取子节点：

1. 先获取节点信息，记录 space_id

feishu-cli wiki get <node_token>

2. 列出该节点下的子节点

feishu-cli wiki nodes <space_id> --parent <node_token>

示例工作流：

获取知识库节点

feishu-cli wiki get WvHQwCaDKiJZAjkm354cvZNjnxd

输出：有子节点: true, 空间 ID: 7540365701802885139

获取子节点列表

feishu-cli wiki nodes 7540365701802885139 --parent WvHQwCaDKiJZAjkm354cvZNjnxd

输出：列出所有子节点及其文档类型

注意事项

• 知识库 vs 普通文档：知识库使用 node_token ，普通文档使用 document_id

• 权限要求：需要应用具有 wiki:wiki:readonly 权限

• 中间文件：导出的 Markdown 默认存放在 /tmp 目录

• 目录节点：目录节点的内容可能为空或只包含 WikiCatalog 块（type=42），实际内容在子节点中

图片处理（重要）

导出文档时务必下载图片，以便理解文档中的图片内容：

导出并下载图片

feishu-cli wiki export <node_token>
--output /tmp/wiki_doc.md
--download-images
--assets-dir /tmp/wiki_assets

查看下载的图片

ls /tmp/wiki_assets/

使用 Read 工具读取图片（Claude 支持多模态）

Read /tmp/wiki_assets/image_1.png

流程：

• 导出时使用 --download-images --assets-dir <dir> 下载图片

• 使用 ls 查看下载的图片文件

• 使用 Read 工具逐个读取图片，理解图片内容

• 将图片内容整合到文档分析中