@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-read.md

@@ -0,0 +1,61 @@
+
+# sheets +read（读取单元格）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +read`。
+
+内置能力：
+
+- 支持 `--url` / `--spreadsheet-token` 二选一（URL 支持 wiki；支持粘贴时带空格/引号/反引号）
+- 若已传 `--sheet-id`，`--range` 可写 `A1:D10` 或 `C2`
+- 将单元格富文本 segment 数组拍平成纯文本，减少输出冗余
+- 默认最多返回 200 行（超出会 `truncated=true`）
+
+## 命令
+
+```bash
+# 读取指定范围（推荐）
+lark-cli sheets +read --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --range "<sheetId>!A1:H20"
+
+# 配合 --sheet-id，可直接写相对范围或单个单元格
+lark-cli sheets +read --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --range "C2"
+
+# 仅指定工作表（不含 A1:D10），读取整个工作表（仍会做 200 行截断）
+lark-cli sheets +read --spreadsheet-token "shtxxxxxxxx" --range "<sheetId>"
+
+# 不指定 range：读取 --sheet-id 对应工作表；再不指定则读取第一个工作表
+lark-cli sheets +read --spreadsheet-token "shtxxxxxxxx" --sheet-id "<sheetId>"
+
+# 控制值渲染方式
+lark-cli sheets +read --url "https://..." --range "<sheetId>!A1:D10" --value-render-option Formula
+
+# 仅预览参数（不发请求）
+lark-cli sheets +read --url "https://..." --range "<sheetId>!A1:D10" --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` 时生效） |
+| `--value-render-option <opt>` | 否 | `ToString`（默认）/ `FormattedValue` / `Formula` / `UnformattedValue` |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+## 输出
+
+JSON，包含：
+
+- `range`：服务端实际读取的范围
+- `values`：二维数组（已做富文本拍平）
+- `truncated/total_rows`：当行数超过 200 时出现
+
+## 参考
+
+- [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-replace.md

@@ -0,0 +1,62 @@
+
+# sheets +replace（替换单元格）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +replace`。
+
+在指定范围内查找并替换单元格内容，支持正则、大小写敏感、全单元格匹配等选项。
+
+> [!CAUTION]
+> 这是**写入操作** —— 执行前必须确认用户意图。可以先用 `--dry-run` 预览。
+
+## 命令
+
+```bash
+# 简单替换
+lark-cli sheets +replace --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --find "hello" --replacement "world"
+
+# 指定范围 + 大小写敏感
+lark-cli sheets +replace --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --range "A1:C5" \
+  --find "Hello" --replacement "World" --match-case
+
+# 正则替换
+lark-cli sheets +replace --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --find "\\d{4}-\\d{2}-\\d{2}" \
+  --replacement "DATE" --search-by-regex
+
+# 仅预览
+lark-cli sheets +replace --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --find "old" --replacement "new" --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url <url>` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token <token>` | 否 | 表格 token（与 `--url` 二选一） |
+| `--sheet-id <id>` | 是 | 工作表 ID |
+| `--find <text>` | 是 | 搜索文本（启用 `--search-by-regex` 时为正则表达式） |
+| `--replacement <text>` | 是 | 替换文本 |
+| `--range <range>` | 否 | 搜索范围（不传则搜索整个工作表） |
+| `--match-case` | 否 | 区分大小写 |
+| `--match-entire-cell` | 否 | 匹配整个单元格 |
+| `--search-by-regex` | 否 | 使用正则表达式搜索 |
+| `--include-formulas` | 否 | 在公式中搜索 |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+## 输出
+
+JSON，包含 `replace_result`：
+
+- `matched_cells`：匹配的非公式单元格列表
+- `matched_formula_cells`：匹配的公式单元格列表
+- `rows_count`：包含匹配的行数
+
+## 参考
+
+- [lark-sheets-find](lark-sheets-find.md) — 查找单元格（只查不改）
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

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

@@ -0,0 +1,62 @@
+
+# sheets +set-dropdown（设置下拉列表）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +set-dropdown`。
+
+为指定范围的单元格配置下拉列表选项。**这是使用 `multipleValue` 格式写入数据的前置步骤**——未配置下拉选项的单元格，`multipleValue` 写入会变成纯文本。
+
+> [!CAUTION]
+> 这是**写入操作** —— 执行前必须确认用户意图。可以先用 `--dry-run` 预览。
+
+## 命令
+
+```bash
+# 基础：设置单选下拉
+lark-cli sheets +set-dropdown --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --range "<sheetId>!A2:A100" --condition-values '["选项1", "选项2", "选项3"]'
+
+# 多选 + 颜色高亮
+lark-cli sheets +set-dropdown --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!A2:A100" --condition-values '["选项1", "选项2", "选项3"]' \
+  --multiple --highlight --colors '["#1FB6C1", "#F006C2", "#FB16C3"]'
+
+# 仅预览参数（不发请求）
+lark-cli sheets +set-dropdown --url "https://..." --range "..." --condition-values '...' --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--range` | 是 | 范围（如 `<sheetId>!A2:A100`），单次最多 5000 行 x 100 列 |
+| `--condition-values` | 是 | 下拉选项，JSON 数组（如 `'["选项1","选项2"]'`），最多 500 个，每个 ≤100 字符，不能包含逗号 |
+| `--multiple` | 否 | 是否多选，默认 false |
+| `--highlight` | 否 | 是否着色，默认 false |
+| `--colors` | 否 | RGB 十六进制颜色 JSON 数组，需与 `--condition-values` 一一对应（`--highlight` 时必填） |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+## 输出
+
+JSON，包含 `code`（0=成功）和 `msg`。
+
+## 典型流程
+
+```bash
+# 1. 先配置下拉选项
+lark-cli sheets +set-dropdown --url "<url>" \
+  --range "<sheetId>!J2:J100" --condition-values '["选项1","选项2"]' --multiple
+
+# 2. 再用 multipleValue 写入
+lark-cli sheets +write --url "<url>" --sheet-id "<sheetId>" --range "J2" \
+  --values '[[{"type":"multipleValue","values":["选项1","选项2"]}]]'
+```
+
+## 参考
+
+- [lark-sheets-update-dropdown](lark-sheets-update-dropdown.md) — 更新下拉列表
+- [lark-sheets-get-dropdown](lark-sheets-get-dropdown.md) — 查询下拉列表
+- [lark-sheets-delete-dropdown](lark-sheets-delete-dropdown.md) — 删除下拉列表

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

@@ -0,0 +1,71 @@
+
+# sheets +set-style（设置单元格样式）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +set-style`。
+
+对指定范围的单元格设置样式（字体、颜色、对齐、边框等）。
+
+> [!CAUTION]
+> 这是**写入操作** —— 执行前必须确认用户意图。可以先用 `--dry-run` 预览。
+
+## 命令
+
+```bash
+# 设置加粗 + 红色背景
+lark-cli sheets +set-style --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!A1:C3" \
+  --style '{"font":{"bold":true},"backColor":"#ff0000"}'
+
+# 配合 --sheet-id + 居中对齐
+lark-cli sheets +set-style --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --range "A1:D1" \
+  --style '{"hAlign":1,"vAlign":1,"font":{"bold":true,"font_size":"12pt/1.5"}}'
+
+# 清除格式
+lark-cli sheets +set-style --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!A1:Z100" --style '{"clean":true}'
+
+# 仅预览
+lark-cli sheets +set-style --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!A1:B2" --style '{"foreColor":"#0000ff"}' --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url <url>` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token <token>` | 否 | 表格 token（与 `--url` 二选一） |
+| `--range <range>` | 是 | 单元格范围（`<sheetId>!A1:B2`，或配合 `--sheet-id`） |
+| `--sheet-id <id>` | 否 | 工作表 ID（用于相对范围） |
+| `--style <json>` | 是 | 样式 JSON 对象 |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+### style JSON 字段
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `font.bold` | bool | 加粗 |
+| `font.italic` | bool | 斜体 |
+| `font.font_size` | string | 字号，如 `"12pt/1.5"` |
+| `font.clean` | bool | 清除字体格式 |
+| `textDecoration` | int | 0=无, 1=下划线, 2=删除线, 3=两者 |
+| `formatter` | string | 数字格式 |
+| `hAlign` | int | 水平对齐：0=左, 1=居中, 2=右 |
+| `vAlign` | int | 垂直对齐：0=上, 1=居中, 2=下 |
+| `foreColor` | string | 字体颜色（hex，如 `"#000000"`） |
+| `backColor` | string | 背景色（hex） |
+| `borderType` | string | 边框：FULL_BORDER, OUTER_BORDER, INNER_BORDER, NO_BORDER 等 |
+| `borderColor` | string | 边框颜色（hex） |
+| `clean` | bool | 清除所有格式 |
+
+## 输出
+
+JSON，包含 `updates`（updatedRange, updatedRows, updatedColumns, updatedCells, revision）。
+
+## 参考
+
+- [lark-sheets-batch-set-style](lark-sheets-batch-set-style.md) — 批量设置样式
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

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

@@ -0,0 +1,46 @@
+
+# sheets +unmerge-cells（拆分单元格）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +unmerge-cells`。
+
+拆分指定范围内的合并单元格。
+
+> [!CAUTION]
+> 这是**写入操作** —— 执行前必须确认用户意图。可以先用 `--dry-run` 预览。
+
+## 命令
+
+```bash
+# 拆分 A1:B2 范围的合并单元格
+lark-cli sheets +unmerge-cells --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!A1:B2"
+
+# 配合 --sheet-id
+lark-cli sheets +unmerge-cells --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --range "A1:B2"
+
+# 仅预览
+lark-cli sheets +unmerge-cells --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!A1:B2" --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（用于相对范围） |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+## 输出
+
+JSON，包含 `spreadsheetToken`。
+
+## 参考
+
+- [lark-sheets-merge-cells](lark-sheets-merge-cells.md) — 合并单元格
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数

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

@@ -0,0 +1,60 @@
+
+# sheets +update-dimension（更新行列属性）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +update-dimension`。
+
+更新指定范围行/列的属性，支持设置显隐状态和行高/列宽。
+
+> [!CAUTION]
+> 这是**写入操作** —— 执行前必须确认用户意图。可以先用 `--dry-run` 预览。
+
+## 命令
+
+```bash
+# 隐藏第 1-3 行
+lark-cli sheets +update-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension ROWS --start-index 1 --end-index 3 \
+  --visible=false
+
+# 设置第 1-5 列列宽为 120px
+lark-cli sheets +update-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension COLUMNS --start-index 1 --end-index 5 \
+  --fixed-size 120
+
+# 同时设置显示 + 行高
+lark-cli sheets +update-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension ROWS --start-index 1 --end-index 10 \
+  --visible=true --fixed-size 50
+
+# 仅预览参数
+lark-cli sheets +update-dimension --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --dimension ROWS --start-index 1 --end-index 3 \
+  --visible=true --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**，含） |
+| `--visible <true\|false>` | 否 | `true` 显示 / `false` 隐藏（须与 `--fixed-size` 至少传一个） |
+| `--fixed-size <px>` | 否 | 行高或列宽（像素）（须与 `--visible` 至少传一个） |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+> **注意**：`--visible` 是 bool flag，传值时使用 `--visible=true` 或 `--visible=false` 格式。
+
+## 输出
+
+JSON（成功时 `data` 为空对象 `{}`）。
+
+## 参考
+
+- [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-update-dropdown.md

@@ -0,0 +1,51 @@
+
+# sheets +update-dropdown（更新下拉列表）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +update-dropdown`。
+
+更新已有下拉列表的选项、颜色等配置。可同时更新多个范围。
+
+> [!CAUTION]
+> 这是**写入操作** —— 执行前必须确认用户意图。可以先用 `--dry-run` 预览。
+
+## 命令
+
+```bash
+lark-cli sheets +update-dropdown --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --sheet-id "<sheetId>" \
+  --ranges '["<sheetId>!A1:A100", "<sheetId>!C1:C100"]' \
+  --condition-values '["新选项1", "新选项2", "新选项3"]'
+
+# 更新为多选 + 着色
+lark-cli sheets +update-dropdown --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" \
+  --ranges '["<sheetId>!A1:A100"]' \
+  --condition-values '["选项A", "选项B"]' \
+  --multiple --highlight --colors '["#1FB6C1", "#F006C2"]'
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--ranges` | 是 | 范围 JSON 数组（如 `'["sheetId!A1:A100"]'`） |
+| `--condition-values` | 是 | 新的下拉选项，JSON 数组 |
+| `--multiple` | 否 | 是否多选，默认 false |
+| `--highlight` | 否 | 是否着色，默认 false |
+| `--colors` | 否 | RGB 颜色 JSON 数组，需与 `--condition-values` 一一对应 |
+| `--dry-run` | 否 | 仅打印参数，不执行请求 |
+
+## 输出
+
+JSON，包含 `spreadsheetToken`、`sheetId`、`dataValidation`（选项值和颜色映射）。
+
+## 参考
+
+- [lark-sheets-set-dropdown](lark-sheets-set-dropdown.md) — 设置下拉列表
+- [lark-sheets-get-dropdown](lark-sheets-get-dropdown.md) — 查询下拉列表
+- [lark-sheets-delete-dropdown](lark-sheets-delete-dropdown.md) — 删除下拉列表

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

@@ -0,0 +1,27 @@
+
+# sheets +update-filter-view-condition（更新筛选条件）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +update-filter-view-condition`。
+
+## 命令
+
+```bash
+lark-cli sheets +update-filter-view-condition --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --filter-view-id "<fvId>" --condition-id "E" \
+  --filter-type "number" --compare-type "between" --expected '["2","10"]'
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--filter-view-id` | 是 | 筛选视图 ID |
+| `--condition-id` | 是 | 列字母（如 `E`） |
+| `--filter-type` | 否 | 筛选类型 |
+| `--compare-type` | 否 | 比较运算符 |
+| `--expected` | 否 | 筛选值 JSON 数组 |

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

@@ -0,0 +1,24 @@
+
+# sheets +update-filter-view（更新筛选视图）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +update-filter-view`。
+
+## 命令
+
+```bash
+lark-cli sheets +update-filter-view --spreadsheet-token "shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --filter-view-id "<fvId>" --range "<sheetId>!A1:J20"
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--url` | 否 | 电子表格 URL |
+| `--spreadsheet-token` | 否 | 表格 token |
+| `--sheet-id` | 是 | 工作表 ID |
+| `--filter-view-id` | 是 | 筛选视图 ID |
+| `--range` | 否 | 新的筛选范围 |
+| `--filter-view-name` | 否 | 新的显示名称 |

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

@@ -0,0 +1,65 @@
+
+# sheets +write-image（写入图片到单元格）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +write-image`。
+
+特性：
+
+- 将本地图片文件写入到电子表格的指定单元格
+- 支持格式：PNG、JPEG、JPG、GIF、BMP、JFIF、EXIF、TIFF、BPG、HEIC
+- `--range` 的起始和结束单元格必须相同（单个单元格），如 `A1` 或 `<sheetId>!B2:B2`
+- `--name` 默认取 `--image` 的文件名
+
+> [!CAUTION]
+> 这是**写入操作** —— 执行前必须确认用户意图。可以先用 `--dry-run` 预览。
+
+## 命令
+
+```bash
+# 写入图片到指定单元格
+lark-cli sheets +write-image --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!B2:B2" \
+  --image "./logo.png"
+
+# 使用 URL + sheet-id，指定单个单元格
+lark-cli sheets +write-image --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --range "C3" \
+  --image "./chart.jpg"
+
+# 自定义图片名称
+lark-cli sheets +write-image --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!A1:A1" \
+  --image "./output.png" --name "revenue_chart.png"
+
+# 仅预览参数（不发请求）
+lark-cli sheets +write-image --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!B2:B2" --image "./logo.png" --dry-run
+```
+
+## 参数
+
+| 参数 | 必填 | 说明 |
+|------|----|------|
+| `--url <url>` | 否  | 电子表格 URL（与 `--spreadsheet-token` 二选一） |
+| `--spreadsheet-token <token>` | 否  | 表格 token（与 `--url` 二选一） |
+| `--range <range>` | 是  | 目标单元格：`<sheetId>!A1:A1`、`A1`（需配合 `--sheet-id`） |
+| `--sheet-id <id>` | 否  | 工作表 ID |
+| `--image <path>` | 是  | 本地图片文件的**相对路径**（必须在当前目录下，如 `./logo.png`；不支持绝对路径）|
+| `--name <filename>` | 否  | 图片文件名（含扩展名，默认取 `--image` 的文件名） |
+| `--dry-run` | 否  | 仅打印参数，不执行请求 |
+
+## 输出
+
+JSON，包含：
+
+- `spreadsheetToken` — 表格 token
+- `updateRange` — 图片写入的单元格范围
+- `revision` — 工作表版本号
+
+## 参考
+
+- [lark-sheets-write](lark-sheets-write.md) — 写入普通单元格数据
+- [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-write.md

@@ -0,0 +1,60 @@
+
+# sheets +write（写入单元格 / 覆盖写入）
+
+> **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。
+
+本 skill 对应 shortcut：`lark-cli sheets +write`。
+
+- `--values` 必须是二维数组 JSON
+- 内置尺寸校验：最多 5000 行、每行最多 100 列
+- 若已传 `--sheet-id`，`--range` 可写 `A1:D10` 或 `C2`
+- 若 `--range` 只给了 `<sheetId>` 或单个起始单元格，工具会按 `--values` 的尺寸自动展开为矩形范围
+
+> [!CAUTION]
+> 这是**写入操作** —— 执行前必须确认用户意图。可以先用 `--dry-run` 预览。
+
+## 命令
+
+```bash
+# 覆盖写入一个矩形区域
+lark-cli sheets +write --spreadsheet-token "shtxxxxxxxx" \
+  --range "<sheetId>!A1:B2" \
+  --values '[["name","age"],["alice",18]]'
+
+# 已有 --sheet-id 时，可直接写相对范围
+lark-cli sheets +write --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --sheet-id "<sheetId>" --range "C2" \
+  --values '[["hello"]]'
+
+# 只给 sheetId：会从 A1 开始，按 values 尺寸自动展开
+lark-cli sheets +write --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \
+  --range "<sheetId>" \
+  --values '[["hello","world"]]'
+
+# 仅预览参数（不发请求）
+lark-cli sheets +write --spreadsheet-token "shtxxxxxxxx" --range "<sheetId>!A1:B2" \
+  --values '[["name","age"],["alice",18]]' --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，包含：
+
+- `updated_range/updated_rows/updated_columns/updated_cells`
+- `revision`
+
+## 参考
+
+- [lark-sheets-read](lark-sheets-read.md) — 写入前可先 read 验证范围
+- [lark-shared](../../lark-shared/SKILL.md) — 认证和全局参数