rongshu/.agents/skills/lark-base/references/lark-base-base-create.md

base +base-create

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

创建一个新的 Base；可选指定父文件夹和时区。

推荐命令

lark-cli base +base-create \
  --name "New Base"

lark-cli base +base-create \
  --name "项目管理" \
  --folder-token fld_xxx \
  --time-zone Asia/Shanghai

参数

参数	必填	说明
--name <name>	是	新 Base 名称
--folder-token <token>	否	目标文件夹 token
--time-zone <tz>	否	时区，如 Asia/Shanghai

API 入参详情

HTTP 方法和路径：

POST /open-apis/base/v3/bases

返回重点

• 返回 base。
• CLI 会额外标记 created: true。
• 回复结果时，必须主动返回新 Base 的可访问链接：
  • 优先使用返回结果中的 base.url
  • 同时返回新 Base 的 token；字段名以实际返回为准，常见为 base_token 或 app_token
  • 如果本次返回没有 url，至少返回新 Base 的名称和 token

[!IMPORTANT] 如果 Base 是以应用身份（bot）创建的，shortcut 会在创建成功后自动尝试为当前 CLI 用户添加该 Base 的 full_access（管理员）权限，并在输出中附带 permission_grant 字段。

permission_grant.status 语义如下：

• granted：当前 CLI 用户已获得该 Base 的管理员权限
• skipped：Base 已创建成功，但没有可授权的当前 CLI 用户，或创建结果缺少可授权 token
• failed：Base 已创建成功，但自动授权失败；结果中会包含失败原因，用户可稍后重试授权，或继续使用应用身份（bot）处理该 Base

回复创建结果时，除 base token 和可访问链接外，还必须明确告知用户 permission_grant 的结果。

仍然不要擅自执行 owner 转移。 如果用户需要把 owner 转给自己，必须单独确认。

工作流

[!CAUTION] 这是写入操作 — 执行前必须向用户确认。

1. 先确认 Base 名称。
2. --folder-token、--time-zone 都是可选项；用户没要求时不要为此额外追问。
3. 创建成功后，整理并返回：Base 名称、token，以及响应中已有的可访问链接。

参考

• lark-base-workspace.md — base / workspace 索引页
• lark-base-base-copy.md — 复制 Base