飞书 Bitable 接入 SOP · 3 步上线¶

版本: v0.6 · 2026-06-13 域名: open.feishu.cn (国内版 feishu.cn) 已就位: bitable_sync.py + auto_create_10_tables.py + .env 还差: 1 个 base + base_token

第 1 步 (3 min): 飞书新建空 base¶

飞书桌面端 → 「云文档」 → 「+ 新建」 → 「多维表格」
命名: 「ECC-三类业务生产管理」
不建任何表 (脚本自动建 10 张)

复制 URL, 形如:

https://xxxxx.feishu.cn/base/bascnAbCdEfGhIjKlMnOpQrStUv?table=...
                           ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
                           这就是 BASE_TOKEN (含 bascn 前缀)

第 2 步 (2 min): 自建应用加入 base 协作者¶

base 右上 → 「⋯」 → 「协作者」 → 「+ 添加」
搜索您的自建应用名 (App ID cli_aaacd23ee7799ce4)
权限选 「可编辑」 (查看权限会让建表失败)

搜不到? 先到飞书开发者后台「应用功能 → 多维表格」开启 Bitable 权限

第 3 步 (30 s): 写 .env + 一键真建 10 表¶

# 1. 写 base_token 到 .env
echo "LARK_BITABLE_BASE_TOKEN=bascnAbCdEfGhIjKlMnOpQrStUv" \
  >> ~/.claude/skills/ecc-shared/scripts/.env

# 2. 真建 10 表 (一次性)
python3 ~/.claude/skills/ecc-shared/scripts/auto_create_10_tables.py

# 3. 验证
python3 ~/.claude/skills/ecc-shared/scripts/bitable_sync.py --list-tables

# 4. 真 push 数据
python3 ~/.claude/skills/ecc-shared/scripts/bitable_sync.py \
  --csv ~/Downloads/bitable_benchmark.csv --table v06_P0红线

飞书自建应用必需 scope¶

飞书开发者后台 → 应用 → 「权限管理」:

✓ bitable:app                  多维表格 - 查看
✓ bitable:app:create           多维表格 - 创建 (建 base)
✓ table.records                多维表格 - 表记录全读写
✓ table.records:readonly       多维表格 - 表记录只读
✓ docs:doc                     云空间 - 查看
✓ contact:user.id:readonly     通讯录 - 用户 ID 只读

加完必须发布版本 (「版本管理 → 创建版本 → 提交审核」, 公司内通常秒通过)。

故障排查¶

报错	原因	修
`tenant access token invalid`	App Secret 错/轮换	重看后台
`app not in base collaborators`	第 2 步漏	加协作者
`permission denied` (建表)	缺 `bitable:app:create`	后台加 + 发布
`field type 18 requires existing table`	link 字段需先建关联表	当前脚本已避免 (10 表均简单字段)

v0.7 Base Automation Extension (in-base 自动化)¶

用户决策"两者结合": - OpenAPI (本套件): outbound (Python → 飞书) - Base Extension: in-base 触发 (按钮/字段变化 → webhook)

v0.7 计划: 1. base 内「触发 P0 整改」按钮 → 调 audit_3skill.py 2. 「自动同步进度」定时器 → 每天 9:00 跑 08_交付打包.py 3. base 内显示 KPI dashboard (替代本地 HTML)

参考: https://open.feishu.cn/document/base-extensions/base-automation-extension-development-guide

归属: ~/.claude/skills/ecc-shared/sop/06_飞书Bitable接入_3步上线.md v0.6 状态: 工具链就位, 等用户完成第 1-3 步即可真接通