核心能力
feishu-bitable 是飞书官方生态的多维表格自动化操作技能，提供从 URL 解析到数据 CRUD 的完整工作流支持。
显著优势
1. 智能 URL 解析机制
- 自动识别
/wiki/知识库链接与/base/直链两种格式 - 内置
feishu_bitable_get_meta解析层，彻底解决 node_token 与 app_token 混淆问题 - 无需手动转换，降低 80% 以上的权限错误率
2. 全字段类型原生支持
- 覆盖 15+ 种字段类型：文本、数字、单选/多选、日期时间、复选框、人员、电话、链接、附件等
- 自动类型映射表，写入数据格式零猜测
- 特殊类型如 URL、人员字段提供结构化输入方式
3. 企业级操作完整性
- 读取：分页查询、字段元数据获取
- 写入：单条/批量记录创建、字段级更新
- 管理：新建表格应用、动态创建字段
潜在局限
- 权限依赖较重：需飞书开放平台后台开通
bitable:bitable等 scope，企业内网可能受限 - 附件字段只读：图片、文件等附件类型不支持直接写入，需配合飞书原生上传流程
- 速率限制未公开：官方 API 限流策略未文档化，大批量操作存在不确定性
- 企业租户绑定：数据隔离于具体飞书企业，跨组织协作需额外配置
适合人群
| 场景 | 典型用户 |
|------|---------|
| 自动化数据录入 | RPA 开发者、运营人员 |
| 轻量级业务系统 | 中小企业无代码搭建者 |
| 飞书生态深度用户 | 已使用飞书文档/审批的团队 |
| 结构化数据同步 | CRM/ERP 与飞书双向打通需求 |
常规风险提示
- Token 泄露风险：app_token 具备表级读写权限，避免硬编码或日志暴露
- 误删误改风险：更新/删除操作不可逆，建议生产环境配合数据备份策略
- 字段类型变更风险：修改字段类型可能导致历史数据格式不兼容
- 权限漂移风险：飞书管理员调整权限 scope 后可能导致 API 突然失效
最佳实践建议
1. 始终使用 feishu_bitable_get_meta 作为入口，禁止直接解析 URL 参数
2. 写入前先用 list_fields 校验字段名与类型，避免 131005 类错误
3. 批量操作建议分片 + 指数退避，应对隐形速率限制
4. 生产环境配置飞书 API 调用告警，监控 91402/99991672 等错误码