Codex × 飞书 CLI：一句话处理多维表格
难度：🟡 进阶级
耗时：⏱️ 10 分钟
适用环境：Codex / Terminal / Antigravity
1. 场景价值与交付产物预览
企业运营和研发过程中，每天都有大量数据（Bug 工单、用户反馈、竞品动态、赞助商名单）需要手工录入飞书多维表格（Bitable）。通过集成 飞书官方或社区 CLI 工具，可以让 Agent 直接接收一段非结构化聊天记录或日志，自动清洗字段并直接调用飞书 OpenAPI 写入指定数据表。
- 输入：一段包含客户反馈或工单信息的纯文本。
- 输出成果：自动在飞书多维表格中新增一条格式规整的记录，并回传记录 ID。
2. 前置准备与环境配置
在飞书开放平台申请自建应用，并获取 App ID 与 App Secret：
bash
# 1. 安装飞书命令行工具 (feishu-cli 或 larksdk)
npm install -g @larksuiteoapi/node-sdk3. 核心配置文件 (开箱即用)
在项目根目录创建 .env.feishu（确保已加入 .gitignore 防止凭据泄露）：
dotenv
FEISHU_APP_ID=cli_a1b2c3d4e5f6
FEISHU_APP_SECRET=your_app_secret_here
FEISHU_BITABLE_APP_TOKEN=bascnAbCdEfGh123456
FEISHU_TABLE_ID=tblXYZ9876544. 黄金 Prompt 指令流
markdown
你是一名高效的企业运营协同助手。
请读取当前环境中的 `.env.feishu` 凭证，并将以下工单内容清洗并录入飞书多维表格：
【待录入原始信息】：
“今天下午 3 点客户 李先生（手机：13800000000）反馈支付成功后未自动收到激活码，系统返回状态为 PENDING，请人工核查处理。”
【处理要求】：
1. 提取结构化字段：
- 提交人：李先生
- 手机号：13800000000
- 问题类型：支付履约异常
- 紧急程度：高（红色）
- 详细描述：支付成功后未自动收到激活码，系统状态 PENDING
2. 调用飞书 Bitable API 执行新建记录；
3. 输出操作成功提示，并返回该条记录在飞书中的直接查看 URL。5. 排障与避坑指南 (Troubleshooting)
- 报错
99991663: App ticket is not ready：- 原因：新开通的应用需要先在飞书工作台启用，并在开放平台后台申请“多维表格读写权限 (bitable:app:read/write)”。
- 多选标签无法写入：
- 解法：多选字段在飞书 API 中必须以数组形式传入标签名称，且需确保标签已在表中预设。
6. 示例源码与产物资源
- 📁 飞书 SDK 脚本源码：
samples/feishu-bitable-sync.js - 💡 想要扩展飞书机器人通知？查阅 site-factory-tools 通知指南