ai_member_xiaobian/.agents/skills/lark-base/references/lark-base-table-create.md

base +table-create

前置条件： 先阅读 ../lark-shared/SKILL.md 了解认证、全局参数和安全规则。

创建数据表；可选地继续创建字段和视图。

推荐命令

lark-cli base +table-create \
  --base-token app_xxx \
  --name "客户名单"

lark-cli base +table-create \
  --base-token app_xxx \
  --name "项目管理" \
  --fields '[{"name":"项目名称","type":"text"}]' \
  --view '[{"name":"默认表格","type":"grid"}]' 

参数

参数	必填	说明
--base-token <token>	是	Base Token
--name <name>	是	新表名称
--fields <json>	否	字段 JSON 数组
--view <json>	否	视图 JSON 对象或数组

API 入参详情

HTTP 方法和路径：

POST /open-apis/base/v3/bases/:base_token/tables

• 如果传了 --fields，CLI 会继续调用字段接口。
• 如果传了 --view，CLI 会继续调用视图接口。

返回重点

• 至少返回 table。
• 传了 --fields / --view 时，还会附带 fields / views。

工作流

1. 先只传 --name 建空表。
2. 字段或视图参数较复杂时，先精简到最小必需字段，再以内联 JSON 传参。

坑点

• ⚠️ 这是写入操作，执行前必须确认。
• ⚠️ CLI 会用 --fields 的第一个元素更新系统默认首列，后续元素才是新增字段。
• ⚠️ 不要并行改同一张表，避免状态竞争。

参考

• lark-base-table.md — table 索引页
• lark-base-field-create.md — 建字段
• lark-base-view-create.md — 建视图