@fectivnfy112358/minimax-code-web 0.1.0-preview.0 → 0.1.0-preview.3

package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-delete-dropdown.md

@@ -0,0 +1,46 @@
+
+# sheets +delete-dropdown（删除下拉列表）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +delete-dropdown`。
+
+删除指定范围的下拉列表配置。支持一次删除多个范围。
+
+> [!CAUTION]
+> 这是**删除操作** —— 执行前必须确认用户意图。可以先用 `--dry-run` 预览。
+
+## 命令
+
+```bash
+# 删除单个范围
+lark-cli sheets +delete-dropdown --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --ranges '["<sheetId>!A2:A100"]'
+
+# 删除多个范围
+lark-cli sheets +delete-dropdown --spreadsheet-token "shtxxxxxxxx" \
+  --ranges '["<sheetId>!A2:A100", "<sheetId>!C1:C50"]'
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--ranges` | 是 | 范围 JSON 数组（如 `'["sheetId!A2:A100"]'`），单个范围最多 5000 格，单次最多 100 个范围 |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+## 输出
+
+JSON，包含：
+
+- `rangeResults[].range` — 对应的范围
+- `rangeResults[].success` — 是否成功
+- `rangeResults[].updatedCells` — 影响的单元格数量
+
+## 参考
+
+- [lark-sheets-set-dropdown](lark-sheets-set-dropdown.md) — 设置下拉列表
+- [lark-sheets-update-dropdown](lark-sheets-update-dropdown.md) — 更新下拉列表
+- [lark-sheets-get-dropdown](lark-sheets-get-dropdown.md) — 查询下拉列表

package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-delete-filter-view-condition.md

@@ -0,0 +1,26 @@
+
+# sheets +delete-filter-view-condition（删除筛选条件）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +delete-filter-view-condition`。
+
+> [!CAUTION]
+> 这是**破坏性写入操作** —— 删除后不可恢复。
+
+## 命令
+
+```bash
+lark-cli sheets +delete-filter-view-condition --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --filter-view-id "<fvId>" --condition-id "E"
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--filter-view-id` | 是 | 筛选视图 ID |
+| `--condition-id` | 是 | 列字母（如 `E`） |

package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-delete-filter-view.md

@@ -0,0 +1,25 @@
+
+# sheets +delete-filter-view（删除筛选视图）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +delete-filter-view`。
+
+> [!CAUTION]
+> 这是**破坏性写入操作** —— 删除后不可恢复。执行前必须确认用户意图。
+
+## 命令
+
+```bash
+lark-cli sheets +delete-filter-view --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --filter-view-id "<fvId>"
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--filter-view-id` | 是 | 筛选视图 ID |

package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-export.md

@@ -0,0 +1,51 @@
+
+# sheets +export（导出表格）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +export`。
+
+特性：
+
+- 创建导出任务并轮询完成（默认最多约 30 秒）
+- 支持导出 `xlsx` 或 `csv`
+- 若提供 `--output-path`，会直接下载并保存到本地；否则输出 `file_token` 供后续处理
+
+## 命令
+
+```bash
+# 导出为 xlsx 并保存到本地
+lark-cli sheets +export --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --file-extension xlsx --output-path "./report.xlsx"
+
+# 导出为 csv（必须指定 sheet-id）
+lark-cli sheets +export --spreadsheet-token "shtxxxxxxxx" \
+  --file-extension csv --sheet-id "<sheetId>" --output-path "./report.csv"
+
+# 不下载：只获取 file_token
+lark-cli sheets +export --spreadsheet-token "shtxxxxxxxx" --file-extension xlsx
+
+# 仅预览参数（不发请求）
+lark-cli sheets +export --url "https://..." --file-extension xlsx --output-path "./report.xlsx" --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url <url>` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一；支持 wiki URL） |
+| `--spreadsheet-token <token>` | 否 | 表格 token（与 `--url` 二选一） |
+| `--file-extension <ext>` | 是 | `xlsx` 或 `csv` |
+| `--sheet-id <id>` | 否 | 工作表 ID（导出 `csv` 时必填；`xlsx` 可不填） |
+| `--output-path <path>` | 否 | 本地保存路径；提供则自动下载保存 |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+## 输出
+
+- 若提供 `--output-path`：输出 `file_path/file_name/file_size`
+- 否则：输出 `file_token/file_name/file_size`
+
+## 参考
+
+- [lark-sheets-info](lark-sheets-info.md) — 先获取 `sheet_id`
+- [lark-shared](../../lark-shared/SKILL.md)

