ai_member_xiaobian/.agents/skills/lark-base/references/lark-base-view-create.md
2026-05-15 10:57:05 +08:00

1.4 KiB

base +view-create

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

创建一个视图。

1. 顶层规则

  • --json 结构是 {name, type?}
  • name 必填;同表内应唯一。
  • type 可省略;省略时默认 grid
  • 视图类型取值范围:gridkanbangallerycalendargantt
  • +view-create 不负责排序、分组、筛选、时间轴、卡片封面、可见字段顺序;这些配置需要创建后再调用对应命令。
  • 表单视图不走 +view-create;使用表单相关命令。

2. 推荐命令

lark-cli base +view-create \
  --base-token <base_token> \
  --table-id <table_id> \
  --json '{"name":"进行中","type":"grid"}'

3. JSON 写法

{ "name": "进行中", "type": "grid" }

最小写法:

{ "name": "默认视图" }

4. 使用建议

  • 需要设置可见字段顺序时,创建后继续调用 lark-base-view-set-visible-fields.md
  • 需要设置筛选、分组、排序、时间轴、卡片封面时,创建后继续调用对应 +view-set-* 命令。

5. 易错点

  • 不要把 form 当成 type 传进来。
  • 不要指望 +view-create 一次完成视图布局与属性配置。

6. 参考