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

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

@@ -0,0 +1,262 @@
+---
+name: lark-sheets
+version: 1.1.0
+description: "飞书电子表格：创建和操作电子表格。创建表格并写入表头和数据、读取和写入单元格、追加行数据、在已知电子表格中查找单元格内容、导出表格文件。当用户需要创建电子表格、批量读写数据、在已知表格中查找内容、导出或下载表格时使用。若用户是想按名称或关键词搜索云空间里的表格文件，请改用 lark-doc 的 docs +search 先定位资源。"
+metadata:
+  requires:
+    bins: ["lark-cli"]
+  cliHelp: "lark-cli sheets --help"
+---
+
+# sheets (v3)
+
+**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理**
+
+## 快速决策
+- 按标题或关键词找云空间里的表格文件，先用 `lark-cli docs +search`。
+- `docs +search` 会直接返回 `SHEET` 结果，不要把它误解成只能搜文档 / Wiki。
+- 已知 spreadsheet URL / token 后，再进入 `sheets +info`、`sheets +read`、`sheets +find` 等对象内部操作。
+
+## 核心概念
+
+### 文档类型与 Token
+
+飞书开放平台中，不同类型的文档有不同的 URL 格式和 Token 处理方式。在进行文档操作（如添加评论、下载文件等）时，必须先获取正确的 `file_token`。
+
+### 文档 URL 格式与 Token 处理
+
+| URL 格式 | 示例                                                      | Token 类型 | 处理方式 |
+|----------|---------------------------------------------------------|-----------|----------|
+| `/docx/` | `https://example.larksuite.com/docx/doxcnxxxxxxxxx`    | `file_token` | URL 路径中的 token 直接作为 `file_token` 使用 |
+| `/doc/` | `https://example.larksuite.com/doc/doccnxxxxxxxxx`     | `file_token` | URL 路径中的 token 直接作为 `file_token` 使用 |
+| `/wiki/` | `https://example.larksuite.com/wiki/wikcnxxxxxxxxx`    | `wiki_token` | ⚠️ **不能直接使用**，需要先查询获取真实的 `obj_token` |
+| `/sheets/` | `https://example.larksuite.com/sheets/shtcnxxxxxxxxx`  | `file_token` | URL 路径中的 token 直接作为 `file_token` 使用 |
+| `/drive/folder/` | `https://example.larksuite.com/drive/folder/fldcnxxxx` | `folder_token` | URL 路径中的 token 作为文件夹 token 使用 |
+
+### Wiki 链接特殊处理（关键！）
+
+知识库链接（`/wiki/TOKEN`）背后可能是云文档、电子表格、多维表格等不同类型的文档。**不能直接假设 URL 中的 token 就是 file_token**，必须先查询实际类型和真实 token。
+
+#### 处理流程
+
+1. **使用 `wiki.spaces.get_node` 查询节点信息**
+   ```bash
+   lark-cli wiki spaces get_node --params '{"token":"wiki_token"}'
+   ```
+
+2. **从返回结果中提取关键信息**
+   - `node.obj_type`：文档类型（docx/doc/sheet/bitable/slides/file/mindnote）
+   - `node.obj_token`：**真实的文档 token**（用于后续操作）
+   - `node.title`：文档标题
+
+3. **根据 `obj_type` 使用对应的 API**
+
+   | obj_type | 说明 | 使用的 API |
+   |----------|------|-----------|
+   | `docx` | 新版云文档 | `drive file.comments.*`、`docx.*` |
+   | `doc` | 旧版云文档 | `drive file.comments.*` |
+   | `sheet` | 电子表格 | `sheets.*` |
+   | `bitable` | 多维表格 | `bitable.*` |
+   | `slides` | 幻灯片 | `drive.*` |
+   | `file` | 文件 | `drive.*` |
+   | `mindnote` | 思维导图 | `drive.*` |
+
+#### 查询示例
+
+```bash
+# 查询 wiki 节点
+lark-cli wiki spaces get_node --params '{"token":"wiki_token"}'
+```
+
+返回结果示例：
+```json
+{
+   "node": {
+      "obj_type": "docx",
+      "obj_token": "xxxx",
+      "title": "标题",
+      "node_type": "origin",
+      "space_id": "12345678910"
+   }
+}
+```
+
+### 资源关系
+
+```
+Wiki Space (知识空间)
+└── Wiki Node (知识库节点)
+    ├── obj_type: docx (新版文档)
+    │   └── obj_token (真实文档 token)
+    ├── obj_type: doc (旧版文档)
+    │   └── obj_token (真实文档 token)
+    ├── obj_type: sheet (电子表格)
+    │   └── obj_token (真实文档 token)
+    ├── obj_type: bitable (多维表格)
+    │   └── obj_token (真实文档 token)
+    └── obj_type: file/slides/mindnote
+        └── obj_token (真实文档 token)
+
+Drive Folder (云空间文件夹)
+└── File (文件/文档)
+    └── file_token (直接使用)
+```
+
+**操作流程（重要）：**
+
+1. **create** — 创建筛选
+   - 用于首次创建筛选
+   - ⚠️ range 必须覆盖所有需要筛选的列（如 B1:E200）
+   - 如果已有筛选存在，再用 create 会覆盖整个筛选
+
+2. **update** — 更新筛选
+   - 用于在已有筛选上添加/更新指定列的条件
+   - 只需指定 col 和 condition，不需要 range
+
+3. **delete** — 删除筛选
+
+4. **get** — 获取筛选状态
+
+**多列筛选示例：**
+
+创建媒体名称(B列)和情感分析(E列)的双重筛选：
+
+```bash
+# 1. 删除现有筛选（如有）
+lark-cli sheets spreadsheet.sheet.filters delete \
+  --params '{"spreadsheet_token":"<spreadsheet_token>","sheet_id":"<sheet_id>"}'
+
+# 2. 创建第一个筛选，range 覆盖所有要筛选的列
+lark-cli sheets spreadsheet.sheet.filters create \
+  --params '{"spreadsheet_token":"<spreadsheet_token>","sheet_id":"<sheet_id>"}' \
+  --data '{"col":"B","condition":{"expected":["xx"],"filter_type":"multiValue"},"range":"<sheet_id>!B1:E200"}'
+
+# 3. 添加第二个筛选条件
+lark-cli sheets spreadsheet.sheet.filters update \
+  --params '{"spreadsheet_token":"<spreadsheet_token>","sheet_id":"<sheet_id>"}' \
+  --data '{"col":"E","condition":{"expected":["xx"],"filter_type":"multiValue"}}'
+```
+
+**常见错误：**
+- `Wrong Filter Value`：筛选已存在，需要先 delete 再 create
+- `Excess Limit`：update 时重复添加同一列条件
+
+### 单元格数据类型
+
+接受二维数组的 shortcut（`+write`/`+append` 的 `--values`、`+create` 的 `--data`）中，每个单元格值支持以下类型。**公式、带文本链接、@人、@文档、下拉列表必须使用对象格式**，直接传字符串会被当作纯文本存储。
+
+| 类型 | 写入格式 | 示例 |
+|------|---------|------|
+| 字符串 | `"文本"` | `"hello"` |
+| 数字 | `数字` | `123`、`3.14` |
+| 日期 | `数字`（自 1899-12-30 起的天数，需先设单元格日期格式） | `42101` |
+| 链接（纯 URL） | `"URL 字符串"` | `"https://example.com"` |
+| 链接（带文本） | `{"type":"url","text":"显示文本","link":"URL"}` | `{"type":"url","text":"飞书","link":"https://www.feishu.cn"}` |
+| 邮箱 | `"邮箱字符串"` | `"user@example.com"` |
+| **公式** | `{"type":"formula","text":"=公式"}` | `{"type":"formula","text":"=SUM(A1:A10)"}` |
+| @人 | `{"type":"mention","text":"标识","textType":"email\|openId\|unionId","notify":false}` | `{"type":"mention","text":"user@example.com","textType":"email","notify":false}`（notify 可选，默认 false；仅在用户明确要求通知时设为 true） |
+| @文档 | `{"type":"mention","textType":"fileToken","text":"token","objType":"类型"}` | `{"type":"mention","textType":"fileToken","text":"shtXXX","objType":"sheet"}` |
+| 下拉列表 | `{"type":"multipleValue","values":[值1,值2]}` | `{"type":"multipleValue","values":["选项A","选项B"]}` |
+
+**写入公式示例**：
+
+```bash
+# ✅ 正确：使用对象格式
+lark-cli sheets +write --url "URL" --sheet-id "sheetId" --range "C6" \
+  --values '[[{"type":"formula","text":"=SUM(C2:C5)"}]]'
+
+# ❌ 错误：直接传字符串，会被存为纯文本
+lark-cli sheets +write --url "URL" --sheet-id "sheetId" --range "C6" \
+  --values '[["=SUM(C2:C5)"]]'
+```
+
+> **公式语法参考**：涉及 ARRAYFORMULA、原生数组函数、MAP/LAMBDA、日期差、Excel 公式改写等飞书特有规则时，先阅读 [`references/lark-sheets-formula.md`](references/lark-sheets-formula.md)。
+
+**限制**：
+- 公式支持 IMPORTRANGE 跨表引用（最多 5 层嵌套、每个工作表最多 100 个引用）
+- @人仅支持同租户用户，单次最多 50 人
+- 下拉列表需**先配置下拉选项**，否则 `multipleValue` 写入会变成纯文本。配置方法见 [`references/lark-sheets-set-dropdown.md`](references/lark-sheets-set-dropdown.md)。值中的字符串不能包含逗号
+
+## Shortcuts（推荐优先使用）
+
+Shortcut 是对常用操作的高级封装（`lark-cli sheets +<verb> [flags]`）。有 Shortcut 的操作优先使用。
+
+| Shortcut | 说明 |
+|----------|------|
+| [`+info`](references/lark-sheets-info.md) | View spreadsheet and sheet information |
+| [`+read`](references/lark-sheets-read.md) | Read spreadsheet cell values |
+| [`+write`](references/lark-sheets-write.md) | Write to spreadsheet cells (overwrite mode) |
+| [`+write-image`](references/lark-sheets-write-image.md) | Write an image into a spreadsheet cell |
+| [`+append`](references/lark-sheets-append.md) | Append rows to a spreadsheet |
+| [`+find`](references/lark-sheets-find.md) | Find cells in a spreadsheet |
+| [`+create`](references/lark-sheets-create.md) | Create a spreadsheet (optional header row and initial data) |
+| [`+export`](references/lark-sheets-export.md) | Export a spreadsheet (async task polling + optional download) |
+| [`+merge-cells`](references/lark-sheets-merge-cells.md) | Merge cells in a spreadsheet |
+| [`+unmerge-cells`](references/lark-sheets-unmerge-cells.md) | Unmerge (split) cells in a spreadsheet |
+| [`+replace`](references/lark-sheets-replace.md) | Find and replace cell values |
+| [`+set-style`](references/lark-sheets-set-style.md) | Set cell style for a range |
+| [`+batch-set-style`](references/lark-sheets-batch-set-style.md) | Batch set cell styles for multiple ranges |
+| [`+add-dimension`](references/lark-sheets-add-dimension.md) | Add rows or columns at the end of a sheet |
+| [`+insert-dimension`](references/lark-sheets-insert-dimension.md) | Insert rows or columns at a specified position |
+| [`+update-dimension`](references/lark-sheets-update-dimension.md) | Update row or column properties (visibility, size) |
+| [`+move-dimension`](references/lark-sheets-move-dimension.md) | Move rows or columns to a new position |
+| [`+delete-dimension`](references/lark-sheets-delete-dimension.md) | Delete rows or columns |
+| [`+create-filter-view`](references/lark-sheets-create-filter-view.md) | Create a filter view |
+| [`+update-filter-view`](references/lark-sheets-update-filter-view.md) | Update a filter view |
+| [`+list-filter-views`](references/lark-sheets-list-filter-views.md) | List all filter views in a sheet |
+| [`+get-filter-view`](references/lark-sheets-get-filter-view.md) | Get a filter view by ID |
+| [`+delete-filter-view`](references/lark-sheets-delete-filter-view.md) | Delete a filter view |
+| [`+create-filter-view-condition`](references/lark-sheets-create-filter-view-condition.md) | Create a filter condition on a filter view |
+| [`+update-filter-view-condition`](references/lark-sheets-update-filter-view-condition.md) | Update a filter condition |
+| [`+list-filter-view-conditions`](references/lark-sheets-list-filter-view-conditions.md) | List all filter conditions of a filter view |
+| [`+get-filter-view-condition`](references/lark-sheets-get-filter-view-condition.md) | Get a filter condition by column |
+| [`+delete-filter-view-condition`](references/lark-sheets-delete-filter-view-condition.md) | Delete a filter condition |
+
+### 下拉列表
+
+| Shortcut | 说明 |
+|----------|------|
+| [`+set-dropdown`](references/lark-sheets-set-dropdown.md) | 设置下拉列表（`multipleValue` 写入的前置步骤） |
+| [`+update-dropdown`](references/lark-sheets-update-dropdown.md) | 更新下拉列表选项 |
+| [`+get-dropdown`](references/lark-sheets-get-dropdown.md) | 查询下拉列表配置 |
+| [`+delete-dropdown`](references/lark-sheets-delete-dropdown.md) | 删除下拉列表 |
+
+## API Resources
+
+```bash
+lark-cli schema sheets.<resource>.<method>   # 调用 API 前必须先查看参数结构
+lark-cli sheets <resource> <method> [flags] # 调用 API
+```
+
+> **重要**：使用原生 API 时，必须先运行 `schema` 查看 `--data` / `--params` 参数结构，不要猜测字段格式。
+
+### spreadsheets
+
+  - `create` — 创建电子表格
+  - `get` — 获取电子表格信息
+  - `patch` — 修改电子表格属性
+
+### spreadsheet.sheet.filters
+
+  - `create` — 创建筛选
+  - `delete` — 删除筛选
+  - `get` — 获取筛选
+  - `update` — 更新筛选
+
+### spreadsheet.sheets
+
+  - `find` — 查找单元格
+
+## 权限表
+
+| 方法 | 所需 scope |
+|------|-----------|
+| `spreadsheets.create` | `sheets:spreadsheet:create` |
+| `spreadsheets.get` | `sheets:spreadsheet.meta:read` |
+| `spreadsheets.patch` | `sheets:spreadsheet.meta:write_only` |
+| `spreadsheet.sheet.filters.create` | `sheets:spreadsheet:write_only` |
+| `spreadsheet.sheet.filters.delete` | `sheets:spreadsheet:write_only` |
+| `spreadsheet.sheet.filters.get` | `sheets:spreadsheet:read` |
+| `spreadsheet.sheet.filters.update` | `sheets:spreadsheet:write_only` |
+| `spreadsheet.sheets.find` | `sheets:spreadsheet:read` |
+

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