package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-find.md

@@ -0,0 +1,62 @@
+
+# sheets +find（查找单元格）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+> **边界说明：** `sheets +find` 不是云空间搜索，只在一个已知 spreadsheet 内查找单元格内容。如果还不知道目标 spreadsheet 是哪一个，先用 [`lark-doc`](../../lark-doc/SKILL.md) 的 `docs +search` 定位文件；`docs +search` 的结果里会直接返回 `SHEET` 类型，再回到 `sheets +info` / `sheets +find`。
+
+本 skill 对应 shortcut：`lark-cli sheets +find`。
+
+特性：
+
+- `--sheet-id` 必填（建议先用 `sheets +info` 获取）
+- `--range` 可写完整范围（如 `<sheetId>!A1:D200`）
+- 若已传 `--sheet-id`，`--range` 也可直接写 `A1:D200` 或 `C2`
+- 默认**区分大小写**；加 `--ignore-case` 可不区分大小写
+- 可选 `--search-by-regex` 按正则匹配
+
+## 命令
+
+```bash
+# 在指定范围查找（默认区分大小写）
+lark-cli sheets +find --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --find "张三" --range "A1:H200"
+
+# 不区分大小写
+lark-cli sheets +find --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --find "仓库管理营收报表" --range "H1:H500" --ignore-case
+
+# 正则查找
+lark-cli sheets +find --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --find "仓库管理营收报表" --range "H1:H500" --search-by-regex
+
+# 仅预览参数（不发请求）
+lark-cli sheets +find --url "https://..." --sheet-id "<sheetId>" --find "xxx" --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url <url>` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一；支持 wiki URL） |
+| `--spreadsheet-token <token>` | 否 | 表格 token（与 `--url` 二选一） |
+| `--sheet-id <id>` | 是 | 工作表 ID（可通过 `+info` 获取） |
+| `--find <text>` | 是 | 查找内容（字符串或正则） |
+| `--range <range>` | 否 | 范围（如 `<sheetId>!A1:D200`，或 `A1:D200` / `C2` 配合 `--sheet-id`）；不填则搜索整个工作表 |
+| `--ignore-case` | 否 | 不区分大小写（默认区分） |
+| `--match-entire-cell` | 否 | 完全匹配单元格 |
+| `--search-by-regex` | 否 | 使用正则 |
+| `--include-formulas` | 否 | 搜索公式 |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+## 输出
+
+JSON，包含：
+
+- `matched_cells`
+- `matched_formula_cells`
+- `rows_count`
+
+## 参考
+
+- [lark-sheets-info](lark-sheets-info.md)
+- [lark-shared](../../lark-shared/SKILL.md)

package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-formula.md

