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

sheets +create（创建表格）

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

本 skill 对应 shortcut：lark-cli sheets +create。

特性：

• 一步创建表格并返回 URL
• 可选 --headers/--data 在创建后自动写入到第一个工作表的 A1 开始

[!CAUTION] 这是写入操作 —— 执行前必须确认用户意图。可以先用 --dry-run 预览。

[!IMPORTANT] 如果表格是以应用身份（bot）创建的，如 lark-cli sheets +create --as bot 在表格创建成功后，CLI 会尝试为当前 CLI 用户自动授予该表格的 full_access（可管理权限）。

以应用身份创建时，结果里会额外返回 permission_grant 字段，明确说明授权结果：

• status = granted：当前 CLI 用户已获得该表格的可管理权限
• status = skipped：本地没有可用的当前用户 open_id，因此不会自动授权；可提示用户先完成 lark-cli auth login，再让 AI / agent 继续使用应用身份（bot）授予当前用户权限
• status = failed：表格已创建成功，但自动授权用户失败；会带上失败原因，并提示稍后重试或继续使用 bot 身份处理该表格

permission_grant.perm = full_access 表示该资源已授予“可管理权限”。

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

命令

# 最简单：只创建
lark-cli sheets +create --title "仓库管理营收报表"

# 创建并写入表头 + 初始数据
lark-cli sheets +create --title "仓库管理营收报表" \
  --headers '["仓库","统计月份","入库金额","出库金额","销售收入","毛利率"]' \
  --data '[["华东一仓","2026-03",125000,98000,168000,"41.7%"]]'

# 创建到指定文件夹（folder_token）
lark-cli sheets +create --title "测试表" --folder-token "fldbc_xxx"

# 仅预览参数（不发请求）
lark-cli sheets +create --title "测试表" --dry-run

参数

参数	必填	说明
--title <title>	是	表格标题
--folder-token <token>	否	云空间文件夹 token（创建到指定目录）
--headers <json>	否	一维数组 JSON（表头；写入到 A1）
--data <json>	否	二维数组 JSON（初始数据；紧跟表头写入）
--dry-run	否	仅打印参数，不执行请求

输出

JSON，包含：

• spreadsheet_token
• title
• url
• permission_grant（仅 --as bot 时返回）

参考

• lark-sheets-write — 后续覆盖写入
• lark-sheets-append — 后续追加写入
• lark-shared