n8n-nodes-feishu-plus

飞书多维表格的 n8n 社区节点 — 支持 11 个 Bitable 操作，具备生产级重试、熔断和完整测试覆盖。

安装

在 n8n 中：

1. 进入 Settings → Community Nodes
2. 输入 n8n-nodes-feishu-plus
3. 点击 Install

或通过命令行：

cd ~/.n8n/nodes
npm install n8n-nodes-feishu-plus

配置凭证

1. 在 飞书开放平台 创建应用，获取 App ID 和 App Secret
2. 在 n8n 中进入 Credentials → New → Feishu Plus API
3. 填入 App ID 和 App Secret

功能列表

| 操作 | 说明 | |------|------| | 获取记录 | 获取单条记录 | | 创建记录 | 新增单条记录 | | 更新记录 | 更新单条记录 | | 删除记录 | 删除单条记录 | | 列出记录 | 列出记录，支持自动分页 | | 搜索记录 | 按条件搜索记录，支持 filter + 自动分页 | | 批量创建 | 批量新增记录（上限 500 条） | | 批量更新 | 批量更新记录（上限 500 条） | | 批量删除 | 批量删除记录（上限 500 条） | | 列出数据表 | 获取多维表格下所有数据表 | | 列出字段 | 获取数据表的字段定义 |

特性

• 重试 + 熔断 — 指数退避重试 + 熔断器保护，应对飞书 API 限流
• Token 自动刷新 — tenant_access_token 过期自动续期
• Simplify 模式 — 开启后返回精简数据，去除飞书原始嵌套结构
• 自动分页 — 列出/搜索操作自动拉取全部数据，无需手动翻页
• 错误脱敏 — App Secret 不会出现在错误信息中
• continueOnFail — 批量处理时单条失败不影响整体执行
• 104 项测试 — 单元测试 + 集成测试全覆盖

开发

npm install
npm test          # 运行测试
npm run build     # 编译 TypeScript
npm run lint      # ESLint 检查

许可证

MIT