@@ -0,0 +1,89 @@
+
+# 飞书表格公式规则
+
+> 生成或改写飞书电子表格公式时的参考规则。飞书不像 Excel 365 默认 spill，普通公式对区域默认"投影"（只取当前行/列对应的单值），必须显式使用 `ARRAYFORMULA` 或原生数组函数才能逐项展开。
+
+## 写入方式
+
+公式必须使用对象格式写入（参见 SKILL.md「单元格数据类型」）：
+
+```bash
+--values '[[{"type":"formula","text":"=SUM(A1:A10)"}]]'
+```
+
+## ARRAYFORMULA 判断流程
+
+1. 结果是**标量**（单值）→ 不需要
+2. 结果是**数组**，且公式中**有**原生数组函数 → 不需要（数组语义自动传播）
+3. 结果是**数组**，且公式中**无**原生数组函数，对区域做标量计算 → 加 `ARRAYFORMULA`
+
+```text
+# 有原生数组函数，无需包裹
+=FILTER(A2:A10,B2:B10="x")+1          ✓
+=XLOOKUP(E2:E10,A2:A10,B2:B10)*100    ✓
+=MAP(A2:A10,LAMBDA(x,x*2))-1          ✓
+
+# 无原生数组函数，必须包裹
+=ARRAYFORMULA(A2:A100*B2:B100)         ✓
+=ARRAYFORMULA(IF(A2:A100>0,B2:B100,""))✓
+```
+
+## 原生数组函数清单（无需 ARRAYFORMULA）
+
+`ARRAYFORMULA` `ARRAY_CONSTRAIN` `BYCOL` `BYROW` `CELL` `CHOOSECOLS` `CHOOSEROWS` `DROP` `EXPAND` `FILTER` `FLATTEN` `FREQUENCY` `GROWTH` `HSTACK` `IMPORTDATA` `IMPORTFEED` `IMPORTHTML` `IMPORTRANGE` `IMPORTXML` `LINEST` `LOGEST` `LOOKUP` `MAKEARRAY` `MAP` `MINVERSE` `MMULT` `MUNIT` `QUERY` `RANDARRAY` `REDUCE` `REGEXEXTRACT` `SCAN` `SEQUENCE` `SORT` `SORTBY` `SORTN` `SPLIT` `SUMPRODUCT` `SWITCH` `TAKE` `TEXTSPLIT` `TOCOL` `TOROW` `TRANSPOSE` `TREND` `UNIQUE` `VSTACK` `WRAPCOLS` `WRAPROWS` `XLOOKUP`
+
+## 高风险函数：INDEX / OFFSET / ROW / COLUMN / MATCH
+
+行号/列号/偏移量本身是数组时，必须显式包裹：
+
+```text
+=ARRAYFORMULA(INDEX(...))
+=ARRAYFORMULA(ROW(...))
+```
+
+例外：结果直接交给聚合函数消费时不需要：`=SUM(INDEX(A1:B2,0,1))` ✓
+
+## 隐式逐项求值 → MAP/LAMBDA
+
+Excel 中 `SUBTOTAL`、`INDIRECT`、`OFFSET` 等在 `SUMPRODUCT` 内会隐式逐行求值，飞书不会。用 MAP 显式遍历：
+
+```text
+# Excel
+=SUMPRODUCT(SUBTOTAL(103,INDIRECT("E"&ROW($E$16:$E$387))))
+
+# 飞书
+=SUMPRODUCT(MAP(ARRAYFORMULA(ROW($E$16:$E$387)),LAMBDA(r,SUBTOTAL(103,INDIRECT("E"&r)))))
+```
+
+同类场景：`SUMIF/COUNTIF/SUMIFS` 的范围参数来自 `INDIRECT/OFFSET` 时也需要 MAP。
+
+## 多维结果降维
+
+飞书公式结果只能是二维，不能返回"区域的列表"。合并多个区域时：
+
+| 需求 | 写法 |
+|------|------|
+| 上下堆叠 | `=VSTACK(a, b, c)` |
+| 左右拼接 | `=HSTACK(a, b, c)` |
+| 压成单列 | `=TOCOL(...)` |
+| 压成单行 | `=TOROW(...)` |
+| 归约为标量 | `=REDUCE(init, arr, LAMBDA(acc, x, ...))` |
+
+## 日期差
+
+| 需求 | 正确写法 | 错误写法 |
+|------|---------|---------|
+| 天数差 | `=DAYS(B2,A2)` 或 `=DATEDIF(A2,B2,"D")` 或 `=B2-A2` | `=DAY(B2-A2)` |
+| 月份差 | `=DATEDIF(A2,B2,"M")` | `=MONTH(B2-A2)` |
+| 年份差 | `=DATEDIF(A2,B2,"Y")` | `=YEAR(B2-A2)` |
+| 工作日差 | `=NETWORKDAYS(A2,B2)` | — |
+
+## 飞书不支持的 Excel 语法
+
+| Excel 语法 | 飞书替代 |
+|-----------|---------|
+| `=@A1:A10`（隐式交叉） | `=A1:A10`（飞书默认投影，去掉 `@`） |
+| `=A1#`（spill range） | 改成明确范围，或用 `TAKE`/`DROP`/`ARRAY_CONSTRAIN` |
+| `=SUM(Table1[Amount])`（结构化引用） | `=SUM(A2:A100)`（改为 A1 区域） |
+| `{=A1:A10*B1:B10}`（CSE 花括号） | `=ARRAYFORMULA(A1:A10*B1:B10)` |
+| `STOCKHISTORY` / `WEBSERVICE` / `CUBE*` | 飞书无等价函数 |

package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-get-dropdown.md

