Feishu Bitable (多维表格) SKILL

🚨 执行前必读

• ✅ 创建数据表：支持两种模式, ① 明确需求时，在 create 时通过 table.fields 一次性定义字段（减少 API 调用）；② 探索式场景时，使用默认表 + 逐步修改字段（更稳定，易调整）
• ⚠️ 默认表的空行坑：app.create 自带的默认表中会有空记录（空行）！插入数据前建议先调用 feishu_bitable_app_table_record.list + batch_delete 删除空行，避免数据污染
• ✅ 写记录前：先调用 feishu_bitable_app_table_field.list 获取字段 type/ui_type
• ✅ 人员字段：默认 open_id（ou_...），值必须是 [{id:"ou_xxx"}]（数组对象）
• ✅ 日期字段：毫秒时间戳（例如 1674206443000），不是秒
• ✅ 单选字段：字符串（例如 "选项1"），不是数组
• ✅ 多选字段：字符串数组（例如 ["选项1", "选项2"]）
• ✅ 附件字段：必须先上传到当前多维表格，使用返回的 file_token
• ✅ 批量上限：单次 ≤ 500 条，超过需分批（批量操作是原子性的）
• ✅ 并发限制：同一数据表不支持并发写，需串行调用 + 延迟 0.5-1 秒

---

📋 快速索引：意图 → 工具 → 必填参数

用户意图	工具	action	必填参数	常用可选
查表有哪些字段	feishu_bitable_app_table_field	list	app_token, table_id	-
查记录	feishu_bitable_app_table_record	list	app_token, table_id	filter, sort, field_names
新增一行	feishu_bitable_app_table_record	create	app_token, table_id, fields	-
批量导入	feishu_bitable_app_table_record	batch_create	app_token, table_id, records (≤500)	-
更新一行	feishu_bitable_app_table_record	update	app_token, table_id, record_id, fields	-
批量更新	feishu_bitable_app_table_record	batch_update	app_token, table_id, records (≤500)	-
创建多维表格	feishu_bitable_app	create	name	folder_token
创建数据表	feishu_bitable_app_table	create	app_token, name	fields
创建字段	feishu_bitable_app_table_field	create	app_token, table_id, field_name, type	property
创建视图	feishu_bitable_app_table_view	create	app_token, table_id, view_name, view_type	-

---

🎯 核心约束（Schema 未透露的知识）

📚 详细参考文档

当遇到字段配置、记录值格式问题或需要完整示例时，查阅以下文档：