飞书多维表自动化

这个技能解决什么问题

飞书多维表很适合当轻量 CRM：记录状态一改，就该触发后续动作。但把表格和 AI 后端接起来并不顺：飞书应用权限是版本制的，加了 scope 不发布新版本就不生效；写了表还不行，应用必须被加为多维表协作人（可编辑），这是和 scope 独立的第二层门。联调时又常撞上 401、99991672、91403、空请求体、超时、ByteString 报错。这个技能把一条已真实跑通的链路固化下来，让新会话能照着搭闭环或直接查表排错。

它如何工作

核心闭环是：多维表某行状态变更 → 自动化“调用网页”POST 到你的后端 → DeepSeek 生成跟进话术 → 回写字段（可选再给负责人发私信）。skill 内含两份可直接读的参考：references/runbook.md 走 7 步联调，references/troubleshooting.md 是按出现频率排的 10 个真实坑速查。

7 步大致是：先本地验证接口逻辑；在飞书开放平台建企业自建应用拿 app_id / app_secret；开 bitable:app 与 im:message 权限并发布新版本；建多维表、设计字段，从 URL 摘出 appToken / tableId；部署到 Vercel 并配 FEISHU_* 环境变量；在表里配触发器（“当记录更新” + “调用网页”POST）；真联调并看日志对齐字段。

边界与注意点

• 飞书 URL 里的 secret= 必须和后端 FEISHU_AUTOMATION_SECRET 完全一致，否则直接 401。
• DEEPSEEK_API_KEY 要纯 ASCII、sk- 开头；混入中文或全角字符会触发 ByteString 类报错。
• 飞书自动化要求约 3 秒内返回 ack；联调期可在 URL 加 &sync=1，让错误直接打回终端便于定位。
• *.vercel.app 免费域名在国内可能被墙；飞书服务器连不上时，用 cpolar 内网穿透暴露本地 dev 是可行绕法。

适合已经会写后端、想把多维表当触发源的工程师；它不是填表机器人，而是把一套容易踩坑的飞书事件与权限流程整理成可复用的操作手册。