@@ -0,0 +1,43 @@
+
+# sheets +get-dropdown（查询下拉列表）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +get-dropdown`。
+
+查询指定范围内已配置的下拉列表设置，包括选项值、是否多选、颜色映射等。
+
+## 命令
+
+```bash
+lark-cli sheets +get-dropdown --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --range "<sheetId>!A2:A100"
+
+lark-cli sheets +get-dropdown --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!A2:A100"
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--range` | 是 | 范围（如 `<sheetId>!A2:A100`） |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+## 输出
+
+JSON，包含：
+
+- `dataValidations[].conditionValues` — 下拉选项列表
+- `dataValidations[].ranges` — 应用范围
+- `dataValidations[].options.multipleValues` — 是否多选
+- `dataValidations[].options.highlightValidData` — 是否着色
+- `dataValidations[].options.colorValueMap` — 选项颜色映射
+
+## 参考
+
+- [lark-sheets-set-dropdown](lark-sheets-set-dropdown.md) — 设置下拉列表
+- [lark-sheets-update-dropdown](lark-sheets-update-dropdown.md) — 更新下拉列表
+- [lark-sheets-delete-dropdown](lark-sheets-delete-dropdown.md) — 删除下拉列表

package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-get-filter-view-condition.md

@@ -0,0 +1,27 @@
+
+# sheets +get-filter-view-condition（获取筛选条件）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +get-filter-view-condition`。
+
+## 命令
+
+```bash
+lark-cli sheets +get-filter-view-condition --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --filter-view-id "<fvId>" --condition-id "E"
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--filter-view-id` | 是 | 筛选视图 ID |
+| `--condition-id` | 是 | 列字母（如 `E`） |
+
+## 输出
+
+JSON，包含 `condition`（condition_id, filter_type, compare_type, expected）。

package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-get-filter-view.md

@@ -0,0 +1,26 @@
+
+# sheets +get-filter-view（获取筛选视图）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +get-filter-view`。
+
+## 命令
+
+```bash
+lark-cli sheets +get-filter-view --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --filter-view-id "<fvId>"
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--filter-view-id` | 是 | 筛选视图 ID |
+
+## 输出
+
+JSON，包含 `filter_view`（filter_view_id, filter_view_name, range）。

package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-info.md

@@ -0,0 +1,43 @@
+
+# sheets +info（查看表格/工作表信息）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +info`。
+
+用于：
+
+- 从表格 URL / token 获取 `spreadsheet_token`
+- 列出工作表（`sheet_id`、标题、行列数等），便于后续 `+read/+write/+find/+export` 使用
+
+## 命令
+
+```bash
+# 传 URL（支持用户粘贴时带空格/引号/反引号；支持 wiki URL）
+lark-cli sheets +info --url "https://example.larksuite.com/sheets/shtxxxxxxxx"
+
+# 传 spreadsheet_token
+lark-cli sheets +info --spreadsheet-token "shtxxxxxxxx"
+
+# 仅预览请求参数（不发请求）
+lark-cli sheets +info --url "https://..." --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url <url>` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一；支持 wiki URL） |
+| `--spreadsheet-token <token>` | 否 | 表格 token（与 `--url` 二选一） |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+## 输出
+
+JSON，包含：
+
+- `spreadsheet_token`：后续命令复用
+- `sheets[]`：每个工作表的 `sheet_id`、`title`、`row_count`、`column_count` 等
+
+## 参考
+
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-insert-dimension.md

@@ -0,0 +1,51 @@
+
+# sheets +insert-dimension（插入行列）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +insert-dimension`。
+
+在指定位置插入空行或空列，已有数据向下或向右移动。支持继承相邻行/列样式。
+
+> [!CAUTION]
+> 这是**写入操作** —— 执行前必须确认用户意图。可以先用 `--dry-run` 预览。
+
+## 命令
+
+```bash
+# 在第 3 行前插入 4 行空行（0-indexed，插入位置 3~7，不含 7）
+lark-cli sheets +insert-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension ROWS --start-index 3 --end-index 7
+
+# 插入列，并继承前方列的样式
+lark-cli sheets +insert-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension COLUMNS --start-index 2 --end-index 4 \
+  --inherit-style BEFORE
+
+# 仅预览参数
+lark-cli sheets +insert-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension ROWS --start-index 0 --end-index 2 --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url <url>` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token <token>` | 否 | 表格 token（与 `--url` 二选一） |
+| `--sheet-id <id>` | 是 | 工作表 ID |
+| `--dimension <ROWS\|COLUMNS>` | 是 | 操作维度：`ROWS` 或 `COLUMNS` |
+| `--start-index <n>` | 是 | 起始位置（0-indexed） |
+| `--end-index <n>` | 是 | 结束位置（0-indexed，不包含；插入数量 = end - start） |
+| `--inherit-style <BEFORE\|AFTER>` | 否 | 样式继承方向：`BEFORE` 继承前方、`AFTER` 继承后方；不传则为空白样式 |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+## 输出
+
+JSON（成功时 `data` 为空对象 `{}`）。
+
+## 参考
+
+- [lark-sheets-add-dimension](lark-sheets-add-dimension.md) — 在末尾追加行列
+- [lark-sheets-delete-dimension](lark-sheets-delete-dimension.md) — 删除行列
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-list-filter-view-conditions.md

@@ -0,0 +1,28 @@
+
+# sheets +list-filter-view-conditions（查询筛选条件）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +list-filter-view-conditions`。
+
+查询筛选视图的所有筛选条件。
+
+## 命令
+
+```bash
+lark-cli sheets +list-filter-view-conditions --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --filter-view-id "<fvId>"
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--filter-view-id` | 是 | 筛选视图 ID |
+
+## 输出
+
+JSON，包含 `items[]`（condition_id, filter_type, compare_type, expected）。

