# 飞书知识库内容读取技能

## 功能说明
批量读取飞书知识库中指定文档及其所有子文档的内容，支持结构化提取文档内容，用于后续分析、整理和同步。

## 使用场景
1. 需要批量获取知识库中某目录下所有文档内容
2. 需要读取指定文档及其子文档做内容分析
3. 需要迁移或备份知识库内容
4. 需要同步知识库内容到其他存储位置

## 前置条件
- 已获取飞书用户授权（包含知识库读取权限）
- 已知目标文档的飞书URL或node_token

## 操作步骤

### 1. 获取文档子文档列表
如果需要读取目录下的所有子文档，先调用接口获取子文档列表：
```json
{
  "name": "feishu_wiki_space_node",
  "parameters": {
    "action": "list",
    "parent_node_token": "<目标文档的node_token>",
    "space_id": "<文档所在知识空间的space_id>"
  }
}
```
- 可以通过文档URL提取node_token，例如URL：`https://makee-interactive.feishu.cn/wiki/R8REwpLPxikYUEkLsdCcGy7pnCh` 中的 `R8REwpLPxikYUEkLsdCcGy7pnCh` 就是node_token
- space_id可以通过get接口查询文档信息获取

### 2. 读取单个文档内容
对每个子文档，调用接口读取内容：
```json
{
  "name": "feishu_fetch_doc",
  "parameters": {
    "doc_id": "<子文档的node_token或URL>"
  }
}
```
- 支持直接传入文档URL，工具会自动解析node_token
- 返回内容为Markdown格式，保留文档结构、表格、链接等元素

### 3. 批量读取完整流程示例
```
# 第一步：获取目录下所有子文档
GET子文档列表 → 得到所有子文档的node_token和标题

# 第二步：遍历读取每个子文档
FOR 每个子文档 IN 子文档列表:
    读取子文档内容 → 保存到本地或内存

# 第三步：内容处理（可选）
合并/整理/分析读取到的所有文档内容
```

## 示例
### 读取「L2 数据分析」目录下所有子文档
1. 目标文档URL：`https://makee-interactive.feishu.cn/wiki/R8REwpLPxikYUEkLsdCcGy7pnCh`
2. 调用`feishu_wiki_space_node`的list接口，获取到3个子文档
3. 分别调用`feishu_fetch_doc`读取每个子文档内容
4. 得到所有3个文档的完整Markdown内容

## 注意事项
1. 每个子文档的读取需要单独调用接口
2. 如果文档内容过大，需要使用offset参数分页读取
3. 需要确保用户已授权知识库读取权限，否则会返回授权失败
4. 文档中的图片、附件等资源需要单独调用下载接口获取
