feishu-bitable

name	feishu-bitable
description	飞书多维表格管理。用于创建应用、查看表格、查询/新增/更新/删除记录（支持筛选）。当用户提到多维表格、数据表、结构化数据、查询/更新表格记录时触发。注意：普通电子表格（单元格操作）用 feishu-sheet，多维表格是带类型字段和视图的数据库。

Feishu Bitable

飞书多维表格（Base）的 CRUD 操作。查询记录、添加行、更新字段、管理表格。

与 feishu-sheet 的边界：Bitable 是有类型字段和视图的数据库（多维表格），feishu-sheet 是基于单元格的电子表格。数据库式操作用 Bitable，表格/报表式操作用 Sheet。

URL Parsing

从飞书 URL 提取参数：

https://xxx.feishu.cn/base/AbCdEfG123?table=tblXXX&view=vewYYY

• app_token = AbCdEfG123（路径 /base/ 后的 segment）
• table_id = tblXXX（query param table=，以 tbl 开头）
• view 参数可忽略，query 时可选传

CLI 调用方式

cd ~/Agent\ Space/agentic-feishu && python3 tools/builtin/skill_bitable.py <action> --params '<json>'

示例：

python3 tools/builtin/skill_bitable.py list_tables --params '{"app_token": "xxx"}'

Actions

调用方式：python3 tools/builtin/skill_bitable.py <action> --params '<json>'

• create — 创建 Bitable 应用。params: {name, folder_token?}。创建后自动调用 feishu_perm 将请求用户加为 full_access 协作者（失败不阻断）。
• list_tables — 列出应用中的所有表格。params: {app_token}。
• query — 查询记录。params: {app_token, table_id, filter_expr?, page_size?=20}。filter_expr 使用飞书公式语法（如 CurrentValue.[Status]="Done"），字段名区分大小写，page_size 默认 20，最大 500。
• add_record — 添加记录。params: {app_token, table_id, fields}。fields 为字段名到值的字典，字段名必须与表格定义完全一致（区分大小写）。
• update_record — 更新记录。params: {app_token, table_id, record_id, fields}。只传需要修改的字段。
• delete_record — 删除记录（不可逆）。params: {app_token, table_id, record_id}。

Field Value Formats

fields 字典中常见字段值格式：

字段类型	格式示例
文本	"field_name": "value"
数字	"field_name": 123
单选	"field_name": "option_name"
多选	"field_name": ["opt1", "opt2"]
日期	"field_name": 1709539200000（毫秒时间戳）
复选框	"field_name": true
人员	"field_name": [{"id": "ou_xxx"}]
超链接	"field_name": {"link": "https://...", "text": "label"}

Coded Behaviors

以下规则由代码保证：

• Auto-share on create：create 后自动调用 ensure_user_access（feishu_perm 集成），赋予请求用户 full_access，失败不阻断主流程。
• Query defaults：page_size 默认 20，最大 500。
• Field case-sensitive：filter_expr 中的字段名和 fields 字典的 key 均区分大小写，必须与表格列名完全一致。
• Bot 需要 bitable:app 权限 scope。

Params Examples

feishu_bitable("list_tables", {"app_token": "AbCdEfG123"})

feishu_bitable("query", {
    "app_token": "AbCdEfG123",
    "table_id": "tblXXX",
    "filter_expr": 'CurrentValue.[Status]="Done"',
    "page_size": 50
})

feishu_bitable("add_record", {
    "app_token": "AbCdEfG123",
    "table_id": "tblXXX",
    "fields": {"Name": "Test", "Status": "Todo"}
})