npm package: @luka-cat-mimi/n8n-nodes-feishu
Description: 飞书 N8N 集成插件
Author: luka-cat
Latest version: 0.9.13

# @luka-cat-mimi/n8n-nodes-feishu

飞书 n8n 社区节点，提供飞书开放平台 API 的集成支持。

> 本项目是基于 [n8n-nodes-feishu-lite](https://github.com/other-blowsnow/n8n-nodes-feishu-lite) 之上进行的二次开发，感谢原作者的开源贡献！

## 安装

参考：https://docs.n8n.io/integrations/community-nodes/installation/

节点名称：`@luka-cat-mimi/n8n-nodes-feishu`

## 功能列表

### 🚀 飞书 Trigger ✨ 新增

通过 **WebSocket 长连接**方式监听飞书事件，当事件发生时自动启动工作流。

**主要特点：**

- 支持订阅多种飞书事件（消息、卡片交互、链接预览、人员事件、审批等）
- 两种响应模式：
  - **Immediately**：事件触发后立即响应
  - **Using '飞书响应' Node**：配合飞书响应节点同步返回自定义响应

> ⚠️ 由于飞书 API 限制，每个飞书应用同时只能有一个 Trigger 在运行。

### 🔄 飞书响应 ✨ 新增

配合**飞书 Trigger** 使用，用于同步响应飞书事件（如卡片交互、链接预览回调）。

**主要特点：**

- 支持**无响应**或**自定义 JSON** 响应
- 可显示 Toast 提示消息
- 可同步响应json信息到飞书
- 可选启用响应输出分支

---

### 知识库 (13)

- 获取知识空间列表
- 获取知识空间信息
- 更新知识空间设置
- 添加知识空间成员
- 删除知识空间成员
- 获取知识空间成员列表
- 创建知识空间节点
- **创建动态层级的知识库空间节点 (自定义封装)** ✨ 新增
- 创建知识空间节点副本
- 获取知识空间节点信息
- 获取知识空间子节点列表 ✨支持递归获取子节点
- 移动知识空间节点
- 更新知识空间节点标题

### 群组管理 (12)

- **创建群** ✨ 新增
- **更新群信息** ✨ 新增
- **解散群** ✨ 新增
- 获取群信息
- 获取用户或机器人所在的群列表
- 搜索对用户或机器人可见的群列表
- 获取群成员列表
- 将用户或机器人拉入群聊
- 移出群成员
- 判断用户或机器人是否在群里
- 指定群管理员
- 删除群管理员

### 通讯录 (5)

- 获取用户信息
- 批量获取用户信息
- 通过手机号或邮箱获取用户 ID
- 获取子部门列表 ✨ 新增（支持递归获取、树形/扁平数据结构）
- 获取部门直属用户列表 ✨ 新增

### 任务 (6)

- 创建任务
- 获取任务详情
- 更新任务
- 删除任务
- 添加任务成员
- 移除任务成员

### 云文档 (11)

- 创建文档
- 获取文档基本信息
- 获取文档纯文本内容
- 获取云文档内容
- 获取文档所有块
- 获取块的内容
- 创建块
- 创建嵌套块
- 更新块的内容
- 删除块
- Markdown/HTML 内容转换为文档块

### 多维表格 (26)

- 解析多维表格地址
- 创建多维表格
- 复制多维表格
- 获取多维表格元数据
- 更新多维表格元数据
- 列出数据表
- 新增数据表
- 更新数据表
- 删除数据表
- 列出视图
- 获取视图
- 新增视图
- 更新视图
- 删除视图
- 查询记录
- 查询记录-通过记录ID
- 新增记录
- 更新记录
- 删除记录
- 批量新增记录
- 批量更新记录
- 批量删除记录
- 列出字段
- 新增字段
- 更新字段
- 删除字段

### 消息 (21)

- 发送消息
- 回复消息
- 编辑消息
- **获取指定消息的内容** ✨ 新增
- 转发消息
- 撤回消息
- 批量发送消息
- 批量撤回消息
- 查询批量消息整体进度
- 查询批量消息推送和阅读人数
- 更新已发送的消息卡片
- 延时更新消息卡片
- 发送仅特定人可见的消息卡片
- 删除仅特定人可见的消息卡片
- 发送应用内加急
- 上传图片
- 下载图片
- 上传文件
- 下载文件
- **获取消息中的资源文件** ✨ 新增
- 解密事件消息

### 日历 (16)

- 搜索日历
- 查询日历信息
- 查询主日历信息
- 创建共享日历
- 删除共享日历
- 获取日程列表
- 获取日程
- 搜索日程
- 创建日程
- 更新日程
- 删除日程
- 获取日程参与人列表
- 添加日程参与人
- 删除日程参与人
- 创建会议群
- 解绑会议群

### Aily (5)

- 读取文件基础信息
- 文件上传
- 调用技能
- 查询技能列表
- 获取技能信息

### 云空间 (11)

- 上传素材
- **上传素材通过Url** ✨ 增强
- **下载素材** ✨ 新增（下载各类云文档中的素材，例如电子表格中的图片）
- **分片上传素材** ✨ 新增（支持大文件分片上传，5并发加速）
- 订阅云文档事件
- 取消云文档事件订阅
- 导出云文档（自动轮询任务状态并下载文件）
- **导入文件** ✨ 新增（支持 Word/Excel/CSV/Markdown/TXT/HTML 导入为云文档，自动轮询任务状态）
- 上传文件（支持二进制文件上传到云空间文件夹）
- 分片上传文件（三合一接口，支持大文件分片上传，5 并发加速）
- 下载文件

## ✨ 特别之处

### 🔄 Return All 自动分页

以下接口支持 **Return All** 功能，自动处理分页获取全部数据：

| 模块     | 接口名称                                                 |
| -------- | -------------------------------------------------------- |
| 知识库   | 获取知识空间列表                                         |
| 知识库   | 获取知识空间成员列表                                     |
| 知识库   | 获取知识空间子节点列表（支持递归获取所有子节点）         |
| Aily     | 查询技能列表                                             |
| 群组管理 | 获取用户或机器人所在的群列表                             |
| 群组管理 | 搜索对用户或机器人可见的群列表                           |
| 群组管理 | 获取群成员列表                                           |
| 多维表格 | 查询记录                                                 |
| 多维表格 | 列出数据表 ✨ 新增                                       |
| 多维表格 | 列出视图 ✨ 新增                                         |
| 多维表格 | 列出字段 ✨ 新增                                         |
| 日历     | 搜索日历 ✨ 新增                                         |
| 日历     | 获取日程列表 ✨ 新增                                     |
| 日历     | 搜索日程 ✨ 新增                                         |
| 日历     | 获取日程参与人列表 ✨ 新增                               |
| 云文档   | 获取文档所有块 ✨ 新增                                   |
| 通讯录   | 获取子部门列表（支持递归获取、树形/扁平数据结构）✨ 新增 |
| 通讯录   | 获取部门直属用户列表 ✨ 新增                             |

### ⏱️ 超时与批次管理

大部分接口支持以下高级选项：

- **Timeout（超时时间）**：设置请求超时时间（毫秒），避免请求长时间挂起
- **Batching（批次管理）**：
  - **Items per Batch**：每批处理的数量，用于控制请求频率
  - **Batch Interval (ms)**：每批请求之间的等待时间，避免触发 API 限流

这些功能可在接口的 `Options` 选项中配置，有效应对飞书 API 的频率限制。

## 凭证类型

- **应用级别凭证** - 使用 App ID 和 App Secret 进行认证
- **用户级别凭证** - 使用 OAuth 2.0 进行用户授权认证

## 注意事项

1. 使用应用凭证访问文档时，需要在文档中将应用添加为协作者
2. 错误码查询：https://open.feishu.cn/search

## 📝 许可证

MIT License

## 🆘 支持

- 📧 邮箱：luka.cat.mimi@gmail.com
- 🐛 [问题反馈](https://github.com/luka-n8n-nodes/n8n-nodes-volcengine/issues)