@@ -0,0 +1,51 @@
+
+# sheets +add-dimension（增加行列）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +add-dimension`。
+
+在工作表末尾追加空行或空列，不影响已有数据。
+
+> [!CAUTION]
+> 这是**写入操作** —— 执行前必须确认用户意图。可以先用 `--dry-run` 预览。
+
+## 命令
+
+```bash
+# 在末尾追加 10 行
+lark-cli sheets +add-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension ROWS --length 10
+
+# 在末尾追加 3 列
+lark-cli sheets +add-dimension --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension COLUMNS --length 3
+
+# 仅预览参数（不发请求）
+lark-cli sheets +add-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension ROWS --length 5 --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url <url>` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token <token>` | 否 | 表格 token（与 `--url` 二选一） |
+| `--sheet-id <id>` | 是 | 工作表 ID |
+| `--dimension <ROWS\|COLUMNS>` | 是 | 操作维度：`ROWS` 或 `COLUMNS` |
+| `--length <n>` | 是 | 追加数量（1-5000） |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+## 输出
+
+JSON，包含：
+
+- `addCount`：实际追加的行/列数
+- `majorDimension`：`ROWS` 或 `COLUMNS`
+
+## 参考
+
+- [lark-sheets-info](lark-sheets-info.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-append.md

@@ -0,0 +1,56 @@
+
+# sheets +append（追加行）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +append`。
+
+- `--values` 必须是二维数组 JSON
+- 内置尺寸校验：最多 5000 行、每行最多 100 列
+- `--range` 可以是 `<sheetId>` 或 `<sheetId>!A1:D10`
+- 若已传 `--sheet-id`，`--range` 也可写 `A1:D10` 或 `C2`
+
+> [!CAUTION]
+> 这是**写入操作** —— 执行前必须确认用户意图。可以先用 `--dry-run` 预览。
+
+## 命令
+
+```bash
+# 追加一行（6 列示例）
+lark-cli sheets +append --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!A1" \
+  --values '[["华东一仓","2026-03",125000,98000,168000,"41.7%"]]'
+
+# 配合 --sheet-id，可直接写相对范围
+lark-cli sheets +append --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --range "A1" \
+  --values '[["A","B"]]'
+
+# 仅预览参数（不发请求）
+lark-cli sheets +append --spreadsheet-token "shtxxxxxxxx" --range "<sheetId>!A1" \
+  --values '[["A","B"]]' --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url <url>` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一；支持 wiki URL） |
+| `--spreadsheet-token <token>` | 否 | 表格 token（与 `--url` 二选一） |
+| `--range <range>` | 否 | 追加范围：`<sheetId>!A1:D10`、`A1:D10` / `C2`（需配合 `--sheet-id`），或 `<sheetId>` |
+| `--sheet-id <id>` | 否 | 工作表 ID（不提供 `--range` 时生效） |
+| `--values <json>` | 是 | 二维数组 JSON（追加的行数据） |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+## 输出
+
+JSON，包含：
+
+- `table_range`
+- `updated_range/updated_rows/updated_columns/updated_cells`
+- `revision`
+
+## 参考
+
+- [lark-sheets-read](lark-sheets-read.md) — 追加后可 read 验证
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

