feishu-plus

Feishu/Lark Bitable operations with production-grade retry, circuit breaker and test coverage

Package Information

Downloads: 293 weekly / 293 monthly
Latest Version: 0.1.2

Available Nodes

飞书 Plus / Feishu Plus icon
飞书 Plus / Feishu Plus
飞书多维表格操作 Feishu Bitable operations with retry, circuit-breaker & full test coverage

Documentation

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

Discussion