Description
@luka-cat-mimi/n8n-nodes-feishu-project
在 n8n 中轻松操作飞书项目 —— 无需写代码，拖拽即可实现工作项管理自动化。
为什么选择这个节点？
| 痛点 | 解决方案 |
|——|———-|
| 飞书项目 API 调用复杂 | 动态表单：空间、工作项类型自动加载，下拉选择即可 |
| 分页数据获取麻烦 | 一键获取全部：自动处理分页，返回完整数据 |
| API 限流导致失败 | 批次处理：自动控制请求频率，避免触发限流 |
| 请求卡死无响应 | 超时保护：设置超时时间，请求异常及时中断 |
安装
npm install @luka-cat-mimi/n8n-nodes-feishu-project
或在 n8n 社区节点中搜索安装，参考：社区节点安装指南
节点概览
本插件包含两个节点：
| 节点 | 类型 | 说明 |
|——|——|——|
| 飞书项目 | 操作节点 | 调用飞书项目 API，支持工作项、空间、用户、工作流等 66 个操作 |
| 监听事件 | 触发器（Webhook） | 接收飞书项目回调事件，按条件触发工作流 |
触发器：监听事件
通过 Webhook 接收飞书项目的回调事件来触发工作流，固定使用 POST 方法。
支持的事件
| 类型 | 事件（编码） |
|——|——|
| 工作项（100） | 创建（1001）/ 删除（1002）/ 恢复（1004）/ 终止（1005）/ 模版升级（1006）/ 修改字段（1009） |
| 节点（200） | 完成（2001）/ 删除（2002）/ 恢复（2003）/ 回滚（2004）/ 修改估分与排期（2005）/ 修改负责人（2006）/ 修改实际工时（2007）/ 多人确认流转（2009） |
| 状态（300） | 状态变更（3001） |
| 子任务（400） | 新建（4001）/ 删除（4002）/ 完成（4003）/ 取消完成（4004）/ 修改负责人（4005）/ 修改估分（4006）/ 修改排期（4007）/ 修改实际工时（4008）/ 修改字段（4009） |
| 空间（500） | 添加成员（5001）/ 删除成员（5002）/ 完成工作移交（5003）/ 拒绝工作移交（5004） |
| 插件（600） | 安装（6001）/ 卸载（6002）/ 更新（6003）/ 购买（6004） |
「监听事件」支持通配符 *（所有事件），默认选中。
配置回调地址
将节点生成的 Webhook URL 填入飞书项目对应的回调地址中：
1. 工作项 / 节点 / 状态 / 子任务 / 空间等业务事件（100~500）：开发者后台 → 插件功能 → 插件构成 添加构成 → 监听事件
2. 插件安装 / 卸载 / 更新 / 购买等插件事件（600）：开发者后台 → 插件发布 → 插件事件订阅
验证签名（可选）
开启「验证签名」后填入回调 Token，节点会按 sha256(pluginid + requesttime + token) 计算签名并与请求体 signature 比对，校验失败返回 401。
过滤选项（Options）
支持对回调进行多级过滤，判断顺序为：签名 → 来源类型 → 监听事件 → 飞书项目空间 → 工作项类型，任一不匹配则忽略（返回 200 但不触发工作流）。
| 选项 | 说明 |
|——|——|
| 允许来源类型 | 多选：普通用户操作（normal）、OpenAPI（openapi）、系统行为（system）、自动化（automation）。按 source 匹配 |
| 允许飞书项目空间 | 动态多选，默认通配符。按 data.project_key 匹配 |
| 允许的工作项类型 | 字符串，支持逗号分隔、JSON 数组或表达式数组（如 ["issue","story"]、issue,story、{{ ["issue","story"] }}），默认通配符 *。按 data.workitemtype_key 匹配；事件不含该字段时视为通过 |
支持的功能（66 个操作）
工作项管理（16 个）– 创建、更新、删除、批量操作…
- 创建工作项 / 查询工作项详情 / 更新工作项 / 删除工作项
- 批量更新工作项 / 终止工作项 / 获取工作项元数据 / 获取工作项操作记录
- 获取工作项任务结果 / 批量查询评审信息 / 查询评审结论 / 更新评审
- 创建工时记录 / 获取工时记录列表 / 更新工时记录 / 删除工时记录
工作项搜索（4 个）– 单空间搜索、复杂条件、全局搜索…
工作项配置（9 个）– 字段管理、关联配置…
空间管理（6 个）– 空间列表、详情、成员…
空间关联（4 个）– 工作项关联绑定…
流程与节点（5 个）– 流程节点操作、状态变更…
子任务（5 个）– 子任务 CRUD…
视图管理（8 个）– 视图创建、更新…
评论管理（4 个）– 评论 CRUD…
附件管理（4 个）– 文件上传下载…
用户管理（2 个）– 用户信息、用户搜索…
其他（3 个）– 流程模板、角色、群组、度量…
快速开始
1. 获取凭证
| 凭证 | 获取方式 |
|——|———-|
| 插件 ID / 密钥 | 飞书项目管理后台 → 插件管理 → 创建或查看插件 |
| 用户 ID | 飞书项目空间左下角 → 双击个人头像 |
| Host | 通常为 project.feishu.cn |
2. 配置凭证
在 n8n 中创建 飞书项目 API 凭据：
| 字段 | 示例 |
|——|——|
| 飞书项目 Host | project.feishu.cn |
| 插件 ID | MII_0000000000000000 |
| 插件密钥 | AB92E56666CT8D60704743BF69C92C16 |
| 用户 ID | 7568516887894324252 |
3. 开始使用
拖入节点 → 选择资源和操作 → 填写参数 → 执行！
注意事项
支持
许可证
MIT License
