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。

工作流

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

坑点

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

参考

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