feishu-bitable
飞书多维表格（Bitable）的创建、查询、编辑和管理工具。包含 27 种字段类型支持、高级筛选、批量操作和视图管理。 **当以下情况时使用此 Skill**： (1) 需要创建或管理飞书多维表格 App (2) 需要在多维表格中新增、查询、修改、删除记录（行数据） (3) 需要管理字段（列）、视图、数据表 (4) 用户提到"多维表格"、"bitable"、"数据表"、"记录"、"字段" (5) 需要批量导入数据或批量更新多维表格 --- # 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 未透露的知识） ### 📚 详细参考文档 **当遇到字段配置、记录值格式问题或需要完整示例时，查阅以下文档**： - **[字段 Property 配置详解](referenc