---

name: lark-base version: 1.2.0 description: "当需要用 lark-cli 操作飞书多维表格（Base）时调用：搜索 Base、建表、字段管理、记录读写、记录分享链接、视图配置、历史查询，以及角色/表单/仪表盘管理/工作流；也适用于把旧的 +table / +field / +record 写法改成当前命令写法。涉及字段设计、公式字段、查找引用、跨表计算、行级派生指标、数据分析需求时也必须使用本 skill。" metadata: requires: bins: ["lark-cli"] cliHelp: "lark-cli base --help"

base

前置条件： 先阅读 ../lark-shared/SKILL.md。 执行前必做： 执行任何 base 命令前，必须先阅读对应命令的 reference 文档，再调用命令。 查询类任务必做： 涉及筛选、排序、Top/Bottom N、聚合、多表关联、查询后写入或判断全局结论时，必须先阅读 references/lark-base-data-analysis-sop.md，再选择 record / view / data-query 路径。 命名约定： Base 业务命令仅使用 lark-cli base +... 形式；如需先解析 Wiki 链接，可先调用 lark-cli wiki ...。 分流规则： 如果用户要“把本地文件导入成 Base / 多维表格 / bitable”，第一步不是 base，而是 lark-cli drive +import --type bitable；导入完成后再回到 lark-cli base +... 做表内操作。

1. 何时使用本 Skill

1.1 触发条件

以下场景应使用本 skill：

• 用户明确要操作飞书多维表格 / Base。
• 用户要建表、改表、查表、删表，或管理字段、记录、视图。
• 用户要做公式字段、lookup 字段、派生指标、跨表计算。
• 用户要做临时统计、聚合分析、比较排序、求最值。
• 用户要管理 workflow、dashboard、表单、角色权限。
• 用户给出 /base/{token} 链接。
• 用户给出 /wiki/{token} 链接，且最终解析为 bitable。
• 用户要把旧的 Base 聚合式写法改成当前原子命令写法，例如把旧 +table / +field / +record / +view / +history / +workspace 改写成当前命令。

以下场景不应使用本 skill：

• 用户只是做认证、初始化配置、切换 --as user/bot、处理 scope。此时先读 ../lark-shared/SKILL.md。
• 用户只是泛化地讨论“数据分析 / 字段设计”，但并不在 Base 场景中。不要因为提到“统计 / 公式 / lookup”就误触发。

1.2 前置约束

1. 先阅读 ../lark-shared/SKILL.md。
2. Base 业务命令仅使用 lark-cli base +... 形式的 shortcut 命令；如果输入是 Wiki 链接，可先调用 lark-cli wiki spaces get_node 解析真实 token。
3. 定位到命令后，先读该命令对应的 reference，再执行命令。
4. 如果用户要把本地 Excel / CSV / .base 快照导入成 Base / 多维表格 / bitable，第一步不是 base，而是 lark-cli drive +import --type bitable；导入完成后再回到 lark-cli base +... 做表内操作。
5. 不要在 Base 场景改走 lark-cli api /open-apis/bitable/v1/...。
6. 如果用户只给 Base 名称、关键词，或说“帮我找一个多维表格”，先通过 lark-cli docs +search --query <keyword> --filter '{"doc_types":["BITABLE"]}' 搜索 BITABLE 资源；拿到 Base URL 后再使用本 skill 的 base +... 命令。复杂搜索再读 ../lark-doc/references/lark-doc-search.md：标题精确匹配、限定创建者/群/文件夹/时间范围、只搜标题/评论、分页/全量搜索。

2. 模块与命令导航

本章按“先选模块，再选命令”的方式组织。先判断用户目标属于哪个大模块，再进入对应子模块，按要求阅读 reference 后执行命令。

2.1 模块地图

| 大模块 | 处理什么问题 | 包含的小模块 / 能力 | |------|-------------|-------------------| | Base 模块 | 管理 Base 本体，或从链接进入 Base 场景 | base-create / base-get / base-copy，Base / Wiki 链接解析 | | 表与数据模块 | 管理 Base 内部结构与日常数据操作 | table / field / record / view | | 公式 / Lookup 模块 | 处理派生字段、条件判断、跨表计算、固定查找引用 | formula / lookup 字段创建与更新 | | 数据分析模块 | 做一次性筛选、分组、聚合分析 | data-query | | Workflow 模块 | 管理自动化流程 | workflow-list / get / create / update / enable / disable | | Dashboard 模块 | 管理仪表盘和图表组件 | dashboard-* / dashboard-block-* | | 表单模块 | 管理表单和表单题目 | form-* / form-questions-* | | 权限与角色模块 | 管理高级权限和自定义角色 | advperm-* / role-* |

