用途
本工作流用于对飞书多维表格（Base/Bitable）进行智能分析。它让 AI 能够读懂表结构、聚合分析数据、检测异常并生成洞察报告，从而释放沉淀在 Base 中的数据价值。当用户提出「帮我分析一下这个表」「这个多维表格有什么趋势」「给这个 Base 做个数据报告」「这个表里有没有异常数据」「帮我看看这个表的分布情况」「汇总一下这个表的关键指标」等需求时使用。
前置条件
支持 user 身份。执行前需确保已授权：
lark-cli auth login --domain base,doc
开始前必须先用 Read 工具读取 lark-shared/SKILL.md，其中包含认证、权限处理和安全规则。
主要能力
- 解析数据源：从 Base 链接中提取 base_token、table_id、view_id，或直接使用用户提供的 token。
- 获取表结构：通过 base +table-list 列出所有数据表，通过 base +field-list 获取目标表的字段结构，识别数值字段、日期字段、选项字段、人员字段、公式/查找字段等。
- 数据聚合分析：使用 base +data-query 进行聚合（sum、average、max/min、count、counta 等），支持 --filter 条件过滤和 --page-size 控制返回量；使用 base +record-list 获取记录样本；使用 base +record-search 按关键词搜索记录。
- AI 分析引擎：执行趋势分析（按日/周/月聚合、识别增长下降、计算环比同比）、分布分析（各选项值数量和占比、集中度）、异常检测（极端值 >3σ、缺失值比例、数据一致性检查）、关联分析（字段间相关性推断、交叉分组对比）。
- 生成结构化分析报告：包含数据概览、关键指标、分布分析、时间趋势、异常与问题、洞察与建议等部分。
- 可选写回文档：使用 docs +create 将报告写入飞书文档。
- 可选生成仪表盘：使用 base +dashboard-arrange 在 Base 仪表盘中添加 Markdown 文本块并自动排列。
使用方式
工作流按以下步骤执行：
- 解析数据源：从 Base 链接提取 base_token、table_id、view_id，或直接使用提供的 token；模糊描述时提示用户提供具体链接或 token。
- 获取表结构：
lark-cli base +table-list --base-token "<base_token>" --format json
lark-cli base +field-list --base-token "<base_token>" --table-id "<table_id>" --format json
- 数据聚合分析：
lark-cli base +data-query --base-token "<base_token>" --table-id "<table_id>" \
--field-names '["<字段1>","<字段2>"]' \
--group-by '["<分组字段>"]' \
--aggregations '[{"field_name":"<数值字段>","type":"sum"}]' \
--format json
获取记录样本：
lark-cli base +record-list --base-token "<base_token>" --table-id "<table_id>" \
--page-size 100 --format json
关键词搜索异常记录（v1.0.8+）：
lark-cli base +record-search --base-token "<base_token>" --table-id "<table_id>" \
--query "<关键词>" --format json
使用记录字段过滤（v1.0.8+）：
lark-cli base +record-list --base-token "<base_token>" --table-id "<table_id>" \
--filter '<过滤条件>' --page-size 100 --format json
- AI 分析引擎：基于表结构和聚合结果执行趋势分析、分布分析、异常检测、关联分析。
- 生成分析报告：输出包含数据概览、关键指标、分布分析、时间趋势、异常与问题、洞察与建议的结构化报告。
- 写回文档（可选）：
lark-cli docs +create --title "数据分析报告：{表名} (<date>)" --markdown "<报告内容>"
- 生成仪表盘（可选，v1.0.8+）：
lark-cli base +dashboard-arrange --base-token "<base_token>" \
--dashboard-id "<dashboard_id>" --format json
适用场景
- 分析多维表格数据、查看数据趋势。
- 生成 Base 数据报告、数据洞察。
- 检测表中异常数据。
- 查看表的分布情况、生成数据仪表盘。
- 汇总表的关键指标。
限制与容错
- 数据量控制：Base 单次最多返回 500 条记录。数据量大时使用 --page-token 分页获取，但分析场景通常用聚合查询（+data-query）更高效。
- JSON 输入校验（v1.0.11+）：Base 快捷命令会校验 JSON 输入并拒绝 null 对象。确保传入的 --filter、--aggregations 等 JSON 参数不是 null 而是有效的 JSON 对象或数组，空置时直接省略该参数。
- 表无数值字段：仅做分布分析和记录统计，不做趋势分析。
- 表无日期字段：跳过时间趋势分析，标注「无时间维度」。
- 表为空（0 条记录）：提示「该表暂无数据」。
- 字段类型无法聚合：跳过该字段，分析其他可聚合字段。
- base_token 无权限：提示用户检查 Base 分享权限。
权限表
| 步骤 | 命令 | 所需 scope | 是否必选 |
|---|---|---|---|
| 表结构 | base +table-list / +field-list | bitable:bitable:readonly | 必选 |
| 数据聚合 | base +data-query | bitable:bitable:readonly | 必选 |
| 记录列表 | base +record-list | bitable:bitable:readonly | 可选（逐行分析时） |
| 关键词搜索 | base +record-search | bitable:bitable:readonly | 可选（定位异常时） |
| 生成报告 | docs +create | docx:document:write | 可选（写回时） |
| 仪表盘排列 | base +dashboard-arrange | bitable:bitable | 可选（仪表盘时） |
参考
- lark-shared — 认证、权限（必读）
- lark-base — +field-list、+data-query、+record-list 详细用法
- lark-doc — +create 详细用法