SuperAPI AI 工具集

lark-workflow-bitable-sync

办公与效率

查看项目

更新于 10-16 06:23

技能介绍

用途:在飞书多维表格之间同步数据,把源表的新增或变更记录写入目标表,并生成同步预览与变更报告。

主要能力:读取源表与目标表字段结构;由 AI 生成字段映射方案(需用户确认);分页拉取源数据(每页最多 200 条);拉取目标表现有数据用于去重;基于去重字段比对出新增、需更新、无变化记录;通过 upsert 写入差异数据。

使用方式:仅支持 user 身份,执行前需授权:lark-cli auth login --domain base。开始前须先用 Read 工具读取 ../lark-shared/SKILL.md(含认证与权限处理)。流程为:分别对源表和目标表执行 base +field-list(两次调用必须串行,不能并发);确认字段映射与去重字段;用 base +record-list 拉取源数据与目标数据;比对去重后确认同步;对每条差异记录调用 base +record-upsert,串行执行且每次间隔至少 1 秒。

限制与注意:只映射可写入字段,忽略公式、查找引用、系统字段;日期字段需 Unix 毫秒时间戳,人员字段格式为 [{"id":"ou_xxx"}],单选字段传选项名称字符串。降级策略包括跳过不兼容字段、提示创建对应字段、分批同步(每批 50 条)、写入限流时降至每 2 秒一条。所需 scope:field-list 与 record-list 为 bitable:app:readonly,record-upsert 为 bitable:app。其他细节暂未提供。