2.2 Base 模块

用于管理 Base 本体，或从用户给出的链接进入后续 Base 操作。
模块索引：references/lark-base-workspace.md

| 命令 | 用途 / 何时使用 | 必读 reference | 路由提醒 | |------|------------------|----------------|----------| | lark-cli docs +search --query <keyword> --filter '{"doc_types":["BITABLE"]}' | 按名称、关键词查找 Base / 多维表格 / bitable | 复杂搜索再读 ../lark-doc/references/lark-doc-search.md | 先定位资源，再回到 base +... 操作表内数据 | | +base-create | 创建新的 Base | lark-base-base-create.md、lark-base-workspace.md | 写入操作；执行前先读 reference；--folder-token、--time-zone 都是可选项 | | +base-get | 获取 Base 信息 | lark-base-base-get.md、lark-base-workspace.md | 适合确认 Base 本体信息，不替代表/字段结构读取 | | +base-copy | 复制已有 Base | lark-base-base-copy.md、lark-base-workspace.md | 写入操作；执行前先读 reference；复制成功后应主动返回新 Base 标识信息 |

2.3 表与数据模块

这是最常用的大模块，包含 table / field / record / view 四类子模块。
补充示例：references/examples.md，适合需要串联 table / record / view 完整操作链路时再读。

2.3.1 Table 子模块

子模块索引：references/lark-base-table.md

| 命令 | 用途 / 何时使用 | 必读 reference | 路由提醒 | |------|------------------|----------------|----------| | +table-list / +table-get | 列出数据表，或获取单个表详情 | lark-base-table-list.md、lark-base-table-get.md | +table-list 只能串行执行；+table-get 适合删除/修改前确认目标 | | +table-create / +table-update / +table-delete | 创建、更新或删除数据表 | lark-base-table-create.md、lark-base-table-update.md、lark-base-table-delete.md | 创建适合一次性建表；更新前先确认目标表；删除时用户已明确目标可直接执行并带 --yes |

2.3.2 Field 子模块

普通字段管理走这里；如果字段类型是 formula 或 lookup，转到下方“公式 / Lookup 模块”。
子模块索引：references/lark-base-field.md

| 命令 | 用途 / 何时使用 | 必读 reference | 路由提醒 | |------|------------------|----------------|----------| | +field-list / +field-get | 列出字段结构，或获取单个字段详情 | lark-base-field-list.md、lark-base-field-get.md | 写记录、写字段、做分析前常先读 +field-list；+field-list 只能串行执行；+field-get 适合删除/更新前确认目标 | | +field-create / +field-update / +field-delete | 创建、更新或删除普通字段 | lark-base-field-create.md、lark-base-field-update.md、lark-base-field-delete.md、lark-base-shortcut-field-properties.md | 写字段前先看字段属性规范；如果涉及类型转换，直接按 +field-update 中的字段类型变更规则执行，只在安全白名单内考虑原地转换；如果类型是 formula / lookup，先转去读对应 guide；删除时用户已明确目标可直接执行并带 --yes | | +field-search-options | 查询字段可选项 | lark-base-field-search-options.md | 适合单选/多选等选项型字段 |

2.3.3 Record 子模块

子模块索引：references/lark-base-record.md、references/lark-base-history.md

| 命令 | 用途 / 何时使用 | 必读 reference | 路由提醒 | |------|------------------|----------------|----------| | +record-search / +record-list / +record-get | 按关键词检索记录、读取记录明细 / 分页导出，或按 ID 获取一条或多条记录 | lark-base-data-analysis-sop.md | 记录读取统一先读 data analysis SOP：已知 record_id 用 +record-get；明确关键词用 +record-search；普通明细用 +record-list；明确筛选 / 排序 / Top N 用临时视图投影后 +record-list --view-id；统计聚合才分流到 +data-query；+record-get 支持重复 --record-id 或 --json 读取多条记录 | | +record-upsert / +record-batch-create / +record-batch-update | 创建、更新或批量写入记录 | lark-base-record-upsert.md、lark-base-record-batch-create.md、lark-base-record-batch-update.md、lark-base-cell-value.md | 写前先 +field-list；只写存储字段；+record-batch-update 为同值更新（同一 patch 应用到多条记录）；批量单次不超过 200 条；附件不要走这里 | | +record-upload-attachment | 给已有记录上传附件 | lark-base-record-upload-attachment.md | 附件上传专用链路，不要用 +record-upsert / +record-batch-* 伪造附件值 | | lark-cli docs +media-download | 下载 Base 附件文件到本地 | ../lark-doc/references/lark-doc-media-download.md | Base 附件的 file_token 从 +record-get 返回的附件字段数组里取；不要用 lark-cli drive +download（对 Base 附件返回 403） | | +record-delete | 删除一条或多条记录 | lark-base-record-delete.md | 删除多条时重复传 --record-id 指定多个记录；用户已明确目标可直接执行并带 --yes | | +record-history-list | 查询指定记录的变更历史 | lark-base-record-history-list.md | 按 table-id + record-id 查询，不支持整表扫描；+record-history-list 只能串行执行 | | +record-share-link-create | 为一条或多条记录生成分享链接 | lark-base-record-share-link-create.md | 单次最多 100 条；重复 record_id 会自动去重；适合分享单条记录或批量分享场景 |

