飞书多维表格智能导入

解决的问题

团队经常要把数仓、BI、CRM 或 ERP 导出的数据搬进飞书多维表格。手动复制粘贴容易漏行、串列，报表更新后也需要反复导入；如果每次都要人工建字段，字段类型判断还会影响后续统计。feishu-bitable-import 针对的是这种从本地文件到飞书表格的数据同步问题：把 CSV、Excel、JSON 变成结构化、可协作、可追踪的表格数据。

技能如何工作

技能先做字段分析，再按业务场景选择同步策略。常见能力包括：

• 智能类型推断：根据数值、日期、单选、多选、链接、手机号等分布识别飞书字段类型。
• 三种同步模式：增量更新 适合主键变化的业务数据；全量覆盖 适合每日报表；仅新增 适合日志追加。
• 零配置建表：从源文件推断字段并创建表格，减少手动配置。
• 可靠性处理：对 API 限流、网络超时、格式错误做重试、跳过或报错，避免整批任务失败。

典型流程是：准备飞书自建应用权限与 .env，导入源文件，分析数据结构，选择同步模式，执行导入并输出结果报告。

适用边界与注意点

它适合已有稳定结构、需要定期同步到飞书多维表格的团队数据；如果源数据频繁变更、字段语义不明确，或飞书权限不足，需要先清理数据和应用配置。全量覆盖会清空旧数据，增量同步依赖可识别的主键或匹配规则，生产环境应先小规模验证。