SuperAPI AI 工具集

feishu-cli-bitable

通用与其它

查看项目

更新于 10-15 16:43

技能介绍

用途:通过 feishu-cli bitable 命令操作飞书多维表格(Bitable/Base),底层使用 base/v3 新 API。字段 token 在 CLI 中只认 --base-token(--app-token 已删除),从多维表格 URL 的 /base/<token> 或 /bitable/<token> 片段获取。

主要能力:覆盖多维表格本体创建/获取/复制/重命名与高级权限开关;数据表、字段(含选项搜索)增删改查;记录 list/get/batch-get/search/upsert/批量增改删/共享链接/修改历史,附件上传下载(单次 ≤50)与移除;视图基础 CRUD 及过滤、排序、分组、可见字段、时间轴、卡片等配置读写;角色与协作者增删;advperm 高级权限开关;base 级 data-query 数据聚合;工作流;仪表盘与图表块 CRUD/排版;表单与表单问题 CRUD,并支持按 share-token 取详情与提交。

身份与认证:所有命令支持 --as bot|user|auto,默认 auto(User 优先、Tenant 兜底)。--as bot 走 App 凭证,无需登录,适合 cron 与无人值守;--as user 需先 auth login。App 凭证可通过环境变量 FEISHU_APP_ID、FEISHU_APP_SECRET 提供。

典型用法示例: feishu-cli bitable table list --base-token bscnxxxx --as bot feishu-cli bitable record upsert --base-token xxx --table-id tblxxx --config '{"fields":{"名称":"测试"}}' feishu-cli bitable data-query --base-token xxx --config '{"dimensions":[{"field_id":"fld_cat"}],"measures":[{"field_id":"fld_amt","type":"sum"}]}' 写命令多支持 --dry-run 预览、--format 与 --jq 输出控制。

限制:--as bot 报 91403 通常是 Bot 未被加入协作者,需先赋权;role member 所需 scope 为 bitable:app 等,不是 base:role;workflow 的 create/get/update/enable/disable 走私有扩展端点,公开 OpenAPI 仅文档化 list;dashboard block 的 --data-config 内部结构无本地校验,建议先 get 已有块作模板;update 类命令多为 PUT 全量替换;-upload 等部分命令参数与范围以资料所列为准,未提供的内容暂未提供。