2.3.4 View 子模块

子模块索引：references/lark-base-view.md

| 命令 | 用途 / 何时使用 | 必读 reference | 路由提醒 | |------|------------------|----------------|----------| | +view-list / +view-get | 列出视图，或获取视图详情 | lark-base-view-list.md、lark-base-view-get.md | +view-list 只能串行执行；+view-get 适合查看已有视图配置 | | +view-create / +view-delete / +view-rename | 创建、删除或重命名视图 | lark-base-view-create.md、lark-base-view-delete.md、lark-base-view-rename.md | 创建前先确认表和视图类型；删除前先确认目标；用户已明确新名字时可直接重命名 | | +view-get-filter / +view-set-filter | 读取或配置筛选条件 | lark-base-view-get-filter.md、lark-base-view-set-filter.md、lark-base-data-analysis-sop.md | 常与 +record-list 组合，用于按视图筛选读取 | | +view-get-sort / +view-set-sort | 读取或配置排序 | lark-base-view-get-sort.md、lark-base-view-set-sort.md | 字段名必须来自真实结构 | | +view-get-group / +view-set-group | 读取或配置分组 | lark-base-view-get-group.md、lark-base-view-set-group.md | 字段名必须来自真实结构 | | +view-get-visible-fields / +view-set-visible-fields | 读取或配置视图可见字段 | lark-base-view-get-visible-fields.md、lark-base-view-set-visible-fields.md | 用于控制视图中的字段顺序与可见性；字段名必须来自真实结构 | | +view-get-card / +view-set-card | 读取或配置卡片视图 | lark-base-view-get-card.md、lark-base-view-set-card.md | 适合卡片展示场景 | | +view-get-timebar / +view-set-timebar | 读取或配置时间轴视图 | lark-base-view-get-timebar.md、lark-base-view-set-timebar.md | 适合时间线展示场景 |

2.4 公式 / Lookup 模块

只要用户诉求涉及派生指标、条件判断、文本处理、日期差、跨表计算、跨表筛选后取值，都要先判断是否进入本模块。

默认优先考虑 formula：适合常规计算、条件判断、文本处理、日期差、跨表聚合，以及需要长期显示在表里的派生结果。
只有当用户明确要求 lookup，或场景天然符合 from / select / where / aggregate 这种固定查找建模时，再使用 lookup。

| 命令 | 用途 / 何时使用 | 必读 reference | 路由提醒 | |------|------------------|----------------|----------| | +field-create（type=formula） | 创建公式字段 | formula-field-guide.md、lark-base-field-create.md、lark-base-shortcut-field-properties.md | 没读 guide 前不要直接创建 | | +field-update（type=formula） | 更新公式字段 | formula-field-guide.md、lark-base-field-update.md、lark-base-shortcut-field-properties.md | 先拿当前表结构 | | +field-create（type=lookup） | 创建 lookup 字段 | lookup-field-guide.md、lark-base-field-create.md、lark-base-shortcut-field-properties.md | 没读 guide 前不要直接创建 | | +field-update（type=lookup） | 更新 lookup 字段 | lookup-field-guide.md、lark-base-field-update.md、lark-base-shortcut-field-properties.md | 跨表时还要拿目标表结构 |

2.5 数据分析模块

用于一次性分析和临时聚合查询。用户要的是“这次算出来的结果”，而不是把结果沉淀成字段时，优先进入本模块。

进入本模块前先确认几件事：

• +data-query 只做聚合查询（分组、过滤、排序、聚合计算），不用于列出原始记录或逐条明细。
• 调用者必须是目标多维表格的管理员，拥有目标多维表格的 FA（Full Access / 完全访问权限），否则会返回权限错误。
• `