必须完成授权配置、ID提取、连接建立和字段映射四步闭环操作：创建飞书自建应用并开通bitable:app:read/write及bitable:record:read/write权限，发布应用；准确提取base格式多维表格ID；在扣子工作流中配置get_records和add_records插件，严格匹配表名与英文字段标识；通过代码执行节点处理数据后，用add_records按唯一主键字段更新记录。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让扣子智能体自动读取飞书多维表格数据并实时写入新记录，必须完成授权配置、ID提取、连接建立和字段映射四步闭环操作，缺一不可。
创建飞书自建应用并开通必要权限
这一步绕不过去：没有合法应用凭证，扣子根本无法调用飞书API。
打开飞书开放平台（https://open.feishu.cn/）→点击“创建企业自建应用”→填写名称与描述→进入应用详情页。
在“凭证与基础信息”板块，【务必复制App ID和App Secret并妥善保存】，后续在扣子插件中必须精确粘贴，字母大小写和符号都不能错。
左侧菜单进入“权限管理”，搜索并勾选以下四项权限：
bitable:app:read
bitable:app:write
bitable:record:read
bitable:record:write
最后点击“版本管理与发布”→发布应用。注意：未发布的应用在扣子中测试会直接报403错误，且该操作仅对企业版飞书账号开放，个人账号无此入口。
准确获取多维表格Base ID
飞书多维表格ID不是随便复制URL就能用的——必须从正确路径生成的表格中提取base格式ID。
方法一：从飞书云盘新建表格
飞书云盘 → 我的文件夹 → 新建 → 多维表格 → 创建成功后，浏览器地址栏显示形如 https://xxxx.feishu.cn/base/abc123def456ghi 的链接 → 复制斜杠后那一串字符（即 abc123def456ghi）。
方法二：从已有表格提取
打开目标多维表格 → 点击右上角「…」→「分享」→「复制链接」→ 粘贴到记事本 → 找到 base/ 后面的字符串 → 删除末尾可能存在的参数（如 ?table=xxx），只保留纯ID。
【切勿使用wiki/开头的ID做扣子写入操作】，部分插件对wiki ID支持不稳定，会导致add_records失败但无明确报错。
在扣子工作流中接入飞书多维表格
登录扣子（https://www.coze.cn/）→进入工作流编辑页→点击「插件」→搜索“飞书多维表格”→添加三个核心插件：
① create_base（可选，用于首次自动建表）
② get_records（读取指定视图全部或筛选记录）
③ add_records（向指定数据表批量写入）
配置get_records插件：
填写Base ID（上一步获取的）→选择目标数据表名（下拉列表需手动刷新才显示）→设置视图ID（若不填则默认读取第一个视图）→字段过滤可留空或填入“status=active”类条件。
配置add_records插件：
Base ID与get_records一致→表名必须完全匹配（区分大小写）→records字段填入JSON数组，每项结构须与目标表字段严格对应，例如：
{"fields":{"标题":"AI日报","作者":"张三","阅读量":1280}}
关键提醒：add_records中字段名必须是飞书后台定义的英文字段标识（field_id），不是你在表格里看到的中文列名。进飞书多维表格设置 → 编辑字段 → 点击字段右侧「…」→「复制字段ID」才能拿到真实标识。
实现双向联动的数据映射逻辑
单向读或写只是搬运，双向联动的核心在于用扣子处理数据后，把结果精准回填到原记录的指定字段。
第一步：用get_records读出原始数据，输出为变量 records_list。
第二步：拖入「代码执行」节点（Python），对 records_list 中每条记录做处理，例如清洗文本、计算得分、调用大模型改写标题等，输出加工后的字典列表 processed_data。
第三步：将 processed_data 连接到 add_records 插件 → 在 records 字段绑定该变量 → 同时在「更新模式」中选择「按记录ID更新」→ 勾选「启用更新」→ 在「主键字段」填入飞书表中已有的唯一标识字段名（如 record_id 或 自增ID字段英文名）。
这一步必须填对主键字段名，否则add_records会当成新增记录插入重复数据。可在飞书多维表格字段设置里确认该字段是否开启「唯一性」并复制其英文ID。
