lark-base

Name: lark-base
Author: larksuite

382kinstalls1.1kforks

How to install lark-base?

larksuite/cli/lark-base

$npx -y skills add larksuite/cli --skill lark-base

Installs into the current project.

Summary

飞书多维表格（Base）操作：建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、workflow、角色权限；遇到 Base/多维表格/bitable 或 /base/ 链接时使用。文件导入转 lark-drive，认证/授权转 lark-shared。

Files · 1

View on GitHub

SKILL.md

1	# base
2
3	## 何时使用
4
5	使用本 skill：
6
7	- 用户明确提到 Base / 多维表格 / bitable，或给出 `/base/` 链接。
8	- 用户要在 Base 内建表、改表、管理字段、写记录、查记录、配视图。
9	- 用户要在 Base 内做公式字段、lookup 字段、跨表计算、派生指标、筛选聚合、TopN、统计分析。
10	- 用户要管理 Base 表单、仪表盘、workflow、高级权限或角色。
11	- 用户要把旧 Base 聚合式命令或旧写法迁移到当前 `lark-cli base +...` shortcut。
12
13	不要使用本 skill：
14
15	- 只是认证、初始化配置、切换身份、处理 scope 或权限授权恢复，转 `lark-shared`。
16	- 把本地 Excel / CSV / `.base` 导入成 Base，转 `lark-drive +import --type bitable`。
17	- 泛化数据分析、字段设计、公式讨论，但没有 Base/多维表格上下文。
18
19	## 使用边界
20
21	- Base 业务操作只使用 `lark-cli base +...` shortcut，不使用旧聚合式 `+table / +field / +record / +view / +history / +workspace`。
22	- 本轮 Base 不依赖 `lark-cli schema`。SKILL 只保留路由、风险和复杂 JSON/DSL；简单命令由命令自身的参数、tips 和错误恢复承接。
23	- 用户要把 Excel / CSV / `.base` 导入成 Base 时，先转 `lark-cli drive +import --type bitable`，导入完成后再回到 Base 命令。
24	- 认证、初始化、scope、身份切换、权限不足恢复属于 `lark-shared`；Base 文档只保留会影响 Base 路径选择的权限规则。
25
26	## 先获取 Base Token 和所需 ID
27
28	进入任何需要目标 Base 的 shortcut 前，必须先拿到可用的 `base_token`，以及当前任务需要的 `table_id` / `view_id` / `record_id` / `form_id` / `dashboard_id` / `workflow_id` 等真实 ID；不要把完整 URL、wiki token、workspace token 或孤立 raw token 直接当作 `--base-token`。
29
30	- 用户输入 URL 或分享链接：先运行 `lark-cli base +url-resolve --url "<url>" --as user`，用返回的 `base_token` 和相关 ID 继续后续命令。
31	- 用户输入 Base 标题、关键词或不确定名称：先运行 `lark-cli base +title-resolve --title "<keyword>" --as user`；`--title` 传入标题中的短关键词，不超过 30 个字符；过长标题先取最有区分度的短关键词；多候选时先让用户消歧，不要猜。
32	- 文档嵌入 Base 标签：直接读取 `<bitable>` / `<base_refer>` 的 `token` 作为 `--base-token`，`table-id` 作为 `--table-id`，`view-id` 作为 `--view-id`；孤立 raw token 不走 `+url-resolve`。
33	- 仍无法定位且用户不是要新建 Base 时，先反问用户要操作哪一个 Base；用户要新建时才用 `+base-create`。
34
35	## 快速路由
36
37	\| 用户目标 \| 优先命令 \| 何时读 reference \|
38	\|---\|---\|---\|
39	\| 查 Base 本体 \| `+base-get` \| 用返回确认 Base 名称、owner、权限和可继续操作的 token \|
40	\| 创建/复制 Base \| `+base-create` / `+base-copy` \| 新建时强烈推荐用 `--table-name` + `--fields` 同时配置新 Base 里唯一一个初始数据表的 name 和 schema；写入后报告新 Base 标识和 `permission_grant` \|
41	\| 查看 Base 内资源目录 \| `+base-block-list` \| 想先了解一个 Base 里有哪些 table/docx/dashboard/workflow/folder 时优先用它；返回 ID 关系和 fewshot 看 `--help` \|
42	\| 管理 Base 内资源目录 \| `+base-block-create/move/rename/delete` \| 创建或整理 Base 直接管理的 folder/table/docx/dashboard/workflow；资源内容继续用对应命令 \|
43	\| 管理数据表 \| `+table-list/get/create/update/delete` \| 处理 table 的列出、详情、创建、重命名和删除 \|
44	\| 列/查/删字段 \| `+field-list/get/delete/search-options` \| 写入前用 list/get 确认字段类型、选项、ID；删除前确认目标字段 \|
45	\| 创建/更新字段 \| `+field-create` / `+field-update` \| 必读 [lark-base-field-json.md](references/lark-base-field-json.md)；公式读 [formula-field-guide.md](references/formula-field-guide.md)；lookup 读 [lookup-field-guide.md](references/lookup-field-guide.md)；命令细节读 [lark-base-field-create.md](references/lark-base-field-create.md) / [lark-base-field-update.md](references/lark-base-field-update.md) \|
46	\| 读记录明细 \| `+record-get` / `+record-list` / `+record-search` \| 涉及筛选、排序、Top/Bottom N、聚合、多表关联、全局结论时读 [lark-base-data-analysis-sop.md](references/lark-base-data-analysis-sop.md) \|
47	\| 写记录 \| `+record-upsert` / `+record-batch-create` / `+record-batch-update` \| 必读 [lark-base-record-upsert.md](references/lark-base-record-upsert.md) / [lark-base-record-batch-create.md](references/lark-base-record-batch-create.md) / [lark-base-record-batch-update.md](references/lark-base-record-batch-update.md) 和 [lark-base-cell-value.md](references/lark-base-cell-value.md) \|
48	\| 附件字段 \| `+record-upload-attachment` / `+record-download-attachment` / `+record-remove-attachment` \| 附件不要伪造成普通 CellValue；上传走本地文件，下载/删除按 file token 或字段定位 \|
49	\| 删除记录 / 分享记录链接 / 历史 \| `+record-delete` / `+record-share-link-create` / `+record-history-list` \| 删除前确认 record；分享链接最多 100 条；历史读 [lark-base-record-history-list.md](references/lark-base-record-history-list.md)，只查单条记录，不做整表审计 \|
50	\| 管理视图 \| `+view-*` \| `+view-set-filter` 读 [lark-base-view-set-filter.md](references/lark-base-view-set-filter.md)；其余配置先 get 现状，再按返回结构更新 \|
51	\| 一次性聚合统计 \| `+data-query` \| 必读 [lark-base-data-analysis-sop.md](references/lark-base-data-analysis-sop.md) 和入口 [lark-base-data-query-guide.md](references/lark-base-data-query-guide.md)；完整 DSL 再读 [lark-base-data-query.md](references/lark-base-data-query.md) \|
52	\| 公式字段 \| `+field-create/update --json '{"type":"formula",...}'` \| 必读 [formula-field-guide.md](references/formula-field-guide.md)，读后再加隐藏确认 flag `--i-have-read-guide` \|
53	\| Lookup 字段 \| `+field-create/update --json '{"type":"lookup",...}'` \| 必读 [lookup-field-guide.md](references/lookup-field-guide.md)，读后再加隐藏确认 flag `--i-have-read-guide` \|
54	\| 表单提交 \| `+form-submit` \| 先读 [lark-base-form-detail.md](references/lark-base-form-detail.md) 获取题目、filter 和附件所需 `base_token`；提交 JSON 读 [lark-base-form-submit.md](references/lark-base-form-submit.md) \|
55	\| 表单题目创建/更新 \| `+form-questions-create` / `+form-questions-update` \| 读 [lark-base-form-questions-create.md](references/lark-base-form-questions-create.md) / [lark-base-form-questions-update.md](references/l

People who liked this also viewed

6 picks

Type

lark-base

382kinstalls1.1kforks

View on GitHub

How to install lark-base?

larksuite/cli/lark-base

$npx -y skills add larksuite/cli --skill lark-base

Installs into the current project.

Summary

Files · 1

View on GitHub

SKILL.md

1	# base
2
3	## 何时使用
4
5	使用本 skill：
6
7	- 用户明确提到 Base / 多维表格 / bitable，或给出 `/base/` 链接。
8	- 用户要在 Base 内建表、改表、管理字段、写记录、查记录、配视图。
9	- 用户要在 Base 内做公式字段、lookup 字段、跨表计算、派生指标、筛选聚合、TopN、统计分析。
10	- 用户要管理 Base 表单、仪表盘、workflow、高级权限或角色。
11	- 用户要把旧 Base 聚合式命令或旧写法迁移到当前 `lark-cli base +...` shortcut。
12
13	不要使用本 skill：
14
15	- 只是认证、初始化配置、切换身份、处理 scope 或权限授权恢复，转 `lark-shared`。
16	- 把本地 Excel / CSV / `.base` 导入成 Base，转 `lark-drive +import --type bitable`。
17	- 泛化数据分析、字段设计、公式讨论，但没有 Base/多维表格上下文。
18
19	## 使用边界
20
21	- Base 业务操作只使用 `lark-cli base +...` shortcut，不使用旧聚合式 `+table / +field / +record / +view / +history / +workspace`。
22	- 本轮 Base 不依赖 `lark-cli schema`。SKILL 只保留路由、风险和复杂 JSON/DSL；简单命令由命令自身的参数、tips 和错误恢复承接。
23	- 用户要把 Excel / CSV / `.base` 导入成 Base 时，先转 `lark-cli drive +import --type bitable`，导入完成后再回到 Base 命令。
24	- 认证、初始化、scope、身份切换、权限不足恢复属于 `lark-shared`；Base 文档只保留会影响 Base 路径选择的权限规则。
25
26	## 先获取 Base Token 和所需 ID
27
28	进入任何需要目标 Base 的 shortcut 前，必须先拿到可用的 `base_token`，以及当前任务需要的 `table_id` / `view_id` / `record_id` / `form_id` / `dashboard_id` / `workflow_id` 等真实 ID；不要把完整 URL、wiki token、workspace token 或孤立 raw token 直接当作 `--base-token`。
29
30	- 用户输入 URL 或分享链接：先运行 `lark-cli base +url-resolve --url "<url>" --as user`，用返回的 `base_token` 和相关 ID 继续后续命令。
31	- 用户输入 Base 标题、关键词或不确定名称：先运行 `lark-cli base +title-resolve --title "<keyword>" --as user`；`--title` 传入标题中的短关键词，不超过 30 个字符；过长标题先取最有区分度的短关键词；多候选时先让用户消歧，不要猜。
32	- 文档嵌入 Base 标签：直接读取 `<bitable>` / `<base_refer>` 的 `token` 作为 `--base-token`，`table-id` 作为 `--table-id`，`view-id` 作为 `--view-id`；孤立 raw token 不走 `+url-resolve`。
33	- 仍无法定位且用户不是要新建 Base 时，先反问用户要操作哪一个 Base；用户要新建时才用 `+base-create`。
34
35	## 快速路由
36
37	\| 用户目标 \| 优先命令 \| 何时读 reference \|
38	\|---\|---\|---\|
39	\| 查 Base 本体 \| `+base-get` \| 用返回确认 Base 名称、owner、权限和可继续操作的 token \|
40	\| 创建/复制 Base \| `+base-create` / `+base-copy` \| 新建时强烈推荐用 `--table-name` + `--fields` 同时配置新 Base 里唯一一个初始数据表的 name 和 schema；写入后报告新 Base 标识和 `permission_grant` \|
41	\| 查看 Base 内资源目录 \| `+base-block-list` \| 想先了解一个 Base 里有哪些 table/docx/dashboard/workflow/folder 时优先用它；返回 ID 关系和 fewshot 看 `--help` \|
42	\| 管理 Base 内资源目录 \| `+base-block-create/move/rename/delete` \| 创建或整理 Base 直接管理的 folder/table/docx/dashboard/workflow；资源内容继续用对应命令 \|
43	\| 管理数据表 \| `+table-list/get/create/update/delete` \| 处理 table 的列出、详情、创建、重命名和删除 \|
44	\| 列/查/删字段 \| `+field-list/get/delete/search-options` \| 写入前用 list/get 确认字段类型、选项、ID；删除前确认目标字段 \|
45	\| 创建/更新字段 \| `+field-create` / `+field-update` \| 必读 [lark-base-field-json.md](references/lark-base-field-json.md)；公式读 [formula-field-guide.md](references/formula-field-guide.md)；lookup 读 [lookup-field-guide.md](references/lookup-field-guide.md)；命令细节读 [lark-base-field-create.md](references/lark-base-field-create.md) / [lark-base-field-update.md](references/lark-base-field-update.md) \|
46	\| 读记录明细 \| `+record-get` / `+record-list` / `+record-search` \| 涉及筛选、排序、Top/Bottom N、聚合、多表关联、全局结论时读 [lark-base-data-analysis-sop.md](references/lark-base-data-analysis-sop.md) \|
47	\| 写记录 \| `+record-upsert` / `+record-batch-create` / `+record-batch-update` \| 必读 [lark-base-record-upsert.md](references/lark-base-record-upsert.md) / [lark-base-record-batch-create.md](references/lark-base-record-batch-create.md) / [lark-base-record-batch-update.md](references/lark-base-record-batch-update.md) 和 [lark-base-cell-value.md](references/lark-base-cell-value.md) \|
48	\| 附件字段 \| `+record-upload-attachment` / `+record-download-attachment` / `+record-remove-attachment` \| 附件不要伪造成普通 CellValue；上传走本地文件，下载/删除按 file token 或字段定位 \|
49	\| 删除记录 / 分享记录链接 / 历史 \| `+record-delete` / `+record-share-link-create` / `+record-history-list` \| 删除前确认 record；分享链接最多 100 条；历史读 [lark-base-record-history-list.md](references/lark-base-record-history-list.md)，只查单条记录，不做整表审计 \|
50	\| 管理视图 \| `+view-*` \| `+view-set-filter` 读 [lark-base-view-set-filter.md](references/lark-base-view-set-filter.md)；其余配置先 get 现状，再按返回结构更新 \|
51	\| 一次性聚合统计 \| `+data-query` \| 必读 [lark-base-data-analysis-sop.md](references/lark-base-data-analysis-sop.md) 和入口 [lark-base-data-query-guide.md](references/lark-base-data-query-guide.md)；完整 DSL 再读 [lark-base-data-query.md](references/lark-base-data-query.md) \|
52	\| 公式字段 \| `+field-create/update --json '{"type":"formula",...}'` \| 必读 [formula-field-guide.md](references/formula-field-guide.md)，读后再加隐藏确认 flag `--i-have-read-guide` \|
53	\| Lookup 字段 \| `+field-create/update --json '{"type":"lookup",...}'` \| 必读 [lookup-field-guide.md](references/lookup-field-guide.md)，读后再加隐藏确认 flag `--i-have-read-guide` \|
54	\| 表单提交 \| `+form-submit` \| 先读 [lark-base-form-detail.md](references/lark-base-form-detail.md) 获取题目、filter 和附件所需 `base_token`；提交 JSON 读 [lark-base-form-submit.md](references/lark-base-form-submit.md) \|
55	\| 表单题目创建/更新 \| `+form-questions-create` / `+form-questions-update` \| 读 [lark-base-form-questions-create.md](references/lark-base-form-questions-create.md) / [lark-base-form-questions-update.md](references/l

People who liked this also viewed

6 picks

Type