飞书多维表格数据同步操作文档

功能

• 将本地数据与飞书多维表格（Bitable）双向同步，覆盖“网站管理”和“外链管理”两类数据。
• 支持两种方式：
  1. 同步模式：为当前分组绑定多维表格，并进行双向同步（同步到本地 / 同步到飞书）。
  2. 导入/导出模式：一次性从表格导入或导出到多维表格/Google Sheet。
• 自动同步：开启后，新增/编辑/删除记录会自动同步到飞书，避免手动重复操作。

前置条件

• 账号权限：同步功能需要PRO权限（若未登录或免费账号会提示升级）。
• 飞书凭据：在“设置 > 飞书多维表格授权”中填写
  • App ID、App Secret（用于获取 tenant_access_token）：https://open.feishu.cn/app
  • App Token（默认值，可在同步/导入导出弹窗中临时改）
• App Secret 仅保存在本地浏览器，不会上传服务器。

具体操作步骤：https://o0nxwynbb5p.feishu.cn/wiki/MMF7wDIKjisUkhkj9EOcYULFn0b

如何使用

启用飞书授权

1. 进入“设置”页面，找到“飞书多维表格授权”。
2. 打开“自动同步”开关。
3. 填写 App ID、App Secret、App Token。

分组绑定并同步（推荐）

适用：需要长期双向同步、保持记录与表格关联。

入口：

• 网站管理：右上角“更多”菜单 -> “飞书同步”
• 外链管理：右上角“更多”菜单 -> “飞书同步”

操作：

1. 在弹窗中输入 App Token（默认带出设置值）。

2. 点击“加载表格”，可选择已有表格；也可直接输入新表格名称。

3. 点击“同步到飞书”：

   • 若表格不存在会自动创建，并补齐所需字段。
   • 绑定当前分组到该表格。

4. 点击“同步到本地”：

   • 从飞书拉取数据并写入当前分组。
   • 若发现差异，会提示是否覆盖本地数据。

注意：

• 若要绑定已有表格，当前分组必须为空（否则会提示“只能在分组无数据时绑定已有数据表”）。
• 每个分组最多同步 1000 条记录。
• 绑定后会保存 record_id，用于后续更新/删除定位。

解绑：

• 在同步弹窗中点击“解绑”即可解除绑定，会清除该分组下所有记录的 record_id。

导入/导出（一次性）

适用：临时导入或导出，不绑定分组。

入口：

• 网站管理 -> 导入/导出 -> 飞书-多维表格/Google Sheet
• 外链管理 -> 导入/导出 -> 飞书-多维表格/Google Sheet

导入：

1. 输入 App Token，选择或输入表格名称。
2. 点击“从飞书导入”。
3. 系统会解析记录并写入当前分组。

导出：

1. 输入 App Token，选择或输入表格名称。
2. 点击“同步到飞书”（导出）。
3. 系统会把当前分组数据写入表格，并补齐所需字段。

自动同步行为

• 开启后：
  • 新增/编辑记录：自动创建或更新飞书记录。
  • 删除记录：自动删除飞书记录。
  • 记录迁移到其他分组：在新分组表中创建，并尝试删除旧表记录。
• 若飞书端记录已被删除，更新时会提示“是否新建一条？”。
• 若本地缺失 record_id，会提示立即同步以修复关联。

常见提示

• “请先在设置面板填写飞书 App ID 和 App Secret”：未配置飞书凭据。
• “请先填写多维表格 App Token”：未提供 App Token。
• “每个分组最多可同步 1000 条记录”：同步量超限。
• “只能在分组无数据时绑定已有数据表”：绑定已有表格但分组非空。