用途:用 lark-cli base +... 原子命令操作飞书多维表格(Base,旧称 Bitable),包括建表与表结构管理、字段与记录读写、视图配置、公式与 lookup 派生字段、一次性聚合分析、工作流、仪表盘、表单以及高级权限和自定义角色管理。也支持把旧的 +table / +field / +record / +view / +history / +workspace 聚合式写法改写为当前原子命令。
前置与用法:先阅读 ../lark-shared/SKILL.md;执行任何 base 命令前必须阅读对应命令的 reference 文档再调用。Base 业务命令仅用 lark-cli base +...,不要改走 lark-cli api /open-apis/bitable/v1/...。Wiki 链接先用 lark-cli wiki spaces get_node 解析,取 node.obj_token 作为 --base-token。把本地 Excel/CSV 导入为多维表格的第一步是 lark-cli drive +import --type bitable,导入后再做表内操作。附件上传用 +record-upload-attachment,下载用 lark-cli docs +media-download --token <file_token> --output <path>。
限制与规则:先拿结构再写命令,表名、字段名、表达式引用必须精确匹配真实返回,跨表需读目标表结构。只写存储字段,系统、附件、formula、lookup 字段不可直接写入。一次性统计用 +data-query(调用者需为 Base 管理员并有完全访问权限,且仅支持白名单字段类型),明细与检索用 +record-list / +record-search / +record-get。多个 list 命令禁止并发,只能串行;+record-list 的 --limit 最大 200,批量写入单批建议不超过 500 条,串行写入并延迟 0.5–1 秒。workflow、dashboard、formula、lookup 场景需先读对应 guide 或 schema。删除操作在目标明确时可带 --yes 直接执行;+base-create / +base-copy 成功后需返回新 Base 标识信息。其余细节如具体参数与示例,资料未完整提供。