package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-list-filter-views.md

@@ -0,0 +1,26 @@
+
+# sheets +list-filter-views（查询筛选视图）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +list-filter-views`。
+
+查询工作表中的所有筛选视图，返回视图 ID、名称和范围。
+
+## 命令
+
+```bash
+lark-cli sheets +list-filter-views --spreadsheet-token "shtxxxxxxxx" --sheet-id "<sheetId>"
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+
+## 输出
+
+JSON，包含 `items[]`（filter_view_id, filter_view_name, range）。

package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-merge-cells.md

@@ -0,0 +1,47 @@
+
+# sheets +merge-cells（合并单元格）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +merge-cells`。
+
+合并指定范围的单元格，支持全合并、按行合并、按列合并三种模式。
+
+> [!CAUTION]
+> 这是**写入操作** —— 执行前必须确认用户意图。可以先用 `--dry-run` 预览。
+
+## 命令
+
+```bash
+# 全合并 A1:B2
+lark-cli sheets +merge-cells --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!A1:B2" --merge-type MERGE_ALL
+
+# 按行合并，配合 --sheet-id
+lark-cli sheets +merge-cells --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --range "A1:D4" --merge-type MERGE_ROWS
+
+# 仅预览
+lark-cli sheets +merge-cells --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!A1:B2" --merge-type MERGE_ALL --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url <url>` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token <token>` | 否 | 表格 token（与 `--url` 二选一） |
+| `--range <range>` | 是 | 单元格范围（`<sheetId>!A1:B2`，或配合 `--sheet-id` 使用 `A1:B2`） |
+| `--sheet-id <id>` | 否 | 工作表 ID（用于相对范围） |
+| `--merge-type <type>` | 是 | 合并方式：`MERGE_ALL`（全合并）、`MERGE_ROWS`（按行）、`MERGE_COLUMNS`（按列） |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+## 输出
+
+JSON，包含 `spreadsheetToken`。
+
+## 参考
+
+- [lark-sheets-unmerge-cells](lark-sheets-unmerge-cells.md) — 拆分单元格
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-move-dimension.md

@@ -0,0 +1,52 @@
+
+# sheets +move-dimension（移动行列）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +move-dimension`。
+
+将指定范围的行/列移动到目标位置。被移动到目标位置后，原本在目标位置的行/列会对应右移或下移。
+
+> [!CAUTION]
+> 这是**写入操作** —— 执行前必须确认用户意图。可以先用 `--dry-run` 预览。
+
+## 命令
+
+```bash
+# 将第 0-1 行移动到第 4 行位置
+lark-cli sheets +move-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension ROWS \
+  --start-index 0 --end-index 1 --destination-index 4
+
+# 将第 2 列移动到第 0 列位置
+lark-cli sheets +move-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension COLUMNS \
+  --start-index 2 --end-index 2 --destination-index 0
+
+# 仅预览参数
+lark-cli sheets +move-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension ROWS \
+  --start-index 0 --end-index 1 --destination-index 4 --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url <url>` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token <token>` | 否 | 表格 token（与 `--url` 二选一） |
+| `--sheet-id <id>` | 是 | 工作表 ID |
+| `--dimension <ROWS\|COLUMNS>` | 是 | 操作维度：`ROWS` 或 `COLUMNS` |
+| `--start-index <n>` | 是 | 源起始位置（0-indexed） |
+| `--end-index <n>` | 是 | 源结束位置（0-indexed，含） |
+| `--destination-index <n>` | 是 | 目标位置（0-indexed） |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+## 输出
+
+JSON（成功时 `data` 为空对象 `{}`）。
+
+## 参考
+
+- [lark-sheets-info](lark-sheets-info.md) — 查看当前行列数
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数