ai_member_xiaobian/.agents/skills/lark-sheets/references/lark-sheets-row-column-management.md

Sheets Row and Column Management

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

这份 reference 汇总行列结构操作：

• +add-dimension
• +insert-dimension
• +update-dimension
• +move-dimension
• +delete-dimension

+add-dimension

对应命令：lark-cli sheets +add-dimension

在工作表末尾追加空行或空列，不影响已有数据。

lark-cli sheets +add-dimension --spreadsheet-token "shtxxxxxxxx" \
  --sheet-id "<sheetId>" --dimension ROWS --length 10

参数：

参数	必填	说明
--url	否	电子表格 URL（与 --spreadsheet-token 二选一）
--spreadsheet-token	否	表格 token
--sheet-id	是	工作表 ID
--dimension	是	ROWS 或 COLUMNS
--length	是	追加数量（1-5000）
--dry-run	否	仅打印请求，不执行

输出：addCount、majorDimension

+insert-dimension

对应命令：lark-cli sheets +insert-dimension

在指定位置插入空行或空列，已有数据向下或向右移动。

lark-cli sheets +insert-dimension --spreadsheet-token "shtxxxxxxxx" \
  --sheet-id "<sheetId>" --dimension ROWS --start-index 3 --end-index 7

参数：

参数	必填	说明
--url	否	电子表格 URL（与 --spreadsheet-token 二选一）
--spreadsheet-token	否	表格 token
--sheet-id	是	工作表 ID
--dimension	是	ROWS 或 COLUMNS
--start-index	是	起始位置（0-indexed）
--end-index	是	结束位置（0-indexed，不含）
--inherit-style	否	BEFORE 或 AFTER
--dry-run	否	仅打印请求，不执行

输出：成功时 data 为空对象 {}

+update-dimension

对应命令：lark-cli sheets +update-dimension

更新指定范围行/列的显隐状态和行高/列宽。

lark-cli sheets +update-dimension --spreadsheet-token "shtxxxxxxxx" \
  --sheet-id "<sheetId>" --dimension ROWS --start-index 1 --end-index 3 \
  --visible=false

参数：

参数	必填	说明
--url	否	电子表格 URL（与 --spreadsheet-token 二选一）
--spreadsheet-token	否	表格 token
--sheet-id	是	工作表 ID
--dimension	是	ROWS 或 COLUMNS
--start-index	是	起始位置（1-indexed，含）
--end-index	是	结束位置（1-indexed，含）
--visible	否	--visible=true 或 --visible=false
--fixed-size	否	行高或列宽（像素）
--dry-run	否	仅打印请求，不执行

输出：成功时 data 为空对象 {}

+move-dimension

对应命令：lark-cli sheets +move-dimension

将指定范围的行/列移动到目标位置。

lark-cli sheets +move-dimension --spreadsheet-token "shtxxxxxxxx" \
  --sheet-id "<sheetId>" --dimension ROWS \
  --start-index 0 --end-index 1 --destination-index 4

参数：

参数	必填	说明
--url	否	电子表格 URL（与 --spreadsheet-token 二选一）
--spreadsheet-token	否	表格 token
--sheet-id	是	工作表 ID
--dimension	是	ROWS 或 COLUMNS
--start-index	是	源起始位置（0-indexed）
--end-index	是	源结束位置（0-indexed，含）
--destination-index	是	目标位置（0-indexed）
--dry-run	否	仅打印请求，不执行

输出：成功时 data 为空对象 {}

+delete-dimension

对应命令：lark-cli sheets +delete-dimension

删除指定范围的行或列。

lark-cli sheets +delete-dimension --spreadsheet-token "shtxxxxxxxx" \
  --sheet-id "<sheetId>" --dimension ROWS --start-index 3 --end-index 7

参数：

参数	必填	说明
--url	否	电子表格 URL（与 --spreadsheet-token 二选一）
--spreadsheet-token	否	表格 token
--sheet-id	是	工作表 ID
--dimension	是	ROWS 或 COLUMNS
--start-index	是	起始位置（1-indexed，含）
--end-index	是	结束位置（1-indexed，含）
--dry-run	否	仅打印请求，不执行

输出：delCount、majorDimension

参考

• spreadsheet-management — 查看当前工作表信息
• cell-style-and-merge — 调整样式或合并单元格