飞书多维表格（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 配置详解](references/field properties.md) 每种字段类型创建/更新时需要的 property 参数结构（单选的 options、进度的 min/max、关联的 table id 等） [记录值数据结构详解](references/record values.md) 每种字段类型在记录中对应的 fields 值格式（人员字段只传 id、日期是毫秒时间戳、附件需先上传等） [使用场景完整示例](references/examples.md) 8 个完整场景示例（创建表模式对比、批量导入、筛选查询、附件处理、关联字段等）何时查阅 : 创建/更新字段时收到 125408X 错误码（property 结构错误）→ 查 field properties.md 写入记录时收到 125406X 错误码（字段值转换失败）→ 查 record values.md 需要完整的操作流程和参数示例 → 查 examples.md 1. 字段类型与值格式必须严格匹配 Bitable 最大的坑：不同字段类型对 value 的数据结构要求完全不同。最易错的字段类型（完整列表见 [record values.md](references/record values.md)） type ui type 字段类型正确格式 ❌ 常见错误 11 User 人员 [{id: "ou xxx"}] 传字符串 "ou xxx" 或 [{name: "张三"}] 5 DateTime 日期 1674206443000 （毫秒）传秒时间戳或字符串 3 SingleSelect 单选 "选项名" 传数组 ["选项名"] 4 MultiSelect 多选 ["选项1", "选项2"] 传字符串 "选项1" 15 Url 超链接 {link: "...", text: "..."} 只传字符串 URL 17 Attachment 附件 [{file token: "..."}] 传外部 URL 或本地路径强制流程： 1. 先调用 feishu bitable app table field.list 获取字段的 type 和 ui type 2. 根据上表或 [record values.md](references/record values.md) 构造正确格式 3. 错误码 125406X 或 1254015 → 检查字段值格式人员字段特别注意：默认使用 open id（ou ...），与 calendar/task 一致格式： [{id: "ou xxx"}] （数组对象）只能传 id 字段，不能传 name/email 等 📌 核心使用场景完整示例 : 查阅 [examples.md](references/examples.md) 了解更多场景（创建表模式对比、空行处理、附件上传、关联字段等）场景 1: 查字段类型（必做第一步）返回：包含每个字段的 field id 、 field name 、 type 、 ui type 、 property 场景 2: 批量导入客户数据字段值格式：人员： [{id: "ou xxx"}] （数组对象）日期：毫秒时间戳单选：字符串多选：字符串数组限制 : 最多 500 条记录场景 3: 筛选查询（高级筛选） filter 说明：支持 10 种 operator（is/isNot/contains/isEmpty 等，见附录 C） ⚠️ isEmpty/isNotEmpty 必须传 value: [] （虽然逻辑上不需要值，但 API 要求必须传空数组）日期筛选可使用 ["Today"] 、 ["ExactDate", "时间戳"] 等 sort 可指定多个排序字段 🔍 常见错误与排查错误码错误现象根本原因解决方案 1254064 DatetimeFieldConvFail 日期字段格式错误必须用毫秒时间戳（如 1772121600000 ），不能用字符串（ "2026 02 27" 、RFC3339）或秒级时间戳 1254068 URLFieldConvFail 超链接字段格式错误必须用对象 {text: "显示文本", link: "URL"} ，不能直接传字符串 URL 1254066 UserFieldConvFail 人员字段格式错误或 ID 类型不匹配必须传 [{id: "ou xxx"}] ，确认 user id type 1254015 Field types do not match 字段值格式与类型不匹配先 list 字段，按类型构造正确格式 1254104 RecordAddOnceExceedLimit 批量创建超过 500 条分批调用，每批 ≤ 500 1254291 Write conflict 并发写冲突串行调用 + 延迟 0.5 1 秒 1254303 AttachPermNotAllow 附件未上传到当前表格先调用上传素材接口 1254045 FieldNameNotFound 字段名不存在检查字段名（包括空格、大小写） 📚 附录：背景知识 A. 资源层级关系 B. 筛选条件 operator 列表 operator 含义支持字段 value 要求 is 等于所有单个值 isNot 不等于除日期外单个值 contains 包含除日期外可多个值 doesNotContain 不包含除日期外可多个值 isEmpty 为空所有必须为 [] isNotEmpty 不为空所有必须为 [] isGreater 大于数字、日期单个值 isGreaterEqual 大于等于数字（不支持日期）单个值 isLess 小于数字、日期单个值 isLessEqual 小于等于数字（不支持日期）单个值日期字段特殊值 : ["Today"] , ["Tomorrow"] , ["ExactDate", "时间戳"] 等（完整列表见 [examples.md](references/examples.md 场景 3 筛选查询高级筛选)） C. 使用限制限制项上限数据表 + 仪表盘 100（单个 App）记录数 20,000（单个数据表）字段数 300（单个数据表）视图数 200（单个数据表）批量创建/更新/删除 500（单次 API 调用）单元格文本 10 万字符单选/多选选项 20,000（单个字段）单元格附件 100 单元格人员 1,000 D. 其他约束从其他数据源同步的数据表，不支持增删改记录公式字段、查看引用字段是只读的删除操作无法恢复视图筛选条件使用 field id ，需先调用 field.list 获取

feishu-bitable