package/server/assets/skills/lark-tools/cli-skills/lark-sheets/references/lark-sheets-batch-set-style.md

@@ -0,0 +1,53 @@
+
+# sheets +batch-set-style（批量设置单元格样式）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +batch-set-style`。
+
+对多个范围批量设置不同的单元格样式，一次请求可包含多组范围和样式。
+
+> [!CAUTION]
+> 这是**写入操作** —— 执行前必须确认用户意图。可以先用 `--dry-run` 预览。
+
+## 命令
+
+```bash
+# 对两组范围分别设置样式
+lark-cli sheets +batch-set-style --spreadsheet-token "shtxxxxxxxx" \
+  --data '[{"ranges":["<sheetId>!A1:C3"],"style":{"font":{"bold":true},"backColor":"#21d11f"}},{"ranges":["<sheetId>!D1:F3"],"style":{"foreColor":"#ff0000"}}]'
+
+# 同一样式应用到多个范围
+lark-cli sheets +batch-set-style --spreadsheet-token "shtxxxxxxxx" \
+  --data '[{"ranges":["<sheetId>!A1:B2","<sheetId>!D4:E5"],"style":{"hAlign":1,"font":{"bold":true}}}]'
+
+# 仅预览
+lark-cli sheets +batch-set-style --spreadsheet-token "shtxxxxxxxx" \
+  --data '[{"ranges":["<sheetId>!A1:B2"],"style":{"backColor":"#0000ff"}}]' --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url <url>` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token <token>` | 否 | 表格 token（与 `--url` 二选一） |
+| `--data <json>` | 是 | JSON 数组，每项包含 `ranges`（字符串数组）和 `style`（样式对象） |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+### style 对象字段
+
+与 `+set-style` 相同，参见 [lark-sheets-set-style](lark-sheets-set-style.md)。
+
+## 输出
+
+JSON，包含：
+
+- `totalUpdatedRows/totalUpdatedColumns/totalUpdatedCells`：汇总更新量
+- `revision`：工作表版本号
+- `responses[]`：每个范围的更新详情
+
+## 参考
+
+- [lark-sheets-set-style](lark-sheets-set-style.md) — 单范围设置样式
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

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

@@ -0,0 +1,42 @@
+
+# sheets +create-filter-view-condition（创建筛选条件）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +create-filter-view-condition`。
+
+为筛选视图的指定列创建筛选条件。
+
+> [!CAUTION]
+> 这是**写入操作** —— 执行前必须确认用户意图。
+
+## 命令
+
+```bash
+# 数值筛选：E 列 < 6
+lark-cli sheets +create-filter-view-condition --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --filter-view-id "<fvId>" \
+  --condition-id "E" --filter-type "number" --compare-type "less" --expected '["6"]'
+
+# 文本筛选：G 列以 a 开头
+lark-cli sheets +create-filter-view-condition --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --filter-view-id "<fvId>" \
+  --condition-id "G" --filter-type "text" --compare-type "beginsWith" --expected '["a"]'
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--filter-view-id` | 是 | 筛选视图 ID |
+| `--condition-id` | 是 | 列字母（如 `E`） |
+| `--filter-type` | 是 | 筛选类型：`hiddenValue`、`number`、`text`、`color` |
+| `--compare-type` | 否 | 比较运算符（如 `less`、`beginsWith`、`between`） |
+| `--expected` | 是 | 筛选值 JSON 数组（如 `["6"]` 或 `["2","10"]`） |
+
+## 输出
+
+JSON，包含 `condition`（condition_id, filter_type, compare_type, expected）。

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

