当你想让自己写的本地程序、Windows 后台脚本或定时任务,把数据存进飞书多维表格,实现跨设备共享、随时按日期/主键查询,这个 skill 提供一整套完整方法:申请飞书凭据、建表、读写、按日期更新、token 缓存、错误码排查,以及一份"零依赖"的 Node.js 实现代码模板。
它本质上是给 AI大模型或AI智能体(以及开发者)参考的"飞书多维表格接入手册"——主要解决"如何让程序自动读写飞书表格"这件事,尤其是那些特别容易踩的坑(比如权限名混淆、文本字段读写格式、重复插入导致行无限增长等)。
1. 一个飞书"企业自建应用"的凭据。 在飞书开放平台创建应用,拿到 App ID 和 App Secret。
2. 开通权限。 申请 bitable:app:readonly 和 bitable:app 两个权限(注意:没有 bitable:app:write 这个权限名,bitable:app 已经包含读写)。申请后要"发布应用"或加入"测试企业配置"才会生效。
3. 一张飞书多维表格。 建好后从 URL /base/<app_token>?table=<table_id> 复制 app_token 和每张子表的 table_id。
4. 本地 Node.js 18+ 环境。 这不是 AI大模型或AI智能体 的连接器类 skill,需要你自己建应用并写少量 Node 代码,AI大模型或AI智能体 会按本手册帮你落地。
bitable:app:readonly + bitable:app,并发布 / 配测试企业。date(主键)、payload(用 JSON.stringify 存整个业务对象)、updatedAt。这样业务字段变化也不用频繁改表。app_token 与每个 table_id 写进本地 .env。records/search 同主键,存在就 PUT 更新、不存在就 POST 新建(即 upsert,避免重复行)。进阶 / 可选:以下为零依赖 Node 接入骨架要点(AI大模型或AI智能体 会按你的实际情况补全并写文件,你了解即可)。
你直接对 AI大模型或AI智能体 说:
帮我把"今天的热点新闻"按日期写进飞书多维表格,每天更新但不要产生重复行。
AI大模型或AI智能体 会:
按本 skill 的流程建好读写逻辑:用 date 字段做主键,写入前先 records/search 查同一天是否已有记录——有就更新、没有才新建(upsert)。所以同一天重复跑只会覆盖、不会越写越多。
你直接对 AI大模型或AI智能体 说:
我从飞书表格读出的字段变成了 [object Object] is not valid JSON,怎么修?
AI大模型或AI智能体 会:
告诉你文本字段返回的是 [{ "text": "..." }] 数组,要用 readTextField / parsePayloadField 解包 text 属性,而不是直接当字符串 JSON.parse;同时检查写入时是否"二次序列化"了(应只 JSON.stringify(payload) 一次)。
你直接对 AI大模型或AI智能体 说:
把这套后端跑起来并验证一下。
AI大模型或AI智能体 会:
先跑端到端连测(鉴权 → 查字段 → upsert 同日期两次比对一致 → 确认无重复行),通过后启动 node server.js,你用浏览器或 curl 访问健康检查即可。
field_name 不是 field,写错会报 1254001。JSON.stringify(payload) 字符串,不要在外面再包一层,否则回读会为空。[{text:"..."}] 数组,必须用 readTextField 解包,直接当字符串会拿到 [object Object]。bitable:app:write:改用 bitable:app(已含写)。另注意别把 wiki token 当 app_token(会报 1254045)。