Feishu CLI 多维表格

Feishu CLI 多维表格模块是功能最丰富的领域，包含 60 个快捷命令，覆盖飞书多维表格（Base）的方方面面。所有命令使用 base 服务前缀，通过 Base v3 API 操作。

核心能力包括：

• 数据表增删改查 — 创建、列出、获取、更新和删除数据表，支持字段定义
• 记录管理 — 新增/更新、列出、查询、删除记录，支持附件上传
• 字段操作 — 创建带类型的字段，包括公式、查找引用、单选/多选及其选项
• 视图配置 — 15 个命令用于筛选、分组、排序、时间轴和卡片布局
• 数据查询 — 使用 JSON DSL 进行高级分析，支持聚合、筛选和分组
• 仪表盘 — 创建仪表盘及图表/指标块
• 工作流 — 创建、启用和禁用自动化工作流
• 表单 — 创建表单和管理表单问题
• 角色与权限 — 角色增删改查及高级权限开关

所有命令均支持用户和机器人身份。高风险操作（删除）支持 --dry-run 进行安全预览。

大多数多维表格命令共享以下通用引用参数。--base-token 几乎在所有操作中都是必需的，可从多维表格 URL 中提取。

在 Base 中创建、列出、获取、更新和删除数据表。创建数据表时支持内联定义字段和视图。

创建、读取、更新和删除记录。+record-upsert 命令会根据是否提供 --record-id 智能决定是创建还是更新记录。支持直接向附件字段上传文件。

创建、列出、获取、更新和删除字段。字段定义使用包含 field_name、type（数字编码）和可选 property（用于选项、公式和查找引用）的 JSON 对象。

创建、列出、重命名和删除视图。配置视图级别的筛选、分组、排序、时间轴和卡片布局。每个配置项都有专用的获取和设置命令。

使用 LiteQuery 协议查询和分析 Base 数据 — 这是一种支持维度、度量、聚合、筛选、排序和分组的 JSON DSL。DSL 中必须包含 dimensions 或 measures 至少其一。

创建和管理仪表盘，支持图表区块、指标区块和其他可视化组件。仪表盘提供 Base 数据的可视化概览。

在 Base 中创建和管理自动化工作流。工作流可以基于记录变更、时间条件或手动触发来执行操作。工作流定义以 JSON 格式传入，大型定义可使用 @path/to/file.json 语法从文件加载。

创建关联到 Base 数据表的表单并管理表单问题。表单提供用户友好的输入界面，用于向数据表收集记录。

创建和管理自定义角色以实现细粒度的访问控制。可在 Base 级别启用或禁用高级权限。启用高级权限后，访问控制通过角色而非简单共享来管理。

获取 Base 信息、创建新 Base 或复制已有 Base。

• 批量限制：记录操作每批最多 500 条记录。
• 附件大小：+record-upload-attachment 每个文件最大 20 MB。
• 知识库链接：如果您的 Base 位于知识库中，需要先使用 lark-cli wiki spaces get_node 解析知识库 token 以获取实际的 Base token。
• 试运行支持：高风险操作（删除命令）支持 --dry-run，可在执行前预览 API 调用。
• 字段引用：大多数命令的 --field-id 参数既接受字段 ID（fldXXX）也接受字段名称。
• 从文件加载 JSON：对于大型 JSON 负载，可使用 @path/to/file.json 语法替代内联 JSON 字符串。
• 公式/查找引用字段：创建公式或查找引用字段（类型 17、18）时，请先阅读字段指南并设置 --i-have-read-guide。