@@ -0,0 +1,42 @@
+
+# sheets +create-filter-view（创建筛选视图）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +create-filter-view`。
+
+在工作表中创建筛选视图，每个工作表最多 150 个筛选视图。
+
+> [!CAUTION]
+> 这是**写入操作** —— 执行前必须确认用户意图。可以先用 `--dry-run` 预览。
+
+## 命令
+
+```bash
+lark-cli sheets +create-filter-view --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --range "<sheetId>!A1:H14"
+
+# 指定名称
+lark-cli sheets +create-filter-view --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --range "<sheetId>!A1:H14" --filter-view-name "我的筛选"
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--range` | 是 | 筛选范围（如 `sheetId!A1:H14`） |
+| `--filter-view-name` | 否 | 显示名称（最多 100 字符） |
+| `--filter-view-id` | 否 | 自定义 10 位字母数字 ID（不传则自动生成） |
+
+## 输出
+
+JSON，包含 `filter_view`（filter_view_id, filter_view_name, range）。
+
+## 参考
+
+- [lark-sheets-list-filter-views](lark-sheets-list-filter-views.md) — 查询所有筛选视图
+- [lark-sheets-create-filter-view-condition](lark-sheets-create-filter-view-condition.md) — 添加筛选条件

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

@@ -0,0 +1,69 @@
+
+# sheets +create（创建表格）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../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 转给自己，必须单独确认。
+
+## 命令
+
+```bash
+# 最简单：只创建
+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-write.md) — 后续覆盖写入
+- [lark-sheets-append](lark-sheets-append.md) — 后续追加写入
+- [lark-shared](../../lark-shared/SKILL.md)

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

@@ -0,0 +1,53 @@
+
+# sheets +delete-dimension（删除行列）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +delete-dimension`。
+
+删除指定范围的行或列，已有数据向上或向左移动。
+
+> [!CAUTION]
+> 这是**破坏性写入操作** —— 删除后数据不可恢复。执行前必须确认用户意图，建议先用 `--dry-run` 预览。
+
+## 命令
+
+```bash
+# 删除第 3-7 行（1-indexed，闭区间）
+lark-cli sheets +delete-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension ROWS --start-index 3 --end-index 7
+
+# 删除第 5-8 列
+lark-cli sheets +delete-dimension --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension COLUMNS --start-index 5 --end-index 8
+
+# 仅预览参数
+lark-cli sheets +delete-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension ROWS --start-index 3 --end-index 7 --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url <url>` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token <token>` | 否 | 表格 token（与 `--url` 二选一） |
+| `--sheet-id <id>` | 是 | 工作表 ID |
+| `--dimension <ROWS\|COLUMNS>` | 是 | 操作维度：`ROWS` 或 `COLUMNS` |
+| `--start-index <n>` | 是 | 起始位置（**1-indexed**，含） |
+| `--end-index <n>` | 是 | 结束位置（**1-indexed**，含） |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+## 输出
+
+JSON，包含：
+
+- `delCount`：实际删除的行/列数
+- `majorDimension`：`ROWS` 或 `COLUMNS`
+
+## 参考
+
+- [lark-sheets-add-dimension](lark-sheets-add-dimension.md) — 增加行列
+- [lark-sheets-insert-dimension](lark-sheets-insert-dimension.md) — 插入行列
+- [lark-sheets-info](lark-sheets-info.md) — 查看当前行列数
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数