用途:在飞书电子表格中完成创建、读取、写入与维护操作,命令以 lark-cli sheets 开头。开始前须先用 Read 工具读取 ../lark-shared/SKILL.md 获取认证与权限处理,并按场景先读对应 reference 再执行命令。
主要能力:读数据用 +csv-get(纯值)或 +cells-get(公式/样式/批注);写入用 +csv-put、+table-put、+cells-set、+cells-set-style、+cells-set-image;工作簿操作用 +workbook-create、+workbook-info、+workbook-import、+sheet-copy、+revision-get、+workbook-export;行列与区域用 +dim-insert、+dim-delete、+range-sort、+range-copy、+cells-merge、+cols-resize 等;对象类含 +chart-create-basic、+pivot-create、+cond-format-create、+filter-create、+filter-view-create、+sparkline-create、+float-image-create;另有 +cells-search、+cells-replace、+changeset-get、+history-list、+history-revert、+formula-verify。
使用方式:定位资源用公共四件套 --url / --spreadsheet-token / --sheet-id / --sheet-name,两组各二选一必填;不确定子表名时先 +workbook-info 查询,不要猜 Sheet1。--range 只写 A1:B2,含 ! 时整段用单引号包裹。大 JSON 走 @file 或 stdin。high-risk-write 命令(如 +batch-update、+cells-clear、+dim-delete、+history-revert 及各类删除)需先 --dry-run 预览并经用户同意后加 --yes。
限制与注意:写操作不自动回读,需自行用 +-list / +-get 校验;公式落表后须用 +formula-verify 逐段检查,AI 公式用 --ai-only 异步检查;金额、百分比、日期等按规则区分数字与文本;样式写入后需回读确认。非 POSIX shell 需按适配方式改写命令。具体参数细节以各 reference 为准。