核心用法
飞书多维表格(Bitable)技能是飞书开放平台API的完整封装，提供CLI工具与程序化接口两种调用方式。核心能力覆盖三大模块：
数据表管理：创建/列表/获取/删除数据表，支持预定义字段结构初始化。通过--app-token定位目标多维表格，使用JSON格式描述字段配置，支持16种字段类型（文本、数字、单多选、人员、附件、公式等）。
记录操作：提供完整的单记录与批量操作API。create-record/update-record/delete-record处理单条数据；batch_create/batch_update/batch_delete支持单次100条记录的批量处理。查询支持filter过滤条件（字段名+运算符+值）、sort排序、分页参数，可实现复杂数据筛选。
视图与字段管理：支持读取视图列表与详情，动态增删改字段结构，适应 schema 演进需求。
显著优点
- 功能完整度：覆盖飞书Bitable全部核心API端点，非只读封装，支持生产级写操作
- 批量效率：原生支持批量CRUD，降低高频场景下的API调用次数
- 字段类型齐全：完整映射飞书16种字段类型，包括公式、创建人/时间等系统字段
- 错误处理完善：内置网络重试、权限验证、速率限制处理
潜在局限
- 凭证门槛：必须使用企业自建应用（
cli_xxx格式），个人用户无法直接使用 - 权限配置复杂：需申请
bitable:record:readonly和bitable:record:write权限，管理员审批流程较长 - 速率限制敏感：飞书API存在严格QPS限制，大规模数据迁移需自行实现退避逻辑
- 无实时同步：轮询模式，非Webhook实时推送
适合人群
企业IT管理员、飞书生态开发者、需要将内部系统与飞书多维表格打通的自动化工程师。典型场景包括：CRM/ERP数据双向同步、日报/周报自动生成、项目进度看板自动化更新、跨系统数据ETL管道。
常规风险
凭证泄露风险：FEISHU_APP_SECRET具有应用级权限，泄露可导致全量数据表被访问。建议使用FEISHU_APP_SECRET_PATH文件挂载方式，避免硬编码。误操作风险：批量delete无回收站保护，脚本执行前务必确认filter条件。数据一致性：高并发写入可能出现覆盖冲突，关键业务建议加锁或版本控制。