jingsongliujing/feishu-cli-web/lark-base

base

前置条件： 先阅读 `../lark-shared/SKILL.md`。

执行前必做： 执行任何 base 命令前，必须先阅读对应命令的 reference 文档，再调用命令。

命名约定： 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/...。

2. 模块与命令导航

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

2.1 模块地图

2.2 Base 模块

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

2.3 表与数据模块

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

2.3.1 Table 子模块

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

2.3.2 Field 子模块

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

2.3.3 Record 子模块

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

2.3.4 View 子模块

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

2.4 公式 / Lookup 模块

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

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

2.5 数据分析模块

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

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

• +data-query 只做聚合查询（分组、过滤、排序、聚合计算），不用于列出原始记录或逐条明细。
• 调用者必须是目标多维表格的管理员，拥有目标多维表格的 FA（Full Access / 完全访问权限），否则会返回权限错误。
• +data-query 只支持白名单字段类型；formula、lookup、附件、系统字段、关联等字段不能用于 dimensions / measures / filters / sort。

2.6 Workflow 模块

这是高约束模块。执行任何 workflow 命令前，都必须先读对应命令文档和 schema。 模块索引：`references/lark-base-workflow.md`